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

Claude 채팅의 프로젝트에는 네 가지 종류의 컨텍스트가 있으며, 각기 다르게 저장됩니다.

Project instructions(프로젝트 지침). Anthropic 고객 센터에 따르면 "Claude는 프로젝트 내의 모든 채팅에 이 지침을 사용합니다." 이는 톤, 역할, 규칙과 같은 상시 브리핑입니다.

Project knowledge(프로젝트 지식). 사용자가 업로드한 파일입니다. "이 공간에 업로드하는 모든 내용은 해당 프로젝트 내의 모든 채팅에서 사용됩니다." 유료 플랜의 경우, 대규모 지식 베이스는 검색(retrieval) 방식으로 전환되며, 이에 대해서는 RAG 모드의 Claude projects 가이드에서 설명합니다.

Project chats(프로젝트 채팅). 프로젝트 내부의 대화입니다. 고객 센터는 중요한 참고 사항을 덧붙입니다. "정보가 프로젝트 지식 베이스에 추가되지 않는 한, 프로젝트 내의 채팅 간에 컨텍스트는 공유되지 않습니다."

Project memory(프로젝트 메모리). "각 프로젝트에는 고유한 메모리가 있습니다." 프로젝트에서 작업하는 동안 Claude는 프로젝트 외부 채팅의 메모리와 함께 해당 메모리를 사용하며, 새로운 메모리는 프로젝트에 저장됩니다.

Claude Code로 이동할 때 이러한 각 항목에는 목적지가 필요하며, 목적지는 사용하는 Claude Code 버전에 따라 달라집니다.

claude.ai/code의 새로운 Projects에서

Anthropic은 "Claude Code를 시작으로 단계적으로" 새로운 버전의 프로젝트를 출시하고 있습니다. 고객 센터의 설명에 따르면, "프로젝트는 하나의 대화입니다. 필요한 것을 생각나는 대로 말하면 Claude가 작업을 클라우드에서 실행되는 병렬 스레드로 나눕니다." 또한 "모든 스레드는 프로젝트의 파일, 저장소, 지침 및 메모리에서 시작됩니다"라고 덧붙입니다.

Claude Code 문서에는 해당 컨텍스트가 상주하는 위치가 명시되어 있습니다.

• Project memory: "요구 사항, 결정 사항, 함정 등 Claude가 프로젝트에 대해 기록한 메모로, 파일로 저장됩니다." 모든 클라우드 스레드는 시작될 때 인덱스 파일인 MEMORY.md를 읽습니다.
• Project instructions: "각 새 스레드와 프로젝트 대화의 Claude에게 전송되는 텍스트로, 최대 16,000자까지 가능합니다."
• 저장소, 파일 및 환경: 모든 스레드가 복제하는 저장소, 읽을 수 있는 파일, 실행되는 클라우드 환경입니다.

새로운 Projects는 claude.ai/code, 데스크톱 앱 및 Claude 모바일 앱에서 사용할 수 있습니다. 문서의 제한 사항 섹션에는 "터미널 CLI, VS Code 확장 프로그램 또는 JetBrains 플러그인"에서는 사용할 수 없다고 명시되어 있습니다. Claude Code Projects 및 프로젝트 메모리 가이드에서 접속 후 메모리가 작동하는 방식을 다룹니다.

내 머신의 Claude Code에서

터미널에서 Claude Code는 파일로부터 컨텍스트를 읽습니다. 메모리 문서에는 다음 범위가 나열되어 있습니다.

• Project instructions (./CLAUDE.md): "프로젝트를 위한 팀 공유 지침"으로, 소스 제어를 통해 팀원들과 공유됩니다.
• Local instructions (./CLAUDE.local.md): "개인적인 프로젝트별 기본 설정; .gitignore에 추가하세요."
• User instructions (~/.claude/CLAUDE.md): "모든 프로젝트에 적용되는 개인적인 기본 설정".
• Auto memory: Claude가 직접 작성하며 "사용자 기본 설정, 사용자가 Claude에게 주는 수정 사항, Claude가 코드에서 도출할 수 없는 프로젝트 컨텍스트"를 다룹니다.

