Claude Code: assinatura ou API, custos, configuração e escolha

O Claude Code já está instalado, mas ainda falta decidir como pagar: entrar com uma assinatura do Claude, colocar saldo na API oficial ou conectar um gateway compatível com Anthropic? As três opções podem abrir o mesmo terminal e, mesmo assim, cobrar contas diferentes.

Escolha primeiro a relação de cobrança e só depois informe credenciais. Este guia mostra o que cada rota oferece, como comparar os preços atuais, quais restrições regionais verificar e como fazer um teste pequeno e rastreável com o BetterToken sem expor a chave de API.

Escolha a rota de cobrança conforme o trabalho real

A recomendação prática depende do cenário: use assinatura se também precisa dos aplicativos do Claude e programa de modo interativo com frequência; use API se precisa de chaves próprias, automação ou cobrança por uso; não compre o login de outra pessoa.

Rota	O que você paga	Melhor cenário	O que conferir antes de pagar
Sua assinatura Pro ou Max	Aplicativos do Claude e Claude Code dentro de limites compartilhados	Pessoa que usa chat e Claude Code com frequência	País compatível, capacidade do plano e créditos opcionais de uso
API oficial do Claude Console	Chamadas de modelo cobradas separadamente pelas tarifas da API	Scripts, CI, produtos, integrações de equipe e picos intensivos	Elegibilidade do Console, preço do modelo, limites e recarga automática
Gateway compatível com Anthropic, como BetterToken	Saldo, preços, chave e endpoint do próprio provedor	Quem precisa de outra relação de pagamento ou endpoint compatível	Modelos, grupo de preço, pagamento, tratamento de dados e política da empresa
Conta Claude revendida ou compartilhada	Acesso controlado por um vendedor	Nenhum uso profissional confiável	Recuperação, atividade de terceiros, confidencialidade e risco de interrupção

Um plano pago do Claude e o Claude Console são produtos e faturas separados. O BetterToken é uma terceira conta: recarregar o saldo não ativa o Pro, e assinar o Pro não cria crédito no BetterToken.

Quanto custa a assinatura do Claude? O Claude Code é pago à parte?

Preços publicados para assinaturas pela web, conferidos em 30 de setembro de 2026:

Plano	Preço publicado	O que observar
Pro	US$ 20 no pagamento mensal ou US$ 200 antecipados por um ano	O plano anual equivale a cerca de US$ 16,67 por mês; o site arredonda para US$ 17. Não se trata de uma cobrança mensal de US$ 17.
Max 5x	US$ 100/mês	Franquia maior, mas não uso ilimitado.
Max 20x	US$ 200/mês	Franquia ainda maior, sujeita aos limites aplicáveis.

Tributos aplicáveis são cobrados à parte e os preços nas lojas de aplicativos podem variar. Antes da compra, consulte os preços atuais e os detalhes de cobrança do Max. Usuários de Team e Enterprise devem verificar os assentos e a cobrança da organização, em vez de presumir que vale o preço de um plano individual.

Uma assinatura Pro ou Max elegível já inclui o Claude Code; não é preciso comprar outra “assinatura do Claude Code” pessoal. Porém, Claude e Claude Code compartilham a franquia do plano, e o pagamento da assinatura não vira saldo da API no Console. Ativar uso adicional pago ou mudar para cobrança por API pode gerar despesas extras. Confira as configurações antes de aceitar, conforme a orientação sobre Pro e Max no Claude Code.

Qual opção de login define onde haverá cobrança?

O menu escolhe mais do que uma interface: ele define a conta e a modalidade de cobrança.

Opção exibida	O que significa
Claude account with subscription	Entrada com uma conta Claude elegível. O uso segue o plano Pro, Max, Team ou Enterprise e as configurações da organização.
Anthropic Console account	Uso da conta oficial do Console e de sua cobrança de API. A assinatura pessoal não recarrega esse saldo.
3rd-party platform	Configuração de uma integração de nuvem compatível, como Amazon Bedrock, Microsoft Foundry ou Vertex AI, com a conta correspondente.

