CLAUDE.md 파일 하나로 Claude 출력 토큰 63% 절감

Context

Claude Code는 기본적으로 Sure!, Great question! 같은 시작 인사와 I hope this helps! 같은 종료 인사를 포함한다. 질문 재진술, Unicode/스마트쿼트 사용, 요청 범위 외 코드 수정 등 불필요한 출력이 반복된다.

Technical Solution

• 프로젝트 루트에 CLAUDE.md 배치 → Claude Code가 자동 인식
• sycophantic 오프닝/클로징 금지 → 첫 문장에서 즉시 응답
• 질문 재진술 금지 → 즉시 실행
• ASCII-only 출력 강제 → Unicode/스마트쿼트/em dash 사용 금지
• 불필요한 → 실제 안전 위험만 해당
• 요청 범위 내 코드만 수정 → 범위 크리프 방지
• 단순 작업 해결책 강제 → 과도한 추상화 금지
• 불확실한 사실에 I don't know 필수 → 할루시네이션 방지
• 동일 파일 중복 읽기 금지 → 토큰 절약
• 사용자 수정 사항을 세션 사실로 저장

Impact

5개 프롬프트 벤치마크: 465단어 → 170단어 (63% 감소)

• async/await 설명: 180단어 → 65단어 (64% 감소)
• 코드 리뷰: 120단어 → 30단어 (75% 감소)
• REST API 설명: 110단어 → 55단어 (50% 감소)
• 할루시네이션 수정: 55단어 → 20단어 (64% 감소)

일일 1,000개 프롬프트 기준: 월 약 $8.64 절감

Key Takeaway

CLAUDE.md는 입력 토큰을 추가하므로 출력 볼륨이 충분히 높아야 순수 절감 효과가 있다. 범용 규칙보다 실제 실패 상황에 맞춘 구체적 규칙이 효과적이다.