De onde vêm os números
O Claude Code conta quatro tipos de tokens para cada modelo: entrada, saída, leituras de cache e gravações em cache. O bloco Session do /usage (o /cost é o mesmo comando) lista esses tokens por modelo, e o ccusage exporta as mesmas contagens a partir dos seus registros locais. A calculadora multiplica cada contagem pelo preço público da API daquele modelo.
O /usage só vê esta máquina: os números vêm do histórico local de sessões, sem os seus outros computadores nem o claude.ai. Rode em cada PC, ou exporte com o ccusage em cada um, para ter o quadro completo.
Quais preços
Os preços públicos da API da Anthropic por milhão de tokens, conferidos em 22 de setembro de 2026. Cada modelo é associado pelo prefixo conhecido mais longo do seu id: claude-opus-5-5-20260922 recebe o preço de claude-opus-5-5, nunca o de claude-opus-5. Um modelo que não está na tabela aparece, mas o preço nunca é chutado.
As leituras de cache custam um décimo do preço de entrada na maioria dos modelos (menos no Claude Opus 5.5 e no Claude Fable 5.1). As gravações em cache custam 1,25× o preço de entrada para uma duração de 5 minutos, ou 2× para uma hora.
Por que o cache muda tudo
O Claude Code envia a conversa inteira a cada requisição. A maior parte é lida de volta do cache de prompts, por uma fração do preço de entrada; por isso as leituras de cache costumam ser a maior contagem de tokens e uma pequena parte da conta. A linha “Sem o cache” precifica os mesmos tokens como entrada comum para mostrar quanto o cache economizou.
A duração também importa: em uma assinatura Pro ou Max, o Claude Code mantém o cache principal por uma hora, e por cinco minutos com uma chave de API ou créditos de uso. Depois de uma pausa maior, o cache expira, e a primeira requisição o grava de novo por inteiro.
Assinatura ou API
Pro e Max não cobram por token: o valor em dólares do /usage é pensado para quem usa a API e, em uma assinatura, não é o que você paga. O que limita você é a sessão de 5 horas e o limite semanal, que o valor em dólares não mostra. Mesmo assim, o equivalente em API é uma boa régua do quanto você usa o Claude Code.
Os números da própria Anthropic para o Claude Code cobrado pelas tarifas da API: cerca de US$ 13 por desenvolvedor por dia ativo, de US$ 150 a US$ 250 por desenvolvedor por mês, e menos de US$ 30 por dia ativo para 90% dos usuários. Depois dos seus limites no Pro e no Max, os créditos de uso são cobrados por essas tarifas da API.
Perguntas
Eu pago esse valor com uma assinatura do Claude?
Não. Pro e Max têm preço fixo e limites: o equivalente em API só diz quanto o mesmo trabalho teria custado com uma chave de API. Você só paga por token com os créditos de uso, depois de passar dos seus limites.
Por que meu resultado é diferente do valor em dólares do /usage?
Os motivos de sempre: gravações em cache precificadas a uma hora em vez de cinco minutos, um preço que mudou desde o lançamento da sua versão do Claude Code, ou um modelo que falta na nossa tabela (aparece, mas nunca é chutado).
O que são leituras e gravações de cache?
Uma gravação em cache guarda o começo de uma conversa para que as próximas requisições possam reutilizá-lo; uma leitura de cache o reutiliza por uma fração do preço de entrada. As sessões longas do Claude Code são quase só leituras de cache.
Como vejo o total de todos os meus computadores?
O /usage e o ccusage só leem a máquina em que rodam. O UsageMeter Link lê o Claude Code em cada PC com Windows e soma tudo na sua conta UsageMeter, por modelo e por dia.
Páginas relacionadas
- Limites de uso do Claude CodeO que o Claude Code compartilha com o claude.ai e como funcionam os limites dele.
- Widgets do Claude para o seu READMEMostre seus tokens e modelos do Claude Code no GitHub, no seu site ou no Notion.
- Calculadora da hora de reinício do ClaudeA hora exata em que seu limite de 5 horas volta, no seu fuso horário.
- Limites de uso do Claude por planoOs limites de sessão, semanais e de modelo de cada plano, em uma única tabela.
Fontes
- Documentação do Claude Code: gerenciar custos (/usage, médias)
- Documentação do Claude Code: cache de prompts e duração do cache
- Preços da API da Anthropic
- Planos e preços do Claude
- ccusage: saída JSON
Conferido com as páginas da Anthropic em 24 de setembro de 2026. A Anthropic pode mudar essas regras a qualquer momento.
O UsageMeter é uma ferramenta independente, sem afiliação com a Anthropic. Claude e Claude Code são produtos da Anthropic.