컨텍스트 손실 없이 Claude 채팅을 Claude Code로 마이그레이션하는 방법 (2026)

Claude Code 문서의 메모리 페이지는 다음과 같은 명확한 문장으로 시작합니다. "각 Claude Code 세션은 새로운 컨텍스트 창으로 시작됩니다. 두 가지 메커니즘이 세션 간에 지식을 전달합니다." 문서는 이 두 가지를 다음과 같이 명시합니다:

• "CLAUDE.md 파일: Claude에게 영구적인 컨텍스트를 제공하기 위해 작성하는 지침."
• "자동 메모리(Auto memory): 사용자의 수정 사항 및 선호도를 바탕으로 Claude가 직접 작성하는 메모"

둘 다 파일입니다. CLAUDE.md는 리포지토리나 홈 폴더에 위치하며, 자동 메모리는 컴퓨터의 디렉터리에 저장됩니다. 문서는 각 파일이 로드되는 위치를 설명하며, 두 위치 모두 Claude Code 측에 있습니다.

Claude 채팅의 메모리는 다르게 작동합니다. Anthropic의 메모리 관련 문서에 따르면 "Claude는 채팅을 진행하면서 메모리를 개별 주제의 집합으로 저장합니다"라고 하며, 클라우드 상의 채팅과 Claude Cowork 간에 공유되는 하나의 메모리를 설명합니다. 반면 Claude Code의 메모리 문서에서는 CLAUDE.md와 자동 메모리만 설명할 뿐, 채팅 메모리나 채팅 기록을 세션으로 로드하는 것에 대해서는 설명하지 않습니다. 무언가를 직접 복사하기 전까지는 두 가지를 별개로 취급해야 합니다.

프로젝트도 마찬가지입니다. Claude Code에는 이제 클라우드 작업을 위한 자체 Projects 기능이 있으며, 문서는 이를 이전 기능과 구분합니다. "claude.ai 채팅 및 Cowork의 프로젝트: 스레드나 코디네이터 없이 대화와 참조 파일을 그룹화하는 이전의 프로젝트 환경." 즉, 채팅에서 빌드한 프로젝트는 Claude Code의 프로젝트와는 다른 것입니다.

두 도구가 공유하는 것은 요금제 플랜입니다. Pro 또는 Max 요금제에서 Claude Code를 사용하는 것에 대한 Anthropic의 문서에 따르면 "이러한 제한은 Claude와 Claude Code 간에 공유되므로, 두 도구에서의 모든 활동이 동일한 제한에 반영됩니다"라고 명시되어 있습니다.

유용한 채팅에는 여러 종류의 컨텍스트가 포함되어 있습니다. 각 컨텍스트는 Claude Code에서 자연스럽게 저장될 위치가 있습니다.

코드베이스에 대한 결정 및 컨벤션

이러한 내용은 프로젝트 CLAUDE.md(./CLAUDE.md 또는 ./.claude/CLAUDE.md)에 저장됩니다. 문서에서는 이를 "프로젝트를 위한 팀 공유 지침"으로 설명하며, 예시로 "프로젝트 아키텍처, 코딩 표준, 공통 워크플로"를 들고 있습니다. 채팅을 통해 에러 처리 방법, 날짜 처리에 사용할 라이브러리, 폴더 구조의 의미 등을 결정했다면, 이는 프로젝트 CLAUDE.md에 작성해야 할 내용입니다.

여기에 무엇을 작성해야 하는지에 대한 Anthropic의 조언은 다음과 같습니다. "CLAUDE.md를 그렇지 않았다면 다시 설명해야 했을 내용을 적어두는 곳으로 취급하세요." 그리고 크기에 대해서는 "CLAUDE.md 파일당 200행 미만을 목표로 하세요"라고 권장합니다.

개인 선호도

모든 프로젝트에 적용되는 선호도는 ~/.claude/CLAUDE.md에 저장되며, 문서에서는 이를 "모든 프로젝트에 대한 개인 선호도"라고 부릅니다. 커밋하고 싶지 않은 특정 프로젝트에 대한 선호도는 ./CLAUDE.local.md에 저장하며, 이는 "개인 프로젝트 전용 선호도; .gitignore에 추가할 것"으로 설명되어 있습니다.

채팅 메모리를 통해 사용자가 작은 단위의 커밋을 선호한다거나, 코드보다 설명을 먼저 듣고 싶어 한다는 점을 파악했다면 바로 이 위치에 저장해야 합니다.

