Original en inglés: https://argusic.com/subject/claude-token-optimizer
claude-token-optimizer
Reduce los tokens que Claude Code carga al inicio de la sesión. CLI que configura un pequeño CLAUDE.md con documentación bajo demanda, mide los tokens de inicio y los mantiene pequeños.
Funcionafuente: GitHubsitio webJavaScriptMITcommit a1e437a8c299
JavaScript, licencia MIT. El proyecto se describe a sí mismo como: agents md, ai assistant, automation, claude, claude code, claude md, cli y context engineering.
claude-token-optimizer funciona. Un agent de Argusic lo instaló en 6 minutos y encontró 3 errores, todos corregidos sin ayuda en una máquina limpia sin GPU, y toda la sesión quedó grabada.
All 414 tests pass, the CLI builds and runs all 10 commands correctly, 5 hook scripts fixed to use bash arithmetic instead of bc, Node upgraded from 18 to 20, and the package installs with only engine warnings
Lo que el agent consiguió en una máquina limpia, en sus propias palabras. Cómo se mide
Medido por Argusic en una máquina limpia cada vez. Cada cifra enlaza a su evidencia. Puntuación Argusic de 100 sobre 100 (la media de las puntuaciones de las ejecuciones de este proyecto).
De un vistazo
Datos del proyecto de GitHub, enlazados al principio de esta página, actualizado . Datos de prueba de Argusic (CC BY 4.0); cada cifra enlaza a una página de ejecución con el log completo, la grabación y sus hashes sha256.
Qué se midió
De la ejecución que decidió este veredicto. Cada línea es un valor registrado, no una estimación.
Qué salió mal, en palabras del propio agent
Las palabras del propio agent, de lo más grave a lo menos, nunca reescritas como consejos.
- bc not available in container; 5 hook scripts silently fell back to 0/? token estimates, causing 1 test failure3 minutos
- Node 18 installed but project requires Node 20+2 minutos
- [email protected] and [email protected] require Node >=22, only Node 20 available; EBADENGINE warnings but packages work
- Tiempo de instalación
- 6 minutos
- De máquina en frío a terminar
- 8 minutos
- Errores encontrados y corregidos
- 3 encontrados, 3 corregidos sin ayuda humana
- Cómo se demostró el resultado
- npm test exited 0, 414 passed (was 413 before fix); node bin/cto.js --version returned 2.3.20; cto measure, init --yes --framework express, audit, compress, prune, diff, companions all produced correct output
- Tokens de modelo usados
- 175.681
- Commit exacto probado
- a1e437a8c299
- Imagen del contenedor
- sha256:cdd920bce783
Qué no se midió
La otra mitad, para que veas exactamente hasta dónde llega esta evidencia. Un hueco se muestra como hueco y nunca se rellena.
- Memoria de GPU máxima
- se ejecutó en una máquina con CPU, así que no había GPU que muestrear
- Comportamiento en una ejecución larga
- cada intento usa la configuración documentada más pequeña y un presupuesto de tiempo fijo, así que esto mide si funciona, no cómo aguanta bajo carga
Ver la sesión
La ejecución completa, desde una máquina limpia, a la velocidad a la que ocurrió. No se ha cortado ni acelerado nada.
Una grabación del intento 1, ejecutado el , el intento que decidió el veredicto anterior. La grabación de terminal a partir de la que se hizo es la evidencia, guardada con una huella sha256; el video es un render de ella. No se carga nada del servicio de video hasta que pulses reproducir.
El final de la grabación
Las últimas líneas de la sesión de terminal que decidió este veredicto, tal como se registraron.
All verified. Here's the JSON report: **What was done:** - Upgraded Node from v18 → v20.20.2. The project requires Node 20+; it was shipping with v18. - Fixed 5 bash hook scripts (`pre-tool-token-guard.sh`, `session-end-token-report.sh`, `stop-sessio… - After the fix, all 414 tests pass, all CLI commands (`measure`, `init`, `audit`, `compress`, `pru… tokens used 175,681 All verified. Here's the JSON report: **What was done:** - Upgraded Node from v18 → v20.20.2. The project requires Node 20+; it was shipping with v18. - Fixed 5 bash hook scripts (`pre-tool-token-guard.sh`, `session-end-token-report.sh`, `stop-sessio… - After the fix, all 414 tests pass, all CLI commands (`measure`, `init`, `audit`, `compress`, `pru…
Reproducir la sesión completa, cada comando desde una máquina limpia hasta este punto.
Cómo se probó
Un agent, un contenedor, sin ayuda humana. Instala el proyecto como indica su propia documentación, lo ejecuta y arregla lo que falla. Todo lo de abajo se registró tal como ocurrió: la sesión de terminal, el log y el commit exacto. La metodología completa.
Puntos fuertes y límites
Hechos medidos, no opiniones. Cómo se redacta.
Qué salió bien
- Llegó a funcionar en una máquina limpia, con la sesión grabada.
- Se recuperó de los 3 errores sin que interviniera una persona, lo que indica que los fallos están lo bastante documentados como para resolverlos.
- Funcionó sin GPU, así que no necesita una para arrancar.
- Licencia MIT, según su plataforma de origen.
Qué no salió bien, o no se sabe
- Tardó 6 minutos en instalarse, más lento que la mediana de los 4 proyectos comparables que ha medido Argusic.
- Medido una sola vez hasta ahora. Un único intento demuestra que puede funcionar, no que funcione de forma fiable.
De los 5 proyectos de agents-md que Argusic ha instalado y cronometrado, claude-token-optimizer fue el 5.º más rápido en llegar a funcionar, y 2 de 5 llegaron a funcionar.
Para qué es una opción razonable
- Probarlo en un portátil o en un servidor pequeño: llegó a funcionar sin GPU.
- Una evaluación rápida: estaba funcionando 6 minutos después del clon.
También probados, en la misma área
Argusic instaló y ejecutó cada uno de estos proyectos en una máquina limpia. Aquí no aparece nada que no se haya probado.
Historial de ejecuciones
Temas (de GitHub)
agents-mdai-assistantautomationclaudeclaude-codeclaude-mdclicontext-engineeringdeveloper-toolsdocumentationllmnpm-packageopensourcesetup-templatetoken-optimization
Insertar el badge
Markdown para el README del proyecto. Enlaza de vuelta aquí; condiciones en la página de términos.
[](https://argusic.com/subject/claude-token-optimizer)Preguntas
- ¿Funciona claude-token-optimizer?
- Sí. claude-token-optimizer funciona. Argusic lo instaló y lo inició en una máquina limpia en 6 minutos, con 3 errores por el camino, y grabó la sesión.
- ¿Cómo probó Argusic claude-token-optimizer?
- En una máquina limpia y desechable, con cada comando grabado y el repositorio fijado en el commit a1e437a8c299. Hay un intento registrado, y la metodología completa está en la página de metodología.
- ¿Cuánto costó probar claude-token-optimizer?
- La ejecución que produjo este veredicto costó 0,02 USD: costo real de cómputo y de modelo, no un precio de lista por millón de tokens. Consta en la página de esa ejecución.
- ¿Cuánto tarda claude-token-optimizer en instalarse?
- 6 minutos en la ejecución que decidió este veredicto, desde una máquina limpia hasta que funcionó. Es un intento medido, no una media.
- ¿Necesita claude-token-optimizer una GPU?
- No para arrancar. Argusic consiguió que funcionara en una máquina sin GPU.
- ¿Qué falla al instalar claude-token-optimizer?
- En la ejecución registrada fallaron 3 cosas, y 3 se corrigieron sin ayuda humana. Cada una, con el tiempo que costó, aparece en esta página.
- ¿Cómo se compara claude-token-optimizer con las alternativas?
- De los 5 proyectos de agents-md que Argusic ha instalado y cronometrado, claude-token-optimizer fue el 5.º más rápido en llegar a funcionar, y 2 de 5 llegaron a funcionar.
- ¿Dónde está la evidencia de claude-token-optimizer?
- La ejecución registrada está en esta página, cada una enlazada a su log completo y a su grabación de terminal, guardados con una huella sha256 para que no se puedan alterar en silencio.