DOCUMENTAÇÃO NEXA
Configure em 2 minutos.
Com a sua chave NEXA você conecta o Claude Code, o OpenCode ou qualquer app compatível com a API da OpenAI ou da Anthropic. Sem instalação complicada: aponte a URL base, cole a chave e pronto.
$env:ANTHROPIC_BASE_URL = "https://cloudnexapro.site/api/public" $env:ANTHROPIC_AUTH_TOKEN = "SUA_CHAVE_sk-nx" claude
Primeiros passos
Do pagamento à primeira resposta em quatro passos.
Na página inicial, escolha um pacote de tokens ou um plano por período. Assim que o pagamento é aprovado, a sua chave sk-nx-… é gerada automaticamente.
A chave aparece na tela após a aprovação e fica sempre disponível no painel Minha chave. Guarde-a em local seguro — ela é o seu acesso.
Abrir o painelO setx grava as variáveis no seu usuário. Feche e abra o terminal depois — o terminal aberto não enxerga a mudança.
>setx ANTHROPIC_BASE_URL "https://cloudnexapro.site/api/public" >setx ANTHROPIC_API_KEY "sk-nx-SUA_CHAVE"
O primeiro comando responde uma linha e sai — se aparecer "oi", está tudo certo. O segundo abre o Claude Code na pasta do seu projeto. Na primeira vez ele pergunta se quer usar a chave do ambiente: responda Yes.
>claude -p "responda só: oi">cd $HOME\projeto >claude --model claude-opus-5.5
/logout dentro do Claude Code, saia e abra de novo — senão ele ignora a chave do ambiente.Teste rápido
Confirme em segundos que a sua chave está ativa, direto do terminal.
curl https://cloudnexapro.site/api/public/v1/chat/completions \
-H "Authorization: Bearer SUA_CHAVE_sk-nx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"messages": [{ "role": "user", "content": "Olá!" }]
}'Modelos
Família Claude disponível no gateway. Use o nome exato no parâmetro model.
| Modelo | Perfil | Indicado para |
|---|---|---|
claude-opus-5-5 | Padrão | Projetos complexos, refatorações grandes e raciocínio profundo |
claude-fable-5-1 | Criativo | Escrita, ideias e geração de conteúdo |
claude-sonnet-5-5 | Rápido | Tarefas do dia a dia com resposta ágil |
Endpoints
O gateway fala os dois protocolos: Anthropic (Claude Code) e OpenAI (OpenCode e apps em geral).
| Método | Caminho | Protocolo |
|---|---|---|
| POST | https://cloudnexapro.site/api/public/v1/messages | Anthropic — usado pelo Claude Code |
| POST | https://cloudnexapro.site/api/public/v1/chat/completions | OpenAI — usado pelo OpenCode e apps compatíveis |
| POST | https://cloudnexapro.site/api/public/v1/responses | OpenAI Responses — usado pelo Codex |
| GET | https://cloudnexapro.site/api/public/v1/models | Lista os modelos disponíveis |
Authorization: Bearer SUA_CHAVE (protocolo OpenAI) ou x-api-key / variável ANTHROPIC_AUTH_TOKEN (protocolo Anthropic).Claude Code
O terminal oficial da Anthropic, apontado para o gateway NEXA. No PowerShell, na pasta do projeto:
$env:ANTHROPIC_BASE_URL = "https://cloudnexapro.site/api/public" $env:ANTHROPIC_AUTH_TOKEN = "SUA_CHAVE_sk-nx" claude
Dentro dele, rode /model e escolha o modelo, por exemplo claude-sonnet-5-5. Use sempre na mesma janela do PowerShell em que definiu as duas variáveis.
OpenCode
Instale, crie o arquivo de configuração na pasta do projeto e selecione o provedor NEXA.
npm install -g --allow-scripts=opencode-ai opencode-ai $env:NEXA_API_KEY = "SUA_CHAVE_sk-nx"
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"nexa": {
"npm": "@ai-sdk/openai-compatible",
"name": "NEXA API",
"options": {
"baseURL": "https://cloudnexapro.site/api/public/v1",
"apiKey": "{env:NEXA_API_KEY}"
},
"models": {
"claude-sonnet-5-5": { "name": "claude-sonnet-5-5" }
}
}
}
}Abra o OpenCode com opencode, rode /models e selecione NEXA API → claude-sonnet-5-5.
Codex
Configuração do OpenAI Codex CLI/app com a Responses API da NEXA.
model = "claude-sonnet-5-5" model_provider = "nexa" [model_providers.nexa] name = "NEXA" base_url = "https://cloudnexapro.site/api/public/v1" experimental_bearer_token = "SUA_CHAVE_sk-nx" wire_api = "responses"
Erros comuns
Os códigos que o gateway pode devolver e o que fazer em cada caso.
| Código | Motivo | Como resolver |
|---|---|---|
401 | Chave inválida ou ausente | Confira se copiou a chave completa, começando com sk-nx- |
403 | Chave bloqueada ou limite de dispositivos | O acesso é individual: até 2 dispositivos. Fale com o suporte se o uso for legítimo |
429 | Limite de pedidos por minuto | Aguarde alguns segundos e tente de novo — o gateway tenta outro fornecedor automaticamente |
524 | O fornecedor demorou demais para responder | Repita o pedido; o gateway alterna para um fornecedor disponível |
Seu próximo commit começa aqui.
Escolha um plano, cole a chave no Claude Code ou no OpenCode e continue programando.
