Cómo configurar la 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-5", 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-5", 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-5", 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-5", 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-5", "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-5", "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":"glm-5.2", "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":"glm-5.2", "prompt":"Hello from CKEY", "stream":false }'

OpenAI-compatible chat/completions /v1

Cursor

Cursor debe usar el modo compatible con OpenAI con una API key personalizada y una Base URL personalizada.

Valores necesarios

Proveedor: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modelo: deepseek-v4-flash-0731
Ruta: chat/completions
Requisito del plan: Se requiere un plan de Cursor que admita endpoints de API personalizados.

Pasos recomendados

1Abre los ajustes de Cursor y ve a AI / Models / API Keys.
2Activa la opción de API key de OpenAI personalizada o de proveedor personalizado si tu versión de Cursor la llama de otra forma.
3Pega la API key y la Base URL que se muestran abajo.
4Elige el modelo sugerido u otro modelo activo en la tabla de precios.

Bloque de configuración listo para copiar

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: deepseek-v4-flash-0731
Route: chat/completions

Modelos recomendados

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Notas

Cursor usa el flujo compatible con OpenAI, así que la Base URL debe incluir `/v1`.
Si un modelo falla dentro de Cursor, prueba con otro modelo compatible con OpenAI de la lista de activos.
Después de guardar, prueba con un prompt corto para confirmar que funciona la ruta `chat/completions`.

Anthropic-compatible messages root URL

Claude Code

Claude Code debe configurarse mediante variables de entorno de Anthropic, pero la Base URL debe quedar en el dominio raíz.

Instalar Claude Code

macOS / Linux / Windows (Node 18+): npm install -g @anthropic-ai/claude-code
Después de instalar, ejecuta `claude` para confirmarlo. La configuración se guarda en `~/.claude/settings.json`.
Linux / macOS: `~/.claude/settings.json`
Windows: `%USERPROFILE%\.claude\settings.json`

Valores necesarios

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io
Modelo: claude-opus-5
Ruta: messages
Max tokens: 1024

Notas

`ANTHROPIC_BASE_URL` no debe incluir `/v1`.
Prefiere un modelo que admita la ruta `messages`.
Si Claude Code te pide iniciar sesión primero, completa ese paso una vez y vuelve a abrirlo con las variables de entorno de abajo.
Los requests enviados por la ruta `messages` deben incluir el campo `max_tokens`.

Sesión de terminal temporal

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

Sesión temporal de PowerShell

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

Configuración persistente

{
    "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
gpt-5.4
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

OpenAI-compatible VS Code /v1

Extensiones de VS Code

La mayoría de las extensiones de VS Code funcionan mejor en modo compatible con OpenAI con una Base URL personalizada.

Valores necesarios

Proveedor: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modelo: claude-opus-5
Ruta: messages or chat/completions
Max 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

Usa el proveedor compatible con OpenAI: la Base URL con `/v1` y tu API key desde la consola.

Roo Code

Usa el proveedor compatible con OpenAI: la Base URL con `/v1` y tu API key desde la consola.

Kilo Code

Usa el proveedor compatible con OpenAI: la Base URL con `/v1` y tu API key desde la consola.

Modelos recomendados

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Notas

Usa el proveedor compatible con OpenAI: la Base URL con `/v1` y tu API key desde la consola.
Cursor usa el flujo compatible con OpenAI, así que la Base URL debe incluir `/v1`.
Después de guardar, prueba con un prompt corto para confirmar que funciona la ruta `chat/completions`.
Los requests enviados por la ruta `messages` deben incluir el campo `max_tokens`.

OpenAI-compatible ~/.codex /v1

Codex CLI

La extensión Codex para VS Code admite la API compatible con OpenAI con Base URL y API key personalizadas.

Instalar Codex CLI

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
Después de instalar, ejecuta `codex` para comprobarlo. Codex lee la autenticación de `~/.codex/auth.json` y la config de `~/.codex/config.toml`.
Config: `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`)
Auth: `~/.codex/auth.json` (Windows: `%USERPROFILE%\.codex\auth.json`)

Valores necesarios

Proveedor: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modelo: deepseek-v4-flash-0731
Ruta: chat/completions

Pasos recomendados

1Instala la extensión Codex desde el Marketplace de VS Code.
2Abre los ajustes de VS Code y busca la configuración de Codex.
3Completa la API Key y la Base URL en la configuración de Codex.
4Elige un modelo de la lista de modelos activos.

Contenido de `~/.codex/config.toml`

model = "deepseek-v4-flash-0731"
model_reasoning_effort = "high"
personality = "pragmatic"

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

Contenido de `~/.codex/auth.json`

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

Modelos recomendados

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Notas

Codex usa endpoints compatibles con OpenAI, por lo que la Base URL debe incluir /v1.
Después de configurar, recarga VS Code para aplicar los cambios.
Prueba abriendo un archivo de código e intentando chatear con Codex.

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid es un asistente CLI que permite configurar modelos personalizados mediante el archivo `settings.json`.

Instalar Droid CLI

