본문으로 건너뛰기
피드

CLAUDE.md 파일 하나로 Claude 출력 토큰 63% 줄이기

ai-ml 약 4분
vote
0
댓글
북마크

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

  • 1

    CLAUDE.md 하나로 출력 토큰 63% 절감, 코드 변경 불필요

  • 2

    sycophancy, 빈 클로징, 질문 반복, 과잉 추상화 등 12가지 낭비 패턴 차단

  • 3

    코드 리뷰 기준 120단어→30단어(75% 감소)

  • 4

    매 메시지마다 입력 토큰 소비 — 출력량 많은 환경에서만 순이익

  • 5

    글로벌/프로젝트/서브디렉토리 레벨로 계층적 구성 가능

  • 프로젝트 루트에 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% 절감

💡

> 하루 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 한 줄로 설치 가능

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

댓글

댓글

댓글을 불러오는 중...

ai-ml

애플 새 음성 인식 API, 온디바이스 영어 전사에서 위스퍼 스몰까지 이겼다

애플의 새 음성 인식 API인 스피치애널라이저가 리브리스피치 벤치마크에서 기존 SFSpeechRecognizer는 물론 위스퍼 스몰보다도 낮은 단어 오류율을 기록했어. 깨끗한 음성에서는 2.12%, noisy 음성에서는 4.56%로, 기존 애플 API 대비 오류율을 3.5~4배 줄였고 위스퍼 스몰보다 약 3배 빠르게 돌았어. 다만 영어·애플 플랫폼·OS 26 조건의 결과라, 다국어와 크로스플랫폼에서는 여전히 위스퍼의 장점이 남아 있어.

ai-ml

AI를 진짜 잘 쓰는 기업, 미국 증시에서 연 30% 프리미엄 받는다는 연구

예일대와 로체스터대 연구진이 기업의 실제 대형 언어 모델 사용 데이터를 분석했더니, AI 활용도가 높은 상위 20% 기업이 하위 20%보다 주당 평균 0.64% 높은 초과수익률을 냈다. 단순히 AI 기업이냐가 아니라, 업무에 AI를 얼마나 깊게 쓰는지가 시장 가치에 반영되고 있다는 얘기다.

ai-ml

ZTE, AI 에이전트폰으로 스마트폰 재도전…진짜 승부처는 앱 생태계

ZTE가 바이트댄스의 더우바오를 탑재한 AI 에이전트 스마트폰으로 시장 재진입을 노린다. 핵심은 사용자가 명령하면 AI가 여러 앱을 직접 열고 조작하는 방식인데, 위챗·타오바오·알리페이 같은 플랫폼과 충돌하면서 생태계 문제가 가장 큰 변수로 떠올랐다.

ai-ml

노벨상 학자들까지 “AI 경제 충격, 지금 제도 안 만들면 늦다”

노벨 경제학상 수상자 15명을 포함한 학자와 기술 업계 인사 약 200명이 AI가 향후 10년 안에 경제를 급격히 바꿀 수 있다며 정책 대응을 촉구했다. 이들은 산업혁명보다 큰 변화가 훨씬 짧은 시간에 올 수 있고, 대규모 일자리 대체와 생활 수준 향상이라는 양면성이 동시에 존재한다고 봤다.

ai-ml

NHN, AI 데이터센터 매출 기대감에 목표주가 5만6000원으로 상향

한국투자증권이 NHN의 목표주가를 4만5000원에서 5만6000원으로 올리고 투자의견 매수를 유지했다. 핵심 근거는 양평 AI 데이터센터 가동, 공공·민간 GPU 클러스터 수주 확대, 클라우드 사업부 신규 매출 반영이다.