MandAPI

Como configurar o Claude Code com uma API

Parte do guia completo: Claude Code com MandAPI.

Para usar o Claude Code com uma API, você precisa dizer a ele como autenticar e para onde enviar as requisições. No caso mais simples (API oficial da Anthropic), basta uma chave. Se você usa um gateway ou provedor alternativo, precisa de um endpoint (ANTHROPIC_BASE_URL) e de um token (ANTHROPIC_AUTH_TOKEN).

Configuração rápida

A forma recomendada é gravar as credenciais no settings.json do Claude Code, bloco env, para que valham em todos os projetos:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://seu-gateway.exemplo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-sua-chave-aqui"
  }
}
  • macOS / Linux: ~/.claude/settings.json
  • Windows: C:\Users\<seu-usuario>\.claude\settings.json

Se você usa a API oficial direta (não um gateway), troque ANTHROPIC_AUTH_TOKEN por ANTHROPIC_API_KEY. Veja a diferença em ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY.

O que você precisa

  • Claude Code instalado (claude --version retorna a versão).
  • Uma credencial válida:
  • API oficial: ANTHROPIC_API_KEY (criada em console.anthropic.com).
  • Gateway/provider: ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN (fornecidos pelo provedor).
  • Um editor de texto para editar settings.json.
  • Para MandAPI, use https://api.mandapi.com como ANTHROPIC_BASE_URL e gere o token em https://app.mandapi.com/keys.

Como configurar passo a passo

  1. Localize ou crie o arquivo settings.json no caminho do seu sistema (acima).
  2. Adicione o bloco env com ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN (gateway) ou ANTHROPIC_API_KEY (oficial).
  3. Salve o arquivo.
  4. Abra um novo terminal — configurações não se aplicam à sessão já aberta.
  5. Rode claude e confirme a autenticação.

Precedência de configuração

Se houver conflitos, a ordem é: variável de ambiente do shell > settings.json de projeto (.claude/settings.json) > settings.json de usuário (~/.claude/settings.json).

Nunca coloque credenciais no settings.json de projeto que vá para o Git — ele é compartilhado com quem clonar o repositório. Use sempre o nível de usuário ou variáveis de ambiente.

Windows

No Windows, o caminho é C:\Users\<seu-usuario>\.claude\settings.json. Se o Claude Code roda dentro do WSL, use o caminho ~/.claude/settings.json do próprio WSL. Para pular o login oficial em algumas integrações, defina hasCompletedOnboarding: true no %USERPROFILE%\.claude.json.

macOS

~/.claude/settings.json (Zsh é o shell padrão). Após salvar, um novo terminal é suficiente para aplicar — não é necessário source para o settings.json.

Linux

~/.claude/settings.json. Requer Node 18+ apenas se você instalou via npm; o instalador nativo não depende de Node.

Como verificar se funcionou

Dentro do Claude Code, rode:

/status

O comando mostra o método de autenticação ativo, o ANTHROPIC_BASE_URL e o modelo. Se aparecer erro de autenticação, vá para erro 401.

Você também pode disparar uma resposta de teste:

claude -p "digite oi"

Se retornar "oi" (ou equivalente), a cadeia instalação → config → API está OK. Passo a passo completo em teste de conexão.

Erros comuns

  • 401 Unauthorized — chave errada, expirada ou com espaço. Veja erro 401.
  • 404 Not Found — URL final com /v1/v1/... (o BASE_URL já trazia /v1) ou endpoint/path errado. Veja erro 404.
  • "There's an issue with the selected model" — mensagem genérica que agrupa erro de modelo, auth e rede.

FAQ

Preciso usar a API oficial ou posso usar outro provedor? Pode usar qualquer endpoint compatível com a API Anthropic. É só definir ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN.

A configuração vale para todos os projetos? Sim, se gravada no settings.json de usuário. Por projeto, use .claude/settings.json local.

Posso usar login por assinatura (Pro/Max) em vez de API key? Sim. Nesse caso não defina ANTHROPIC_API_KEY; o OAuth cuida da autenticação.