PRIMEIROS PASSOS

Sua chave chegou. Vamos ligar.

Em 2 minutos você usa o Claude Code ou o Claude Desktop com a sua chave lunax_sk_…. Você só precisa de duas coisas:

URL base: https://api.lunaxcore.com — sem /v1 no final, porque o programa acrescenta essa parte sozinho.
Sua chave: a que você recebeu na compra (começa com lunax_sk_). Guarde em local seguro — ela não é mostrada de novo.

1Claude Code no terminal

No macOS ou Linux, cole no terminal trocando lunax_sk_SUA_CHAVE pela sua chave:

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

Para não repetir sempre, adicione as duas linhas export ao final de ~/.zshrc ou ~/.bashrc. No Windows (PowerShell):

setx ANTHROPIC_BASE_URL "https://api.lunaxcore.com"
setx ANTHROPIC_API_KEY "lunax_sk_SUA_CHAVE"

Feche e abra o terminal depois do setx.

2Claude Code no app do computador

O aplicativo de computador lê o mesmo arquivo de configurações do terminal. Abra (ou crie) ~/.claude/settings.json — no Windows, %USERPROFILE%\.claude\settings.json — e salve o bloco abaixo com a sua chave:

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

Feche o aplicativo por completo e abra de novo. Para conferir, rode /status: devem aparecer a linha Anthropic base URL e a chave de API.

3Claude Desktop (o app de conversa)

Aqui o ajuste é dentro do próprio aplicativo. Abra o menu, escolha Help → Troubleshooting → Enable Developer Mode e depois Developer → Configure Third-Party Inference. Na tela que abre, selecione o tipo Gateway e preencha:

Gateway base URL:    https://api.lunaxcore.com
Gateway API key:     lunax_sk_SUA_CHAVE
Gateway auth scheme: Bearer

Confirme em Apply Changes e reinicie o aplicativo. A lista de modelos vem sozinha; se algum programa não conseguir buscá-la, digite o nome do modelo manualmente (ex.: claude-sonnet-4-5).

4Teste rápido com curl

Se aparecer uma lista de modelos, sua chave está funcionando:

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

E uma mensagem de verdade:

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":64,"messages":[{"role":"user","content":"Olá"}]}'

5Deu erro de autenticação?

401 authentication_error — confira se copiou a chave inteira, sem espaços ou aspas sobrando, e se a URL base é https://api.lunaxcore.com. Rode echo $ANTHROPIC_API_KEY para ver o que o terminal está usando. Chaves expiradas ou revogadas também dão 401.
Ainda pede login da Anthropic — o programa não leu as variáveis: abra um terminal novo, ou feche e reabra o aplicativo depois de salvar o settings.json.
404 ou caminho duplicado — a base levou /v1 onde não devia. Deixe só https://api.lunaxcore.com; o /v1 vale apenas para chamadas diretas como o curl acima.
403 permission_error — o modelo não está liberado para a sua chave, ou sua chave só aceita certos IPs.
429 — limite de tokens do plano ou de chamadas por minuto atingido; aguarde ou fale com quem vendeu a chave.

Nada resolveu? Envie ao seu fornecedor os primeiros 12 caracteres da chave (nunca a chave inteira) e a mensagem de erro.