Orçamentos de tokens: coloque um teto no gasto dos seus agentes
Você não quer descobrir depois quantos tokens um agente queimou numa tarefa longa ou durante a noite. Os orçamentos de tokens definem tetos por agente, por turno e por dia: você é avisado quando um agente chega perto e, no teto, ele para sem perder o trabalho.
Três tetos
Os orçamentos de tokens ficam em Settings → Orchestration → “Token budget” e vêm desligados por padrão.
- Por agente: a conversa inteira do agente. Cada agente também pode ter o próprio teto no diálogo do agente; 0 significa ilimitado.
- Por turno: um pedido e o trabalho que ele inicia.
- Por dia: todos os agentes juntos.
- Digite valores como “2M”, “500k” ou “1,5 milyon”.
Como conta
O gasto é contado em tokens equivalentes de entrada, lidos das próprias transcrições de conversa da CLI. Leituras de cache contam 0,1× e gravações de cache 1,25×, para que conversas longas com cache não sejam contadas a mais. Funciona com o Claude Code, o Codex e os outros agentes CLI que registram o uso no próprio histórico.
Avisos e paradas
Um orçamento primeiro avisa você e depois para o agente.
- Uma notificação chega aos 80% de um teto; a porcentagem do aviso é configurável. Ela vai para o desktop e para o Telegram, se você tiver configurado.
- No teto o agente para, mas a conversa fica, então ele continua assim que você aumenta o teto.
- O teto diário só para agentes que estão trabalhando.
Um chip no cabeçalho do agente
Um chip no cabeçalho do agente mostra o gasto até agora e a média por turno. A média é uma estimativa do custo do próximo pedido.
Como configurar
- 1
Ligue “Token budget” em Settings → Orchestration.
- 2
Informe os tetos por agente, por turno e por dia, como 2M ou 500k.
- 3
Se precisar, dê a um agente o próprio teto no diálogo do agente.
- 4
Acompanhe o gasto no chip do cabeçalho do agente.
Perguntas
Um agente perde o trabalho quando bate no teto?
Não. Ele para mas mantém a conversa, e continua de onde parou assim que você aumenta o teto.
Como os tokens em cache são contados?
Leituras de cache a 0,1× e gravações de cache a 1,25×. Tudo é contado em tokens equivalentes de entrada a partir das próprias transcrições da CLI.
Com quais agentes funciona?
Agentes Claude Code e Codex.
O teto diário para agentes ociosos também?
Não. Só para agentes que estão trabalhando naquele momento.
Quando o aviso chega?
Aos 80% de um teto por padrão; você pode mudar a porcentagem nas configurações.
Recursos relacionados
Reúna seus agentes em uma só mesa.
Comece no plano gratuito. Baixe, adicione a pasta de um projeto e abra seu primeiro agente.
Artigos sobre o tema
Blog- 28 de outubro de 2026Orquestração de agentes de IA: 5 padrões e ferramentasOrquestração de agentes de IA para programar: orquestrador e workers, líder com lista de tarefas, fan-out em worktrees, handoffs, best-of-N e o que dá errado.
- 25 de outubro de 2026Preço do Claude Code: Pro vs Max vs API comparadosPreço do Claude Code em outubro de 2026: Pro, Max, Team, Enterprise e API pré-paga comparados, como funcionam os limites de uso e como manter os custos baixos.