A ferramenta Claude-context-lint audita a sobrecarga de tokens em projetos Claude Code.

O que ela faz

O claude-context-lint analisa projetos do Claude Code para revelar o consumo oculto de tokens de contexto que ocorre antes de qualquer entrada do usuário. Toda conversa no Claude Code começa com uma sobrecarga de arquivos CLAUDE.md, descrições de habilidades, esquemas de ferramentas MCP e o prompt base do sistema, todos os quais consomem tokens de contexto imediatamente.

Principais recursos e descobertas

A ferramenta analisa seus arquivos CLAUDE.md, habilidades, configurações MCP e prompt do sistema. Ela mostra o custo de tokens por turno versus o custo na invocação, considerando que as habilidades não são carregadas completamente a cada turno. Ela detecta habilidades quase duplicadas que desperdiçam tokens e sinaliza servidores MCP que poderiam usar o ToolSearch para adiar o carregamento de ferramentas.

De acordo com o teste do desenvolvedor, 18% de uma janela de contexto de 200K foi consumida antes do primeiro turno. O maior contribuinte foram os servidores MCP carregando todos os esquemas de ferramentas antecipadamente em vez de adiá-los.

Exemplo de saída

Auditoria de Contexto do Claude Code
─────────────────────────────
CLAUDE.md 1.240 tokens
Habilidades (32 carregadas) 4.800 tokens MÉDIO
⚠ 3 habilidades quase duplicadas detectadas
Servidores MCP (3) 14.100 tokens CRÍTICO
postgres 6.600 tokens (22 ferramentas) [sempre carregado]
Prompt do Sistema 8.500 tokens (sobrecarga base)
─────────────────────────────
SOBRECARGA TOTAL: 28.640 tokens
Usado Antes da Entrada: 14,3%

Recomendações específicas

A ferramenta gera recomendações concretas com estimativas de economia de tokens. Na saída de exemplo, ela sugere:

• Ativar ToolSearch para o MCP "postgres" → −6.270 tokens
• Encurtar 12 descrições de habilidades verbosas → −1.840 tokens
• Economia potencial: 8.530 tokens (redução de 29,8%)

Instalação e uso

Execute sem instalação usando: npx claude-context-lint

Execute em qualquer projeto com um diretório .claude/. A análise leva cerca de 2 segundos.

Detalhes técnicos

A ferramenta está disponível no npm em https://www.npmjs.com/package/claude-context-lint e no GitHub em https://github.com/skibidiskib/claude-context-lint. Foi construída inteiramente pelo Claude Code e tem licença MIT.