É possível usar o Claude Code de graça? Instalação, assinatura e API

O que é grátis no Claude Code e o que é pago

Não há uma cobrança separada para baixar e instalar o cliente. A instalação, porém, não oferece acesso ao modelo por si só: o Claude Code precisa se autenticar por um plano Claude pago, pelo Claude Console ou por uma plataforma corporativa compatível.

O guia oficial de configuração do Claude Code afirma explicitamente que o plano Claude.ai Free não inclui acesso ao Claude Code. Solicitações reais exigem um plano Claude pago, cobrança pelo Claude Console/API ou um provedor de terceiros compatível. Use a página de preços do Claude apenas para conferir recursos e limites atuais dos planos pagos, pois eles podem mudar.

Quando alguém diz que “o Claude Code é grátis”, normalmente está falando apenas do cliente. As solicitações ao modelo consomem a franquia de um plano pago ou tokens faturáveis da API.

Assinatura Claude e API usam modelos de cobrança diferentes

Ao entrar pelo Claude.ai, o uso do Claude Code está incluído no plano pago e compartilha os limites gerais do plano com outras interfaces Claude. Ao se autenticar pelo Claude Console, aplica-se a cobrança da API baseada em tokens. O custo real depende do modelo, do tamanho do contexto e do volume de trabalho.

• Plano Claude pago: cobrança por assinatura com uso incluído; o consumo entra na franquia compartilhada do plano. Confira /usage e Settings → Usage. É adequado para trabalho interativo quando você já tem um plano.
• Claude Console / API: cobrança baseada em tokens; o consumo é registrado na organização e no workspace da API. Confira /usage para a sessão e o Claude Console para o faturamento. É adequado para separar cobrança por API, orçamento e acesso organizacional.

Como não confundir autenticação por assinatura e por API

O Claude Code seleciona as credenciais segundo uma ordem de prioridade. A variável de ambiente ANTHROPIC_API_KEY tem precedência sobre a autenticação OAuth feita por /login. No modo interativo, o Claude Code pede uma vez autorização para usar a chave detectada; no modo não interativo -p, a chave é usada automaticamente quando a variável está definida.

Você pode verificar se a variável está definida sem exibir seu valor:

if [ "${ANTHROPIC_API_KEY+x}" = x ]; then
  printf '%s\n' 'Variable is set'
else
  printf '%s\n' 'Variable is not set'
fi

Depois, execute /status dentro do Claude Code. A linha Login method mostra o método de autenticação ativo, e uma linha adicional API key aparece quando uma API key está em uso.

Se você pretendia usar a assinatura, mas uma chave de ambiente está ativa, remova-a da sessão atual com:

unset ANTHROPIC_API_KEY

Execute /status novamente. Não apague arquivos de credenciais manualmente: use os comandos oficiais /logout e /login para trocar a conta salva.

Como interpretar uso e limites em /usage

A seção Session no topo de /usage mostra estatísticas da sessão atual: tokens de input, output, cache read e cache write. O valor em dólares é calculado localmente a partir da contagem de tokens e pode diferir da cobrança real.

Para usuários da API, essa seção ajuda a estimar o uso da sessão, mas o registro oficial de faturamento fica na página Usage do Claude Console. Depois de /clear, os contadores da nova sessão começam novamente.

Para assinantes Pro, Max, Team e Enterprise, o uso do Claude Code está incluído no plano. Portanto, a estimativa em dólares da seção Session não é o valor cobrado da assinatura. Na mesma tela, assinantes podem ver barras de uso do plano, estatísticas de atividade e detalhamentos de skills, subagents, plugins e MCP servers.

As teclas d e w alternam o detalhamento entre as últimas 24 horas e os últimos sete dias. Essas informações vêm do histórico local do computador atual e não incluem atividade de outros dispositivos ou do claude.ai.

Onde conferir as condições atuais

Quatro páginas oficiais cobrem este tema:

• Claude Plans & Pricing — quais planos incluem o Claude Code atualmente e os limites informados
• Manage costs effectively — como interpretar /usage, onde verificar a cobrança da API e como os limites funcionam
• Authentication — métodos de login, prioridade de credenciais, /status, /login e /logout
• Claude Console Usage — uso e custos reais de uma organização da API

Não trate preços, tamanhos de limites ou conjuntos de recursos como valores permanentes em suas anotações. Abra a página de preços atual antes de pagar ou alterar o método de autenticação.

Como escolher um método de acesso ao Claude Code

A escolha depende de onde o uso deve ser contabilizado:

1. Você já tem um plano Claude pago e trabalha de forma interativa. Entre com /login, confira Login method em /status e acompanhe as barras do plano em /usage.
2. Sua organização precisa de cobrança por API e limites de gastos separados. Use o acesso pelo Claude Console e confira a fatura real no Console, não a estimativa local da seção Session.
3. O Claude Code roda em CI ou em um script sem browser. O acesso por API é uma opção, mas não a única: a documentação oficial também oferece um token OAuth de assinatura de longa duração por meio de claude setup-token. O método de autenticação ativo determina como o uso é pago.
4. O limite do seu plano pago acabou. Você pode esperar a renovação, trocar de plano ou habilitar créditos de uso se estiverem disponíveis para sua conta. O uso adicional é cobrado pelas tarifas padrão da API.

Depois de mudar o método de acesso, repita duas verificações: /status responde “qual conta está ativa?”, enquanto /usage responde “qual limite ou registro de uso está visível agora?”.

Se você precisa comparar caminhos de pagamento por região, consulte também este guia regional separado. Esta página mantém o foco mais estreito na diferença entre instalar o cliente gratuitamente e pagar pelo acesso ao modelo.

Perguntas frequentes

Posso usar o Claude Code no plano Free?

Na página atual de preços, o Claude Code aparece nos planos pagos, mas não no Free. Você pode instalar o cliente sem uma compra separada, porém as solicitações ao modelo exigem um método de acesso pago compatível.

Por que /usage mostra dólares se tenho uma assinatura?

É uma estimativa local do custo de API dos tokens usados na sessão atual. Para um assinante, não é uma fatura. Confira as barras de uso do plano na mesma tela.

Uma API Key pode mudar o Claude Code de assinatura para cobrança por API?

Sim. Se ANTHROPIC_API_KEY estiver definida e seu uso tiver sido aprovado, ela terá precedência sobre o OAuth da assinatura. Confira o método ativo em /status.

Onde vejo os valores exatos cobrados pela API?

No Claude Console. A seção Session de /usage serve como estimativa local e pode não corresponder à cobrança real.

Próximo passo: acesso à API para Claude Code

Se você escolheu um orçamento de API separado e sua própria chave para o Claude Code, consulte a página da API para Claude Code. Esta é uma integração da API BetterToken, não uma assinatura Claude; confirme os campos e limites atuais antes da configuração.