La herramienta Claude-context-lint audita el uso excesivo de tokens en proyectos de Claude Code.

Qué hace

claude-context-lint analiza proyectos de Claude Code para revelar el consumo oculto de tokens de contexto que ocurre antes de cualquier entrada del usuario. Cada conversación de Claude Code comienza con sobrecarga de archivos CLAUDE.md, descripciones de habilidades, esquemas de herramientas MCP y el mensaje base del sistema, todos los cuales consumen tokens de contexto inmediatamente.

Características y hallazgos clave

La herramienta escanea tus archivos CLAUDE.md, habilidades, configuraciones MCP y mensaje del sistema. Muestra el costo de tokens por turno versus el costo por invocación, teniendo en cuenta que las habilidades no se cargan completamente cada turno. Detecta habilidades casi duplicadas que desperdician tokens y marca servidores MCP que podrían usar ToolSearch para diferir la carga de herramientas.

Según la prueba del desarrollador, el 18% de una ventana de contexto de 200K se consumió antes del primer turno. El mayor contribuyente fueron los servidores MCP cargando todos los esquemas de herramientas por adelantado en lugar de diferirlos.

Ejemplo de salida

Auditoría de Contexto de Claude Code
─────────────────────────────
CLAUDE.md 1,240 tokens
Habilidades (32 cargadas) 4,800 tokens MEDIO
⚠ 3 habilidades casi duplicadas detectadas
Servidores MCP (3) 14,100 tokens CRÍTICO
postgres 6,600 tokens (22 herramientas) [siempre cargado]
Mensaje del Sistema 8,500 tokens (sobrecarga base)
─────────────────────────────
SOBRECARGA TOTAL: 28,640 tokens
Usado Antes de la Entrada: 14.3%

Recomendaciones específicas

La herramienta genera recomendaciones concretas con estimaciones de ahorro de tokens. En el ejemplo de salida, sugiere:

• Habilitar ToolSearch para MCP "postgres" → −6,270 tokens
• Acortar 12 descripciones de habilidades verbosas → −1,840 tokens
• Ahorro potencial: 8,530 tokens (29.8% de reducción)

Instalación y uso

Ejecuta sin instalación usando: npx claude-context-lint

Ejecútalo en cualquier proyecto con un directorio .claude/. El escaneo toma unos 2 segundos.

Detalles técnicos

La herramienta está disponible en npm en https://www.npmjs.com/package/claude-context-lint y en GitHub en https://github.com/skibidiskib/claude-context-lint. Fue construida completamente por Claude Code y tiene licencia MIT.