MemoryLake
모든 글로 돌아가기
Tutorial2026년 5월 25일6 분 소요

Claude Code 기억을 Claude로 마이그레이션하는 방법: 2026 업데이트 가이드

Claude Code는 터미널에 존재하고, Claude 채팅 제품은 브라우저나 데스크탑 클라이언트에서 실행됩니다. 동일한 모델이지만, 서로 다른 기억 표면을 가지고 있습니다. `CLAUDE.md`, 슬래시 명령어 및 MCP 지원 컨텍스트가 Claude Projects 내에 어떻게 배치되는지 알아보세요.

간단한 답변

Claude Code는 기억을 Claude 채팅으로 자동으로 전송하지 않습니다. 각 리포지토리의 CLAUDE.md (및 ~/.claude/CLAUDE.md의 관련 부분)를 Claude Project의 시스템 프롬프트에 복사하고, 주요 리포 문서를 프로젝트 지식으로 업로드하며, 슬래시 명령어를 프로젝트 지식 텍스트로 변환해야 합니다. 각 리포당 15–25분을 계획하세요. MemoryLake와 같은 공유 MCP 기반 기억 계층은 두 클라이언트가 동일한 소스를 읽을 수 있게 합니다.

사람들이 Claude Code에서 Claude 채팅으로 이동하는 이유

2026년의 세 가지 요인:

  • 고급 설계 논의. 장기적인 아키텍처 대화는 종종 채팅 UI에서 더 나은 느낌을 줍니다.
  • 크로스 디바이스 접근. Claude 채팅 제품은 어디서나 실행되며, Claude Code는 터미널이 필요합니다.
  • 비개발자와의 공유. CLI에 익숙하지 않은 팀원들도 채팅 기반 프로젝트에 참여할 수 있습니다.

"기억"이 Claude Code와 Claude에서 의미하는 것

동일한 모델, 서로 다른 표면.

Claude Code 기억은 리포 루트의 `CLAUDE.md`, `~/.claude/CLAUDE.md` (사용자 전역), `.claude/commands/` 아래의 사용자 정의 슬래시 명령어, 그리고 Claude Code 설정에서 구성된 MCP 서버에 중점을 둡니다.

Claude (채팅) 기억Projects 내에 존재합니다. 각 프로젝트는 고유한 Project Knowledge (업로드된 파일 및 붙여넣은 텍스트)와 선택적 System Prompt를 가집니다.

CLAUDE.md는 프로젝트 시스템 프롬프트가 됩니다. 리포 docs/는 프로젝트 지식이 됩니다. 슬래시 명령어는 프로젝트 지식 텍스트 또는 참조 프롬프트가 됩니다.

1단계: Claude Code 기억 내보내기

Claude Code는 모든 것을 일반 파일로 저장합니다.

  1. 리포의 `CLAUDE.md`를 읽습니다. 내용을 작업 텍스트 파일에 복사합니다.
  2. `~/.claude/CLAUDE.md`를 읽습니다. 전역 지침을 user-guidance.txt에 복사합니다.
  3. *`.claude/commands/.md를 나열합니다.** 이를 slash-commands.md`로 묶습니다.
  4. 사용 중인 MCP 서버를 식별합니다. 각 서버의 이름, 엔드포인트 URL 및 인증 정보를 기록합니다.

최종 상태: 각 리포당 CLAUDE.md, user-guidance.txt, slash-commands.md, 및 mcp-list.md가 포함된 claude-code-export/ 폴더.

2단계: Claude (채팅)로 가져오기

Claude는 프로젝트별 지식을 기대합니다.

  1. 리포당 프로젝트를 생성합니다. Projects → Create Project를 엽니다. 리포 이름으로 지정합니다.
  2. `CLAUDE.md`를 시스템 프롬프트로 붙여넣습니다. 채팅에 맞게 조정합니다 — 경로 및 CLI 참조는 터미널 컨텍스트 없이 명확하게 읽혀야 합니다.
  3. 리포 문서를 프로젝트 지식으로 업로드합니다. Add Content → Upload Files를 클릭합니다. README.md, ADR, 스타일 가이드 및 유사한 파일을 첨부합니다.
  4. 슬래시 명령어를 프로젝트 지식 텍스트로 추가합니다. 번들을 붙여넣어 Claude가 요청 시 이를 가져올 수 있도록 합니다.
  5. 전역 사용자 지침이 어디에 들어갈지 결정합니다. 각 관련 프로젝트에 반복합니다 — Claude는 전역 기억 계층이 없습니다.
  6. MCP 서버를 다시 추가합니다. Claude Desktop의 MCP 구성에서 mcp-list.md의 MCP 서버를 추가합니다.
  7. 검사합니다. 프로젝트를 열고 이동된 규칙에 의존하는 질문을 합니다.