Claude가 코드에서 파악할 수 없는 배경 지식

논의한 내용 중 일부는 리포지토리에 나타나지 않습니다. 특정 접근 방식을 거부한 이유, 마감일, 서비스 담당자 등이 이에 해당합니다. Claude Code의 자동 메모리는 이러한 종류의 메모를 위해 빌드되었습니다. 문서에는 저장되는 유형이 나열되어 있으며, 여기에는 "프로젝트: 진행 중인 작업, 마감일, 그리고 Claude가 코드나 git 기록에서 도출할 수 없는 결정 사항"이 포함됩니다.

Claude Code에게 특정 사실을 저장하도록 지시할 수도 있습니다. 사실을 기억하라고 요청하면 자동 메모리에 저장됩니다. 대신 CLAUDE.md에 지침을 넣으려면 직접 요청하거나 파일을 직접 편집하면 됩니다.

자동 메모리를 사용하기 전에 알아두어야 할 제한 사항이 있습니다:

• "자동 메모리는 로컬 머신에 종속됩니다." 이는 ~/.claude/projects/<project>/memory/ 아래에 저장되며, "파일은 머신이나 클라우드 환경 간에 공유되지 않습니다."
• "MEMORY.md 파일의 처음 200행 또는 처음 25KB 중 먼저 도달하는 기준이 모든 대화의 시작 시점에 로드됩니다." 주제 파일은 Claude가 필요할 때 읽습니다.
• "Claude는 아키텍처, 파일 경로, 디버깅 수정 사항 등 코드베이스에서 도출할 수 있는 모든 내용을 건너뜁니다. 또한 CLAUDE.md 파일에 이미 명시된 내용도 건너뜁니다."

따라서 여러 대의 컴퓨터에서 작업하거나 클라우드 세션에서 작업하는 경우, 중요한 내용은 자동 메모리 대신 CLAUDE.md에 작성하세요. Claude Code가 머신 간에 망각하는 이유에 대한 가이드에서 이 공백을 다루고 있습니다.

긴 참조 자료

채팅에서 도출된 사양, 연구 노트, 긴 설명 등은 CLAUDE.md의 내용으로 작성하기보다 docs/ 아래의 문서와 같이 리포지토리 내의 파일로 관리하는 것이 좋습니다. Claude는 필요할 때 이를 읽을 수 있으며, CLAUDE.md에서 이를 가리킬 수 있습니다. 문서에 따르면 "CLAUDE.md 파일은 @path/to/import 구문을 사용하여 추가 파일을 가져올 수 있습니다"라고 하며, 이러한 파일은 이를 가져오는 CLAUDE.md와 함께 시작 시 로드되므로 모든 세션에 필요한 내용만 가져오도록 하세요.

작업 트리(worktree), 다른 컴퓨터 또는 클라우드 세션을 사용하는 경우

Claude Code를 실행하는 위치에 따라 세션이 보게 되는 파일이 달라집니다. 프로젝트 CLAUDE.md는 리포지토리와 함께 이동하므로 모든 클론과 작업 트리에 존재합니다. 자동 메모리는 한 컴퓨터의 단일 리포지토리 내에서 공유됩니다. "동일한 git 리포지토리 내의 모든 작업 트리와 하위 디렉터리는 하나의 자동 메모리 디렉터리를 공유합니다."

사람들이 자주 놓치는 부분이 바로 CLAUDE.local.md입니다. 문서에서는 "gitignored된 CLAUDE.local.md는 생성한 작업 트리에만 존재합니다"라고 명시하고 있습니다. 여러 작업 트리에서 작업하는 경우, 개인 지침은 사용자 파일에 보관하세요. 각 Claude Code 작업 트리 세션이 로드하는 항목에 대한 가이드에서 자세한 내용을 다루고 있습니다.

리포지토리에서 다른 코딩 도구를 위해 이미 AGENTS.md를 사용하고 있다면, Claude Code가 이를 읽을 수 있습니다. CLAUDE.md를 AGENTS.md로 마이그레이션하는 가이드에서 두 파일이 함께 작동하는 방식을 설명합니다.

첫 번째 메시지에 전체 채팅 내용을 붙여넣기. 해당 세션은 컨텍스트를 갖게 되지만, 다음 세션은 새로운 컨텍스트 창으로 시작되므로 붙여넣은 내용은 이전 대화 기록에만 남게 됩니다.

Claude Code에게 Claude 메모리를 조회하도록 요청하기. 문서화된 메모리는 CLAUDE.md와 자동 메모리뿐입니다. 필요한 내용을 이 중 하나에 복사하세요.

