Configuração da API LLM para Cursor, Claude Code, Codex

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/chat/completions \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "messages": [{"role": "user", "content": "Hello"}], "stream": false }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/completions \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Hello", "max_tokens": 256 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/messages \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -d '{ "model": "MODEL", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "A red fox in snow", "n": 1, "size": "1024x1024" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Turn the reference into a watercolor illustration", "image_url": "https://example.com/reference.png", "n": 1, "size": "1024x1024" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/audio/speech \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": "Hello from CKEY", "voice": "alloy", "response_format": "mp3" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/videos/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "A gentle camera move across a mountain", "seconds": 8 } # Poll: GET https://api.xah.io/v1/videos/JOB_ID'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v2/video_generation \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "content": [{"type": "text", "text": "A gentle camera move across a mountain"}], "duration": 6, "ratio": "16:9" } # Poll: GET https://api.xah.io/v2/query/video_generation/JOB_ID # Cancel: DELETE https://api.xah.io/v2/video_generation/JOB_ID'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/embeddings \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": ["first text", "second text"] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/rerank \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "query": "latest AI news", "documents": ["doc A", "doc B"], "top_n": 2 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/moderations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": "Text to classify" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/search \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "query": "latest AI news", "max_results": 5 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1beta/models/MODEL:generateContent \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "contents": [{"role": "user", "parts": [{"text": "Hello"}]}] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/api/chat \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "messages": [{"role": "user", "content": "Hello"}], "stream": false }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/api/generate \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Hello", "stream": false }'

OpenAI-compatible chat/completions /v1

Cursor

O Cursor deve usar o caminho compatível com OpenAI com uma chave de API personalizada e URL base personalizada.

Valores necessários

Provider: OpenAI-compatible
Chave de API: sk-YOUR_API_KEY
URL base: https://api.xah.io/v1
Modelo: gpt-5.4
Rota: chat/completions
Exigência do plano: Requer um plano do Cursor que suporte endpoints de API personalizados.

Etapas recomendadas

1Abra as Configurações do Cursor e vá em IA / Modelos / Chaves de API.
2Ative a chave OpenAI personalizada ou a opção de provider personalizado da sua versão.
3Cole a chave de API e a URL base mostradas abaixo.
4Escolha o modelo sugerido ou outro modelo atualmente ativo.

Bloco pronto para copiar

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Modelos recomendados

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-v4.1-flash

Observações

O Cursor usa o fluxo compatível com OpenAI, por isso a URL base deve incluir `/v1`.
Se um modelo falhar no Cursor, mude para outro modelo ativo compatível com OpenAI.
Depois de salvar, envie um prompt curto para confirmar que `chat/completions` funciona.

Anthropic-compatible messages root URL

Claude Code

O Claude Code deve ser configurado pelas variáveis de ambiente da Anthropic, mas a URL base deve permanecer no domínio raiz.

Instalar o Claude Code

macOS / Linux / Windows (Node 18+): npm install -g @anthropic-ai/claude-code
Após a instalação, execute `claude` para verificar. As configurações são salvas em `~/.claude/settings.json`.
Linux / macOS: `~/.claude/settings.json`
Windows: `%USERPROFILE%\.claude\settings.json`

Valores necessários

Chave de API: sk-YOUR_API_KEY
URL base: https://api.xah.io
Modelo: claude-opus-5
Rota: messages
Máximo de tokens: 1024

Observações

`ANTHROPIC_BASE_URL` não deve incluir `/v1`.
Prefira um modelo que suporte a rota `messages`.
Se o Claude Code pedir autorização primeiro, conclua esse login uma vez e reabra com estas variáveis de ambiente.
Requisições enviadas pela rota `messages` devem incluir o campo `max_tokens`.

Sessão temporária do shell

export ANTHROPIC_BASE_URL="https://api.xah.io"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
claude --bare

Sessão temporária do PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.xah.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_API_KEY"
claude --bare

Configurações permanentes

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.xah.io",
        "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

Modelos recomendados

claude-opus-5
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-4.6

OpenAI-compatible VS Code /v1

Extensões do VS Code

A maioria das extensões do VS Code funciona melhor no modo compatível com OpenAI com uma URL base personalizada.

Valores necessários

Provider: OpenAI-compatible
Chave de API: sk-YOUR_API_KEY
URL base: https://api.xah.io/v1
Modelo: claude-opus-5
Rota: messages or chat/completions
Máximo de tokens: 1024

Continue

