# Orçamentos de tokens

URL: https://agentvera.dev/pt/features/token-budgets/ · Plano: Grátis

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.

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

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/