Cursor 컨텍스트가 Claude Code로 따라오지 않는 이유
각 도구가 저장하는 것
Cursor는 레포지토리에 커밋된 규칙(.cursor/rules/, 레거시 .cursorrules)과 로컬 세션 메모리 및 생성된 Memories에 컨텍스트를 보관합니다. Claude Code는 시작할 때 CLAUDE.md 파일을 읽고 코드베이스를 기반으로 작동하며, 세션 컨텍스트를 창에 유지합니다. 정적 규칙은 양쪽 모두 대략적인 대응물이 있지만, 결정 사항, 수정 사항, 누적된 프로젝트 지식과 같은 동적 이해도는 공유할 수 있는 공간이 없습니다.
이전되지 않는 기술적인 이유
규칙은 단순한 텍스트이므로 .cursor/rules/를 CLAUDE.md로 변환하는 것은 수동으로 가능합니다. 하지만 Cursor의 세션 메모리는 내보내기 기능이 없는 로컬 앱 상태에 저장되며, Claude Code에는 이를 가져오는 기능이 없습니다. 따라서 작성된 규칙을 넘어 Cursor를 진정으로 유용하게 만들었던 부분(학습된 모든 내용)은 함께 이동하지 않습니다. Claude Code는 코드로부터 자체적인 이해를 처음부터 다시 구축합니다.
이로 인해 발생하는 비용
이전 도구가 이미 이해하고 있던 코드베이스에 에이전트를 다시 온보딩해야 합니다. 동일한 컨벤션을 다시 언급하고, 동일한 결정을 다시 설명하며, 동일한 수정을 다시 반복해야 합니다. 규칙 파일에 기록되지 않고 Cursor의 세션 메모리에만 존재했던 모든 것은 그대로 사라집니다. 그리고 일부 작업을 위해 Cursor를 계속 병행해서 사용한다면, 두 도구의 프로젝트 이해도는 즉시 어긋나게 됩니다.
단계별 가이드: 수동으로 Cursor에서 Claude Code로 이동하기
기본적인 방법은 수동이지만, 핵심적인 부분은 이전할 수 있습니다.
1단계: Cursor가 보유한 정보 추출하기
.cursor/rules/*.mdc및 레거시.cursorrules콘텐츠를 복사합니다.- 이 프로젝트에 대한 Cursor의 Memories를 검토하고 보관할 가치가 있는 누적된 사실들을 복사합니다. 일괄 내보내기 기능이 없으므로 수동으로 진행해야 합니다.
- 머릿속이나 이전 채팅에는 존재하지만 규칙 파일에 기록되지 않은 결정 사항과 컨벤션을 메모해 둡니다.
2단계: Claude Code 설정하기
- Cursor 규칙에서 변환한 컨벤션을 바탕으로 레포지토리 루트에
CLAUDE.md를 생성하거나 업데이트합니다. - 백업한 Memories와 결정 사항을
CLAUDE.md또는 Claude Code가 읽을 문서 파일에 추가합니다. - Cursor에서 의존했던 MCP 서버를 Claude Code MCP 설정에 다시 추가합니다.
이렇게 하면 CLAUDE.md로 재작성된 규칙과 백업해 둔 컨텍스트가 포함된 변환된 기본 베이스라인을 얻을 수 있습니다. 세션 기록은 이전되지 않으며, Cursor를 계속 사용하더라도 이 상태에서 동기화가 유지되지 않습니다.
마이그레이션 시 사라지는 것들
규칙 파일에 도달하지 못한 Cursor의 세션 수준 이해도, 이전 Cursor 세션의 대화 기록이 사라집니다. 또한 동기화는 일회성입니다. 다음 달에 CLAUDE.md를 개선하더라도 여전히 Cursor를 사용하는 팀원은 이를 볼 수 없으며, 제3의 도구를 추가하려면 컨텍스트를 다시 변환해야 합니다. 이는 전환하는 순간 나타나는 기기 간 및 도구 간 컨텍스트 격차 때문입니다.
더 나은 방법: 두 에이전트를 위한 단일 메모리 레이어
마이그레이션이 어려운 유일한 이유는 컨텍스트가 각 도구 내부에 존재하기 때문입니다. 이를 중립적인 레이어로 끌어올리면 Cursor와 Claude Code가 동일한 소스를 읽게 됩니다. MemoryLake는 컨벤션, 아키텍처, 결정 사항을 Git 스타일의 버전 관리 및 종단간 암호화 방식으로 한 번만 저장하고, MCP를 통해 두 에이전트 모두에 제공하므로 전환은 재구축이 아닌 단순한 연결이 됩니다.
| 구분 | 수동 Cursor → Claude Code | MemoryLake 레이어 |
|---|---|---|
| 필요한 단계 | 규칙 변환 + 메모리 백업 | 3단계 (최초 1회) |
| 동적 프로젝트 이해도 | 대부분 손실됨 | 유지 및 검색 가능 |
| 점진적 전환 중 동기화 유지 여부 | 아니요 | 예 |
| 추후 제3의 에이전트 지원 여부 | 다시 변환 필요 | 연결만 하면 됨 |
| 결정 사항의 버전 기록 | 아니요 | 예 (Git 스타일) |
1단계: API 키 생성하기
MemoryLake에 로그인하고 키를 생성한 후 첫 번째 요청을 보냅니다. 약 30초 정도 소요됩니다.
2단계: 첫 번째 메모리 업로드하기
두 에이전트 모두에 필요한 프로젝트 지식(컨벤션, 아키텍처 노트, 결정 사항, 참조 문서 등. 문서, 이미지 및 기타 파일 모두 지원됨)을 하나의 도구 규칙 형식에 가두는 대신 여기에 업로드합니다.
3단계: AI 및 에이전트 연결하기
두 도구 모두 MCP를 지원합니다. API 키를 사용하여 Claude Code의 MCP 설정과 .cursor/mcp.json에 MemoryLake를 추가합니다. 점진적으로 전환하는 동안 두 에이전트 모두 뒤처지지 않으며, 동일한 메모리를 MCP 또는 API를 통해 Codex, OpenClaw 및 기타 에이전트에서도 사용할 수 있으므로 다음 도구도 그냥 연결하기만 하면 됩니다.
에이전트를 다시 온보딩할 때 실제로 발생하는 비용
전환 비용
코딩 에이전트를 이동한다는 것은 이전 에이전트가 이미 알고 있던 코드베이스(컨벤션, 결정 사항, 수정 사항)를 수동으로 다시 가르쳐야 함을 의미합니다. 사용량에 따라 요금이 부과되는 에이전트의 경우, 새로운 grep 및 재구축 작업은 실제 작업이 시작되기도 전에 재발견을 위해 토큰을 소모하게 됩니다.
다시 온보딩하는 대신 검색하기
공유 레이어를 사용하면 Claude Code가 프로젝트의 컨벤션과 결정 사항을 재구성하는 대신 필요할 때 가져오므로 첫날부터 정보를 파악한 상태로 시작할 수 있습니다. 더 저렴하고 빠르며, 나중에 다시 전환하거나 도구를 추가하는 데 비용이 들지 않습니다. MemoryLake의 Token Saving Calculator는 사용량에 따른 효과를 예측해 줍니다.
크로스 에이전트 메모리를 위한 모범 사례
동적 컨텍스트는 레이어에, 컨벤션은 레포지토리에
각 도구가 읽을 수 있는 CLAUDE.md / .cursor/rules/에는 안정적인 규칙을 유지하고, 결정 사항, 해결된 이슈, 프로젝트 이해도와 같은 동적 컨텍스트는 공유 메모리에 보관하세요. 각각 알맞은 위치에 배치하는 것이 좋습니다.
전환하기 전에 백업하기
Cursor의 세션 메모리는 사라지는 부분입니다. Claude Code로 완전히 전환하기 전에 이를 공유 레이어에 캡처해 두면 전환 시 아무것도 잃지 않습니다.
레포지토리별 범위 지정
레포지토리당 하나의 메모리 범위를 지정하면 두 에이전트의 컨텍스트를 정확하게 유지하고 한 프로젝트의 컨벤션이 다른 프로젝트로 흘러 들어가는 것을 방지할 수 있습니다.
결론
Cursor와 Claude Code 모두 훌륭한 도구이지만, 둘 사이를 이동하려면 수동으로 재구축해야 합니다. 그리고 기존 설정을 훌륭하게 만들어 주었던 누적된 이해도가 바로 내보낼 수 없는 부분입니다. 대신 이 컨텍스트를 공유 메모리 레이어에 보관하면 전환은 단순한 연결이 됩니다. 두 에이전트 모두 동일한 컨벤션과 결정 사항을 읽고 동기화 상태를 유지하며, 다음에 어떤 도구를 도입하든 바로 사용할 수 있습니다. 한 번만 마이그레이션하고 모든 에이전트가 메모리를 공유하도록 하세요.