CHAPTER 04 / 10
3. CLAUDE.md를 가볍게: 매번 내는 고정비 깎기
『Claude Code 사용 한도 절약법: 토큰 줄이는 설정과 습관 정리』 · 김재우 · 2026년 11월 8일
CLAUDE.md는 세션이 시작될 때 읽혀서 그 뒤로 계속 컨텍스트에 남는다. 적어 둔 줄 수만큼을 요청마다 계속 내는 셈이다.
CHAPTER 04 / 10
『Claude Code 사용 한도 절약법: 토큰 줄이는 설정과 습관 정리』 · 김재우 · 2026년 11월 8일
CLAUDE.md는 세션이 시작될 때 읽혀서 그 뒤로 계속 컨텍스트에 남는다. 적어 둔 줄 수만큼을 요청마다 계속 내는 셈이다.
CLAUDE.md는 세션이 시작될 때 읽혀서 그 뒤로 계속 컨텍스트에 남는다. 적어 둔 줄 수만큼을 요청마다 계속 내는 셈이다.
편하다고 이것저것 덧붙이다 보면 정신 차렸을 때는 수백 줄이 돼 있다. 그걸 깎는 순서를 이 장에서 정리한다.
공식 문서도 CLAUDE.md는 필요한 것만 추려서 200줄 이내를 목표로 하라고 권한다.
먼저 지금 길이를 확인하자.
wc -l CLAUDE.md ~/.claude/CLAUDE.md
CLAUDE.md는 프로젝트 루트에 있는 것과 홈(~/.claude/CLAUDE.md)에 있는 것 둘 다 읽힌다. 홈 쪽은 모든 프로젝트에 붙는 고정비라서 특히 조심해야 한다.
2장에서 소개한 /usage 권장 항목에 Trim ... CLAUDE.md가 떠 있다면 그 파일부터 손대자.
CLAUDE.md에 남겨야 할 건 거의 매번 작업에 필요한 것뿐이다.
| 남긴다 | 뺀다 |
|---|---|
| 쓰는 언어·프레임워크·패키지 매니저 | 특정 작업에만 쓰는 절차(PR 리뷰, DB 마이그레이션, 릴리스 절차) |
| 빌드·테스트 명령 | 긴 참고 자료, API 사양 복사본 |
| 반드시 지킬 규칙(예: main에 직접 push 금지) | 과거 경위, "왜 이렇게 됐는지" 설명 |
| 디렉터리 구성 요점(몇 줄) | 코드를 읽으면 아는 것 |
| "꼼꼼하게", "신중하게"처럼 있으나 없으나 똑같은 지시 |
"뺀다"에 들어가는 것 중 특정 작업에 필요한 절차는 버리지 말고 스킬로 옮긴다(4장). 스킬은 필요할 때만 읽히므로 평소 고정비가 되지 않는다.
이 장의 나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.
이어서 읽기