name: CKEY API
version: 1.0.0
schema: v1
models:
  - name: claude-opus-5
    provider: anthropic
    model: claude-opus-5
    apiBase: https://api.xah.io/v1
    apiKey: sk-YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

Cline

Use o provider compatível com OpenAI, a URL base `/v1` e sua chave de API do Console.

Roo Code

Use o provider compatível com OpenAI, a URL base `/v1` e sua chave de API do Console.

Kilo Code

Use o provider compatível com OpenAI, a URL base `/v1` e sua chave de API do Console.

Modelos recomendados

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-v4.1-flash

Observações

Use o provider compatível com OpenAI, a URL base `/v1` e sua chave de API do Console.
O Cursor usa o fluxo compatível com OpenAI, por isso a URL base deve incluir `/v1`.
Depois de salvar, envie um prompt curto para confirmar que `chat/completions` funciona.
Requisições enviadas pela rota `messages` devem incluir o campo `max_tokens`.

OpenAI-compatible ~/.codex /v1

Codex CLI

A extensão Codex para VS Code suporta API compatível com OpenAI com URL base e chave de API personalizadas.

Instalar o Codex CLI

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
Após a instalação, execute `codex` para verificar. O Codex lê a autenticação de `~/.codex/auth.json` e a configuração de `~/.codex/config.toml`.
Config: `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`)
Auth: `~/.codex/auth.json` (Windows: `%USERPROFILE%\.codex\auth.json`)

Valores necessários

Provider: OpenAI-compatible
Chave de API: sk-YOUR_API_KEY
URL base: https://api.xah.io/v1
Modelo: gpt-5.4
Rota: chat/completions

Etapas recomendadas

1Instale a extensão Codex pela VS Code Marketplace.
2Abra as Configurações do VS Code e procure pela configuração do Codex.
3Informe sua chave de API e URL base nas configurações do Codex.
4Selecione um modelo da lista de modelos ativos.

Conteúdo de `~/.codex/config.toml`

model = "gpt-5.4"
model_reasoning_effort = "xhigh"
personality = "pragmatic"

openai_base_url = "https://api.xah.io/v1"

Conteúdo de `~/.codex/auth.json`

{
    "auth_mode": "apikey",
    "OPENAI_API_KEY": "sk-YOUR_API_KEY"
}

Modelos recomendados

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-v4.1-flash

Observações

O Codex usa endpoints compatíveis com OpenAI, por isso a URL base deve incluir /v1.
Após a configuração, recarregue o VS Code para aplicar as alterações.
Teste abrindo um arquivo de código e conversando com o Codex.

OpenAI-compatible ~/.factory /v1

Factory Droid

O Factory Droid é um assistente de CLI que permite configurar modelos personalizados por meio de um arquivo `settings.json`.

Instalar o Droid CLI

macOS / Linux: curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
Após a instalação, execute `droid` para verificar.
Linux / macOS: `~/.factory/settings.json`
Windows: `%USERPROFILE%\.factory\settings.json`

Valores necessários

Provider: openai
Chave de API: sk-YOUR_API_KEY
URL base: https://api.xah.io/v1
Modelo: gpt-5.4
Rota: chat/completions

Observações

Cada entrada em `customModels` precisa de um `id` exclusivo e um `index` crescente (0, 1, 2...).
Defina `provider` como `openai` para que o Droid use o fluxo compatível com OpenAI.
Você pode adicionar mais modelos duplicando o objeto dentro do array e alterando `model` + `id`.

Conteúdo de `~/.factory/settings.json`

{
    "customModels": [
        {
            "model": "gpt-5.4",
            "id": "custom:ckey-0",
            "index": 0,
            "baseUrl": "https://api.xah.io/v1",
            "apiKey": "sk-YOUR_API_KEY",
            "displayName": "gpt-5.4",
            "maxOutputTokens": 131072,
            "noImageSupport": false,
            "provider": "openai"
        }
    ]
}

Modelos recomendados

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-v4.1-flash

Anthropic-compatible JSONC /v1

OpenCode

O OpenCode pode apontar o provider Anthropic para o seu endpoint e usar a mesma chave de API.

Instalar o OpenCode

Instale via npm: npm install -g opencode-ai
Após a instalação, execute `opencode` para verificar. A configuração fica em `~/.config/opencode/opencode.json` (ou `.jsonc`).

Caminho da configuração

Windows: `%USERPROFILE%\.config\opencode\opencode.json`
Linux / macOS: `~/.config/opencode/opencode.json`

Valores necessários