저장소는 사양서, 아키텍처 노트, API 참조 등 코드와 관련된 지식 파일이 속하는 곳이기도 합니다. Claude Code는 작업에 필요할 때 이를 읽습니다.

고객 센터는 기존 프로젝트 섹션에서 다음과 같이 이동을 설명합니다. "일부 Pro 및 Max 사용자를 위해 기존 프로젝트를 새 버전으로 이동하기 시작했습니다. 이동 중에 손실되거나 삭제되는 것은 없습니다. 지침, 파일, 전체 채팅 기록, 예약된 작업 등 프로젝트의 모든 항목이 함께 이동합니다. 중단했던 부분부터 바로 다시 시작할 수 있습니다."

이 내용이 본인에게 해당되는지는 다음 두 문장에 달려 있습니다. "지난 30일 이내에 기존 프로젝트를 사용한 경우, 프로젝트를 이동하기 전에 이메일을 보내드립니다." 그리고 "채팅 및 Cowork의 다른 기존 프로젝트는 당분간 현재 버전을 유지하며, 롤아웃이 확대됨에 따라 이동할 예정입니다."

Claude Code 문서에서는 롤아웃의 다른 측면을 보여줍니다. 액세스는 "클라우드 세션을 사용했으며 claude.ai 채팅이나 Cowork에 기존 프로젝트가 없는 계정부터 시작"되었으며, 이전 프로젝트는 "재설계된 환경이 적용될 때까지 현재와 같이 계속 작동합니다." Projects 재설계 가이드에서 이 계획이 처음 발표된 방식을 다룹니다.

이동된 프로젝트와 함께 제공되는 목록에는 지침, 파일, 채팅 기록 및 예약된 작업이 포함됩니다. 프로젝트 메모리에 대해서는 언급이 없으므로, 이동 후 프로젝트의 메모리를 열어 의존하고 있는 내용이 있는지 확인하세요.

프로젝트가 이동되더라도 몇 가지 사항은 의도적으로 수행할 가치가 있습니다.

채팅에만 존재하는 결정 사항. 이동된 프로젝트는 채팅 기록을 가져오지만, 새 스레드는 프로젝트의 파일, 지침 및 메모리에서 시작됩니다. 3주 전 어느 채팅에서 내린 결정은 기록에는 남아 있지만, 스레드가 해당 결정과 함께 시작될지 여부는 그것이 메모리나 지침에 도달했는지에 달려 있습니다.

저장소 규칙. 새로운 Projects는 프로젝트 지침을 각 저장소의 CLAUDE.md와 별도로 유지합니다. 문서에 따르면 "빌드 명령과 같이 하나의 저장소에 관한 규칙은 해당 저장소의 CLAUDE.md에 속합니다." 클라우드 스레드는 루트 CLAUDE.md를 읽지만, "하위 디렉터리의 CLAUDE.md 파일과 경로별 규칙은 로드되지 않습니다."

터미널에서의 작업. 새로운 Projects는 터미널 CLI에서 실행되지 않습니다. 터미널에서 빌드하는 경우 프로젝트의 컨텍스트가 저장소에 도달해야 합니다.

이동을 기다리기. 단계적으로 롤아웃되고 있으며, Anthropic은 다른 프로젝트들이 당분간 현재 버전을 유지할 것이라고 말합니다.

모든 지식 파일을 저장소에 업로드하기. 일부는 저장소에 속하지만, 회의록이나 가격 제안서 같은 파일은 코드가 아닌 컨텍스트이며 모든 세션에 노이즈를 추가합니다.

프로젝트 지침을 수정 없이 CLAUDE.md에 붙여넣기. Claude에게 시니어 제품 관리자처럼 답변해달라고 요청하는 등 채팅용으로 작성된 지침은 코딩 에이전트에게 적합하지 않은 경우가 많으며, 긴 CLAUDE.md 파일은 모든 세션에 로드됩니다.

프로젝트 메모리가 터미널에 나타나기를 기대하기. 터미널 세션은 별도의 저장소인 내 머신의 auto memory를 사용합니다.

