DOCUMENTAÇÃO

Conectar ao Lunax Gateway

Você precisa de uma chave lunax_sk_… fornecida pelo administrador.

Claude Code (terminal, app ou extensão)

A base não leva /v1: o Claude Code acrescenta esse trecho sozinho.

export ANTHROPIC_BASE_URL=https://api.lunaxcore.com
export ANTHROPIC_API_KEY=lunax_sk_sua_chave
claude

Para valer em toda abertura, coloque as duas variáveis no bloco env de ~/.claude/settings.json — terminal, app de computador e extensões leem o mesmo arquivo.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lunaxcore.com",
    "ANTHROPIC_API_KEY": "lunax_sk_sua_chave"
  }
}

Claude Desktop

Em Help → Troubleshooting → Enable Developer Mode, abra Developer → Configure Third-Party Inference e escolha Gateway: base https://api.lunaxcore.com, a sua chave como Gateway API key e o esquema Bearer. A lista de modelos vem sozinha.

Chamada direta

curl https://api.lunaxcore.com/v1/messages \
  -H "x-api-key: lunax_sk_sua_chave" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-5","max_tokens":256,"messages":[{"role":"user","content":"Olá"}]}'

Listar modelos liberados

curl https://api.lunaxcore.com/v1/models -H "x-api-key: lunax_sk_sua_chave"

Restrição por IP

O administrador pode limitar sua chave a IPs específicos (IPv4, IPv6 ou faixas CIDR como 10.0.0.0/24). Sem lista, qualquer origem é aceita. Chamadas de fora da lista recebem 403:

{"type":"error","error":{"type":"permission_error","message":"request origin IP is not allowed for this key"}}

Erros comuns