Hacker News 2026.03.31 20

CLAUDE.md 하나로 Claude 출력 토큰을 63% 줄이는 방법

Claude Code 쓰면서 토큰 비용 걱정되셨죠?

Claude Code를 본격적으로 쓰기 시작하면 가장 먼저 체감하는 게 토큰 소비량이에요. 코드 생성, 리팩토링, 디버깅을 시키다 보면 출력 토큰이 순식간에 쌓이거든요. 특히 Opus 같은 고성능 모델을 쓰면 비용이 꽤 부담스러워지는데요. 그런데 프로젝트 루트에 CLAUDE.md 파일 하나만 잘 작성해두면 출력 토큰을 최대 63%까지 줄일 수 있다는 오픈소스 프로젝트가 공개됐어요.

CLAUDE.md가 뭔가요?

혹시 모르시는 분들을 위해 간단히 설명하면, CLAUDE.md는 Claude Code가 프로젝트에서 작업할 때 자동으로 읽어들이는 설정 파일이에요. 쉽게 말해서 "Claude에게 주는 업무 지침서"라고 생각하면 돼요. 여기에 코딩 스타일, 프로젝트 규칙, 응답 방식 등을 적어두면 Claude가 그에 맞춰서 동작하거든요.

이번에 공개된 claude-token-efficient 프로젝트는 이 CLAUDE.md에 토큰 효율성을 극대화하는 지침들을 체계적으로 정리해둔 거예요. 단순히 "짧게 써줘"라고 하는 게 아니라, Claude의 응답 패턴을 분석해서 불필요한 출력이 발생하는 지점들을 하나하나 잡아낸 결과물이에요.

어떻게 63%나 줄이는 걸까요?

핵심 원리는 Claude가 습관적으로 만들어내는 "군더더기"를 체계적으로 제거하는 거예요. 예를 들어볼게요.

첫 번째는 반복 설명 제거예요. Claude는 기본적으로 친절한 모델이라서, 코드를 수정하면 "이 코드는 이러이러한 이유로 수정했고, 기존 코드는 이러이러한 문제가 있었으며..."라고 장문의 설명을 덧붙이는 경향이 있어요. 하지만 실무에서는 diff만 봐도 뭘 바꿨는지 알 수 있는 경우가 대부분이거든요.

두 번째는 불필요한 코드 주석 억제예요. Claude가 코드를 생성할 때 거의 모든 줄에 주석을 다는 습관이 있는데, 이것도 상당한 토큰을 잡아먹어요. 변수명과 함수명이 충분히 설명적이면 주석이 굳이 필요 없는 경우가 많잖아요.

세 번째는 응답 구조 최적화예요. 요약-본문-다시 요약 같은 샌드위치 구조 대신, 핵심만 바로 전달하도록 유도하는 거예요.

적용 방법은 아주 간단해요

사용법은 정말 쉬워요. GitHub 저장소에서 CLAUDE.md 파일을 다운받아서 자기 프로젝트 루트에 넣으면 끝이에요. 기존에 CLAUDE.md를 쓰고 있었다면, 토큰 효율성 관련 섹션만 가져다가 합치면 되고요. 프로젝트별로 커스터마이징도 가능한데, 예를 들어 "이 프로젝트에서는 타입 설명은 항상 포함해줘"처럼 예외 규칙을 추가할 수 있어요.

중요한 건 이게 출력 품질을 떨어뜨리지 않는다는 점이에요. 쓸데없는 수식어나 반복 설명을 줄이는 거지, 핵심 코드나 로직 설명까지 잘라내는 건 아니거든요. 오히려 군더더기가 빠지면서 중요한 내용에 더 집중할 수 있게 된다는 피드백도 있어요.

업계에서 프롬프트 엔지니어링이 시스템 레벨로 올라오고 있어요

Claude Code뿐만 아니라 Cursor, Windsurf 같은 AI 코딩 도구들도 비슷한 시스템 프롬프트 최적화를 내부적으로 적용하고 있어요. 그런데 이런 최적화가 도구 내부에 숨겨져 있으면 사용자가 제어할 수가 없잖아요. CLAUDE.md 방식의 장점은 사용자가 직접 지침을 읽고, 수정하고, 프로젝트에 맞게 조절할 수 있다는 거예요. 일종의 "열린 프롬프트 엔지니어링"인 셈이죠.

GitHub Copilot도 최근 커스텀 인스트럭션 기능을 강화하고 있고, OpenAI의 Codex도 시스템 프롬프트 커스터마이징을 지원하기 시작했어요. AI 코딩 도구에서 "어떻게 지시하느냐"가 생산성을 크게 좌우하는 시대가 된 거예요.

한국 개발자에게 주는 시사점

Claude Code를 업무에 도입한 팀이라면 당장 적용해볼 가치가 있어요. 특히 스타트업처럼 API 비용에 민감한 환경에서는 63% 토큰 절감이 월 비용으로 환산하면 꽤 큰 차이를 만들거든요. 팀 단위로 쓴다면 CLAUDE.md를 Git에 포함시켜서 팀원 모두가 동일한 효율적 설정을 공유하는 것도 좋은 방법이에요.

더 넓게 보면, 이제 프롬프트 엔지니어링이 개인 스킬을 넘어서 팀 인프라의 영역으로 들어오고 있다는 신호이기도 해요. CI/CD 파이프라인 설정하듯이, AI 도구의 동작 방식도 코드로 관리하는 시대가 온 거죠.