O caso: uma desenvolvedora usa um agente de código ligado à API, com o Claude Sonnet 5.5. Num dia típico, ela corrige 2 bugs, implementa 1 funcionalidade nova, faz 1 refatoração com testes e tira 3 dúvidas rápidas sobre o código. No total, o agente executa 145 passos, entre leituras de arquivo, comandos e edições, com 90% do contexto lido do cache.
Resposta curta: o dia custa US$ 4,04 (R$ 20,22). A funcionalidade nova, sozinha, responde por US$ 2,17, 54% do dia. Em 22 dias úteis, a conta chega a US$ 88,79. O que mais pesa não é o número de tarefas, e sim o tamanho do contexto que o agente carrega a cada passo.
1. Por que o agente cobra por passo
Um agente de código trabalha em ciclos. Ele lê um arquivo, decide o que fazer, roda um comando, lê o resultado, edita outro arquivo, roda os testes. Cada um desses movimentos é uma chamada à API, e cada chamada reenvia ao modelo tudo o que ele precisa lembrar: as instruções, os arquivos já lidos, as saídas dos comandos, a conversa até ali.
Por isso o custo de uma tarefa é, aproximadamente:
E o contexto é a parte grande. Numa sessão de funcionalidade nova, o agente pode carregar 80.000 tokens de contexto para escrever 900 de saída. É como pagar para reler um livro inteiro a cada parágrafo escrito. O que salva a conta é o cache de prompt: o trecho que já foi enviado é lido do cache por uma fração do preço.
2. O dia, tarefa por tarefa
Com o Sonnet 5.5 e 90% do contexto lido do cache em cada passo (os outros 10%, a parte nova, são gravados no cache):
| Tarefa | Vezes no dia | Passos | Contexto por passo | Saída por passo | Custo no dia |
|---|---|---|---|---|---|
| Corrigir um bug | 2 | 15 | 30.000 | 600 | US$ 0,49 |
| Funcionalidade nova | 1 | 60 | 80.000 | 900 | US$ 2,17 |
| Refatoração com testes | 1 | 40 | 60.000 | 1.000 | US$ 1,22 |
| Pergunta rápida sobre o código | 3 | 5 | 20.000 | 400 | US$ 0,16 |
| Total | 145 | US$ 4,04 |
Duas tarefas grandes (a funcionalidade e a refatoração) concentram 84% do custo. As perguntas rápidas, mesmo sendo três, quase não aparecem na conta: poucos passos com contexto pequeno.
3. Dentro de um passo
Vale abrir um passo da funcionalidade nova, com 80.000 tokens de contexto e 900 de saída, no Sonnet 5.5:
- leitura do cache: 90% do contexto, 72.000 tokens a US$ 0,10 por milhão = US$ 0,0072;
- gravação no cache: os 10% novos, 8.000 tokens a US$ 2,50 por milhão = US$ 0,0200;
- saída: 900 tokens a US$ 10,00 por milhão = US$ 0,0090;
- total do passo: US$ 0,0362.
A maior fatia do passo é a gravação no cache da parte nova do contexto: 55% do custo. A saída, com pouco mais de 1% dos tokens, vem em seguida, com 25%. A leitura do cache, que é a maior parte dos tokens, fica com só 20%. Os 60 passos da funcionalidade somam US$ 2,17.
4. O que faz o dia disparar
Três situações comuns mudam muito a conta. Todas usam a mesma sessão de funcionalidade nova no Sonnet 5.5 (60 passos, 900 tokens de saída):
| Situação | Custo da sessão | Diferença |
|---|---|---|
| Referência: contexto de 80 mil tokens, 90% do cache | US$ 2,17 | — |
| Pausas longas: só 70% do contexto lido do cache | US$ 4,48 | +106% |
| Cache desligado ou sempre expirado | US$ 10,14 | +367% |
| Contexto inchado: 150 mil tokens por passo | US$ 3,60 | +66% |
- Pausas longas. O cache dura 5 minutos e o prazo é renovado a cada uso. Se a desenvolvedora sai para uma reunião no meio da sessão, o cache expira e o próximo passo grava todo o contexto de novo, pagando 1,25 vez o preço de entrada. Várias pausas ao longo do dia derrubam a taxa de acerto.
- Cache que nunca acerta. Uma ferramenta mal configurada, que muda o começo do prompt a cada chamada (um horário, uma lista de arquivos em ordem diferente), faz o cache falhar sempre. É o pior cenário e nem sempre aparece de forma óbvia.
- Contexto inchado. Sessões longas acumulam saídas de comandos, logs e arquivos que já não importam. Passar de 80.000 para 150.000 tokens de contexto encarece a sessão em 66%. Começar uma sessão nova para cada tarefa, ou pedir ao agente que resuma e compacte o histórico, mantém o contexto enxuto.
5. O mesmo dia em outros modelos
Trocar o modelo muda a conta mais que qualquer ajuste. A tabela roda o mesmo dia nos modelos Claude 5.x:
| Modelo | Custo do dia (US$) | Custo do dia (R$) | 22 dias úteis (R$) |
|---|---|---|---|
| Claude Opus 5.5 | US$ 8,07 | R$ 40,44 | R$ 889,62 |
| Claude Sonnet 5.5 | US$ 4,04 | R$ 20,22 | R$ 444,81 |
| Claude Haiku 5.5 | US$ 0,24 | R$ 1,20 | R$ 26,41 |
Nos modelos da OpenAI, há um detalhe. As médias do calc.dev.br indicam que o mesmo código vira menos tokens no tokenizador do GPT-5.6 (que supomos igual no GPT-6, já que a OpenAI não publicou uma comparação) (3,3 caracteres por token) do que no dos modelos Claude 5.x (2,4). Para comparar o mesmo trabalho, a tabela abaixo reduz contexto e saída nessa proporção:
| Modelo | Custo do dia (US$) | Custo do dia (R$) | 22 dias úteis (R$) |
|---|---|---|---|
| GPT-6 Astra | US$ 17,43 | R$ 87,29 | R$ 1.920,48 |
| GPT-6.1 Sol | US$ 2,94 | R$ 14,70 | R$ 323,50 |
| GPT-6 Sol | US$ 3,49 | R$ 17,46 | R$ 384,10 |
| GPT-6 Luna | US$ 0,17 | R$ 0,87 | R$ 19,20 |
| GPT-5.6 Sol | US$ 6,97 | R$ 34,92 | R$ 768,19 |
| GPT-5.6 Terra | US$ 3,66 | R$ 18,32 | R$ 403,01 |
| GPT-5.6 Luna | US$ 0,37 | R$ 1,83 | R$ 40,30 |
Com esse ajuste, o GPT-5.6 Terra fica 9% abaixo do Sonnet 5.5 neste dia, e o GPT-5.6 Sol, 14% abaixo do Opus 5.5, com o preço promocional que a OpenAI aplica pelo menos até 21 de novembro de 2026 (pelo preço regular, ficaria 13% acima). O GPT-6.1 Sol, que cobra por token o mesmo que o Sonnet 5.5, fica 27% abaixo dele. Sem o ajuste, isto é, contando os mesmos tokens para todos, o Terra sairia mais caro que o Sonnet. É um bom exemplo de como a diferença de tokenizador muda uma comparação que parecia resolvida pela tabela de preços.
Ainda assim, o preço por token não diz tudo: agentes diferentes fazem número diferente de passos para a mesma tarefa, e um modelo que erra mais precisa de mais voltas. A única comparação justa é rodar as mesmas tarefas reais nos modelos candidatos e medir o uso nos campos da resposta da API.
6. Haiku 5.5 em agente: barato, com uma armadilha
O Claude Haiku 5.5 faz o dia inteiro por US$ 0,24. Para tarefas simples e bem delimitadas, como renomear símbolos, atualizar dependências ou escrever testes para funções pequenas, vale experimentar.
A armadilha é o contexto. No Haiku 5.5, um prompt acima de 100.000 tokens paga 5 vezes o preço normal na requisição inteira, incluindo a saída. Agentes passam desse limite com facilidade. A mesma sessão de funcionalidade nova custa US$ 0,13 com 80.000 tokens de contexto e US$ 1,10 com 150.000: 8,5 vezes mais por menos que o dobro de contexto. Se for usar o Haiku 5.5 num agente, limite o contexto abaixo da linha de 100.000 tokens.
7. Pela API ou por um plano?
Este guia olha o custo do dia pela API, que é como funciona quando o agente usa uma chave do Console ou quando uma empresa paga por uso. Quem programa todos os dias também pode usar um plano mensal com o agente incluído. A comparação entre as duas formas de pagar está no guia assinatura ou API para programar com IA.
8. Como manter o custo do dia sob controle
- Uma sessão por tarefa. Começar do zero evita carregar o histórico da tarefa anterior.
- Instruções fixas no começo do prompt. O cache só aproveita o trecho inicial idêntico.
- Evite pausas no meio da sessão ou aceite que a volta paga uma gravação inteira.
- Corte a saída dos comandos. Logs de milhares de linhas entram no contexto de todos os passos seguintes.
- Escolha o modelo pela tarefa: o maior para o difícil, o menor para o repetitivo.
- Acompanhe o uso real no painel do fornecedor nas primeiras semanas e compare com a estimativa.
O que fica fora desta conta
A estimativa cobre só os tokens dos modelos. Ficam de fora ferramentas extras que o agente possa chamar com preço próprio, como busca na web, o computador ou servidor onde ele roda, impostos e tarifas do cartão internacional e a variação do dólar. Também não consideramos limites de uso por minuto, que podem atrasar o trabalho sem mudar o preço.
Perguntas frequentes
Quanto custa um passo de um agente de código?
Com 80.000 tokens de contexto, 90% lidos do cache, e 900 de saída, US$ 0,0362 no Claude Sonnet 5.5.
O que mais encarece um agente de código?
O tamanho do contexto reenviado a cada passo e as falhas de cache. Sem cache, a mesma sessão custa 4,7 vezes mais.
Quanto custa um mês de uso?
No dia deste caso, US$ 88,79 em 22 dias úteis com o Sonnet 5.5, ou R$ 444,81.
Para refazer a conta, use a calculadora de custo de agente de código logo abaixo. Ela já vem com a sessão de funcionalidade nova deste caso; mude sessões, passos e dias para montar o seu dia.