A documentação de autenticação explica essas modalidades. A terceira opção não é um login genérico para qualquer gateway de API. O BetterToken usa a URL base e o token indicados em sua própria documentação.

Procure a cobrança no serviço efetivamente utilizado: faturamento do Claude.ai para a assinatura web, faturamento do Console para a API oficial ou BetterToken Workspace para chamadas pelo BetterToken. O termo de busca claude.console.api não é uma URL base para colar no Claude Code.

Uma variável de ambiente antiga pode causar surpresa. O Claude Code pode selecionar credenciais de API em vez do login de assinatura salvo. No modo não interativo -p, ANTHROPIC_API_KEY é usada quando existe, salvo quando se aplica um método de autenticação de prioridade superior. Confira a prioridade das credenciais, não apenas se você já entrou no Pro antes.

Confira região e pagamento antes de escolher um cartão

A elegibilidade do serviço vem antes da forma de pagamento. A Anthropic publica listas de países para o Claude.ai e para a API comercial. Consulte a lista atual do produto que pretende usar; cartão estrangeiro, telefone ou VPN não mudam por si só a elegibilidade da conta.

Impostos, cartões aceitos, preços das lojas de aplicativos, conversão de moeda e verificações variam por país e conta. Na assinatura oficial, confira a etapa final do checkout do Claude. Na API, revise cobrança e recarga automática no Console. No BetterToken, use os métodos, moeda, câmbio, taxas, mínimo e valor creditado exibidos no fluxo atual, não uma captura antiga.

Observação específica para usuários na Rússia

Em 30 de setembro de 2026, a Rússia não aparecia na página de países compatíveis da Anthropic para o Claude.ai nem para a API comercial. Essa é uma restrição regional, não uma conclusão global. O BetterToken exibe hoje opções de recarga em USD e RUB; métodos e condições finais dependem do checkout. Comece com um valor pequeno permitido e confirme o saldo.

Não resolva um problema de pagamento com uma conta compartilhada

Um acesso revendido pode parecer barato, mas você não controla recuperação, uso simultâneo, segurança ou continuidade. Para código-fonte, use conta e credencial próprias e confira os termos de dados do provedor e a política da sua organização.

Conecte o Claude Code ao BetterToken e confirme a rota

Esta configuração é para um terminal administrado por você. Ela não substitui a política do empregador nem transforma saldo do BetterToken em assinatura do Claude.

1. Crie sua conta, um pequeno saldo e uma API Key

Abra o BetterToken Workspace, leia as condições atuais e adicione apenas saldo de teste. Crie sua própria API Key do BetterToken e, se fizer sentido, defina validade ou limite opcional de gastos. O guia de início rápido cobre conta, saldo e criação da chave.

Não use uma chave da Anthropic nessa configuração. Não coloque a chave do BetterToken no Git, em capturas, tickets ou comandos que fiquem no histórico do shell.

2. Defina no Bash o endpoint documentado

Na nova verificação de 30 de setembro de 2026, os guias em inglês e russo do BetterToken já descrevem a mesma configuração manual: o Anthropic Messages usa a Base URL https://bettertoken.ai sem /v1, e o Claude Code acrescenta /v1/messages. As duas páginas também mandam copiar o Model ID exato do catálogo ao vivo e definir o modelo principal e os três modelos padrão. Para um teste controlado com o Sonnet 5, execute estas linhas no Bash, cole a chave no read oculto e pressione Enter:

export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
export API_TIMEOUT_MS="3000000"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
read -rs ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_AUTH_TOKEN

O ID público exato verificado para este exemplo é claude-sonnet-5. O teste mapeia os aliases Haiku, Sonnet e Opus para o mesmo modelo, evitando uma troca silenciosa. Em produção, você pode usar IDs atuais diferentes do catálogo para cada função. Se uma página em cache ou localizada mostrar campos diferentes, abra novamente o guia atual, remova variáveis conflitantes, reinicie o Claude Code por completo e confirme o modelo e a cobrança no Workspace.

