최근 Claude Code에 '자동 메모리'가 기본 기능으로 들어오면서, 이제는 어제 고친 버그와 "우리 프로젝트는 이렇게 해요" 같은 습관을 매번 다시 설명할 필요가 줄어들었습니다.1 개발 보조 도구가 단순히 코드를 써주는 단계를 넘어, 팀과 저장소의 맥락을 따라오는 방향으로 진화한다는 신호라서 더 의미가 큽니다.
Claude Code 자동 메모리(SESSION/AUTO MEMORY)란?
핵심은 간단합니다. Claude Code가 작업 도중 배운 내용을 프로젝트별로 정리해 두었다가, 다음 세션에서 자동으로 불러옵니다. 예전에는 사용자가 CLAUDE.md에 "pnpm 써요, 테스트는 이 명령어로 돌려요" 같은 규칙을 직접 적어야 했는데, 이제는 Claude가 MEMORY.md를 만들어 누적합니다.1
메모리 파일은 로컬에 저장되며, 세션 시작 시 "Recalled ..." 같은 메시지로 불러온 내용이 표시되고(확장은 단축키로 확인), 필요하면 사용자가 "이건 기억해 둬"라고 명시적으로 저장 요청도 할 수 있습니다.12 즉 '대화 기록'이 아니라, 다음 작업을 빠르게 만드는 요약 노트에 가깝습니다.
MEMORY.md가 바꾸는 디버깅 루틴: "한 번 고치면 다음엔 바로 출발"
자동 메모리의 체감 포인트는 디버깅입니다. 한 번 삽질해서 찾아낸 해결책(예: 특정 모듈 버전 충돌, 빌드 플래그, 테스트 실패의 진짜 원인)이 다음 세션의 출발점이 됩니다.1 매번 "지난번에 뭐였더라..." 하며 맥락 복구부터 하던 시간을 줄이는 거죠.
다만 여기서 중요한 운영 팁이 하나 있습니다. 자동 메모리는 편리하지만, 팀의 '공식 규칙'과 충돌하면 골치가 아파집니다. 실제로 "내가 모르는 곳에 메모리가 쌓여서 CLAUDE.md와 중복/충돌한다"는 불만도 나왔고, 자동 기록만 끄고 싶다는 요청이 제기됐습니다.2 결론은 이거예요. 자주 반복되는 규칙은 CLAUDE.md(공식), 자잘한 시행착오는 MEMORY.md(자동 보조)로 역할을 나눠야 스트레스가 적습니다.
CLAUDE.md·/remember·MCP 메모리: 무엇을 어디에 남길까?
개발자들이 실제로 성과를 내는 패턴을 보면 "바로 코딩"보다 "계획→검토→실행"이 강합니다. 한 개발자는 먼저 리서치 문서와 plan.md를 만들고, 본인이 주석으로 교정한 뒤에야 구현을 시키는 방식이 안정적이라고 정리합니다.3 자동 메모리는 이 흐름에서 '반복 설명'만 덜어주는 장치로 쓰면 가장 안전합니다.
또 다른 관점에서는 메모리를 '학습'이 아니라 '작업 환경 설정'에 가깝다고 봅니다. 자동 메모리는 프로젝트 내부의 운영 규칙(파일명, 세션 충돌 방지 같은 실무 룰)을 잘 잡아주지만, 여러 프로젝트를 가로지르는 구조적 지식은 별도 메모리(MCP 기반 지식 그래프 등)가 더 적합하다는 주장도 있어요.4 요약하면, CLAUDE.md는 헌법, MEMORY.md는 회의록, MCP 메모리는 위키에 가깝습니다.
시사점: "기억하는 코딩 에이전트" 시대의 실전 체크리스트
첫째, 자동 메모리를 켜 둔 채로 1~2주만 써보고, 무엇이 저장되는지부터 확인하세요. 생산성을 올리는 메모리와 잡음을 구분하는 감이 생깁니다.1
둘째, 팀 규칙은 반드시 CLAUDE.md로 '승격'시키세요. 자동 메모리가 반복해서 적는 내용은 편하지만, 공식 규정이 아니면 어느 날 다른 방식으로 흔들릴 수 있습니다.34
셋째, "어디에 무엇이 저장되는지"는 보안/컴플라이언스 관점에서도 중요합니다. 엔터프라이즈 현장에서는 AI 도입이 기술보다 프로세스와 통제(감사, IP 보호)에서 갈린다는 얘기가 반복됩니다.5 메모리 기능은 편의 기능이면서 동시에 거버넌스 기능입니다.
마지막으로, 이 '기억'은 데스크톱에만 갇히지 않습니다. Claude Code는 로컬 세션을 폰에서 이어서 제어하는 Remote Control도 내놨고, "자리에서 일어나도 작업 흐름을 끊지 않겠다"는 방향이 뚜렷합니다.6 결국 우리는 코드를 더 많이 "타이핑"하기보다, 더 잘 "감독"하는 쪽으로 이동 중입니다.
참고
1Claude Code now remembers your fixes, your preferences, and your project quirks on its own
2[FEATURE] Option to disable auto-memory · Issue #23750 · anthropics/claude-code · GitHub
6Anthropic just released a mobile version of Claude Code called Remote Control
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.