마이그레이션 후 여전히 잃는 것

  • 터미널 네이티브 실행. 이제 채팅 UI에 있으며, 실행 및 편집 루프가 다릅니다.
  • 슬래시 명령어 호출. /<name> 단축키는 변환되지 않으며, 대신 대화에서 프롬프트를 참조합니다.
  • 클라이언트별 채팅 기록. Claude Code 세션은 터미널에 남아 있습니다.
  • 지속적인 동기화. 다음 주에 새로운 CLAUDE.md 편집이 프로젝트에 나타나지 않으려면 복사를 다시 해야 합니다.

더 나은 방법: 하나의 기억 계층, 모든 Claude 표면

Claude Code를 배송에 사용하고 Claude 채팅을 논의에 사용하면, 도구별 드리프트가 즉시 시작됩니다.

MemoryLake는 이러한 규칙을 한 번 보관하고 MCP를 통해 노출합니다. 두 클라이언트 모두 MCP를 지원하므로 동일한 프로젝트 컨텍스트가 단일 엔드포인트에서 두 클라이언트로 흐릅니다.

  • 하나의 진실의 출처. 한 번 업데이트하면 두 표면 모두 변경 사항을 확인합니다.
  • 크로스 리포 표준. 팀 규칙은 단일 리포 위에 존재합니다.
  • 다음 도구에 쉽게 추가. 구성 변경으로 Cursor 또는 Windsurf를 추가합니다.

MemoryLake에 연결하는 3단계

1단계: 프로젝트 생성 및 컨텍스트 로드

MemoryLake에 로그인하고 프로젝트 관리로 이동하여 프로젝트 생성 버튼을 클릭합니다. "Claude Code ↔ Claude 공유 컨텍스트"로 이름을 지정합니다. 참조 문서(PDF, Word, Excel, PowerPoint, Markdown 또는 이미지)를 내 공간의 문서 드라이브로 드래그한 후, 문서 탭을 열고 문서 추가 버튼을 클릭합니다. CLAUDE.md, 사용자 지침 및 슬래시 명령어 본문을 기억 탭의 기억 추가를 통해 붙여넣습니다.

1단계: 프로젝트 생성 및 컨텍스트 로드
1단계: 프로젝트 생성 및 컨텍스트 로드

2단계: MCP 서버 엔드포인트 생성

프로젝트 내 MCP 서버 탭을 열고 MCP 서버 추가 버튼을 클릭한 후 설명(예: "Claude Code + Claude 브리지")을 입력하고 생성 버튼을 클릭합니다. MemoryLake는 키 ID, 비밀 및 엔드포인트 URL을 반환합니다. 비밀을 즉시 복사하세요 — 한 번만 표시됩니다.

2단계: MCP 서버 엔드포인트 생성
2단계: MCP 서버 엔드포인트 생성

3단계: 두 클라이언트를 엔드포인트에 연결

Claude Code의 설정에서 엔드포인트 URL과 비밀을 Bearer 토큰으로 사용하여 MemoryLake MCP 서버를 추가합니다. 동일한 MCP 서버를 Claude Desktop의 MCP 구성에 추가하고 Claude를 재시작합니다.

3단계: 두 클라이언트를 엔드포인트에 연결
3단계: 두 클라이언트를 엔드포인트에 연결

네이티브 마이그레이션 vs MemoryLake

차원네이티브 Claude Code → ClaudeMemoryLake 브리지
필요한 단계7–10 수동3 일회성
예상 시간리포당 15–25분설정 약 5분
리포 경계 보존프로젝트별만예 (하나의 프로젝트)
MCP 도구 재사용클라이언트별로 구성엔드포인트 공유
지속적인 변경 사항 동기화아니요
나중에 세 번째 도구와 함께 작동아니요 (재구성)예 (MCP 추가)

자주 묻는 질문

`CLAUDE.md`를 Claude 채팅 제품 내에서 직접 열 수 있나요?

아니요. 내용을 프로젝트의 시스템 프롬프트에 수동으로 붙여넣어야 합니다.

내 슬래시 명령어가 채팅 단축키가 되나요?

아니요. 대화에서 프롬프트로 참조하거나 프로젝트 지식 파일을 유지하세요.

Claude는 내 Claude Code MCP 서버를 상속하나요?

아니요. 각 MCP 서버는 클라이언트별로 구성됩니다. Claude Desktop의 MCP 구성에 추가하세요.

마이그레이션은 보통 얼마나 걸리나요?

리포당 15–25분을 계획하세요. 슬래시 명령어 또는 MCP 서버가 많으면 더 오래 걸립니다.

마이그레이션 후 Claude Code와 Claude를 어떻게 동기화하나요?

두 클라이언트를 공유 MemoryLake 프로젝트에 MCP 서버 엔드포인트를 통해 연결하여 업데이트가 두 클라이언트에 전파되도록 합니다.