Claude Code 세션마다 프로젝트를 다시 설명하는 일 멈추기

새로운 Claude Code 세션을 열고 처음 10분 동안 프로젝트에 대해 다시 설명하는 데 시간을 보냅니다. 무엇을 만들고 있는지, 왜 Mongo 대신 Postgres를 선택했는지, 장황한 출력은 싫고 에세이가 아닌 diff(차이점)를 원하는지, 그리고 인증(auth) 재작성은 기술 부채가 아니라 컴플라이언스(compliance) 마감 기한 때문이라는 점 등을 말이죠.

그러고 나면 세션이 종료되고 그 모든 정보는 증발합니다. 다음 세션에서 당신은 이 과정을 다시 반복합니다.

문제는 모델이 아니라 컨텍스트(context)입니다. Claude Code는 모든 대화를 백지 상태에서 시작합니다. 해결책은 더 큰 모델이나 벡터 데이터베이스(vector database)가 아닙니다. 세션 시작 시 자동으로 로드되는 작고 구조화된 평문 마크다운(markdown) 파일 세트입니다.

구조

~/.claude/
  CLAUDE.md                    # 매 세션마다 로드되는 사용자 정의 지침 (custom instructions)
  projects/<project>/
...

의존성도, 데몬(daemon)도, 클라우드(cloud)도 없습니다. 그저 Claude가 시작 시 읽어들이는 파일들뿐입니다.

네 가지 메모리 유형, 그리고 가장 중요한 한 가지 규칙

유형	저장할 내용	예시
user	당신의 역할, 기술, 선호도	"시니어 백엔드 개발자, Go 선호, 장황한 출력 혐오"
...

가장 가치가 높은 단일 유형은 **피드백(feedback)**입니다. 당신이 Claude를 교정할 때마다 — "X를 하지 마세요", "항상 Y를 하세요" — 그 교정 사항은 메모리 파일이 되어야 합니다. 이것이 매 세션마다 같은 실수를 반복하는 어시스턴트와, 한 번 배우면 다시는 반복하지 않는 어시스턴트의 차이입니다.

인덱스 규칙 (사람들이 자주 틀리는 부분)

MEMORY.md는 모든 대화에 로드되는 단 하나의 파일입니다. 따라서 이 파일은 정확히 한 가지 임무를 가집니다. 바로 콘텐츠를 쏟아붓는 것이 아니라, 포인터(pointer)들의 간결한 인덱스(index)가 되는 것입니다.

200줄 미만으로 유지하세요. 그 선을 넘으면 내용이 잘리게(truncated) 되고, 당신은 뒷부분을 조용히 잃게 됩니다. 인덱스에 들어갈 내용:

• 각 주제 파일에 대한 짧은 설명이 포함된 한 줄짜리 링크
• 말 그대로 모든 세션에 적용되는 핵심 사실들

인덱스에 — 또는 메모리의 그 어디에도 — 들어가지 않는 것:

• 코드 컨벤션 (Code conventions) — Claude는 코드를 직접 읽습니다.
• 파일 경로 및 구조 (File paths and structure) — 그것은 glob/grep을 위한 것입니다.
• Git 히스토리 (Git history) — git log가 권위 있는 정보입니다.
• 버그 수정 (Bug fixes) — 수정 사항은 이미 코드에 반영되어 있습니다.

저장소 (repo)에서 유도할 수 있는 정보라면 저장하지 마세요. 메모리 (Memory)는 코드가 Claude에게 말해줄 수 없는 것들을 위한 것입니다: 당신이 누구인지, 무엇을 왜 결정했는지, 그리고 당신이 어떤 방식으로 협업하기를 원하는지 말이죠.

실제 작동 방식

한 번의 초기 설정이 끝나면, 메모리를 수동으로 관리할 필요가 없습니다. 대화 도중에 "내가 X를 선호한다는 걸 기억해 줘"라고 말하면 Claude가 파일을 작성합니다. 한 번 수정하면 그 수정 사항은 지속됩니다. 한 달에 한 번씩 설정된 내용을 검토하세요. 오래된 것은 삭제하고 인덱스 (index)를 정교하게 다듬으세요. 군더더기 없는 메모리 시스템이 비대해진 시스템보다 언제나 승리합니다.

그 보상은 평범하면서도 엄청납니다: 모든 세션이 당신의 프로젝트, 당신의 기준, 그리고 지난 6개월간의 결정 사항을 이미 알고 있는 Claude와 함께 시작됩니다. 처음 10분의 시간이 사라집니다.

시도해 보세요

이 프로젝트는 무료이며 오픈 소스입니다 — 템플릿과 한 번의 명령어로 끝나는 설정이 제공됩니다:

git clone https://github.com/LuciferForge/claude-code-memory.git
cd claude-code-memory
python3 setup.py

저장소 (Repo) (템플릿 + 전체 인덱스 규칙): https://github.com/LuciferForge/claude-code-memory?utm_source=devto&utm_medium=article&utm_campaign=claude-code-memory-2026-06-01

만약 여러분만의 Claude Code 메모리 설정을 구축했다면, 인덱스를 어떻게 구조화했는지 듣고 싶습니다 — 그 부분은 사람마다 해결 방식이 다르기 때문입니다.