Claude Code: assinatura ou API, qual cobrança usar

Duas formas de pagar pelo Claude Code

Login com assinatura. Você entra com sua conta do claude.ai. O Claude Code está incluído em todos os planos pagos e divide os limites deles: um limite de sessão que reseta a cada 5 horas e um limite semanal. Em outubro de 2026, o Pro custa US$ 20 por mês e o Max custa US$ 100 ou US$ 200 por mês (claude.com/pricing).

Cobrança pela API. Você usa uma conta do Claude Console, uma chave de API ou um provedor de nuvem. O uso é pago conforme o consumo, por token, cobrado nessa conta, sem um bloqueio fixo (Models, usage, and limits in Claude Code). O preço da API varia por modelo e é cobrado por milhão de tokens de entrada e de saída; consulte a página de preços da Anthropic para os valores atuais.

Assinatura ou API: qual vale a pena para você

Uma assinatura dá um custo mensal previsível. A contrapartida é que você para, ou passa para créditos pagos, quando atinge um limite. A cobrança pela API é paga conforme o uso, então o custo depende de quanto você usa, embora contas de API tenham limites de taxa e administradores possam definir limites de gasto para um workspace.

Para ter uma ideia de escala, a página de custos da Anthropic diz que, em implantações corporativas, a média fica em torno de US$ 13 por desenvolvedor por dia ativo e de US$ 150 a US$ 250 por desenvolvedor por mês, com 90% dos usuários abaixo de US$ 30 por dia ativo. Seus números dependem do modelo escolhido, do tamanho do código e dos seus hábitos.

Uma assinatura combina com uso diário constante, quando uma conta previsível importa. A Anthropic também sugere uma conta do Console com créditos de API para períodos intensos de programação.

Como saber qual está ativa

Execute /status no Claude Code. A documentação de autenticação da Anthropic diz que ele confirma qual método está ativo e, quando um login e uma chave de API estão configurados ao mesmo tempo, marca o que não está em uso.

Outros sinais: com assinatura, /usage mostra barras de uso do plano; com cobrança pela API, o bloco Session mostra um custo estimado em dólares. Usuários da API também podem executar /cost para ver o gasto acumulado.

ANTHROPIC_API_KEY passa por cima da sua assinatura

Essa é a causa mais comum de cobranças inesperadas. Na ordem de prioridade de autenticação do Claude Code, uma variável de ambiente ANTHROPIC_API_KEY fica acima do login com assinatura. No modo interativo, o Claude Code pergunta uma vez se deve usar a chave e lembra a sua escolha; no modo não interativo (-p), ele sempre usa a chave. A central de ajuda da Anthropic avisa que isso gera cobranças da API em vez de usar o uso incluído no seu plano.

Para voltar à sua assinatura:

unset ANTHROPIC_API_KEY

Depois, remova do seu perfil de shell a linha que define a variável, abra o Claude Code de novo e confira /status. Enquanto a variável estiver definida, você também pode mudar a escolha anterior com a opção "Use custom API key" em /config. O Claude Desktop não lê essa variável; ele faz login com OAuth.

Como ficar só no seu plano

Quando você atinge um limite na assinatura, o Claude Code pode oferecer continuar com créditos da API. A Anthropic diz que você pode recusar e esperar o limite resetar. Para que a opção pare de aparecer, saia da conta, entre de novo apenas com as credenciais do Pro ou do Max e não adicione credenciais do Console (Use Claude Code with your Pro or Max plan). A recarga automática de créditos da API é um ajuste do Console, então confira lá se você já usou cobrança pela API antes.

Se você tem uma conta de trabalho cobrada de um jeito e um plano pessoal cobrado de outro, dê a cada uma o seu próprio CLAUDE_CONFIG_DIR para que os logins não se misturem. Veja várias contas do Claude Code no mesmo Mac ou o Switch para Claude Code, se você usa o Claude Code dentro do Claude Desktop.