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. 1

    Ligue “Token budget” em Settings → Orchestration.

  2. 2

    Informe os tetos por agente, por turno e por dia, como 2M ou 500k.

  3. 3

    Se precisar, dê a um agente o próprio teto no diálogo do agente.

  4. 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

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.