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

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) message = client.messages.create( model="claude-opus-4.6", max_tokens=1024, messages=[ {"role": "user", "content": "Write a fizzbuzz in Python."} ], ) print(message.content)

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) with client.messages.stream( model="claude-opus-4.6", max_tokens=1024, messages=[ {"role": "user", "content": "Tell me a short story."} ], ) as stream: for text in stream.text_stream: print(text, end="", flush=True) print()

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) response = client.chat.completions.create( model="gpt-5.4", messages=[ {"role": "user", "content": "Hello from CKEY"} ], ) print(response.choices[0].message.content)

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) stream = client.chat.completions.create( model="gpt-5.4", stream=True, messages=[ {"role": "user", "content": "Write a short poem."} ], ) for chunk in stream: delta = chunk.choices[0].delta.content or "" if delta: print(delta, end="", flush=True) print()

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const message = await client.messages.create({ model: "claude-opus-4.6", max_tokens: 1024, messages: [{ role: "user", content: "Write a fizzbuzz in Python." }], }); console.log(message.content);

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const stream = client.messages .stream({ model: "claude-opus-4.6", max_tokens: 1024, messages: [{ role: "user", content: "Tell me a short story." }], }) .on("text", (text) => { process.stdout.write(text); }); await stream.finalMessage(); process.stdout.write("\n");

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const response = await client.chat.completions.create({ model: "gpt-5.4", messages: [{ role: "user", content: "Hello from CKEY" }], }); console.log(response.choices[0]?.message?.content);

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const stream = await client.chat.completions.create({ model: "gpt-5.4", stream: true, messages: [{ role: "user", content: "Write a short poem." }], }); for await (const chunk of stream) { const delta = chunk.choices[0]?.delta?.content ?? ""; if (delta) { process.stdout.write(delta); } } process.stdout.write("\n");

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model":"claude-opus-4.6", "max_tokens":1024, "messages":[ {"role":"user","content":"Write a fizzbuzz in Python."} ] }'

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --no-buffer \ -d '{ "model":"claude-opus-4.6", "max_tokens":1024, "stream":true, "messages":[ {"role":"user","content":"Tell me a short story."} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"gpt-5.4", "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ --no-buffer \ -d '{ "model":"gpt-5.4", "stream":true, "messages":[ {"role":"user","content":"Write a short poem."} ] }'

curl "https://api.xah.io/v1beta/models/gemini-2.5-flash-lite:generateContent" \ -H "Content-Type: application/json" \ -H "x-goog-api-key: sk-YOUR_API_KEY" \ -d '{ "contents":[ {"role":"user","parts":[{"text":"Write a fizzbuzz in Python."}]} ] }'

curl https://api.xah.io/api/chat \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"qwen3.8-27b", "stream":false, "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/api/generate \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"qwen3.8-27b", "prompt":"Hello from CKEY", "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-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-4.6
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-4.6",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

Modelos recomendados

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

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-4.6
Rota: messages or chat/completions
Máximo de tokens: 1024

Continue

name: CKEY API
version: 1.0.0
schema: v1
models:
  - name: claude-opus-4.6
    provider: anthropic
    model: claude-opus-4.6
    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-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-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-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-4.6
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-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-sonnet-4.6": {
                    "name": "claude-sonnet-4.6"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                },
                "deepseek-v4-flash": {
                    "name": "deepseek-v4-flash"
                }
            }
        }
    },
    "model": "ckey/claude-opus-4.6",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-4.6"
        }
    }
}

Modelos recomendados

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

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-flash",
                        "name": "deepseek-v4-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-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

SDKs

Requisição na API da Anthropic

Streaming na API da Anthropic

Requisição compatível com OpenAI

Streaming compatível com OpenAI

Requisição na API da Anthropic

Streaming na API da Anthropic

Requisição compatível com OpenAI

Streaming compatível com OpenAI

Requisição na API da Anthropic

Streaming na API da Anthropic

Requisição compatível com OpenAI

Streaming compatível com OpenAI

Requisição no Gemini (Google)

Requisição no Ollama

Ollama Generate (/api/generate)

Enviar uma imagem local como base64

Enviar uma URL de imagem

URL base

Modelo

Chave de API

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