Essas variáveis valem apenas no shell atual. Para manter a configuração, incorpore os mesmos campos ao arquivo existente do Claude Code sem sobrescrever outros ajustes e reinicie o cliente por completo.

3. Execute uma solicitação limitada e encontre o registro

Inicie o Claude Code em uma pasta pequena de teste:

claude

Envie uma mensagem segura:

Não leia arquivos nem use ferramentas. Responda apenas: conexão confirmada.

O primeiro critério é receber uma resposta normal, sem erro de autenticação, conexão ou modelo. O segundo é encontrar no Workspace um registro correspondente com horário, chave, modelo, tokens e cobrança. Criar a chave ou abrir o terminal, sozinho, não prova qual provedor atendeu a chamada.

claude -p muda o modo de execução, não a origem da cobrança

-p é a forma curta de --print: o Claude Code executa a instrução sem interface interativa e imprime o resultado. É útil em scripts, mas não é gratuito nem escolhe uma conta de cobrança automaticamente.

A credencial ativa decide a fatura. ANTHROPIC_API_KEY substitui um login Pro, Max, Team ou Enterprise salvo e é usado no modo -p somente quando não há um provedor ou método de autenticação de maior prioridade. Sem um provedor de maior prioridade ativo, ANTHROPIC_BASE_URL com ANTHROPIC_AUTH_TOKEN envia a solicitação ao gateway configurado. Antes de medir custos, verifique variáveis herdadas e deixe apenas o provedor desejado.

Teste mínimo:

claude -p --max-turns 1 "Não leia arquivos nem use ferramentas. Responda apenas: conexão confirmada."

Para uma tarefa cobrada por API, adicione controles do cliente:

claude -p --max-turns 3 --max-budget-usd 1.00 "Leia apenas o README.md e explique como iniciar o projeto. Não altere arquivos."

--max-turns limita turnos do agente. A referência atual define --max-budget-usd como o gasto máximo com chamadas de API antes de parar no modo print; a aplicação completa do limite aos subagentes exige Claude Code v2.1.217 ou mais recente. Confira claude --version, concilie o resultado com o registro do provedor e consulte a referência atual da CLI.

Compare assinatura e API com as mesmas tarefas reais

Preço de assinatura e tarifa por token não são equivalentes. O plano também cobre os aplicativos do Claude e tem limites compartilhados; a API oferece chaves, automação e uso medido. Compare quanto custa concluir o mesmo trabalho.

Em 30 de setembro de 2026, a página do Sonnet 5 da Anthropic identifica o API ID exato como claude-sonnet-5 e marca o modelo como legado ativo. Os preços-base públicos eram:

Rota	Tokens de entrada — preço-base	Tokens de saída — preço-base	Escopo
Preço oficial da Claude API	US$ 2,00 por 1 milhão de tokens	US$ 10,00 por 1 milhão de tokens	Preço-base global de primeira parte para este modelo exato
Catálogo público Claude do BetterToken	US$ 1,36 por 1 milhão de tokens	US$ 6,80 por 1 milhão de tokens	Preço publicado de claude-sonnet-5 no grupo Claude

Os valores do BetterToken são 68% das tarifas-base da Anthropic — 32% menores para a mesma combinação de tokens de entrada e saída. As páginas oficiais atuais não sustentam que o Sonnet 5 tenha mudado para US$ 3/US$ 15 em 1º de setembro; essas linhas de US$ 3/US$ 15 na tabela da Anthropic pertencem ao Sonnet 4.6 e 4.5. A tabela inclui os custos-base obrigatórios de entrada e saída, mas não todos os itens possíveis da fatura. Cache, ferramentas do servidor, modificadores de residência de dados, descontos negociados, impostos, taxas de recarga ou pagamento, câmbio, grupo de acesso da chave e modelo realmente roteado podem alterar o total. Use o catálogo como estimativa e confirme o débito pelo registro da solicitação; abra novamente os preços oficiais e o catálogo do BetterToken antes de pagar.

