같은 지시를 두 번째 입력하고 있다면 대화가 아니라 파일에 기록할 때다.

이 장에서 기억할 핵심은 세 가지다.

• 두 가지 기억 장치 — CLAUDE.md는 사용자가 작성하고, 자동 메모리는 Claude가 작성한다.
• 200줄 — CLAUDE.md의 권장 상한
• 네 가지 적용 위치 — 조직 · 사용자 전체 · 프로젝트 · 개인용 프로젝트

3부 시작 — 하네스

2부에서는 자료를 제공하는 방법을 다뤘다. 3부에서는 Claude의 행동 방식을 미리 정하는 방법을 살펴본다.

같은 지시를 매번 반복하지 않고 파일에 기록해 두면 이후 작업에서도 다시 활용할 수 있다. 이처럼 Claude의 행동을 미리 정하는 지침과 장치를 통틀어 하네스라고 부른다.

두 가지 기억 장치

CLAUDE.md와 자동 메모리는 모두 대화가 시작될 때 컨텍스트에 자동으로 포함된다. 1장에서 살펴본 「첫 입력 전부터 채워지는 컨텍스트 창」에 들어가는 정보다.

• CLAUDE.md — 사용자가 작성하는 규칙과 지침. 코딩 규약, 작업 순서, 프로젝트 구조 등을 기록한다.
• 자동 메모리 — Claude가 작성하는 정보. 사용자가 정정한 내용이나 코드만으로 파악하기 어려운 맥락을 기록한다.

CLAUDE.md는 행동 기준을 정할 때, 자동 메모리는 작업 중 파악한 맥락과 정정 내용을 축적할 때 사용한다.

두 장치는 강제 설정이 아니라 Claude가 읽고 참고하는 맥락이다. 반드시 실행하거나 차단해야 하는 규칙에는 훅(hook)을 사용한다.

기록해야 할 시점

공식 문서에서는 다음 네 가지를 기록이 필요한 신호로 제시한다.