Planos, limites e custo sem susto

Field Note

Domingo, 22h. Você roda /usage, vê um "Total cost: $4.10" e quase engasga. Mas você paga assinatura, não API. Então quanto foi, de verdade? Nada a mais? Quatro dólares? Uma fatia do limite semanal? Sem saber de onde vem o número, a leitura do /usage vira horóscopo financeiro: todo mundo interpreta do jeito que dá mais ansiedade.

Conceito

Existem quatro jeitos de pagar pelo Claude Code, e cada um mede consumo de um jeito diferente. Os valores abaixo foram conferidos em claude.com/pricing e na página de custos no momento em que escrevo (outubro de 2026). Preço muda: confira antes de decidir.

1. Assinatura individual (Pro e Max). Valor fixo por mês com uso incluído até um limite.

• Free: não inclui Claude Code.
• Pro: US$ 20 por mês no plano mensal, ou US$ 17 por mês no anual (US$ 200 cobrados de uma vez). Inclui Claude Code.
• Max: a partir de US$ 100 por mês, com opções de 5x ou 20x mais uso que o Pro.

2. Assinatura de time (Team e Enterprise). Cada pessoa usa uma cota por assento. A doc explica que essa cota renova numa janela móvel de cinco horas e numa janela semanal, é compartilhada com o chat do Claude e o Cowork, e o tamanho depende do tipo de assento (Standard ou Premium). No Team, o assento Standard sai por US$ 25 no mensal ou US$ 20 no anual, e o Premium por US$ 125 no mensal ou US$ 100 no anual, com 5x mais uso que o Standard. Enterprise tem condições próprias, veja a página de preços.

3. Usage credits. É o "uso além do limite" das assinaturas. Você liga, define um teto de gasto e continua trabalhando depois de bater o limite do plano. Gerencia com /usage-credits. Atenção: alguns recursos sempre saem de usage credits, mesmo com limite sobrando, como o fast mode, e o Fable dependendo do plano.

4. API (Claude Console) e provedores de nuvem. Paga por token consumido, sem limite fixo. No primeiro login com Console, o Claude Code cria um workspace chamado "Claude Code" para centralizar o custo, e dá para definir limite de gasto por workspace. Em Bedrock, Google Cloud ou Foundry, a cobrança e o controle ficam no console do provedor.

Como ler o /usage (os apelidos /cost e /stats abrem a mesma tela):

• O bloco Session mostra tokens e um custo em dólar calculado localmente a preço de tabela. A doc diz que esse número é estimativa, voltado a quem usa API. Para assinantes Pro e Max, o custo da sessão não é cobrança, já que o uso está incluído na assinatura.
• Para assinantes, a mesma tela mostra barras de uso do plano e uma quebra do que mais pesou (skills, subagentes, plugins, servidores MCP), além de comportamentos que passam de 10% do uso recente, como contexto longo e cache miss. Aperte d ou w para alternar entre 24 horas e 7 dias. Os números vêm do histórico local daquela máquina.
• Com usage credits ligados, aparece uma linha com o gasto do mês.

Referência de custo. A doc cita, para implantações corporativas, média em torno de US$ 13 por desenvolvedor por dia ativo e US$ 150 a 250 por mês, com 90% das pessoas abaixo de US$ 30 por dia ativo. É média de empresa, não meta para você.

O que mais consome, segundo a doc: contexto longo (cada requisição reenvia a conversa toda), cache miss depois de pausa longa, tarefas agendadas rodando com a sessão parada, subagentes e workflows (cada um faz suas próprias requisições), agent teams (a doc estima cerca de 7x mais tokens quando os membros rodam em plan mode), e compactação de contexto grande. Já o /clear não custa nada.

Quando usar

• Antes de adotar no time: registrar uma baseline com um grupo pequeno, como a própria doc recomenda.
• Quando o limite do plano acaba cedo demais na semana.
• Antes de ligar fast mode, Fable ou workflows grandes.
• Ao automatizar com claude -p: dá para pôr um teto com --max-budget-usd (só em modo não interativo, e a doc avisa que o gasto pode passar um pouco do teto).

Quando não usar

• Não use o custo da sessão no /usage como fatura de assinatura. Para cobrança real, veja o Console (API) ou as configurações de uso no claude.ai.
• Não compare seu consumo com a média corporativa como se fosse régua. Tamanho do repositório, modelo e padrão de uso mudam tudo.
• Não otimize centavo antes de ter uma tarefa funcionando. Primeiro faz rodar, depois mede.

Faça agora

1. Abra uma sessão e confirme como você está pagando:

/status

Se aparecer uma linha de login de assinatura (ex.: conta Max), o consumo sai do plano. Se aparecer API key, sai do Console, por token. Se não era isso que você queria, resolva antes de seguir.

2. Rode /clear para zerar os contadores da sessão.
3. Execute a primeira tarefa real da trilha (pode ser a análise da lição anterior).
4. Ao terminar, rode /usage e registre: tokens de entrada e saída, custo estimado da sessão, e, se for assinatura, quanto as barras do plano andaram.
5. Defina um limite inicial por missão. Exemplos: "no máximo 10% da janela de cinco horas por tarefa exploratória" (assinatura) ou "teto de US$ 2 por execução com --max-budget-usd" (API).
6. Se usa assinatura, decida se usage credits ficam ligados ou não, e com qual teto.
7. Salve tudo como Baseline de uso.

Armadilhas

• API key no ambiente. Com ANTHROPIC_API_KEY aprovada, o Claude Code cobra pela API mesmo você tendo assinatura. /status mostra qual credencial está ativa.
• Sessão que nunca é limpa. Uma pergunta de uma linha numa conversa aberta o dia inteiro reenvia o histórico todo.
• Fast mode "só para testar". Sai de usage credits desde o primeiro minuto.
• Esquecer tarefa agendada ou /loop rodando. Dispara mesmo com você longe, carregando o contexto.
• Opus como padrão para tudo. A doc aponta isso, junto com sessões nunca limpas, como causa comum de gasto alto em API.
• Confundir limite de contexto com limite de uso. Aviso de auto-compact é sobre a janela de contexto, não sobre o seu plano.

Material para levar

Baseline de uso:

Data:
Como pago: Pro / Max / Team / Enterprise / Console (API) / nuvem
Credencial ativa em /status:
Usage credits: ligados / desligados    Teto mensal:

Tarefa:
Modelo e effort:
Duração aproximada:
Tokens (entrada / saída):
Custo estimado da sessão (/usage):
Avanço nas barras do plano (se assinatura):

Limite por missão definido:
O que mais pesou na quebra do /usage:

Hábitos que mais economizam, direto da doc:

• /clear entre tarefas sem relação.
• Sonnet para a maior parte do trabalho, Opus quando o problema pede.
• CLAUDE.md curto (a doc sugere menos de 200 linhas). Instrução específica de fluxo vai para skill.
• Prompt específico em vez de "melhore esse código".
• Plan mode em tarefa complexa para não refazer trabalho.
• Desligar servidor MCP que você não está usando.