Original em inglês: https://argusic.com/subject/claude-token-optimizer
claude-token-optimizer
Reduza os tokens que o Claude Code carrega no início da sessão. CLI que configura um CLAUDE.md pequeno com documentação sob demanda, mede os tokens de inicialização e os mantém pequenos.
Executafonte: GitHubpágina do projetoJavaScriptMITcommit a1e437a8c299
JavaScript, licença MIT. O projeto se descreve como: agents md, ai assistant, automation, claude, claude code, claude md, cli e context engineering.
claude-token-optimizer executa. Em uma máquina limpa sem GPU, um agent da Argusic o instalou em 6 minutos e encontrou 3 erros, corrigindo todos sem ajuda, e a sessão inteira foi gravada.
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
O que o agent conseguiu em uma máquina limpa, nas palavras dele. Como isto é medido
Medido pela Argusic em uma máquina nova, todas as vezes. Cada número tem link para as suas evidências. Pontuação Argusic 100 de 100 (a média das pontuações das execuções deste projeto).
Visão geral
Dados do projeto de GitHub, com link no topo desta página, atualizado em . Dados de teste da Argusic (CC BY 4.0); cada número tem link para uma página de execução com o log completo, a gravação e os hashes sha256 deles.
O que foi medido
Da execução que decidiu este veredito. Cada linha é um valor registrado, não uma estimativa.
O que deu errado, nas palavras do agent
As palavras do próprio agent, das piores para as menores, nunca reescritas como conselho.
- 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
- Tempo de instalação
- 6 minutos
- Da máquina limpa até o fim
- 8 minutos
- Erros encontrados e corrigidos
- 3 encontrados, 3 corrigidos sem ajuda humana
- Como o resultado foi comprovado
- 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 exato testado
- a1e437a8c299
- Imagem do container
- sha256:cdd920bce783
O que não foi medido
A outra metade, para você ver exatamente até onde estas evidências vão. Uma lacuna é mostrada como lacuna e nunca é preenchida.
- Pico de memória da GPU
- esta execução foi em uma máquina com CPU, então não havia GPU para medir
- Comportamento em uma execução longa
- cada tentativa usa as menores configurações documentadas e um orçamento de tempo fixo, então isto mede se ele executa, não como ele se comporta sob carga
Assista à sessão
A execução inteira, a partir de uma máquina limpa, na velocidade em que realmente aconteceu. Nada é cortado e nada é acelerado.
Uma gravação da tentativa 1, executada em , a tentativa que decidiu o veredito acima. A gravação do terminal da qual ele foi feito é a evidência, guardada com uma impressão digital sha256; o vídeo é uma renderização dela. Nada é carregado do serviço de vídeo até você apertar o play.
O fim da gravação
As últimas linhas da sessão de terminal que decidiu este veredito, exatamente como foram gravadas.
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…
Reproduzir a sessão inteira, cada comando desde a máquina limpa até este ponto.
Como foi testado
Um agent, um container, nenhuma ajuda humana. Ele instala o projeto do jeito que a própria documentação do projeto manda, executa o projeto e corrige o que quebra. Tudo abaixo é registrado como aconteceu: a sessão de terminal, o log e o commit exato. A metodologia completa.
Pontos fortes e limites
Fatos medidos, não opiniões. Como este conteúdo é escrito.
O que deu certo
- Chegou a um estado de execução em uma máquina limpa, com a sessão gravada.
- Recuperou-se de todos os 3 erros sem que uma pessoa interviesse, o que indica que as falhas estão documentadas o suficiente para serem resolvidas.
- Executou sem GPU, então não precisa de uma para iniciar.
- Licença MIT, segundo a plataforma onde o projeto está hospedado.
O que não deu certo, ou não se sabe
- Levou 6 minutos para instalar, mais devagar que a mediana dos 4 projetos comparáveis que a Argusic mediu.
- Medido uma vez até agora. Uma única tentativa mostra que ele pode executar, não que executa de forma confiável.
Dos 5 projetos de agents-md que a Argusic instalou e cronometrou, claude-token-optimizer foi o 5º mais rápido a chegar a um estado de execução, e 2 de 5 chegaram a esse estado.
Para que é uma escolha razoável
- Testar em um laptop ou em um servidor pequeno: ele chegou a um estado de execução sem GPU.
- Uma avaliação rápida: ele estava executando 6 minutos depois do clone.
Também testados, na mesma área
Cada um destes foi instalado e executado pela Argusic em uma máquina limpa. Nada aparece aqui sem ter sido testado.
Histórico de execuções
Tópicos (de GitHub)
agents-mdai-assistantautomationclaudeclaude-codeclaude-mdclicontext-engineeringdeveloper-toolsdocumentationllmnpm-packageopensourcesetup-templatetoken-optimization
Incorporar o selo
Markdown para o README do projeto. Ele tem link de volta para esta página; os termos estão na página de termos.
[](https://argusic.com/subject/claude-token-optimizer)Perguntas
- claude-token-optimizer executa?
- Sim. claude-token-optimizer executa. A Argusic o instalou e iniciou em uma máquina limpa em 6 minutos, encontrando 3 erros no caminho, e gravou a sessão.
- Como a Argusic testou claude-token-optimizer?
- Em uma máquina nova e descartável, com cada comando gravado e o repositório fixado no commit a1e437a8c299. Há uma tentativa registrada, e a metodologia completa está na página da metodologia.
- Quanto custou testar claude-token-optimizer?
- A execução que produziu este veredito custou US$ 0,02: custo real de computação e de modelo, não um preço de tabela por milhão de tokens. Esse valor está registrado na página da execução.
- Quanto tempo leva para instalar claude-token-optimizer?
- 6 minutos na execução que decidiu este veredito, de uma máquina limpa até um estado de execução. É uma tentativa medida, não uma média.
- claude-token-optimizer precisa de GPU?
- Não para iniciar. A Argusic chegou a um estado de execução em uma máquina sem GPU.
- O que dá errado ao instalar claude-token-optimizer?
- 3 coisas quebraram na execução registrada, e 3 foram corrigidas sem ajuda humana. Cada uma, com o tempo que custou, está listada nesta página.
- Como claude-token-optimizer se compara às alternativas?
- Dos 5 projetos de agents-md que a Argusic instalou e cronometrou, claude-token-optimizer foi o 5º mais rápido a chegar a um estado de execução, e 2 de 5 chegaram a esse estado.
- Onde estão as evidências de claude-token-optimizer?
- A execução registrada está nesta página, cada uma com link para o seu log completo e a sua gravação do terminal, guardados com uma impressão digital sha256 para que não possam ser alterados discretamente.