1단계: 프로젝트 점검

프로젝트를 열고 네 가지 목록을 작성하세요.

• 지침(Instructions): 프로젝트 지침을 텍스트 파일로 복사합니다.
• 지식 파일(Knowledge files): 각 파일을 나열하고 코드에 관한 것(사양, 스키마, 아키텍처 노트)인지 아니면 주변 작업에 관한 것(조사, 계획, 메모)인지 결정합니다.
• 채팅 내 결정 사항: 프로젝트의 최근 채팅을 훑어보며 결정된 사항, 배제된 사항, 여전히 열려 있는 사항 등 결정 사항당 한 줄씩 이유와 함께 작성합니다.
• 프로젝트 메모리(Project memory): 프로젝트 페이지에서 Memory를 열고 Claude가 저장한 내용 중 유지하고 싶은 내용을 기록합니다.

결정 사항 목록은 사람들이 가장 많이 건너뛰는 부분이지만, 가장 중요한 부분이기도 합니다. 프로젝트 지식에 포함되지 않는 한 컨텍스트는 프로젝트의 채팅 간에 공유되지 않는다는 고객 센터의 유의 사항을 기억하세요.

2단계: 프로젝트가 상주할 위치 선택

claude.ai/code에 새로운 Projects가 있고, 특히 프로젝트가 이미 이동된 경우 프로젝트의 지침과 파일은 프로젝트에 그대로 둘 수 있습니다. 작업이 일어나는 저장소를 추가하세요. 사용자가 할 일은 메모리와 지침을 확인하고, 저장소별 규칙을 저장소로 이동하는 것입니다.

터미널에서 작업하거나 아직 새로운 Projects가 없는 경우 저장소가 목적지가 됩니다. 대부분의 작업이 일어나는 저장소를 선택하세요.

3단계: Claude Code가 읽을 수 있는 위치에 각 조각 배치

새로운 Projects의 경우:

1. 이동 후 프로젝트 메모리를 확인하고, 1단계 목록에서 누락된 요구 사항이나 결정 사항을 기억하도록 프로젝트 대화에서 Claude에게 요청합니다.
2. 프로젝트 지침을 다듬어 모든 스레드가 시작해야 하는 브리핑으로 만듭니다.
3. 모든 클라우드 스레드가 읽을 수 있도록 저장소 규칙을 각 저장소 루트의 CLAUDE.md로 이동합니다.

터미널의 Claude Code의 경우:

1. 프로젝트 지침을 CLAUDE.md 섹션으로 다시 작성합니다. 컨벤션, 아키텍처, 워크플로 등 코드에 적용되는 내용을 유지합니다. 개인적인 기본 설정은 CLAUDE.local.md 또는 ~/.claude/CLAUDE.md에 넣습니다.
2. 코드 관련 지식 파일을 저장소의 docs/ 폴더에 추가하고 CLAUDE.md에서 이를 가리키도록 합니다.
3. 결정 사항을 로드될 위치에 기록합니다. 확정된 규칙은 CLAUDE.md에 넣습니다. 특정 접근 방식이 거부된 이유와 같이 Claude가 코드에서 도출할 수 없는 컨텍스트는 auto memory에 넣을 수 있습니다. 첫 번째 세션에서 Claude에게 이를 기억하라고 말하세요.
4. 세션을 시작하고 Claude에게 코드를 작성하기 전에 프로젝트에 대해 알고 있는 내용을 요약해 달라고 요청합니다.

CLAUDE.md를 짧게 유지하세요. Claude Code의 하위 디렉터리 CLAUDE.md 제한 가이드에서 더 긴 지침 파일이 로드되는 방식을 다룹니다.

수동 마이그레이션도 효과적이며, Anthropic의 이동 기능도 대상자들에게 도움이 됩니다. 두 가지 모두 동일한 패턴을 보여줍니다. 프로젝트의 가장 유용한 컨텍스트인 결정 사항과 제약 조건이 새로운 컨테이너에서 계속 재구축된다는 점입니다. 채팅 프로젝트 메모리, 클라우드 프로젝트 메모리, CLAUDE.md, auto memory는 겹치는 사실들이 담기는 네 가지 장소이며, ChatGPT나 Codex에서 계획하거나 검토할 때 이러한 결정 사항을 다시 설명하게 됩니다.

