MandAPI

Como configurar ANTHROPIC_BASE_URL no Claude Code

ANTHROPIC_BASE_URL informa ao Claude Code qual servidor deve receber as requisições. Na MandAPI, o valor é https://api.mandapi.com, sem acrescentar /v1. Em outro gateway, use exatamente a base fornecida pela equipe responsável; ela pode incluir um prefixo de caminho.

Antes de começar

Você precisa de uma conta, uma chave ativa e o Claude Code instalado. O fluxo completo leva poucos minutos:

  1. Crie sua conta MandAPI.
  2. Acesse Chaves de API e gere uma chave.
  3. Configure as duas variáveis abaixo.
  4. Teste o endpoint e depois o Claude Code.

Configuração copiável

Crie ou edite o arquivo de configuração do usuário:

  • macOS e Linux: ~/.claude/settings.json
  • Windows: %USERPROFILE%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.mandapi.com",
    "ANTHROPIC_AUTH_TOKEN": "COLE_SUA_CHAVE_MANDAPI_AQUI"
  }
}

Salve o arquivo e abra um terminal novo. O arquivo precisa ser JSON válido: sem comentários, sem vírgula depois do último campo e com aspas duplas.

Teste 1: endpoint e autenticação

No macOS, Linux ou WSL:

export ANTHROPIC_BASE_URL="https://api.mandapi.com"
export ANTHROPIC_AUTH_TOKEN="COLE_SUA_CHAVE_MANDAPI_AQUI"

curl -sS -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

No PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.mandapi.com"
$env:ANTHROPIC_AUTH_TOKEN = "COLE_SUA_CHAVE_MANDAPI_AQUI"

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ Authorization = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

Resultado esperado: uma resposta JSON Anthropic. Uma mensagem de modelo desconhecido ainda prova que URL e credencial passaram; 401 exige revisar a chave. Um teste de modelo completo só passa depois de usar o ID Claude validado pela MandAPI.

Teste 2: Claude Code ponta a ponta

claude -p "Responda apenas: MandAPI conectada"

Resultado esperado: uma resposta normal do modelo, sem erro de autenticação, rota ou modelo. Ela pode ser semelhante a MandAPI conectada, mas não precisa ser idêntica. Dentro de uma sessão interativa, /status ajuda a conferir qual base e qual método de autenticação foram carregados.

Windows, macOS e Linux: o que muda

O conteúdo do settings.json é o mesmo nos três sistemas. Mudam apenas o caminho do arquivo e a sintaxe usada para definir variáveis temporárias no terminal. Prefira o arquivo de usuário para não salvar credenciais dentro de um projeto Git.

Erros frequentes

  • https://api.mandapi.com/v1 como base: remova /v1.
  • Editar o arquivo e continuar no mesmo terminal: abra uma sessão nova.
  • JSON inválido: valide chaves, vírgulas e aspas.
  • Duas credenciais concorrentes: remova uma ANTHROPIC_API_KEY antiga ao usar o token MandAPI.
  • Chave exposta em commit: revogue-a imediatamente e gere outra.

Leia como resolver 401, como resolver 404 ou execute o diagnóstico completo.

Criar conta e começar com a MandAPI