Claude-context-lint 도구는 Claude Code 프로젝트의 토큰 오버헤드를 감사합니다.

기능 설명

claude-context-lint는 Claude Code 프로젝트를 분석하여 사용자 입력 전에 발생하는 숨겨진 컨텍스트 토큰 소비량을 보여줍니다. 모든 Claude Code 대화는 CLAUDE.md 파일, 스킬 설명, MCP 도구 스키마 및 기본 시스템 프롬프트로 인한 오버헤드로 시작하며, 이 모든 것이 즉시 컨텍스트 토큰을 소비합니다.

주요 기능 및 발견 사항

이 도구는 CLAUDE.md 파일, 스킬, MCP 구성 및 시스템 프롬프트를 스캔합니다. 턴당 토큰 비용 대 호출 시 비용을 보여주며, 스킬이 매 턴마다 완전히 로드되지 않는다는 사실을 고려합니다. 토큰을 낭비하는 거의 중복된 스킬을 감지하고, ToolSearch를 사용하여 도구 로딩을 지연시킬 수 있는 MCP 서버를 표시합니다.

개발자의 테스트에 따르면, 200K 컨텍스트 윈도우의 18%가 첫 번째 턴 전에 소비되었습니다. 가장 큰 원인은 MCP 서버가 도구 스키마를 지연시키지 않고 모두 미리 로드했기 때문입니다.

예시 출력

Claude Code Context Audit
─────────────────────────────
CLAUDE.md 1,240 토큰
스킬 (32개 로드됨) 4,800 토큰 MEDIUM
⚠ 3개의 거의 중복된 스킬 감지됨
MCP 서버 (3개) 14,100 토큰 CRITICAL
postgres 6,600 토큰 (22개 도구) [항상 로드됨]
시스템 프롬프트 8,500 토큰 (기본 오버헤드)
─────────────────────────────
총 오버헤드: 28,640 토큰
입력 전 사용량: 14.3%

구체적인 권장 사항

이 도구는 토큰 절감 추정치와 함께 구체적인 권장 사항을 생성합니다. 예시 출력에서는 다음과 같이 제안합니다:

• "postgres" MCP에 ToolSearch 활성화 → −6,270 토큰
• 12개의 장황한 스킬 설명 줄이기 → −1,840 토큰
• 잠재적 절감량: 8,530 토큰 (29.8% 감소)

설치 및 사용법

설치 없이 실행: npx claude-context-lint

.claude/ 디렉토리가 있는 모든 프로젝트에서 실행할 수 있습니다. 스캔은 약 2초가 소요됩니다.

기술적 세부 사항

이 도구는 https://www.npmjs.com/package/claude-context-lint 및 https://github.com/skibidiskib/claude-context-lint에서 npm과 GitHub를 통해 이용 가능합니다. 완전히 Claude Code로 구축되었으며 MIT 라이선스를 따릅니다.