Início → Guias → Base URL da Anthropic para o Claude Code: definindo ANTHROPIC_BASE_URL do jeito certo

Base URL da Anthropic para o Claude Code: definindo ANTHROPIC_BASE_URL do jeito certo

O Claude Code se conecta ao endereço para onde ANTHROPIC_BASE_URL aponta. A única regra que pega muita gente: ele quer só o host, sem /v1 — o contrário de quase todas as ferramentas no estilo OpenAI.

A resposta curta

Defina duas variáveis de ambiente antes de iniciar o Claude Code:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

O endereço oficial da Anthropic é https://api.anthropic.com; para usar um relay basta substituí-lo. O Claude Code acrescenta /v1/messages sozinho, então a base URL termina no host. Neste gateway, 88% de todo o tráfego Claude dos últimos 30 dias veio do Claude Code configurado exatamente assim.

Onde definir

macOS / Linux — no shell em que você o inicia:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell — só para a janela atual:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json — para que toda sessão use, sem mexer no shell:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

O valor é lido quando o Claude Code inicia. Se mudar, saia e abra uma nova sessão; uma sessão aberta continua com o endereço antigo. ANTHROPIC_AUTH_TOKEN é enviado como Authorization: Bearer; ANTHROPIC_API_KEY, como x-api-key. Este gateway aceita os dois — use um, não os dois.

Teste em um comando

Antes de culpar o Claude Code, verifique o endereço e a chave diretamente:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

Uma resposta em JSON significa que os dois estão certos. text/html ou um 404 significa que a URL está errada; um 401 em JSON significa que a URL está certa e a chave não.

Quando colocar /v1 e quando não

Duas famílias de SDK dividem a URL em pontos diferentes. Clientes no estilo Anthropic acrescentam /v1/messages sozinhos; os no estilo OpenAI esperam /v1 na base URL e acrescentam só /chat/completions:

Cliente	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

Com /v1 no Claude Code, as requisições vão para /v1/v1/messages e retornam 404. Sem /v1 no Cursor, vão para /chat/completions — também 404. Nenhuma chega à API.

Erro de URL ou erro de chave?

• Um erro e nada no seu log de uso → o caminho está errado. Um 404 é respondido na borda da rede e nunca chega à cobrança. Confira o /v1 primeiro.
• 401 com registro no log → a chave está errada, foi revogada ou o saldo acabou.
• Um modelo dá 404 e os outros funcionam com a mesma chave → esse modelo pertence a outro grupo. Cada chave fica presa a um grupo; crie uma segunda para o outro.
• A mudança parece não ter efeito → a variável foi definida em outro shell ou a sessão começou antes.

Escolhendo o modelo

Os nomes de modelo são textos exatos com hífen, nunca ponto — claude-fable-5-1, não claude-fable-5.1. Escolha ao iniciar ou com /model dentro da sessão:

claude --model claude-opus-5-5

Nomes e preços atuais estão na tabela de preços. A configuração de outros clientes está no início rápido, e o app Claude Desktop no guia de apps de desktop.

Comece a usar

Sem assinatura, sem mínimo mensal, sem conversa com vendedor. Recarregue com USDT e gaste o que usar — 1 USDT dá 2 créditos de saldo de API.

Leia o início rápido de 30 segundos

Idioma: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Os preços desta página são preenchidos automaticamente com dados reais de cobrança. Condições de terceiros são citadas da documentação deles.