Para uma execução, comece por:

custo estimado = tokens_entrada / 1.000.000 × tarifa_entrada
                + tokens_saída / 1.000.000 × tarifa_saída
                + cache, ferramentas e outros encargos aplicáveis

Depois execute de 5 a 10 tarefas representativas e use os registros reais. Se você também usa o chat do Claude todos os dias, compare o total da API com o valor conjunto do Pro ou Max. Para CI, scripts ou tarefas isoladas, pagamento por uso e limite por chave costumam ser mais fáceis de controlar.

Solução de problemas: descubra o destino do pagamento ou da chamada

Sintoma	O que verificar primeiro
Você pagou o Pro, mas apareceu uma cobrança de API	Provedor ativo, variáveis de ambiente de API e conta que registrou a chamada.
A fatura da API não aparece no Claude.ai	Abra o Console oficial ou o BetterToken Workspace, conforme o serviço usado.
401	Validade da chave, espaços extras e correspondência com o provedor.
403 ou modelo indisponível	Permissões da conta e do modelo, disponibilidade do provedor e restrições regionais ou da organização; leia o corpo do erro.
404 ou erro de endereço	Use a URL base documentada e evite duplicar /v1.
429, tempo esgotado ou 5xx	Leia os detalhes de velocidade, cota ou saldo; consulte o histórico antes de repetir uma tarefa que pode já ter sido concluída.
O menu de login continua aparecendo	Confira se o mesmo terminal recebeu o token e se ajustes salvos ou opções de nuvem estão escolhendo outro serviço.

Consulte as orientações de diagnóstico do BetterToken e a documentação de autenticação do Claude Code. Ao pedir ajuda, envie o código de erro, horário e ID da chamada, quando disponível — nunca a chave de API.

Perguntas comuns antes de decidir

Preciso de assinatura e saldo de API ao mesmo tempo?

Só quando precisa dos dois produtos. A assinatura cobre Claude e Claude Code dentro dos limites; Console ou gateway são cobrados à parte para chaves, automação ou uso medido adicional.

Saldo do BetterToken ativa Claude.ai Pro ou Max?

Não. BetterToken, assinaturas do Claude e Console têm cobranças separadas e o saldo não é transferível.

3rd-party platform funciona com qualquer gateway?

Não. Essa opção corresponde a integrações de plataforma documentadas. Um gateway compatível com Anthropic é configurado com seu Base URL e variáveis de autenticação.

Gateway de API é igual a uma conta Claude compartilhada?

Não. Com sua conta e chave, você controla a credencial em vez de usar o login de outra pessoa. O gateway continua no caminho dos dados; revise termos, retenção, suporte e regras da empresa antes de enviar código privado.

O que fazer se a Anthropic não oferecer suporte ao meu país?

Não trate VPN, cartão estrangeiro ou telefone alugado como mudança de elegibilidade. Revise a lista atual da Anthropic e avalie separadamente a conta e os termos de qualquer provedor. Um gateway não torna compatível uma conta oficial não suportada.

Como confirmar qual provedor processou o teste?

Exija uma resposta normal e um registro correspondente na conta de cobrança prevista. Se a cobrança aparecer em outro lugar, revise variáveis, configurações salvas e login antes de executar uma tarefa maior.

Decida com um teste pequeno e mensurável

Escolha o Pro se sua região for compatível, você usar os aplicativos do Claude e programar de forma interativa; compare o Max apenas quando os limites compartilhados do Pro forem o gargalo real. Escolha a API oficial do Console para chaves emitidas diretamente pela Anthropic, automação ou controles organizacionais. Considere o BetterToken se a cobrança separada, os preços atuais e o endpoint compatível fizerem sentido, após revisar dados, termos e disponibilidade.

Comece com uma tarefa de baixo risco, confirme a resposta e a cobrança correspondente e só então aumente o uso. Para o caminho do gateway, abra novamente o guia atual do Claude Code e o catálogo em tempo real antes de criar uma chave de produção.