ilhae.ai

CHAPTER 04 / 10

3. CLAUDE.md를 가볍게: 매번 내는 고정비 깎기

『Claude Code 사용 한도 절약법: 토큰 줄이는 설정과 습관 정리』 · 김재우 · 2026년 11월 8일

CLAUDE.md는 세션이 시작될 때 읽혀서 그 뒤로 계속 컨텍스트에 남는다. 적어 둔 줄 수만큼을 요청마다 계속 내는 셈이다.

미리 읽기

CLAUDE.md는 세션이 시작될 때 읽혀서 그 뒤로 계속 컨텍스트에 남는다. 적어 둔 줄 수만큼을 요청마다 계속 내는 셈이다.

편하다고 이것저것 덧붙이다 보면 정신 차렸을 때는 수백 줄이 돼 있다. 그걸 깎는 순서를 이 장에서 정리한다.

기준은 200줄 이내

공식 문서도 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장). 스킬은 필요할 때만 읽히므로 평소 고정비가 되지 않는다.

이 장의 나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.

이어서 읽기

이 장에서 다루는 것

  1. 기준은 200줄 이내
  2. 남길 것·뺄 것
  3. 깎는 순서
  4. 효과 확인

ilhae.ai 안내 도우미대기 중

글자를 치면 사이트 자료를 바로 찾아요. AI 대화는 하루 20번까지이고, 질문 앞부분은 서비스 개선을 위해 30일 보관해요. 개인정보는 적지 마세요.