nadimtuhin/claude-token-optimizer

해결하는 문제

Claude Code는 시작 시 과도한 양의 문서, 세션 노트, 작업 기록을 로드하는 경우가 많아 컨텍스트 창의 상당 부분을 소비합니다. 이 프로젝트는 프로젝트 문서를 재구성하여 Claude가 시작 시 필수 파일만 로드하도록 하는 시스템을 제공함으로써 실제 코드에 수천 토큰을 할당할 수 있게 합니다.

작동 방식

이 도구는 특정 파일 계층 구조와 .claudeignore 파일을 사용하여 구조화된 문서 접근 방식을 구현하며, 불필요한 문서의 자동 로드를 방지합니다. 단일의 거대한 문서 파일을 CLAUDE.md, COMMON_MISTAKES.md, QUICK_START.md, ARCHITECTURE_MAP.md라는 네 가지 핵심 파일로 대체합니다.

주요 기능:

• 프레임워크 인식 초기화: cto init는 프로젝트의 프레임워크(예: Next.js, Django, Go)를 자동 감지하고 관련된 최선의 실천 방법과 일반적인 실수를 적용합니다.
• 토큰 측정: cto measure는 자동 로드되는 파일의 토큰 비용을 추정합니다.
• 유지보수 도구: cto compress와 cto prune는 결정론적 규칙을 사용하여 CLAUDE.md의 크기를 줄입니다.
• 컨텍스트 주입 훅: 쉘 스크립트로, Claude Code 훅에 통합 가능하며, 사용자 프롬프트에 따라 docs/learnings/에서 주제별 문서를 동적으로 로드하여 사용되지 않는 파일에 대해 0 토큰 비용을 보장합니다.

대상 사용자

자동 로드 문서에서 수요 기반 로딩 시스템으로 전환하여 컨텍스트 창을 최적화하고 토큰 사용량을 줄이고자 하는 Claude Code 사용자.

주요 특징

• 매우 큰 토큰 절감: 시작 시 토큰 사용량이 일반적으로 83~87% 감소합니다.
• 프레임워크 지원: 13개의 인기 있는 프레임워크에 대한 사전 정의된 패턴이 있습니다.
• CI 친화적 감사: cto audit는 문서 구조의 건강 상태를 점검하며, CI/CD 파이프라인에서 기계가 읽을 수 있는 JSON 출력을 제공합니다.
• 동적 컨텍스트 주입: 사용자 프롬프트와 docs/learnings/ 내 파일명을 매칭하여 필요할 때만 컨텍스트를 주입합니다.