Cómo configurar la 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

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: gpt-5.4
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: 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-4.1-flash-ckey

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
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

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-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

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: gpt-5.4
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 = "gpt-5.4"
model_reasoning_effort = "xhigh"
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-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

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: gpt-5.4
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": "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-4.1-flash-ckey

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"
                },
                "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

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-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-4.1-flash-ckey",
                        "name": "deepseek-4.1-flash-ckey"
                    }
                ]
            }
        }
    }
}

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-4.1-flash-ckey

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

Endpoints and commands

Text / hội thoại

Images

Audio

Video (task / async)

Embeddings / ranking / safety / search

Native provider routes

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