Como apontar o Claude Code para outra base URL

O Claude Code fala o protocolo da API da Anthropic. Ele não exige que o endpoint seja o oficial: basta apontar a variável de ambiente da base URL para outro endereço que aceite o mesmo formato. É assim que se usa o Claude Code com um gateway próprio, com controle de chave e de consumo.

As duas variáveis que importam

O Claude Code lê a base URL e o token do ambiente. No PowerShell, as duas linhas abaixo valem para a sessão atual do terminal:

$env:ANTHROPIC_BASE_URL = "https://api.devhubbrasil.com"
$env:ANTHROPIC_AUTH_TOKEN = "dh_SUA_CHAVE"

No bash ou zsh a forma equivalente usa export. A base URL é a raiz do host, sem /v1 no final: o próprio protocolo da Anthropic acrescenta o prefixo nas chamadas.

export ANTHROPIC_BASE_URL="https://api.devhubbrasil.com"
export ANTHROPIC_AUTH_TOKEN="dh_SUA_CHAVE"

Por que a base URL não leva /v1

É o erro mais comum. O cliente OpenAI acrescenta /v1 às chamadas, então para ele a base termina em /v1. O cliente Anthropic não faz isso no mesmo ponto, portanto a base dele é a raiz. Trocar as duas produz um 404 imediato, não uma resposta errada, o que ajuda a diagnosticar.

Como conferir que a conexão funciona

Antes de abrir o Claude Code, faça uma chamada mínima. Se o modelo responder, o problema restante está na ferramenta e não na chave. O comando abaixo lista o catálogo disponível para a sua chave:

curl https://api.devhubbrasil.com/v1/models \
  -H "Authorization: Bearer dh_SUA_CHAVE"

Uma resposta com a lista de modelos confirma chave válida e passe ativo. Um 401 indica chave errada; um 402 indica que o passe expirou ou não foi ativado.

Trocar de modelo sem trocar de ferramenta

O modelo é escolhido por chamada, não pela configuração da base URL. Isso significa que você pode começar com um modelo barato para explorar o repositório e recorrer a um modelo maior apenas na etapa difícil, sem reconfigurar nada.

Ver todos os modelos do catálogo →