macOS / Linux: curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
Después de instalar, ejecuta `droid` para comprobarlo.
Linux / macOS: `~/.factory/settings.json`
Windows: `%USERPROFILE%\.factory\settings.json`

Valores necesarios

Proveedor: openai
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modelo: deepseek-v4-flash-0731
Ruta: chat/completions

Notas

Cada entrada en `customModels` necesita un `id` único y un `index` creciente (0, 1, 2...).
Define `provider` como `openai` para que Droid use el flujo compatible con OpenAI.
Puedes agregar más modelos duplicando el objeto dentro del arreglo y cambiando `model` + `id`.

Contenido de `~/.factory/settings.json`

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

Modelos recomendados

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Anthropic-compatible JSONC /v1

OpenCode

OpenCode puede apuntar su proveedor Anthropic a tu endpoint y usar la misma API key.

Instalar OpenCode

Instalar con npm: npm install -g opencode-ai
Después de instalar, ejecuta `opencode` para comprobarlo. La config está en `~/.config/opencode/opencode.json` (o `.jsonc`).

Ruta de la config

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

Valores necesarios

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modelo: claude-opus-5
Ruta: messages
Max tokens: 1024

Bloque de configuración listo 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"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                },
                "deepseek-v4-flash": {
                    "name": "deepseek-v4-flash"
                },
                "gpt-5.5": {
                    "name": "gpt-5.5"
                },
                "claude-haiku-4.5": {
                    "name": "claude-haiku-4.5"
                },
                "claude-opus-4.6": {
                    "name": "claude-opus-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
gpt-5.4
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Notas

OpenCode debe apuntar al endpoint con `/v1`.
Prefiere un modelo Claude activo si tu flujo de trabajo espera herramientas de estilo Anthropic.
Si cambias el modelo en otro lugar de la config, mantén los mismos valores de Base URL y API key que abajo.
Los requests enviados por la ruta `messages` deben incluir el campo `max_tokens`.

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw puede usar un proveedor compatible con OpenAI a través del archivo `openclaw.json` con el alias de proveedor `ckey`.

Ruta de la config

Raíz del proyecto: `./openclaw.json`
Windows: `%USERPROFILE%\.openclaw\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

Valores necesarios

Proveedor: ckey / OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modelo: ckey/gpt-5.4
Ruta: chat/completions

Bloque de configuración listo 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-5",
                        "name": "claude-opus-5"
                    },
                    {
                        "id": "deepseek-v4-flash",
                        "name": "deepseek-v4-flash"
                    },
                    {
                        "id": "gpt-5.5",
                        "name": "gpt-5.5"
                    },
                    {
                        "id": "claude-haiku-4.5",
                        "name": "claude-haiku-4.5"
                    },
                    {
                        "id": "claude-opus-4.6",
                        "name": "claude-opus-4.6"
                    }
                ]
            }
        }
    }
}

Modelos recomendados

ckey/gpt-5.4
ckey/claude-opus-5
ckey/deepseek-v4-flash
ckey/gpt-5.5
ckey/claude-haiku-4.5
ckey/claude-opus-4.6

Notas

OpenClaw debe usar `baseUrl` con `/v1`.
Mantén `api` como `openai-completions` para seguir el flujo compatible con OpenAI.
Puedes agregar o quitar modelos de la lista, pero el alias `ckey/` y la API key deben mantenerse tal como en el ejemplo.

Configura cada cliente de la forma correcta

Preparativos antes de configurar

Reglas de la Base URL

SDKs

Request a la API de Anthropic

Streaming de la API de Anthropic

Request compatible con OpenAI

Streaming compatible con OpenAI

Request a la API de Anthropic

Streaming de la API de Anthropic

Request compatible con OpenAI

Streaming compatible con OpenAI

Request a la API de Anthropic

Streaming de la API de Anthropic

Request compatible con OpenAI

Streaming compatible con OpenAI

Request Gemini (Google)

Request Ollama

Ollama Generate (/api/generate)

Enviar una imagen local en base64

Enviar una imagen por URL

Base URL

Modelo

API Key

Cursor

Valores necesarios

Pasos recomendados

Bloque de configuración listo para copiar

Modelos recomendados

Notas

Claude Code

Instalar Claude Code

Valores necesarios

Notas

Sesión de terminal temporal

Sesión temporal de PowerShell

Configuración persistente

Modelos recomendados

Extensiones de VS Code

Valores necesarios

Continue

Cline

Roo Code

Kilo Code

Modelos recomendados

Notas

Codex CLI

Instalar Codex CLI

Valores necesarios

Pasos recomendados

Contenido de `~/.codex/config.toml`

Contenido de `~/.codex/auth.json`

Modelos recomendados

Notas

Factory Droid

Instalar Droid CLI

Valores necesarios

Notas

Contenido de `~/.factory/settings.json`

Modelos recomendados

OpenCode

Instalar OpenCode

Ruta de la config

Valores necesarios

Bloque de configuración listo para copiar

Modelos recomendados

Notas

OpenClaw

Ruta de la config

Valores necesarios

Bloque de configuración listo para copiar

Modelos recomendados

Notas