Ferramentas inteligentes: corte leituras e saídas desnecessárias do Claude Code

A maior parte dos tokens que um agente gasta não vem do código que ele escreve, e sim dos arquivos e das saídas de comandos que ele lê. As ferramentas inteligentes do AgentVera rodam como hooks entre o Claude Code e as ferramentas dele e barram o que não é necessário antes que chegue ao modelo. As quatro vêm ativadas por padrão e podem ser desligadas uma a uma em Settings → Token savings.

Bloqueio de leituras desnecessárias

Se um arquivo já lido na conversa, e sem mudanças desde então, for lido de novo com cat, head, tail ou sed -n, o pedido é recusado e o agente é avisado de que o conteúdo já está no contexto dele. Na primeira leitura completa de um arquivo com mais de 800 linhas e 24 KB, o agente recebe o resumo do arquivo pelo mapa do projeto e lê só os intervalos de linhas de que precisa. Repetir o mesmo pedido faz ele passar; /compact ou /clear zeram essa memória.

Rodar só os testes afetados

Um comando que roda a suíte de testes inteira, como “npx vitest run”, “jest” ou um “npm test” cujo script é vitest ou jest, é reduzido aos testes das mudanças não commitadas e dos arquivos que as importam, até dois níveis. Se mais de 40 arquivos de teste forem afetados, a suíte inteira roda. O agente é avisado do que foi reduzido e pode rodar tudo com AGENTVERA_ALL_TESTS=1.

Checagem de erros logo após a edição

Antes de um arquivo TS/JS ser editado, os erros atuais dele e de até 8 arquivos que o importam são registrados. Depois da edição, eles são checados de novo com o TypeScript e o ESLint do próprio projeto, e só os erros novos voltam ao Claude no mesmo turno. Os avisos ficam de fora e a checagem tem limite de 8 segundos.

Resultados compartilhados entre agentes

Quando o mesmo comando de lint, checagem de tipos, teste ou build roda de novo na mesma pasta exatamente com o mesmo código, seja por este agente ou por um em paralelo, a saída anterior é devolvida e o agente fica sabendo quem rodou e há quantos minutos.

  • Cobertos: eslint, tsc, vitest run, jest, biome, ruff, mypy, pytest, cargo, go vet, test e build, e os scripts lint, typecheck, check, test e build do npm, pnpm e yarn.
  • Comandos encadeados, --watch, --fix e --write não entram no cache; os resultados ficam guardados por 30 minutos.
  • Rodar o comando de novo logo depois de uma resposta do cache força uma execução nova.

Perguntas

Com quais agentes funcionam?

As quatro rodam em hooks do Claude Code, então só com agentes Claude Code locais. Para o Codex existem o RTK e o mapa do projeto.

Onde vejo a economia?

O bloco de ferramentas inteligentes em Settings → Token savings e o card “Smart tools savings” na aba AI ROI mostram o total deste computador. A estimativa se baseia no tamanho da saída que nunca chegou ao modelo.

O Verify e as checagens de pre-commit também são reduzidos?

Não. A redução de testes vale só para os comandos que o próprio agente roda.

Posso desligá-las?

Sim. Cada uma tem sua própria chave em Settings → Token savings, e as mudanças valem na hora.

Recursos relacionados

Termos relacionados:Hooks do Claude CodeJanela de contextoToken

Todos os recursosVeja os 18 agentes de código suportados

Reúna seus agentes em uma só mesa.

Comece no plano gratuito. Baixe, adicione a pasta de um projeto e abra seu primeiro agente.