Claude Code — MEMORY.md: 알아야 할 모든 것 & 시작하는 방법?

당신은 더 이상 클로드 코드에서 세션 컨텍스트를 잃는 것에 대해 걱정할 필요가 없습니다. 새로운 자동 메모리 기능은 워크플로에서 가장 성가신 부분 중 하나를 해결합니다. 이전에 Claude Code를 사용한 적이 있다면 문제를 잘 알고있을 것입니다. 당신은 세션을 닫고, 다음날 돌아와서, 클로드는 0에서 시작합니다. 그것은 일반적으로 동일한 프로젝트 세부 정보, 환경 설정 및 결정을 반복하여 귀하가있는 곳으로 돌아가는 것을 의미합니다.

Anthropic은 이제 Claude Code에 대한 자동 메모리를 도입했으며 목표는 간단합니다. 세션 간의 핸드 오프를 훨씬 부드럽게 만드십시오. 클로드는 이제 당신과 함께 작업하는 동안 자신의 기억을 구축하고 유지할 수 있습니다. 이동하면서 빌드 명령, 코딩 환경 설정, 아키텍처 선택, 심지어 함께 해결한 어려운 버그와 같은 프로젝트 주변의 유용한 컨텍스트를 조용히 추적합니다.

새 세션을 열면 해당 컨텍스트가 이미 있으므로 시작하는 대신 중지 한 곳에서 계속할 수 있습니다. 이 기능을 특히 흥미롭게 만드는 것은 수동으로 관리 할 필요가 없다는 것입니다. 클로드는 스스로 그것을 처리합니다.

대부분의 Claude Code 사용자는 이미 Claude 지침을 제공하는 데 사용되는 파일 인 CLAUDE.md에 익숙합니다. 자동 메모리는 MEMORY.md라는 새 파일이 있는 두 번째 레이어를 추가합니다. CLAUDE.md와 달리이 파일은 Claude 자체에 의해 작성되고 업데이트되며 세션 전반에 걸쳐 지속적인 스크래치 패드처럼 작동합니다.

나는 Claude Code의 실제 프로젝트에서 Claude Code의 새로운 자동 메모리를 테스트하여 Claude가 기억하는 것, 해당 정보가 저장되는 곳, 신선한 세션으로 돌아갈 때 얼마나 신뢰할 수 있는지 이해했습니다. 이 기사에서는 자동 메모리가 어떻게 작동하는지 설명하고 CLAUDE.md와 MEMORY.md의 차이를 분해하고, 테스트 결과를 공유하고, 필요할 때 기능을 제어하는 방법을 보여줍니다.

우리가 들어가기 전에 - 클로드 코드 (Claude Code)와 함께 일하고 기본적인 프롬프트를 넘어서고 싶다면 유용 할 수있는 실습 워크샵을 주최하고 있습니다.

클로드 코드 (Claude Code) 구축 에이전트는보다 일관되고 반복 가능한 워크 플로우를 구축하는 데 도움이되는 재사용 가능한 기술을 만드는 데 중점을 둔 실용적인 세션입니다.

1. 클로드 코드에서 자동 메모리는 어떻게 작동합니까?

자동 메모리는 Claude Code를 업데이트하자마자 기본적으로 켜집니다. 설치하거나 설정할 필요가 없습니다. 그것은 즉시 작동하기 시작합니다. 세션을 통해 작업하면서 Claude는 조용히 무슨 일이 일어나고 있는지 지켜보고 메모를 유지합니다. 그것은 미래의 세션을 위해 무엇을 절약 할 것인지 스스로 결정합니다.

다음은 Claude가 저장하는 정보의 종류입니다.

빌드 명령, 테스트 워크플로 및 코드베이스 구성 방식과 같은 프로젝트 패턴

어려운 문제에 대한 솔루션 및 특정 오류의 근본 원인을 포함하여 디버깅 통찰력

중요한 파일, 모듈 간의 관계 및 핵심 추상화와 같은 아키텍처 노트

커뮤니케이션 스타일, 워크플로 습관 및 도구 선택과 같은 환경 설정

요점은이 중 어느 것도 수동 입력에 달려 있지 않다는 것입니다. 클로드는 중요한 것을 선택하고 자동으로 기록합니다.

Auto-Memory는 어디에 저장됩니까?

각 프로젝트는 ~/.claude/projects/<projects/projects/project/memory/에 저장된 자체 메모리 디렉토리를 얻습니다.

<project> 경로는 Git 리포지토리의 루트를 기반으로 하며, 이는 동일한 저장소 내부의 모든 하위 디렉터리가 동일한 메모리 위치를 공유한다는 것을 의미합니다.

Git worktrees를 사용하는 경우 각 worktree는 고유한 메모리 디렉터리를 가져옵니다. Git 리포지토리 밖에서 Claude는 대신 현재 작업 디렉토리로 돌아갑니다.

이 폴더 내부에서는 일반적으로 다음과 같은 구조를 찾을 수 있습니다.

~/.claude/projects/<project>/memory/

├── MEMORY.md # 각 세션의 시작시 로드된 주요 인덱스

├─── debugging.md # 디버깅 기록 및 반복적 인 문제에 대한 메모

└── ... # 다른 주제 파일 클로드가 필요할 때 만드는

