CLAUDE.md를 외부 작업 메모리로 사용하기
코딩 세션을 다시 시작할 때 시간을 낭비하지 마세요.
한 개발자는 CLAUDE.md 파일 없이 프로젝트를 다시 여는 데 최대 15분의 정신적 에너지가 소모된다는 것을 발견했습니다. 어디까지 작업했는지 파악해야 했기 때문입니다. 구조화된 CLAUDE.md를 만든 후, 그 시간은 1분 미만으로 줄어들었습니다.
CLAUDE.md는 외부 작업 메모리 역할을 합니다. Claude Code는 매 세션이 시작될 때 이 파일을 자동으로 읽습니다. 파일을 붙여넣거나 AI에게 파일이 존재한다는 것을 상기시킬 필요가 없습니다. 그냥 알아서 작동합니다.
다음 두 가지 파일을 사용해야 합니다:
- 프로젝트 루트의
./CLAUDE.md. 기술 스택 및 코딩 컨벤션과 같은 프로젝트 규칙에 사용하세요. - 전역 규칙을 위한
~/.claude/CLAUDE.md. 선호하는 말투와 같이 모든 프로젝트에 적용되는 사항에 사용하세요.
정신적 에너지는 한정되어 있습니다. Slack 메시지나 이메일 같은 방해 요소는 머릿속의 메모장(mental scratchpad)을 비워버립니다. 다시 돌아왔을 때, 문맥(context)을 재구축하느라 시간을 낭비하게 됩니다. CLAUDE.md는 그 메모장을 머릿속에서 파일로 옮겨줍니다.
이 방식은 네 가지 주요 문제를 해결합니다:
- 기술 스택을 기억하여 다시 설명할 필요가 없습니다.
- 컨벤션을 기억하여 동일한 명명 규칙을 매번 결정할 필요가 없습니다.
- 말투를 기억하여 결과물이 사용자의 스타일과 일치하게 합니다.
- 현재 작업을 기억하여 정확히 어디서부터 시작해야 할지 알려줍니다.
프로젝트 루트에 다음 네 가지 헤더를 포함한 CLAUDE.md 파일을 만드세요:
Project Name
Stack
- 여기에 사용 중인 도구들을 나열하세요.
Voice
- AI가 어떤 방식으로 글을 쓰길 원하는지 나열하세요.
Gotchas
- 피해야 할 실수들을 나열하세요.
Current checkpoint
- 마지막으로 완료된 작업.
- 다음에 해야 할 작업.
- 진행을 방해하는 요소.
Current checkpoint 헤더가 가장 중요합니다. Claude에게 현재 위치를 정확히 알려줍니다. 세션을 열면 Claude가 체크포인트를 읽고 즉시 다음 단계를 알려줍니다.
설정 방법:
- 프로젝트 루트에서
touch CLAUDE.md를 실행합니다. - 위의 네 가지 헤더를 추가합니다.
- 알고 있는 내용을 채워 넣습니다.
- 개인적인 선호도를 위해
~/.claude/CLAUDE.md에 전역 파일을 만듭니다.
Claude가 이미 알고 있었으면 하는 질문을 할 때마다, 그 답변을 파일에 적으세요. 파일을 사용할수록 내용은 더욱 개선됩니다.
계속 업데이트하세요. 오래된 CLAUDE.md 파일은 잘못된 정보를 제공할 수 있습니다. 기술 스택이나 워크플로우가 변경되면 즉시 파일을 업데이트하세요.
Source: https://dev.to/gentic_news/use-claudemd-as-external-working-memory-5f01
선택 사항 학습 커뮤니티: https://t.me/GyaanSetuAi