Quanto custa uma tarefa de Claude Code
Um bugfix, um scaffold e um refactor são três contas diferentes: anatomia de custo por tarefa — turnos, crescimento de contexto, o que uma tarefa realmente custa.
Os números mensais escondem o número que muda seu comportamento: quanto custa uma tarefa. Um bugfix rápido e uma tarde de refactor não são o mesmo produto, mas a fatura os mostra como uma mancha só. Este post quebra o gasto de agente na unidade em que você de fato decide — a tarefa.
Transparência desde o início: eu opero o Teapot Router, um gateway para GPT e Claude Code. A anatomia abaixo é economia de protocolo, não pitch de produto — vale para qualquer endpoint compatível com Anthropic.
O mês esconde a tarefa
Médias mensais são contabilidade honesta e direção inútil. Dentro do mês de um mesmo dev, o custo por tarefa varia muito mais do que o custo por pessoa jamais varia — as tarefas do mesmo dev diferem em uma ordem de grandeza por forma, não por esforço. Três formas cobrem quase tudo que agentes fazem:
- O bugfix cirúrgico. Poucos turnos, contexto enxuto, o arquivo já fora lido antes — o cache faz a maior parte do trabalho. A forma mais barata, e a que faz agentes parecerem grátis.
- O scaffold ou feature nova. Muitos turnos, mas o contexto cresce de forma previsível e o prefixo estável (instruções, convenções, arquivos anteriores) cacheia bem. Custo médio, muito previsível.
- O refactor profundo ou sessão maratona. Centenas de turnos, contexto em bola de neve a cada turno, e a taxa de acerto de cache decidindo a conta mais que o preço de tabela do modelo. É aqui que orçamentos morrem.
A bola de neve de contexto
O mecanismo que encarece a forma três: agentes não têm estado no canal. O turno 15 reenvia a conversa até ali — prompt de sistema, arquivos lidos, resultados de ferramentas. A entrada de cada turno cresce com tudo o que veio antes, então o custo por turno sobe numa sessão longa mesmo com preço por token fixo. Sessões picotadas em tarefas com escopo pagam o contexto uma vez cada; uma sessão interminável paga tudo, repetidas vezes. O formato da sessão é uma decisão de custo tanto quanto de produtividade.
Por que a mesma tarefa cobra diferente
Dois devs rodam o mesmo refactor e veem contas muito diferentes. Suspeitos na ordem de impacto: comportamento de cache (prefixo estável relido barato versus volátil repago frio), disciplina de sessão (sessões com escopo novo versus uma mega-sessão rolante) e roteamento de modelo (flagship em todo passo versus só nos pedidos difíceis). Nada disso aparece no preço de tabela — aparece nos dados por requisição, o único lugar para julgar "por que isto foi caro".
Meça na tarefa, decida na tarefa
Se o seu gateway permite rotular requisições ou dar chaves por projeto, a tarefa vira sua unidade de custo: este refactor custou isto, esta faixa de bugfix custa aquilo por semana. É essa granularidade que torna o orçamento mensal do post anterior defensável — você não discute uma média mágica, lê um livro-razão por tarefa. Sem rotulagem, sessões com escopo mais chaves por projeto são o proxy viável.
O mês é a unidade de orçamento; a tarefa é a unidade de decisão. Conheça suas três formas de tarefa, vigie a bola de neve de contexto e leia o custo onde ele é medido — por requisição, por tarefa — e o número mensal deixa de surpreender.
Perguntas frequentes
Quanto custa uma tarefa típica?
Não há número universal honesto — depende inteiramente da forma (turnos, crescimento de contexto, comportamento de cache). Modele com a calculadora em teapotrouter.com/en/claude-code-cost-calculator e confira no seu livro-razão por requisição depois de uma semana.
Por que minha tarefa pequena custou tanto?
Quase sempre a bola de neve de contexto: uma sessão longa em que cada turno repaga a conversa inteira, ou um padrão de cache-miss que relê tudo frio. Ambos aparecem nas colunas de tokens por requisição antes de virarem dólares.
Como atribuo custos a tarefas específicas?
Rotule requisições ou use chaves por projeto no gateway e agrupe o livro-razão por rótulo. Sem rotulagem, sessões com escopo mais chaves por projeto são o proxy prático.