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

Você pode instalar o Claude Code sem pagar separadamente pelo cliente, mas o plano Claude.ai Free não inclui o Claude Code. Para enviar solicitações reais, é necessário um plano Claude pago, cobrança pelo Console/API ou um provedor de terceiros compatível. Instalação gratuita e uso gratuito do modelo não são a mesma coisa.

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 e API não compartilham saldo

• Plano Claude pago: login OAuth com uma conta Claude.ai; o uso entra no limite compartilhado de Claude e Claude Code. Em /usage, consulte as barras do plano, não a estimativa em dólares de Session.
• Anthropic Console: a API é cobrada por tokens e limites do workspace. Veja o custo real em Claude Console Usage.
• BetterToken API: use sua própria API Key e Base URL da BetterToken; confira o consumo real no BetterToken Dashboard.

A assinatura Claude não cria saldo de API, e recarregar uma API não ativa Pro ou Max. O Claude Code aplica prioridade de credenciais: ANTHROPIC_API_KEY pode prevalecer sobre o login salvo da assinatura. Se a cobrança surpreender, execute /status para identificar a autenticação ativa e depois /usage para o modo atual.

O valor de Session em /usage é uma estimativa local baseada nos tokens da sessão, não uma fatura. Assinantes devem consultar as barras do plano; usuários de API, o painel do provider. Após trocar chave ou login, repita /status e /usage. Não publique chaves, tokens ou arquivos de credenciais.

Quando a assinatura Claude faz sentido

Um plano pago é adequado ao uso interativo por uma pessoa que deseja o produto Claude sob uma conta. Terminal e outras superfícies compartilham a franquia. Não é ilimitado: confirme limites, país e pagamento aceitos, consumo conjunto e administração de equipe no dia da contratação.

Quando a API faz sentido

Calcule com modelos e tarifas atuais, não com números de um artigo antigo. Abrir preços atuais da BetterToken

A API atende custos por uso, automação, CI, equipes e projetos com chaves e orçamentos separados. A API direta da Anthropic usa faturamento e limites do Console. A BetterToken usa conta própria, sua API Key e Base URL Anthropic-compatible; confira pagamentos, modelos e preços ao conectar.

Para Claude Code, a Base URL da BetterToken é https://bettertoken.ai, sem /v1. Use o guia atual do Claude Code para a configuração completa.

Como escolher sem pagar duas vezes pelo produto errado

Pergunte se precisa de um plano de usuário ou workflow API, onde chaves e histórico de cobrança devem ficar e se o provider atende sua região e pagamento. Para cenários de pagamento, leia Claude Code na Rússia: assinatura ou API; aqui delimitamos apenas a instalação gratuita.

Perguntas frequentes

Posso usar Claude Code no plano gratuito Claude.ai?

Não. A documentação atual exige plano pago, Console/API ou provider externo compatível.

É preciso pagar para instalar o cliente?

Não. A cobrança é pelo acesso ao modelo e uso, não pelo download do comando.

A assinatura inclui saldo da Anthropic API?

Não. São sistemas separados; /status identifica o método ativo.

BetterToken vende assinatura Claude?

Não. Ela oferece acesso API independente com conta e chave próprias; não é Claude Pro, Max nem conta Claude.ai compartilhada.

Conclusão

Claude Code só é gratuito para instalar. O trabalho real exige acesso pago ao modelo. Escolha assinatura ou API, confirme a autenticação com /status e avalie limites e custos.

Como conferir o custo da API sem números antigos

Model ID, disponibilidade e tarifas mudam. Use os preços atuais de input, output e cache Token do catálogo BetterToken e compare a estimativa ao valor real no Dashboard após um teste mínimo. É um orçamento API separado, não o preço da assinatura Claude.