Claude Code 쓸 때마다 "우리 pnpm 쓰고 있어", "테스트 명령어는 make test-integration이야"라고 반복하고 계시죠? 이제 한번 알려주면 영원히 기억해요. 세션이 끝나도, 다음 날 켜도, 그대로 남아 있어요.
이게 뭔데?
Claude Code에는 세션이 바뀌어도 유지되는 두 가지 메모리 시스템이 있어요.
첫 번째는 CLAUDE.md. 사용자가 직접 작성하는 규칙서예요. "우리 프로젝트는 TypeScript strict mode 쓴다", "테스트는 pnpm test:integration으로 실행한다" 같은 걸 적어두면, 매 세션 시작할 때 Claude가 자동으로 읽어요. 한마디로 AI한테 주는 온보딩 문서인 거죠.
두 번째가 오늘의 주인공, Auto Memory예요. 이건 Claude가 작업하면서 스스로 메모를 작성하는 기능이에요. 프로젝트 패턴, 디버깅 인사이트, 사용자 선호도 같은 걸 알아서 기록해두고, 다음 세션에서 참고해요. 비유하자면 CLAUDE.md는 내가 쓰는 팀 위키고, Auto Memory는 Claude가 혼자 쓰는 업무 일지예요.
핵심 비유
CLAUDE.md = "이렇게 해라" (내가 쓰는 규칙서)
Auto Memory = "저번에 이래서 실패했다" (Claude가 쓰는 업무 일지)
기술적으로 보면, Auto Memory는 ~/.claude/projects/<project>/memory/ 경로에 마크다운 파일로 저장돼요. 마법 같은 데이터베이스가 아니라, 그냥 텍스트 파일이에요. MEMORY.md가 인덱스 역할을 하고, debugging.md나 api-conventions.md 같은 토픽별 파일을 추가로 만들어요.
중요한 건 MEMORY.md의 처음 200줄만 매 세션에 자동 로드된다는 점이에요. 나머지 토픽 파일은 필요할 때 Claude가 알아서 읽어요. 그래서 MEMORY.md는 간결한 인덱스로 유지하고, 상세 내용은 별도 파일로 분리하는 게 좋아요.
뭐가 달라지는 건데?
솔직히, 메모리 없는 AI 코딩 도우미는 매일 출근하는데 매일 "여기 뭐 하는 회사예요?"라고 묻는 신입이랑 같아요. 매번 프로젝트 구조 설명하고, 코딩 컨벤션 알려주고, 빌드 명령어 가르치고. 이 반복이 한 세션당 대화 토큰을 잡아먹어요.
| 메모리 없이 | Auto Memory 활용 | |
|---|---|---|
| 세션 시작 | 매번 프로젝트 맥락 설명 반복 | 자동으로 맥락 로드 |
| 실수 반복 | 어제 고친 버그 패턴 또 실수 | 이전 디버깅 인사이트 참고 |
| 코딩 컨벤션 | "default export 쓰지 마" 매번 반복 | 한번 알려주면 영구 기억 |
| 빌드/테스트 명령어 | "npm이 아니라 pnpm이야" 매번 교정 | 정확한 명령어 자동 사용 |
| 토큰 소모 | 맥락 반복에 토큰 낭비 | 핵심 작업에 토큰 집중 |
실제 사용기가 인상적이에요. 한 개발자는 13개 프로젝트를 관리하면서 몇 달간 Auto Memory를 돌려봤는데, Claude가 기록한 건 딱 12줄이었대요. 실망했을까요? 아니에요. 그 12줄이 병렬 세션에서 컨텍스트 파일명이 충돌하는 버그를 잡은 핵심 패턴이었거든요. 양이 아니라 질이에요. 매 세션 시작할 때 그 12줄이 자동으로 로드되니까, 같은 실수가 사라진 거죠.
Product Talk의 Teresa Torres는 비기술 직군에서의 활용을 보여줬어요. 마케팅 카피 작성, SEO 최적화, 경쟁사 리서치 — 이 모든 작업에서 Claude가 타겟 고객, 제품 가치, 브랜드 톤을 기억하고 있으니까, 매번 파일 업로드하거나 긴 프롬프트를 쓸 필요가 없어진 거예요.
"CLAUDE.md는 내가 쓰는 설정 파일이고, Auto Memory는 시스템이 자동으로 쓰는 설정 파일이다. 둘 다 '학습'이 아니라 '트레이닝'이다."
— Brent W. Peterson, "Automatic Memory Is Not Learning"
핵심만 정리: 시작하는 법
- /init으로 CLAUDE.md 부트스트랩
프로젝트 디렉토리에서/init을 실행하면 Claude가 프로젝트 구조를 분석해서 기본 CLAUDE.md를 생성해줘요. 중요한 건 — 생성된 내용 중 불필요한 것을 과감하게 삭제하는 거예요. "이 프로젝트는 JavaScript를 사용합니다" 같은 뻔한 건 지우고, Claude가 틀릴 만한 것만 남기세요. 빌드 명령어, 코딩 컨벤션, 아키텍처 결정 사항 위주로요. - Auto Memory 활성화 확인
/memory명령어를 실행하면 현재 메모리 파일 목록과 Auto Memory 토글이 보여요. Auto Memory가 꺼져 있으면 여기서 켜면 돼요. 또는 환경변수CLAUDE_CODE_DISABLE_AUTO_MEMORY=0으로 강제 활성화할 수도 있어요. - 그냥 일하기 — Claude가 알아서 기록
특별히 할 건 없어요. 작업하다 보면 Claude가 프로젝트 패턴, 디버깅 인사이트, 코드 스타일 같은 걸 자동으로 MEMORY.md에 기록해요. 세션 중에Wrote X memories라는 메시지가 뜨면 기록된 거예요. - 직접 기억시키기
특정 사항을 확실히 기억시키고 싶다면, 그냥 말하면 돼요. "우리 pnpm 쓰니까 기억해" 또는 "API 테스트할 때 로컬 Redis 필요한 거 메모해둬"라고요. Claude가 Auto Memory에 기록해요. - 주기적으로 리뷰
/memory로 MEMORY.md를 열어서 Claude가 뭘 기억했는지 확인하세요. 잘못된 게 있으면 수정하고, 반복되는 패턴이 있으면 CLAUDE.md 규칙으로 승격시키면 돼요. 마크다운 파일이라 아무 에디터에서나 수정 가능해요.
주의
Auto Memory는 프로젝트(git 저장소)별로 분리돼요. A 프로젝트에서 배운 건 B 프로젝트로 넘어가지 않아요. 모든 프로젝트에 적용할 개인 선호도는 ~/.claude/CLAUDE.md(글로벌 메모리)에 적으세요.
