MemoryLake
모든 글로 돌아가기
Pain Point2026년 5월 22일7 분 소요

클로드 코드가 내 프로젝트 컨텍스트를 잊는 이유는 무엇인가요?

드디어 클로드 코드를 제대로 설정했습니다: 리포를 알고, 규칙을 알고, 깨끗한 PR을 보냈습니다. 터미널을 닫고, 내일 다시 열면, `claude`를 실행하고 에이전트는 다시 프로젝트가 무엇을 하는지, 어떤 패키지 관리자를 사용하는지 물어봅니다.

`CLAUDE.md`는 바로 거기에 있습니다. 그런데 왜 컨텍스트가 사라졌을까요?

간단한 답변

클로드 코드는 모든 새로운 세션이 새 컨텍스트 창에서 시작되기 때문에 프로젝트 컨텍스트를 잊습니다. CLAUDE.md는 정적 규칙으로 로드되며(기억이 아님), --resume에는 이전 대화 컨텍스트가 완전히 복원되지 않는 문서화된 버그가 있습니다. 자동 기억은 짧은 메모를 캡처하고, 지속적인 프로젝트 기억 레이어는 매번 전체 컨텍스트를 로드할 수 있게 합니다.

클로드 코드가 프로젝트 컨텍스트를 잊는 이유

클로드 코드는 각 세션이 새로운 에이전트라는 아이디어를 기반으로 구축되었습니다. 잊어버리는 세 가지 메커니즘이 있습니다:

1. 모든 세션은 빈 컨텍스트 창으로 시작합니다. 클로드 코드는 각 실행을 깨끗한 슬레이트로 시작한 다음, CLAUDE.md, 참조된 파일 및 프롬프트를 로드합니다. 창 자체는 일반적으로 클로드 소넷 4.5/4.6/4.7에서 200K 토큰으로 관대하지만 세션별입니다. 여러 파일을 읽는 긴 에이전트 실행은 예상보다 더 빨리 채워집니다.

2. `CLAUDE.md`는 규칙이지 기억이 아닙니다. 앤트로픽의 문서에서는 CLAUDE.md를 에이전트가 세션 시작 시 읽는 정적 온보딩 파일로 설명합니다. "pnpm을 사용하고, Vitest로 테스트를 작성하며, /legacy/*를 편집하지 마세요"에 완벽합니다. 이는 전사 저장소가 아닙니다. 결정 뒤의 이유는 거기에 속하지 않으며, 과거 세션의 실체는 거기에 존재하지 않습니다.