Chave de API: sk-YOUR_API_KEY
URL base: https://api.xah.io/v1
Modelo: claude-opus-5
Rota: messages
Máximo de tokens: 1024

Bloco pronto para copiar

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "ckey": {
            "npm": "@ai-sdk/openai-compatible",
            "options": {
                "baseURL": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY"
            },
            "models": {
                "claude-opus-5": {
                    "name": "claude-opus-5"
                },
                "claude-opus-4.6": {
                    "name": "claude-opus-4.6"
                },
                "claude-opus-4.7": {
                    "name": "claude-opus-4.7"
                },
                "claude-opus-4.8": {
                    "name": "claude-opus-4.8"
                },
                "claude-opus-5-5": {
                    "name": "claude-opus-5-5"
                },
                "claude-sonnet-4.6": {
                    "name": "claude-sonnet-4.6"
                }
            }
        }
    },
    "model": "ckey/claude-opus-5",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-5"
        }
    }
}

Modelos recomendados

claude-opus-5
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-4.6

Observações

O OpenCode deve apontar para o endpoint com `/v1`.
Prefira um modelo Claude ativo se o seu fluxo de trabalho usa ferramentas no estilo Anthropic.
Se você mudar o modelo em outro lugar da configuração, mantenha os mesmos valores de URL base e chave de API.
Requisições enviadas pela rota `messages` devem incluir o campo `max_tokens`.

OpenAI-compatible openclaw.json /v1

OpenClaw

O OpenClaw pode usar um provider compatível com OpenAI por meio de `openclaw.json` com um alias de provider `ckey`.

Caminho da configuração

Raiz do projeto: `./openclaw.json`
Windows: `%USERPROFILE%\.openclaw\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

Valores necessários

Provider: ckey / OpenAI-compatible
Chave de API: sk-YOUR_API_KEY
URL base: https://api.xah.io/v1
Modelo: ckey/gpt-5.4
Rota: chat/completions

Bloco pronto para copiar

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "ckey/gpt-5.4"
            }
        }
    },
    "models": {
        "providers": {
            "ckey": {
                "baseUrl": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gpt-5.4",
                        "name": "gpt-5.4"
                    },
                    {
                        "id": "claude-opus-4.6",
                        "name": "claude-opus-4.6"
                    },
                    {
                        "id": "claude-opus-4.7",
                        "name": "claude-opus-4.7"
                    },
                    {
                        "id": "claude-opus-4.8",
                        "name": "claude-opus-4.8"
                    },
                    {
                        "id": "claude-sonnet-4.6",
                        "name": "claude-sonnet-4.6"
                    },
                    {
                        "id": "deepseek-v4.1-flash",
                        "name": "deepseek-v4.1-flash"
                    }
                ]
            }
        }
    }
}

Modelos recomendados

ckey/gpt-5.4
ckey/claude-opus-4.6
ckey/claude-opus-4.7
ckey/claude-opus-4.8
ckey/claude-sonnet-4.6
ckey/deepseek-v4.1-flash

Observações

O OpenClaw deve usar `baseUrl` com `/v1`.
Mantenha `api` como `openai-completions` para o fluxo compatível com OpenAI.
Você pode adicionar ou remover modelos da lista, mas mantenha o alias `ckey/` e os valores de chave de API alinhados ao exemplo.

Configure cada cliente da maneira certa

Antes de configurar

Regras da URL base

Endpoints and commands

Text / hội thoại

Images

Audio

Video (task / async)

Embeddings / ranking / safety / search

Native provider routes

Cursor

Valores necessários

Etapas recomendadas

Bloco pronto para copiar

Modelos recomendados

Observações

Claude Code

Instalar o Claude Code

Valores necessários

Observações

Sessão temporária do shell

Sessão temporária do PowerShell

Configurações permanentes

Modelos recomendados

Extensões do VS Code

Valores necessários

Continue

Cline

Roo Code

Kilo Code

Modelos recomendados

Observações

Codex CLI

Instalar o Codex CLI

Valores necessários

Etapas recomendadas

Conteúdo de `~/.codex/config.toml`

Conteúdo de `~/.codex/auth.json`

Modelos recomendados

Observações

Factory Droid

Instalar o Droid CLI

Valores necessários

Observações

Conteúdo de `~/.factory/settings.json`

Modelos recomendados

OpenCode

Instalar o OpenCode

Caminho da configuração

Valores necessários

Bloco pronto para copiar

Modelos recomendados

Observações

OpenClaw

Caminho da configuração

Valores necessários

Bloco pronto para copiar

Modelos recomendados

Observações