MandAPI

Claude Code erro 404: corrija URL, rota e modelo

Um 404 Not Found prova que algum servidor respondeu, mas não encontrou a rota ou o recurso solicitado. As causas comuns são uma base diferente da fornecida pela equipe do gateway e um identificador de modelo que o gateway não oferece. Na MandAPI, a base correta é a raiz indicada abaixo, sem acrescentar /v1.

Configuração correta da MandAPI

O valor de ANTHROPIC_BASE_URL é a base, sem /v1 no final:

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

Se você usar https://api.mandapi.com/v1, o cliente pode montar uma rota com /v1 duplicado. Corrija o arquivo e abra um terminal novo.

Golden Path para confirmar a correção

  1. Cadastre-se na MandAPI.
  2. Crie uma chave.
  3. Salve a configuração acima em ~/.claude/settings.json ou %USERPROFILE%\.claude\settings.json.
  4. Teste o modelo validado pela MandAPI:
curl -sS -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":"."}]}'
  1. Faça a prova ponta a ponta:
claude -p "Responda apenas: rota ok"

Resultado esperado: o teste direto retorna uma resposta JSON Anthropic e o Claude Code produz uma resposta normal, sem erro de autenticação, rota ou modelo. O texto pode ser semelhante a rota ok, mas não precisa ser idêntico.

Separe erro de rota de erro de modelo

Sintoma Causa provável Ação
Toda chamada retorna 404 Base ou rota errada Remova /v1 da base
Só um modelo retorna 404 ID inexistente Use apenas um ID Claude validado pela MandAPI
O host não resolve DNS ou rede Verifique domínio, VPN e proxy
Retorna 401 Token ou header Siga o guia de 401

Não escolha o modelo pela memória. Use o ID Claude validado pela MandAPI no exemplo abaixo:

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

O que não fazer

  • Na MandAPI, use https://api.mandapi.com como ANTHROPIC_BASE_URL, sem acrescentar /v1 ou /v1/messages. Para outro gateway, use exatamente a base fornecida pela equipe responsável, inclusive quando ela tiver um prefixo de caminho.
  • Não troque a chave repetidamente quando o status é 404; autenticação inválida normalmente aparece como 401.
  • Não confunda timeout ou ENOTFOUND com 404; nesses casos nem houve uma resposta HTTP válida.
  • Não exponha a chave ao compartilhar o corpo de settings.json.

Se ainda houver dúvida, siga o teste de conexão em seis camadas e pare na primeira camada que falhar.

Abrir o painel de chaves MandAPI