Resposta curta
Para rodar o Claude Code pela APIVAI, defina duas variáveis de ambiente: ANTHROPIC_BASE_URL="https://api.apivai.com" e ANTHROPIC_AUTH_TOKEN="<sua chave>", e inicie o claude normalmente. O Claude Code aceita qualquer chave de API compatível com a Anthropic via ANTHROPIC_AUTH_TOKEN. O Claude Code em si não muda; as requisições vão para os mesmos modelos Claude e são cobradas de um saldo pré-pago a preços da APIVAI, por exemplo $1.14 / $5.68 por milhão de tokens de entrada / saída para o Claude Sonnet 4.6 (em 2026-11-18), ou seja, 62% abaixo do preço oficial de tabela.
A configuração leva cerca de cinco minutos.
O que é o Claude Code?
O Claude Code é o agente de programação de linha de comando da Anthropic. Você roda dentro da pasta de um projeto, descreve uma tarefa em linguagem natural e ele lê seus arquivos, propõe e faz alterações, executa comandos como testes ou builds e explica o que fez. A Anthropic recomenda o instalador nativo (curl -fsSL https://claude.ai/install.sh | bash no macOS e no Linux, irm https://claude.ai/install.ps1 | iex no Windows PowerShell); o pacote npm @anthropic-ai/claude-code continua funcionando e exige Node.js 22 ou posterior. Ele está documentado na documentação do Claude Code da Anthropic.
Cada passo do Claude Code é uma requisição de API a um modelo Claude, e um agente trabalhando em uma base de código real envia muito contexto em cada requisição. Por isso o preço por token pesa mais no Claude Code do que no uso ocasional do chat. Por padrão, ele é cobrado pela API da Anthropic a preços de tabela ($3.00 / $15.00 por milhão de tokens para o Claude Sonnet 4.6). Para uma visão mais ampla dos números, veja como reduzir o custo do Claude Code e da API do GPT.
Como um provedor de API personalizado funciona com o Claude Code?
O Claude Code lê as configurações de conexão de variáveis de ambiente:
ANTHROPIC_BASE_URL: para onde as requisições vão. Na APIVAI éhttps://api.apivai.com, sem/v1e sem barra no final, porque o Claude Code acrescenta/v1/messagessozinho.ANTHROPIC_AUTH_TOKEN: a chave enviada em cada requisição.
O que muda: o endereço e a chave. O que continua igual: o Claude Code, seus comandos, ferramentas, permissões e os modelos Claude com que ele fala.
Pré-requisitos
- Claude Code instalado (instalador nativo, ou npm com Node.js 22+;
claude --versiondeve mostrar uma versão) - Uma conta na APIVAI com saldo recarregado
- Uma chave de API criada no Dashboard da APIVAI
- Um terminal: bash ou zsh no macOS/Linux, PowerShell ou cmd no Windows
Passo 1: pegue uma chave de API para o Claude Code
- Crie uma conta com seu e-mail e o código de verificação que receber.
- Recarregue o saldo. O mínimo é $10 com cartão ou criptomoedas, ou ¥20 via Alipay / WeChat Pay. Não há assinatura nem mínimo mensal.
- No Dashboard, crie uma chave de API. Dê um nome como "claude-code-laptop" e defina um orçamento. Quando a chave atinge o orçamento ela para de funcionar, então uma sessão descontrolada não consegue gastar todo o seu saldo.
- Copie a chave e mantenha-a em sigilo. Use uma chave por máquina ou por projeto para ver os custos separados e revogar uma sem afetar as outras.
Passo 2: configure o terminal
macOS e Linux
Adicione estas linhas ao perfil do seu shell, ~/.zshrc (padrão no macOS) ou ~/.bashrc:
export ANTHROPIC_BASE_URL="https://api.apivai.com" export ANTHROPIC_AUTH_TOKEN="your-apivai-key"
Recarregue o perfil e inicie o Claude Code:
source ~/.zshrc # ou: source ~/.bashrc claude
Windows PowerShell
Abra seu perfil com notepad $PROFILE (crie o arquivo se o PowerShell disser que ele não existe) e adicione:
$env:ANTHROPIC_BASE_URL = "https://api.apivai.com" $env:ANTHROPIC_AUTH_TOKEN = "your-apivai-key"
Abra uma nova janela do PowerShell e rode claude.
Windows cmd
O setx grava variáveis de ambiente do usuário de forma permanente:
setx ANTHROPIC_BASE_URL "https://api.apivai.com" setx ANTHROPIC_AUTH_TOKEN "your-apivai-key"
O setx não altera a janela em que você o executou; vale para os terminais abertos depois. Feche a janela, abra uma nova e rode claude. Variáveis definidas assim também ficam visíveis para o PowerShell.
Alternativa: o arquivo de configurações do Claude Code
Em vez de variáveis do shell, você pode colocá-las no arquivo de configurações de usuário do Claude Code, ~/.claude/settings.json (no Windows, %USERPROFILE%\.claude\settings.json), dentro de um objeto env:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apivai.com",
"ANTHROPIC_AUTH_TOKEN": "your-apivai-key"
}
}Se o arquivo já existir, acrescente o bloco env em vez de substituir o arquivo. Assim a configuração vale só para o Claude Code. Os caminhos dos arquivos e a precedência podem mudar entre versões, então veja a documentação de configurações do Claude Code da Anthropic para os detalhes atuais.
Passo 3: verifique a chave antes de iniciar o Claude Code
Uma requisição direta mostra se a chave, a URL e a sua rede estão ok, antes de o Claude Code entrar em cena. No macOS/Linux, com as variáveis do passo 2 carregadas:
curl https://api.apivai.com/v1/messages \
-H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"Say hello"}]}'No PowerShell:
$body = '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"Say hello"}]}'
Invoke-RestMethod -Uri "https://api.apivai.com/v1/messages" -Method Post -ContentType "application/json" -Headers @{ "x-api-key" = $env:ANTHROPIC_AUTH_TOKEN; "anthropic-version" = "2023-06-01" } -Body $bodyUma resposta JSON com um campo content significa que está tudo funcionando, e a requisição aparece no seu Dashboard em instantes. Um código de erro leva à linha correspondente na tabela de solução de problemas abaixo. Repare que a URL do teste contém /v1/messages, enquanto ANTHROPIC_BASE_URL não deve conter.
Como escolho e troco de modelo?
Digite /model dentro do Claude Code para escolher o modelo da sessão atual. As principais opções, em 2026-11-18 (lista completa na página de preços):
| Modelo | Preço APIVAI por 1M (entrada / saída) | Bom para |
|---|---|---|
| Claude Fable 5.1 | $3.97 / $19.87 | Os problemas mais difíceis, tarefas autônomas longas |
| Claude Opus 5.5 | $1.52 / $7.57 | Programação complexa, refatorações, análise |
| Claude Sonnet 5.5 | $0.75 / $3.79 | Programação do dia a dia: o padrão recomendado |
| Claude Sonnet 4.6 | $1.14 / $5.68 | Amplamente suportado; o Sonnet 5.5 é mais novo e mais barato |
| Claude Haiku 4.5 | $0.38 / $1.89 | Edições rápidas e perguntas simples |
Um padrão prático: comece no Sonnet, mude para o Opus com /model quando uma tarefa travar ou precisar de raciocínio mais profundo, e volte quando estiver resolvida.
Como mantenho baixo o custo do Claude Code?
- Use o Sonnet no trabalho de rotina. A maioria das alterações, testes e explicações não precisa do Opus nem do Fable, e o Sonnet custa uma fração deles por token.
- Compacte as sessões longas. O Claude Code tem um comando
/compactque resume a conversa até ali, para que as requisições seguintes levem menos contexto. Use quando uma sessão ficar longa, ou abra uma sessão nova para uma tarefa nova (veja a documentação da Anthropic para o comportamento atual dos comandos). - Deixe o prompt caching trabalhar. O Claude Code coloca em cache automaticamente o contexto repetido, como prompts de sistema e arquivos. A entrada em cache é cobrada pela tarifa de leitura de cache ($0.11 por 1M para o Claude Sonnet 4.6), bem abaixo da entrada normal.
- Defina um orçamento por chave. Uma chave para ao atingir o orçamento, o que limita o custo de cada máquina, projeto ou colega.
- Acompanhe o Dashboard. Cada requisição aparece com modelo, tokens e custo, para você ver quais sessões estão caras.
Usando o Codex CLI com a mesma chave
A mesma chave da APIVAI funciona com o Codex CLI da OpenAI, que usa o formato OpenAI com /v1 na base URL. Para o Codex 0.121 e posteriores, coloque isto em ~/.codex/config.toml (no Windows, %USERPROFILE%\.codex\config.toml):
model = "gpt-6.1-sol" model_provider = "apivai" [model_providers.apivai] name = "APIVAI" base_url = "https://api.apivai.com/v1" env_key = "OPENAI_API_KEY" wire_api = "responses"
Depois defina a chave e inicie o Codex:
export OPENAI_API_KEY="your-apivai-key" codex
A mesma ideia funciona no Cursor; veja o guia de configuração do Cursor.
Solução de problemas
| Sintoma | Causa provável | Solução |
|---|---|---|
| 401 Unauthorized | Chave errada ou excluída | Copie a chave de novo no Dashboard |
| 402 insufficient_quota | O orçamento da chave acabou, ou está baixo demais para este modelo | Adicione orçamento à chave (recarregue antes se o saldo estiver zerado) ou use um modelo mais barato |
| 401 mesmo com a chave correta | O Claude Code está enviando outra credencial: uma ANTHROPIC_API_KEY antiga, um apiKeyHelper ou uma sessão de /login (/status mostra qual está ativa) | Remova a que sobrou, por exemplo: unset ANTHROPIC_API_KEY (bash/zsh), Remove-Item Env:ANTHROPIC_API_KEY (PowerShell), e tire-a dos perfis ou das configurações |
| 404 Not Found | A base URL contém /v1 ou um erro de digitação | Use exatamente https://api.apivai.com no Claude Code; /v1 só para ferramentas no formato OpenAI, como o Codex |
| 429 Too Many Requests | Mais de 60 requisições por minuto em uma chave | Espere um pouco ou divida o trabalho entre várias chaves |
| O Claude Code continua usando a conta antiga | As variáveis não estão carregadas neste terminal | Abra um terminal novo; confira com echo $ANTHROPIC_BASE_URL ou echo $env:ANTHROPIC_BASE_URL |
| Timeouts ou erros de conexão | Um proxy, firewall ou inspeção TLS na sua rede | Libere api.apivai.com, ou defina o proxy da sua rede em HTTPS_PROXY (veja a documentação da Anthropic sobre o suporte a proxy no Claude Code) |
Se um problema persistir, rode o teste com curl do passo 3; ele separa problemas de chave e de rede da configuração do Claude Code. A documentação lista todos os endpoints e erros.
Todos os códigos de erro da API e suas soluções estão reunidos em códigos de erro da API do Claude.
Quanto custa o Claude Code por mês?
Considerando cerca de 4.000 tokens de entrada e 1.500 de saída por mensagem com o Claude Sonnet 4.6, ao longo de 30 dias, em 2026-11-18:
| Uso diário | API oficial | APIVAI |
|---|---|---|
| Leve (10 mensagens/dia) | $10.35 | $3.92 |
| Médio (30 mensagens/dia) | $31.05 | $11.77 |
| Intenso (100 mensagens/dia) | $104 | $39.24 |
Esses números ignoram o prompt caching, que costuma reduzir ainda mais a conta real. Sessões de agente em repositórios grandes podem enviar muito mais contexto por mensagem, então confira seu Dashboard depois dos primeiros dias. Os preços atuais estão na página de preços; para comparar com ferramentas por assinatura, veja o custo do Claude Code vs. Cursor.
FAQ
Preciso de uma conta na Anthropic para usar o Claude Code assim?
Não é preciso chave de API da Anthropic. O Claude Code envia as requisições para a base URL que você definir e se autentica com a sua chave da APIVAI.
O modelo é o mesmo da API oficial?
Sim. As requisições passam para os modelos Claude que você escolher com /model; só o endereço e a cobrança mudam.
Posso voltar para a minha conta da Anthropic?
Sim. Remova ou comente as duas variáveis (ou o bloco env no settings.json) e abra um terminal novo.
A APIVAI vê o meu código?
A APIVAI não armazena nem inspeciona o conteúdo das requisições ou das respostas. Ela guarda apenas metadados de uso (modelo, contagem de tokens, custo, horário) para cobrança.
O que acontece quando o saldo ou o orçamento da chave acaba?
As requisições retornam 402 até você recarregar ou aumentar o orçamento da chave. Nada é cobrado além do seu saldo pré-pago.
Uma chave serve para o Claude Code e o Codex ao mesmo tempo?
Sim. Uma chave funciona com o formato Anthropic (https://api.apivai.com) e com os formatos OpenAI (https://api.apivai.com/v1).