3. `--continue`와 `--resume`에는 알려진 컨텍스트 손실 문제가 있습니다. 널리 논의된 GitHub 문제(anthropics/claude-code #43696)에서는 재개된 세션이 새로운 대화처럼 새로 시작할 수 있으며, 축적된 컨텍스트를 잃는다고 보고합니다. 재개가 작동하더라도 세션 간에 서로를 볼 수 없습니다 — 교차 세션 검색이 없습니다.

결과: 규칙은 유지되고, 에이전트 상태는 사라집니다.

클로드 코드가 프로젝트 컨텍스트를 잊을 때 잃는 것

모든 새로운 claude 호출은 재조정 비용이 발생합니다:

  • 결정 뒤의 이유가 사라집니다. "우리는 마이그레이션 비용 때문에 레거시 users_v1 테이블을 읽기 전용으로 유지하기로 선택했습니다"는 어제 세션에 있었습니다. 오늘의 클로드 코드는 여기에 쓰기를 제안합니다.
  • 다중 세션 작업이 실타래를 잃습니다. 세 개의 세션에 걸친 리팩토링은 매번 에이전트 앞에 계획이 필요합니다. CLAUDE.md로 한 단락을 고정할 수 있지만, 12단계 계획을 이유와 함께 고정할 수는 없습니다.
  • 같은 파일을 다시 로드하는 데 토큰을 소모합니다. 모든 세션은 같은 사양을 다시 읽고, 같은 규칙을 다시 발견하고, 같은 명확한 질문을 다시 묻습니다.

클로드 코드의 내장된 우회 방법(각각의 한계)

클로드 코드는 지속성을 목표로 하는 세 가지 기능을 제공합니다. 각각 도움이 되지만, 진정한 프로젝트 기억을 대체하지는 않습니다.

`CLAUDE.md`는 안정적인 규칙과 온보딩을 위한 올바른 도구입니다. 매 세션마다 로드됩니다. 앤트로픽의 공식 지침은 내 이전 메시지가 아닌 거기에 내구성 있는 지침을 두는 것입니다. 반면: CLAUDE.md는 짧게 유지하는 것이 가장 좋습니다 — 컨텍스트 공간을 위해 다른 모든 것과 경쟁하므로, 진화하는 프로젝트 역사에 적합하지 않습니다.

자동 기억은 클로드가 세션 중에 자신의 메모를 저장할 수 있게 하며, 사용자 선호, 피드백, 프로젝트 컨텍스트 및 참조 포인터로 구성됩니다. "사용자가 간결한 차이를 선호합니다"에 유용합니다. 전체 전사나 결정 로그를 위해 설계되지 않았습니다.

`/resume`와 `--continue`는 전체 컨텍스트로 이전 세션을 이어받기 위해 설계되었습니다. 실제로 사용자는 (문제 #43696, 2026년 4월) 재개된 세션이 빈 상태로 시작할 수 있으며, 작동하더라도 세션 간에 서로를 볼 수 없다고 보고했습니다.

전체 기능 세트를 보려면 공식 클로드 코드 문서를 읽을 수 있습니다.

안정적인 규칙을 위해서는 원주율이 확실합니다. 세션과 도구에 걸쳐 있는 프로젝트 컨텍스트에 대해서는 부족합니다.

클로드 코드의 내장된 기억이 부족한 이유

더 깊은 문제: 클로드 코드를 실행하는 대부분의 팀은 빠른 반복을 위해 Cursor를 사용하고, IDE에 밀접한 워크플로우를 위해 Cascade를 사용하며, 디자인 논의를 위해 ChatGPT를 사용합니다. CLAUDE.md는 그들 중 어느 곳에도 이동하지 않습니다. 각 도구는 프로젝트 규칙의 자체 복사본과 고립된 역사를 가집니다. 도구 간에 컨텍스트가 조각나고 프로젝트가 손해를 봅니다.

기억은 프로젝트를 따라가야 하며, 편집기를 따라가서는 안 됩니다.

MemoryLake가 클로드 코드의 프로젝트 컨텍스트 잊기를 어떻게 해결하는가

MemoryLake는 클로드 코드와 네이티브 MCP 지원을 통해 연결되는 크로스 모델 기억 레이어입니다. 정적 CLAUDE.md에 의존하는 대신, 프로젝트에 자체 기억을 부여하고 클로드 코드는 매 세션마다 이를 읽습니다.

  • 프로젝트별 기억, 파일별이 아닙니다. 사양, ADR, 과거 claude 전사 및 결정 로그는 프로젝트에 존재합니다. 클로드 코드는 매 턴마다 관련된 것을 가져오고, 모든 것을 CLAUDE.md에 맞추려고 하지 않습니다.
  • 원시 프롬프트보다 10,000배 더 많은 컨텍스트. MemoryLake의 검색 엔진은 수십억 개의 프로젝트 기억에서 읽고, 중요한 부분만 반환합니다. 같은 사양을 다시 로드하는 데 토큰을 소모하지 않습니다.
  • 모든 다른 AI로 휴대 가능. 동일한 프로젝트 기억은 Cursor, Windsurf, Claude Desktop, ChatGPT 및 Gemini에서 작동합니다. 프로젝트 중간에 도구를 전환하면 컨텍스트가 따라옵니다.

MemoryLake는 LoCoMo 긴 컨텍스트 벤치마크에서 94.03%를 기록했습니다 — 2026년 기준으로 발표된 최고의 결과로, 밀리초 검색 및 AES-256 종단 간 암호화를 제공합니다.

MemoryLake를 클로드 코드에 연결하는 3단계

  1. 프로젝트를 생성하고 컨텍스트를 로드합니다. MemoryLake에 로그인하고, 프로젝트 관리 열고, 프로젝트 생성 클릭 후 리포 이름으로 지정합니다(예: "acme-api — 클로드 코드 프로젝트"). 문서 드라이브를 통해 사양, ADR 및 과거 claude 전사를 업로드합니다(PDF, Markdown, Word, Excel, 이미지 모두 지원). 기억 탭에 짧은 지침을 추가합니다 — CLAUDE.md를 간결하게 유지하고 MemoryLake가 장기 컨텍스트를 보유하게 합니다.
  2. MCP 서버 엔드포인트를 생성합니다. 프로젝트 내 MCP 서버 탭을 열고, MCP 서버 추가 클릭 후 "클로드 코드 통합"으로 이름을 지정하고 생성 클릭합니다. MemoryLake는 API 키 ID, 비밀 및 엔드포인트 URL을 반환합니다. 비밀은 한 번만 표시되므로 즉시 복사합니다.
  3. 서버를 클로드 코드의 MCP 구성에 추가합니다. claude mcp add memorylake --transport http <endpoint-url>를 실행하고 프롬프트가 표시되면 Bearer 토큰을 추가합니다. (원하는 경우 ~/.claude.json을 직접 편집할 수도 있습니다 — 후행 쉼표에 주의하세요; JSON은 이를 허용하지 않습니다.) claude를 재시작합니다. 이제 에이전트는 매 세션 시작 시 프로젝트 컨텍스트를 로드하기 위해 호출할 수 있는 memorylake 도구를 갖게 됩니다.

자주 묻는 질문

클로드 코드가 세션 간에 내 프로젝트 컨텍스트를 기억하나요?

클로드 코드는 매 세션 시작 시 CLAUDE.md와 참조된 파일을 로드하므로 정적 규칙이 지속됩니다. 과거 세션의 실체는 존재하지 않으며, 각 claude 호출은 새 컨텍스트 창에서 시작됩니다. 자동 기억은 짧은 메모를 저장하고, 전사를 저장하지 않습니다.

클로드 코드가 세션 간에 프로젝트 컨텍스트를 기억하게 하려면 어떻게 해야 하나요?

클로드 코드를 MemoryLake와 같은 외부 기억 레이어에 네이티브 MCP 통합(claude mcp add 또는 ~/.claude.json)을 통해 연결합니다. 프로젝트 파일, 결정 및 과거 전사는 한 번 저장되고 세션마다 가져오므로 에이전트가 전체 컨텍스트로 열립니다.

클로드 코드가 --resume을 사용해도 우리가 논의한 내용을 잊는 이유는 무엇인가요?

문서화된 문제(anthropics/claude-code #43696, 2026년 4월)에서는 --resume--continue가 세션이 새로 시작된 것처럼 새로 시작할 수 있으며, 축적된 컨텍스트를 잃는다고 보고합니다. 재개가 작동하더라도 개별 세션은 서로를 검색할 수 없습니다.

클로드 코드의 컨텍스트 창 크기는 얼마인가요?

클로드 코드는 일반적으로 클로드 소넷 4.5/4.6/4.7에서 세션당 200K 토큰 창으로 실행됩니다. 여러 파일을 읽고 여러 도구를 실행하는 긴 에이전트 실행은 원시 사양이 제안하는 것보다 더 빨리 그 창을 채우며, 새로운 세션은 이를 재설정합니다.

내 클로드 코드 프로젝트 컨텍스트를 Cursor나 ChatGPT와 공유할 수 있나요?

CLAUDE.md는 클로드 코드 전용입니다. MemoryLake는 모델 중립 프로젝트에 기억을 저장하므로 동일한 프로젝트 컨텍스트가 클로드 코드, Cursor, Windsurf, Claude Desktop, ChatGPT 및 MCP 또는 REST를 사용하는 모든 도구에서 작동합니다.