Como testar a conexão da API no Claude Code

Quando a primeira chamada falha, trocar tudo ao mesmo tempo esconde a causa. Esta escada testa uma camada por vez: CLI, DNS, HTTP, autenticação, modelo e chamada ponta a ponta. Pare no primeiro erro.

Prepare a MandAPI

1. Crie uma conta MandAPI.
2. Gere uma chave de API.
3. Configure ANTHROPIC_BASE_URL como https://api.mandapi.com e use a chave em ANTHROPIC_AUTH_TOKEN.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.mandapi.com",
    "ANTHROPIC_AUTH_TOKEN": "COLE_SUA_CHAVE_MANDAPI_AQUI"
  }
}

Nível 1: o CLI existe?

claude --version

Resultado esperado: um número de versão. command not found é instalação ou PATH, não é problema da API.

Nível 2: o DNS resolve?

macOS/Linux:

nslookup api.mandapi.com

PowerShell:

Resolve-DnsName api.mandapi.com

Resultado esperado: pelo menos um endereço IP. ENOTFOUND aponta para DNS, VPN ou proxy.

Nível 3: a rota Anthropic responde?

curl -sS -o response.json -w "%{http_code}\n" \
  -X POST https://api.mandapi.com/v1/messages \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

Resultado esperado sem credencial: 401. Aqui, 401 é um bom sinal: o host e a rota Anthropic existem e exigem autenticação. 000 indica falha de rede; 404 indica rota errada.

Nível 4: a chave funciona?

curl -sS -o response.json -w "%{http_code}\n" \
  -X POST https://api.mandapi.com/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":"."}]}'

PowerShell:

Invoke-WebRequest -Method Post -Uri "https://api.mandapi.com/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 para URL e autenticação: uma resposta JSON Anthropic; até um erro de modelo desconhecido mostra que a credencial foi aceita. 401 exige revisar a chave. O Golden Path completo requer 200 com um modelo Claude realmente validado pela MandAPI.

Nível 5: o modelo existe?

Use o ID Claude verificado pela MandAPI. Não invente nem adapte o nome:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.mandapi.com",
    "ANTHROPIC_AUTH_TOKEN": "COLE_SUA_CHAVE_MANDAPI_AQUI",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

Nível 6: teste ponta a ponta

claude -p "Responda apenas: conexão completa"

Resultado esperado: uma resposta normal do modelo, sem erro de autenticação, rota ou modelo. Ela pode ser semelhante a conexão completa, mas não precisa ser idêntica. Esse teste exercita cliente, rede, token e modelo real.

Interprete o primeiro erro

Para revisar a base, siga como configurar ANTHROPIC_BASE_URL.

Criar conta MandAPI e executar o teste