← Blog
Claude CodeTutorialGuia de configuração

Claude Code com API própria: configurar Base URL e chave

· Atualizado (os preços do texto seguem a tabela de preços atual)

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 /v1 e sem barra no final, porque o Claude Code acrescenta /v1/messages sozinho.
  • 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 --version deve 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

  1. Crie uma conta com seu e-mail e o código de verificação que receber.
  2. 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.
  3. 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.
  4. 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 $body

Uma 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):

ModeloPreço APIVAI por 1M (entrada / saída)Bom para
Claude Fable 5.1$3.97 / $19.87Os problemas mais difíceis, tarefas autônomas longas
Claude Opus 5.5$1.52 / $7.57Programação complexa, refatorações, análise
Claude Sonnet 5.5$0.75 / $3.79Programação do dia a dia: o padrão recomendado
Claude Sonnet 4.6$1.14 / $5.68Amplamente suportado; o Sonnet 5.5 é mais novo e mais barato
Claude Haiku 4.5$0.38 / $1.89Ediçõ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 /compact que 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

SintomaCausa provávelSolução
401 UnauthorizedChave errada ou excluídaCopie a chave de novo no Dashboard
402 insufficient_quotaO orçamento da chave acabou, ou está baixo demais para este modeloAdicione orçamento à chave (recarregue antes se o saldo estiver zerado) ou use um modelo mais barato
401 mesmo com a chave corretaO 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 FoundA base URL contém /v1 ou um erro de digitaçãoUse exatamente https://api.apivai.com no Claude Code; /v1 só para ferramentas no formato OpenAI, como o Codex
429 Too Many RequestsMais de 60 requisições por minuto em uma chaveEspere um pouco ou divida o trabalho entre várias chaves
O Claude Code continua usando a conta antigaAs variáveis não estão carregadas neste terminalAbra um terminal novo; confira com echo $ANTHROPIC_BASE_URL ou echo $env:ANTHROPIC_BASE_URL
Timeouts ou erros de conexãoUm proxy, firewall ou inspeção TLS na sua redeLibere 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árioAPI oficialAPIVAI
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).

Pronto para começar?

Obtenha sua chave de API em 30 segundos. Pague pelo uso do Claude e do GPT.

Começar