Resposta curta
Sim, dá para usar o Claude Code sem assinatura Claude Pro ou Max: basta dar a ele uma chave de API e pagar por token. Com a APIVAI, defina ANTHROPIC_BASE_URL como https://api.apivai.com (sem /v1) e ANTHROPIC_AUTH_TOKEN com sua chave da APIVAI, depois rode claude; essa chave tem prioridade sobre um login do claude.ai. Cada sessão é cobrada de um saldo pré-pago, por exemplo $1.15 / $5.74 por milhão de tokens de entrada / saída no Claude Sonnet 4.6 em 2026-10-10, sem mensalidade e sem limite semanal. Pagar por token costuma sair mais barato com uso leve ou irregular, enquanto a assinatura pode custar menos se você usa o Claude Code várias horas todos os dias.
Dá para usar o Claude Code sem Claude Pro ou Max?
Sim. A documentação de autenticação do Claude Code lista várias formas de autenticar: assinatura Claude Pro ou Max, Claude for Teams ou Enterprise, uma conta do Claude Console cobrada pela API, provedores de nuvem e credenciais em variáveis de ambiente. A assinatura é uma dessas opções, não um requisito. (O plano Free não inclui o Claude Code; o claude.com/pricing diz que «Claude Code is included in all paid plans».)
Quando o Claude Code se autentica com uma chave de API, cada requisição é cobrada por tokens de entrada e saída, em vez de contar nos limites de um plano. O Claude Code em si não muda: os mesmos comandos, ferramentas, permissões e o seletor /model. Você pode usar uma chave do Console aos preços oficiais da Anthropic ou um proxy da API do Claude como a APIVAI, que aceita as mesmas requisições no formato Anthropic com preço por token menor na maioria dos modelos.
Como o Claude Code escolhe entre a assinatura e uma chave de API?
Segundo a documentação de autenticação (consultada em outubro de 2026), quando há várias credenciais o Claude Code usa a primeira que encontrar nesta ordem:
- Credenciais de provedor de nuvem, quando
CLAUDE_CODE_USE_BEDROCK,CLAUDE_CODE_USE_VERTEXouCLAUDE_CODE_USE_FOUNDRYestá definida ANTHROPIC_AUTH_TOKEN, enviada no cabeçalhoAuthorization: Bearere pensada para gateways e proxiesANTHROPIC_API_KEY, enviada no cabeçalhoX-Api-Key; no modo interativo o Claude Code pede sua aprovação uma vez- A saída de um script
apiKeyHelper CLAUDE_CODE_OAUTH_TOKEN, um token de longa duração gerado porclaude setup-tokenque usa sua assinatura- Perfis da Anthropic e credenciais federadas
- O login da assinatura feito com
/login
Na prática:
- Com
ANTHROPIC_AUTH_TOKENdefinida, o Claude Code usa essa chave mesmo que você também esteja logado no Pro ou Max. As requisições não consomem os limites do plano. - Se você tem assinatura e também define
ANTHROPIC_API_KEY, o Claude Code usa a chave depois que você aprova. Dá para mudar essa escolha depois no botão «Use custom API key» em/config. - Digite
/statuspara ver qual credencial está ativa. Quando há um login e uma chave configurados, o/statusmarca a que não está em uso.
## Como configurar o Claude Code com uma chave pré-paga?
Esta é a versão curta; o guia completo de configuração do Claude Code cobre Windows cmd, a alternativa com settings.json e um teste com curl.
- Crie uma conta, recarregue o saldo (a partir de $10, sem assinatura) e crie uma chave no Dashboard. Defina um limite de orçamento para a chave, assim uma única sessão não consegue gastar todo o saldo.
- Defina duas variáveis de ambiente. No macOS ou Linux, adicione-as ao
~/.zshrcou~/.bashrc:
export ANTHROPIC_BASE_URL="https://api.apivai.com" export ANTHROPIC_AUTH_TOKEN="your-apivai-key"
No PowerShell, adicione-as ao seu perfil (notepad $PROFILE):
$env:ANTHROPIC_BASE_URL = "https://api.apivai.com" $env:ANTHROPIC_AUTH_TOKEN = "your-apivai-key"
- Abra um terminal novo, rode
claudee depois/statuspara confirmar que a credencial ativa é o token do seu ambiente. - Escolha um modelo com
/model.
| Configuração | Valor |
|---|---|
ANTHROPIC_BASE_URL | https://api.apivai.com (sem /v1 e sem barra no final; o Claude Code adiciona /v1/messages sozinho) |
ANTHROPIC_AUTH_TOKEN | Sua chave da APIVAI |
ANTHROPIC_API_KEY | Deixe sem definir, para haver só uma chave em jogo |
Quer manter a assinatura também? Deixe o claude comum no login do claude.ai e crie um alias que define as variáveis só para um comando, por exemplo no bash ou zsh:
alias claude-api='ANTHROPIC_BASE_URL="https://api.apivai.com" ANTHROPIC_AUTH_TOKEN="your-apivai-key" claude'
Assim o claude usa o plano e o claude-api cobra por token, o que ajuda quando o limite acaba no meio de uma tarefa.
Quanto custam o Claude Pro e o Max e quais limites eles descrevem?
Conforme o claude.com/pricing em outubro de 2026 (preços sem impostos):
| Plano | Preço | Uso conforme a página |
|---|---|---|
| Pro | $20 por mês no plano mensal, ou $17 por mês no anual ($200 adiantados) | «at least 5x more usage per 5-hour session than Free»; inclui o Claude Code |
| Max | A partir de $100 por mês, nas opções 5x e 20x | «5x or 20x more usage per 5-hour session than Pro»; também lista créditos mensais de API para a Claude Platform |
A página explica os limites assim: «Every plan has usage limits that reset on a rolling five-hour session window, and paid plans add weekly limits on top». Ao atingir um limite, você pode esperar o reset, mudar para um plano maior ou, nos planos pagos, ativar usage credits para «keep working at standard API rates». A página não converte esses limites em tokens, então qualquer comparação com a cobrança por token é uma estimativa.
Quanto custa o Claude Code pagando por token?
O Claude Code envia muito contexto a cada passo: o prompt de sistema, as definições de ferramentas, os arquivos que leu e a conversa até ali. Nos exemplos abaixo supomos que uma hora de trabalho ativo são cerca de 40 requisições, cada uma com uns 40.000 tokens de entrada e 1.000 de saída. São suposições, não medições: repositórios grandes e sessões longas enviam mais, tarefas pequenas menos. Consideramos 22 dias úteis por mês.
| Uso (com Claude Sonnet 4.6) | Requisições por mês | API oficial | APIVAI |
|---|---|---|---|
| Ocasional: 8 horas por mês | 320 | $43.20 | $16.56 |
| Regular: 1 hora por dia útil | 880 | $119 | $45.53 |
| Intenso: 4 horas por dia útil | 3.520 | $475 | $182 |
O mesmo mês intenso no Claude Opus 5.5 sairia por $244 na APIVAI ($634 pelo preço oficial).
Esses números ignoram o cache de prompts, então trate-os como teto. O Claude Code mantém o contexto estável para que as partes repetidas entrem em cache automaticamente. No Claude Sonnet 4.6 na APIVAI, a leitura de cache custa $0.12 por 1M de tokens e a escrita $1.44, contra $1.15 da entrada normal. Como estimativa grosseira, se cerca de 80% da entrada de uma sessão vier do cache, a parte de entrada da conta cai para mais ou menos um terço do valor sem cache.
Quando a assinatura sai mais barata e quando o pagamento por token compensa?
Pagar por token costuma ganhar quando:
- Seu uso é leve ou irregular. Uma semana sem programar não custa nada; a assinatura cobra todo mês.
- Uma equipe divide um orçamento. Um saldo, uma chave por pessoa ou projeto, cada uma com seu próprio limite.
- Você também usa modelos GPT. A mesma chave e o mesmo saldo funcionam em ferramentas no formato OpenAI, como o Codex CLI; veja como reduzir os custos do Claude Code e da API do GPT.
- Você não quer janelas de cinco horas nem tetos semanais. Os limites são o saldo, o orçamento da chave e 60 requisições por minuto por chave (o suporte pode aumentar).
A assinatura pode ser mais barata quando:
- Você usa o Claude Code por horas todos os dias, principalmente com modelos Opus ou tarefas autônomas longas. Se a sua estimativa por token passa bem de $100 por mês e você fica dentro dos limites do plano, um preço fixo é difícil de bater.
- Você também usa os apps do Claude na web, no desktop ou no celular, que o plano cobre e a chave de API não.
- Você depende de recursos ligados ao login do claude.ai, como as sessões na nuvem.
Um teste prático: pague por token durante uma semana, veja o total no Dashboard, multiplique por cerca de 4,3 e compare com $20 ou $100. Para uma comparação mais ampla com Cursor e Codex CLI, leia Claude Code vs Cursor: custo real.
Qual modelo usar com orçamento por token?
Preços por 1M de tokens na APIVAI em 2026-10-10; a lista completa está na página de preços:
| Modelo | Entrada / saída | Indicado para |
|---|---|---|
| Claude Sonnet 4.6 | $1.15 / $5.74 | Programação do dia a dia, a escolha mais popular |
| Claude Sonnet 5.5 | $0.77 / $3.82 | Programação do dia a dia com um modelo mais novo |
| Claude Opus 5.5 | $1.54 / $7.65 | Bugs difíceis, grandes refatorações |
| Claude Haiku 4.5 | $0.38 / $1.92 | Perguntas simples, a opção mais barata |
Comece no Sonnet e mude para o Opus com /model quando uma tarefa empacar. Os IDs dos modelos mudam com o tempo, então pegue-os na página de preços.
Solução de problemas
| Sintoma | Causa provável | Solução |
|---|---|---|
| O Claude Code continua gastando os limites do Pro ou Max | As variáveis não estão carregadas neste terminal | Abra um terminal novo, rode /status e veja qual credencial está ativa |
| «Login expired · Please run /login» | O Claude Code está usando um login do claude.ai, não sua chave | Carregue as variáveis (terminal novo ou alias) em vez de fazer login de novo |
| 401 Unauthorized | Chave errada ou excluída, saldo zerado ou orçamento da chave esgotado | Copie a chave de novo no Dashboard, recarregue ou aumente o orçamento da chave |
| 401 mesmo com a chave certa | Sobrou um ANTHROPIC_API_KEY ou uma chave antiga no settings.json | Remova a credencial extra para ficar só o ANTHROPIC_AUTH_TOKEN |
| 404 Not Found | /v1 ou erro de digitação na base URL | Use exatamente https://api.apivai.com |
| 429 Too Many Requests | Mais de 60 requisições por minuto em uma chave | Aguarde um pouco ou peça ao suporte um limite maior |
Perguntas frequentes
Preciso do Claude Pro para usar o Claude Code?
Não. O Claude Code também funciona com uma chave de API cobrada por token. Defina ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN e ele roda sem nenhum plano.
Posso manter o Pro ou o Max e usar uma chave de API também?
Sim. Use um alias como claude-api que define as variáveis só para um comando e confira com /status qual credencial cada sessão usa.
Pagar por token é mais barato que o Claude Max?
Depende do volume. Com poucas horas por semana costuma ser mais barato; com várias horas de Opus todo dia, o Max pode custar menos se você ficar dentro dos limites dele. Compare uma semana de dados reais do Dashboard com o preço do plano.
Existem limites semanais com chave de API?
Não há janelas de cinco horas nem tetos semanais. O uso é limitado pelo saldo, pelo orçamento que você definir na chave e, por padrão, por 60 requisições por minuto por chave.
Posso usar modelos GPT com o mesmo saldo?
Sim, em ferramentas no formato OpenAI como o Codex CLI, com a base URL https://api.apivai.com/v1. O Claude Code em si trabalha com modelos Claude.
Crie uma conta, recarregue a partir de $10 e cole sua chave no Claude Code.