MemoryLake는 이러한 결정 사항을 사용자가 관리하는 하나의 목록으로 유지하고, Claude Code 및 ChatGPT, Codex와 같이 연결하는 다른 어시스턴트에서 사용할 수 있게 해주는 메모리 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. Claude project, 프로젝트 메모리, auto memory, CLAUDE.md 파일 또는 공급업체의 저장소에서 어떤 내용도 읽거나 쓰거나 삭제하지 않습니다. 업무 콘텐츠의 경우, 조직의 도구 외부에 보관하는 것에 대한 정책을 따르세요.

1단계: API 키 생성

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

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

수동 마이그레이션의 1단계에서 작성한 결정 사항 목록부터 시작하세요. 결정된 사항, 이유, 배제된 사항을 포함합니다. 항목당 하나의 결정을 날짜와 함께 작성하고 해당 프로젝트의 라벨을 붙입니다.

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

Claude Code와 사용하는 다른 어시스턴트를 연결합니다. 터미널이나 클라우드 스레드에서의 다음 세션은 결정 사항을 활용할 수 있는 상태로 시작됩니다.

첫 번째 차이점은 빌드가 파일뿐만 아니라 프로젝트의 추론에서 시작된다는 것입니다. Claude Code는 무엇이 왜 결정되었는지 알게 됩니다.

두 번째는 각 조각이 올바른 위치에 배치된다는 것입니다. 저장소 규칙은 저장소에, 프로젝트 노트는 프로젝트 메모리나 auto memory에 상주하며, 개인적인 기본 설정은 개인적인 상태로 유지됩니다.

세 번째는 다음 이동이 더 쉬워진다는 것입니다. 롤아웃이 다른 프로젝트에 도달하거나 프로젝트 작업을 ChatGPT로 옮길 때, 결정 사항은 이미 특정 컨테이너 외부에 존재하게 됩니다.

결정 사항을 먼저 기록하세요. 이전 채팅에 남겨지기 가장 쉬운 부분입니다.

자동 이동 후 프로젝트 메모리를 확인하세요. 이동 목록에는 이에 대한 언급이 없습니다.

저장소 규칙을 저장소에 넣으세요. 클라우드 스레드와 터미널 세션 모두가 읽을 수 있도록 루트 CLAUDE.md에 넣습니다.

코드 지식과 업무 컨텍스트를 분리하세요. 사양서는 저장소에 넣고, 회의록은 넣을 필요가 없습니다.

개인적인 기본 설정을 공유 CLAUDE.md에서 제외하세요. CLAUDE.local.md나 사용자 파일을 사용하세요.

빌드하기 전에 Claude에게 프로젝트 내용을 다시 설명해 달라고 요청하세요. 컨텍스트가 제대로 전달되었는지 확인하는 가장 빠른 방법입니다.

채팅에서도 Claude가 프로젝트 파일을 잊어버린다면, Claude 프로젝트가 지식 파일을 잊어버리는 문제에 대한 가이드에서 해당 문제를 다룹니다.

Claude project는 지침, 지식 파일, 채팅 및 고유한 메모리를 보유합니다. Anthropic은 기존 프로젝트 중 일부를 Claude Code에서 시작되는 새로운 버전으로 이동하고 있으며, 이동 중에 손실되는 것은 없다고 밝히고 있습니다. 함께 이동되는 목록에는 지침, 파일, 채팅 기록 및 예약된 작업이 포함됩니다. 새로운 Projects는 터미널 CLI에서 실행되지 않으며, 다른 프로젝트들은 당분간 현재 위치에 유지됩니다.

프로젝트가 자동으로 이동되든 직접 이동하든, 해야 할 일은 동일합니다. 결정 사항을 기록하고, 저장소 규칙을 CLAUDE.md에 넣고, 메모리 내용을 확인하며, Claude가 코드를 작성하기 전에 프로젝트 내용을 다시 설명하도록 요청하는 것입니다.