CLAUDE.md: 드롭인 파일로 Claude 출력 토큰을 63% 절감

CLAUDE.md의 기능

CLAUDE.md는 프로젝트 루트에 넣기만 하는 단일 파일입니다. Claude Code가 이를 읽으면 코드 수정 없이 즉시 동작이 변경됩니다. 특히 출력 동작인 아첨, 장황함, 서식 노이즈를 대상으로 합니다.

해결하는 문제

기본적으로 Claude는 가치를 더하지 않는 동작에 토큰을 낭비합니다:

• 응답을 "물론입니다!", "좋은 질문입니다!", "확실히!"로 시작함
• "도움이 되었으면 좋겠습니다! 필요한 것이 있으면 알려주세요!"로 끝냄
• 파서를 깨뜨리는 em 대시(--), 스마트 따옴표, 유니코드 문자 사용
• 답변하기 전에 질문을 재진술함
• 요청한 것 이상의 원치 않는 제안 추가
• 불필요한 추상화로 코드를 과도하게 설계함
• 잘못된 진술에 동의함("정말 맞는 말씀이에요!")

벤치마크 결과

동일한 5개의 프롬프트를 CLAUDE.md 없이(기준)와 CLAUDE.md와 함께(최적화) 테스트했습니다:

• async/await 설명: 180단어 → 65단어 (64% 감소)
• 코드 리뷰: 120단어 → 30단어 (75% 감소)
• REST API란 무엇인가: 110단어 → 55단어 (50% 감소)
• 환각 수정: 55단어 → 20단어 (64% 감소)
• 총합: 465단어 → 170단어 (63% 감소)

4개의 프롬프트당 약 384개의 출력 토큰이 절약됩니다. 참고: 이는 5개의 프롬프트에서 나온 방향성 지표이며, 통계적으로 통제된 연구가 아닙니다.

도움이 되는 경우 vs. 도움이 되지 않는 경우

다음에 가장 효과적입니다:

• 높은 출력량을 가진 자동화 파이프라인(이력서 봇, 에이전트 루프, 코드 생성)
• Claude의 기본 장황함이 수백 번의 호출에 걸쳐 누적되는 반복적인 구조화된 작업
• 세션 간에 일관되고 파싱 가능한 출력 형식이 필요한 팀

다음에는 가치가 없습니다:

• 단일 짧은 쿼리(파일이 모든 메시지에 컨텍스트로 로드되어 저출력 교환 시 순 토큰 증가 발생)
• 캐주얼 일회성 사용(저용량에서는 오버헤드가 상쇄되지 않음)
• 환각된 구현이나 아키텍처적 표류와 같은 심각한 실패 모드 수정
• 작업당 여러 개의 새 세션을 사용하는 파이프라인
• 규모에서의 파서 신뢰성(대신 JSON 모드와 같은 구조화된 출력 사용)
• 토론과 대안이 핵심인 탐색적 또는 아키텍처 작업

비용 고려사항

CLAUDE.md 파일 자체는 모든 메시지에서 입력 토큰을 소비합니다. 절감은 출력 토큰 감소에서 옵니다. 순 이익은 출력량이 지속적인 입력 비용을 상쇄할 만큼 충분히 높을 때만 긍정적입니다. 사용량이 적을수록 절약보다 더 많은 비용이 듭니다.

모델 지원

벤치마크는 Claude에서만 실행되었습니다. 규칙은 모델에 구애받지 않으며 컨텍스트를 읽는 모든 모델에서 작동해야 하지만, llama.cpp, Mistral 또는 기타 로컬 모델에서의 결과는 테스트되지 않았습니다.