MEMORY.md는 주요 진입점입니다. 클로드가 저장 한 모든 것의 색인처럼 작동하며 각 세션의 시작 부분에서 자동으로로드되는 유일한 메모리 파일입니다.

200 라인 제한에 대해 이해하십니까?

명심해야 할 한 가지 중요한 세부 사항 : Claude는 새로운 세션이 시작될 때 MEMORY.md의 처음 200 라인 만 시스템 프롬프트에로드합니다.

MEMORY.md가 너무 길어지기 시작하면 Claude는 기본 파일을 짧고 유용하게 유지하면서 debugging.md 또는 api-conventions.md와 같은 별도의 주제 파일로 더 자세한 메모를 이동할 것으로 예상됩니다. 이러한 추가 주제 파일은 시작시로드되지 않습니다. 클로드는 그 특정한 맥락이 필요할 때만 세션 중에 읽습니다.

따라서 워크플로는 다음과 같습니다.

새로운 세션이 시작되고 MEMORY.md의 처음 200 줄이 로드됩니다.

Claude는 특정 디버깅 이력이 필요하므로 주문형 debugging.md를 읽습니다.

Claude는 새로운 것을 알게 된 다음 MEMORY.md 또는 주제 파일 중 하나를 업데이트합니다.

테스트 중에 한 가지 발견 된 것은 이것이 배경 프로세스로 발생하지 않는다는 것입니다. 이것이 제가 처음 기대했던 것입니다. 실제로 Claude가 세션에서 실시간으로 메모리 디렉토리에 읽고 쓰는 것을 볼 수 있습니다.

CLAUDE.md와 MEMORY.md의 차이점은 무엇입니까?

많은 개발자들이 같은 질문을 할 것입니다. CLAUDE.md가 이미 존재하는 경우 MEMORY.md가 왜 필요합니까? 그것을 명확히합시다.

CLAUDE.md는 항상 Claude Code의 일부였습니다. Claude가 따라야 할 지침, 규칙 및 기본 설정을 작성하는 파일입니다.

MEMORY.md는 다르게 작동합니다.

당신은 MEMORY.md를 직접 쓰지 않습니다. 클로드는 그것을 만들고 자동으로 업데이트합니다.

그것에 대해 생각하는 가장 쉬운 방법은 다음과 같습니다. CLAUDE.md는 지침을위한 것이고 MEMORY.md는 Claude 자신의 스크래치 패드입니다. MEMORY.md 내부에서 Claude는 다음과 같이 귀하와 함께 작업하는 동안 배우는 유용한 컨텍스트를 추적합니다.

당신의 환경 설정

반복되는 프로젝트 패턴

과거 세션의 유용한 메모

그리고 중요한 부분은 클로드가 수동으로 입력 할 필요없이 시간이 지남에 따라 이것을 스스로 구축한다는 것입니다. 따라서 차이점은 간단합니다.

CLAUDE.md : 이것은 Claude에게 무엇을해야하는지 알려주는 곳입니다.

MEMORY.md : Claude가 스스로 메모를 보관하는 곳입니다.

함께,이 두 파일은 클로드에게 세션의 시작 부분에서 더 나은 컨텍스트를 제공합니다.

하나는 클로드에게 당신이 어떻게 행동하기를 원하는지 알려줍니다. 다른 하나는 프로젝트에 대해 이미 배운 내용을 기억하는 데 도움이됩니다.

Claude Code Memory 계층 구조 이해

Claude Code는 CLAUDE.md 및 MEMORY.md에만 의존하지 않습니다. 실제로 계층화된 메모리 시스템을 통해 작동합니다. 각 레이어는 지침이 누구에게 적용되는지, 얼마나 널리 사용해야 하는지에 따라 다른 역할이 있습니다.

주요 아이디어는 간단합니다. 더 구체적인 지침은 더 넓은 지침을 무시합니다.

즉, 프로젝트 수준 CLAUDE.md가 글로벌 사용자 수준 메모리보다 우선시됩니다. 자동 메모리는 또한 프로젝트 수준에서 살고 있습니다. 즉, 귀하와 작업 중인 특정 프로젝트에 대한 범위입니다.

또 다른 유용한 세부 사항은 CLAUDE.local.md입니다. 이 파일은 .gitignore에 자동으로 추가되어 샌드 박스 URL, 로컬 테스트 노트 또는 팀이 공유 할 필요가없는 다른 것과 같은 개인 로컬 설정에 좋은 장소입니다.

Claude는 세션이 시작될 때 무엇을로드합니까?

새로운 Claude Code 세션을 열면 Claude는 여러 레이어에서 컨텍스트를 로드합니다.

이것은 일반적으로 다음을 포함합니다 :

조직의 정책, 하나가 존재하는 경우

공유 팀 지침이 포함된 프로젝트 수준 CLAUDE.md

개인 ~/.claude/CLAUDE.md 환경 설정

Claude의 저장된 노트가 포함 된 MEMORY.md의 처음 200 라인은

따라서 첫 번째 프롬프트를 작성하기 전에 Claude는 이미 프로젝트 규칙, 선호도 및 이전 세션에서 배운 컨텍스트에 대한 실무 이해를 가지고 있습니다.