전체 메모리 내보내기 내용을 CLAUDE.md에 복사하기. CLAUDE.md는 모든 세션에 로드되며, Anthropic은 각 파일을 200행 미만으로 유지할 것을 권장합니다. 리포지토리에 필요한 내용만 이동하세요.

자동 메모리가 알아서 감지하기를 기다리기. 문서에 따르면 "Claude는 매 세션마다 무언가를 저장하지는 않습니다. 향후 대화에서 정보가 유용할지 여부에 따라 기억할 가치가 있는지를 결정합니다"라고 합니다. 중요한 결정 사항이라면 CLAUDE.md에 작성하거나 Claude에게 기억하도록 요청하세요.

CLAUDE.md를 Claude가 반드시 준수해야 하는 규칙으로 취급하기. Anthropic은 "Claude는 이를 강제된 구성이 아닌 컨텍스트로 취급합니다"라고 설명합니다. 길고 장황한 지침보다 구체적이고 짧은 지침이 더 일관되게 준수됩니다.

Claude Code의 Projects에서 채팅 프로젝트 찾기. 이 둘은 서로 다른 기능입니다. 프로젝트의 지침과 파일에서 필요한 부분을 다시 구축하세요.

1단계: Claude 채팅에서 컨텍스트 추출하기

여전히 의존하고 있는 대화부터 시작하세요. 각 대화를 열고 결정 사항, 이유, 제약 조건 등 합의된 내용에 대한 짧은 요약을 작성합니다. 해당 채팅에서 Claude에게 요약 초안을 작성하도록 요청한 다음, 실제로 합의한 내용에 맞게 편집할 수 있습니다.

그런 다음 Claude가 사용자에 대해 저장한 내용을 내보냅니다. 메모리 내보내기 문서에서는 채팅에서 사용할 수 있는 프롬프트를 제공합니다. "내 메모리에 나타난 그대로 나에 대한 기억을 토씨 하나 틀리지 않고 작성해 줘." 결과를 텍스트 파일로 저장하세요. 설정 > 메모리에서도 메모리를 읽을 수 있으며, Anthropic은 "Claude가 기억하는 모든 것은 Topics 아래에 나열됩니다"라고 설명합니다.

전체 대화 기록을 복사하려면 데이터 내보내기를 사용하세요. Anthropic은 "개별 Claude 사용자는 웹 앱 또는 Claude Desktop의 설정 > 개인정보 보호에서 사용자 정보 및 채팅 기록을 내보낼 수 있습니다. iOS 또는 Android용 Claude에서는 내보내기를 실행할 수 없습니다"라고 설명합니다. 다운로드 링크는 이메일로 발송되며 "전송 후 24시간 후에 만료됩니다." Claude 데이터 내보내기 읽기 가이드에서 포함된 내용을 다루고 있습니다.

작업이 채팅 프로젝트 내에 있었다면, 프로젝트의 지침을 텍스트 파일로 복사하고 지식 파일이 있는지 확인하세요.

2단계: 각 요소를 Claude Code가 읽는 위치에 배치하기

요약본을 검토하고 각 항목을 다음과 같이 분류합니다:

• 코드베이스 및 팀에 적용되는 사항: 프로젝트 CLAUDE.md에 추가합니다. 각 줄은 짧고 구체적으로 유지하세요.
• 모든 곳에서 본인에게 적용되는 사항: ~/.claude/CLAUDE.md에 추가합니다.
• 이 리포지토리에서만 본인에게 적용되는 사항: ./CLAUDE.local.md에 추가합니다.
• Claude가 코드에서 도출할 수 없는 배경 지식: Claude Code에게 기억하도록 지시하거나, 모든 머신에서 필요한 경우 CLAUDE.md에 추가합니다.
• 긴 참조 자료: 문서로 커밋하고 CLAUDE.md에서 이를 가리키도록 설정합니다.

Claude가 코드에서 읽을 수 있는 내용은 제외하세요. 그런 다음 새 세션을 시작하고 /memory를 실행합니다. 문서에 따르면 이 명령은 "사용자 및 프로젝트 범위 전반에 걸쳐 CLAUDE.md, CLAUDE.local.md 및 기타 메모리 파일 위치를 나열합니다." 이동한 결정 사항 중 하나에 대해 Claude가 무엇을 알고 있는지 물어보고, 답변이 일치하는지 확인하세요.

