---
title: "CLAUDE.md 파일 하나로 Claude 출력 토큰 63% 줄이기"
published: 2026-03-31T01:23:34.000Z
canonical: https://jeff.news/article/1428
---
# CLAUDE.md 파일 하나로 Claude 출력 토큰 63% 줄이기

프로젝트 루트에 CLAUDE.md 파일을 넣으면 Claude의 아부성 오프너, 공허한 클로징, 과잉 추상화 등을 차단해 출력 토큰을 63% 줄일 수 있다. 단, 입력 토큰 오버헤드가 있어 출력량이 많은 환경에서만 순이익이 남는 솔직한 트레이드오프도 명시하고 있다.

- 프로젝트 루트에 `CLAUDE.md` 파일 하나만 넣으면 Claude의 출력 토큰을 평균 63% 줄일 수 있다는 오픈소스 프로젝트가 나옴
  - Claude Code가 자동으로 `CLAUDE.md`를 읽기 때문에 코드 변경 없이 동작함
  - 핵심은 Claude의 기본 행동 중 토큰만 낭비하는 패턴들을 규칙으로 차단하는 것

- Claude가 기본적으로 하는 토큰 낭비 행동들이 꽤 구체적으로 정리되어 있음
  - "Sure!", "Great question!", "Absolutely!" 같은 아부성 오프너
  - "I hope this helps! Let me know if you need anything!" 같은 공허한 클로징
  - 질문을 다시 반복한 뒤에야 답변 시작
  - 요청하지 않은 추가 제안, 과도한 추상화, em dash/스마트 따옴표 같은 파서 깨뜨리는 유니코드 사용
  - 틀린 말에도 "You're absolutely right!"로 동의하는 sycophancy

- 벤치마크는 5개 프롬프트 기준 단순 비교이긴 한데, 방향성은 명확함
  - async/await 설명: 180단어 → 65단어 (64% 감소)
  - 코드 리뷰: 120단어 → 30단어 (75% 감소)
  - REST API 설명: 110단어 → 55단어 (50% 감소)
  - 전체 465단어 → 170단어, 정보 손실 없이 63% 절감

> [!TIP]
> 하루 100 프롬프트 기준 약 9,600 토큰, 월 $0.86 절감. 하루 1,000 프롬프트면 월 $8.64. 자동화 파이프라인처럼 출력량이 많은 환경에서 효과가 극대화됨.

- 단, 솔직한 트레이드오프도 명시하고 있음
  - `CLAUDE.md` 자체가 매 메시지마다 입력 토큰으로 소비되기 때문에, 출력이 충분히 많아야 순이익이 남
  - 단발성 짧은 질문에는 오히려 손해 — 파일 로딩 오버헤드가 절감분을 넘김
  - 매번 새 세션을 여는 파이프라인도 효과가 떨어짐
  - 탐색적/아키텍처 토론처럼 풍부한 답변이 필요한 작업에는 오히려 제약이 될 수 있음

- `CLAUDE.md`는 계층적으로 구성 가능함
  - 글로벌(`~/.claude/CLAUDE.md`), 프로젝트 루트, 서브디렉토리 레벨로 분리해서 규칙을 적용할 수 있음
  - 범용 프로필, 코딩용, 에이전트 자동화용, 데이터 분석용 프로필을 따로 제공
  - 사용자가 명시적으로 상세 설명을 요청하면 규칙을 오버라이드하도록 설계됨

- 프로젝트 자체가 Claude 커뮤니티의 실제 불만에서 출발한 거라 현실적임
  - GitHub 이슈 #3382 "Claude says You're absolutely right about everything" (350+ 업보트) 등 실제 사례 기반
  - MIT 라이선스, `curl` 한 줄로 설치 가능

## 핵심 포인트

- CLAUDE.md 하나로 출력 토큰 63% 절감, 코드 변경 불필요
- sycophancy, 빈 클로징, 질문 반복, 과잉 추상화 등 12가지 낭비 패턴 차단
- 코드 리뷰 기준 120단어→30단어(75% 감소)
- 매 메시지마다 입력 토큰 소비 — 출력량 많은 환경에서만 순이익
- 글로벌/프로젝트/서브디렉토리 레벨로 계층적 구성 가능

## 인사이트

LLM의 기본 행동 패턴을 시스템 프롬프트 수준에서 제어하는 실용적 접근. 자동화 파이프라인에서 특히 유용하지만, 솔직한 한계 고지가 신뢰를 높인다.