수동 마이그레이션은 일회성 이동에는 효과적입니다. 문제는 이것이 지속되지 않는다는 점입니다. 생각을 정리하기 가장 쉬운 곳이 채팅이기 때문에 앞으로도 계속 채팅으로 논의를 진행할 것이고, 새로운 결정이 내려질 때마다 리포지토리에 다시 복사해야 합니다. 그동안 자동 메모리는 한 대의 컴퓨터에만 머물러 있고, 채팅 메모리는 계정에만 머물러 있게 됩니다.

MemoryLake는 이러한 결정 사항들을 직접 유지 관리하는 하나의 목록에 보관하여, Claude Code 및 ChatGPT, Codex 등 연결하는 다른 어시스턴트에서 사용할 수 있도록 지원하는 메모리 레이어입니다.

사용자가 직접 자신의 언어로 항목을 작성합니다. Claude 채팅, Claude 메모리, CLAUDE.md 파일, 자동 메모리 폴더 또는 타사 벤더의 저장소에서 데이터를 읽거나, 쓰거나, 삭제하지 않습니다. 업무용 리포지토리의 경우, 리포지토리 외부에 보관하는 정보에 대한 조직의 정책을 따르세요.

1단계: API 키 생성하기

로그인한 후 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 Claude 계정과는 별개입니다.

2단계: 첫 번째 메모리 업로드하기

수동 마이그레이션의 1단계에서 작성한 요약(채팅에서 결정된 사항, 제약 조건, 컨벤션)부터 시작하세요. 항목당 하나의 포인트를 작성하고, 날짜를 기입하고, 적용되는 리포지토리 레이블을 지정합니다.

3단계: AI 및 에이전트 연결하기

Claude Code 및 사용하는 다른 어시스턴트를 연결합니다. Claude Code를 실행하는 모든 컴퓨터와 연결된 다른 도구에서 동일한 항목을 사용할 수 있습니다.

첫 번째 차이점은 리포지토리에서의 첫 번째 Claude Code 세션이 채팅에서 결정한 사항을 이미 알고 있다는 것입니다. 아키텍처, 컨벤션, 제약 조건이 다시 찾아낼 필요 없이 그 자리에 준비되어 있습니다.

두 번째는 어떤 파일에 어떤 내용이 들어있는지 명확히 알 수 있다는 점입니다. 팀 규칙은 프로젝트 CLAUDE.md에, 개인 선호도는 사용자 파일에, 배경 지식은 자동 메모리나 자체 목록에 저장됩니다.

세 번째는 채팅에서의 다음 결정 사항이 고립되지 않는다는 점입니다. 한 번만 추가하면 다음에 리포지토리를 열 때 바로 사용할 수 있습니다.

이동하기 전에 대화를 요약하세요. 대화 기록 전체보다 결정 사항과 그 이유를 정리하는 것이 훨씬 유용합니다.

팀 규칙은 프로젝트 CLAUDE.md에 작성하세요. 소스 제어를 통해 공유됩니다.

개인 선호도는 사용자 파일에 작성하세요. ~/.claude/CLAUDE.md는 모든 프로젝트에 적용됩니다.

커밋하지 않을 선호도에는 CLAUDE.local.md를 사용하세요. .gitignore에 추가하세요.

여러 컴퓨터를 사용할 때 자동 메모리에 의존하지 마세요. 자동 메모리는 로컬 머신에 종속됩니다. Claude Code가 프로젝트 컨텍스트를 망각하는 이유에 대한 가이드에서 다른 공백들을 다루고 있습니다.

CLAUDE.md를 짧게 유지하세요. Anthropic은 파일당 200행 미만을 권장합니다.

이동 후 /memory로 확인하세요. 예상한 파일들이 나열되는지 확인합니다.

Claude 채팅과 Claude Code는 계정과 요금제 플랜을 공유하지만, 컨텍스트를 서로 다른 위치에 보관합니다. 채팅은 메모리를 계정에 저장합니다. 반면 Claude Code는 CLAUDE.md 파일과 자체 자동 메모리를 읽으며, 각 세션은 새로운 컨텍스트 창으로 시작됩니다.

채팅 내용을 이동하려면 합의된 사항을 요약하고, 메모리를 내보낸 다음, 각 항목을 Claude Code가 읽는 위치에 배치하세요. 팀 규칙은 프로젝트 CLAUDE.md에, 선호도는 사용자 파일에, 배경 지식은 자동 메모리나 커밋할 파일에 작성합니다. 마지막으로 /memory를 통해 결과를 확인하세요.