Как настроить LLM API для Cursor, Claude Code, Codex

Настройте каждый клиент правильно

Выберите клиент в левой колонке, чтобы увидеть полную инструкцию. Примеры ниже используют ваш текущий API-ключ и реальный базовый URL системы.

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 следует использовать в режиме, совместимом с OpenAI, с собственным API-ключом и базовым URL.

Необходимые значения

Провайдер: OpenAI-compatible
API-ключ: sk-YOUR_API_KEY
Базовый URL: https://api.xah.io/v1
Модель: gpt-5.4
Маршрут: chat/completions
Требование к тарифу: Требуется тариф Cursor, поддерживающий собственные API endpoints.

Готовый блок конфигурации

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

Важно

Cursor работает в совместимом с OpenAI режиме, поэтому базовый URL должен содержать `/v1`.
Если модель не работает в Cursor, попробуйте другую активную модель, совместимую с OpenAI.
После сохранения отправьте короткий промпт, чтобы убедиться, что маршрут `chat/completions` работает.

Anthropic-compatible messages root URL

Claude Code

Claude Code следует настраивать через переменные окружения Anthropic, но базовый URL должен быть на корневом домене.

Установка Claude Code

macOS / Linux / Windows (Node 18+): npm install -g @anthropic-ai/claude-code
После установки выполните команду `claude` для подтверждения. Настройки сохраняются в `~/.claude/settings.json`.
Linux / macOS: `~/.claude/settings.json`
Windows: `%USERPROFILE%\\.claude\\settings.json`

Необходимые значения

API-ключ: sk-YOUR_API_KEY
Базовый URL: https://api.xah.io
Модель: claude-opus-5
Маршрут: messages
Max tokens: 1024

Важно

`ANTHROPIC_BASE_URL` не должен содержать `/v1`.
Предпочтительно выбирать модель, поддерживающую маршрут `messages`.
Если Claude Code требует сначала авторизоваться, пройдите вход один раз и перезапустите его с указанными ниже переменными окружения.
Запросы, отправляемые через маршрут `messages`, должны содержать поле `max_tokens`.

Временная сессия Terminal

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

Временная сессия PowerShell

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

Постоянные настройки

{
    "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": "gpt-5.4"
    }
}

Расширения VS Code

Большинство расширений VS Code работают лучше всего в режиме, совместимом с OpenAI, с собственным базовым URL.

Необходимые значения

Провайдер: OpenAI-compatible
API-ключ: sk-YOUR_API_KEY
Базовый URL: https://api.xah.io/v1
Модель: claude-opus-5
Маршрут: 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

Используйте провайдера, совместимого с OpenAI, базовый URL с `/v1` и ваш API-ключ из консоли.

Roo Code

Используйте провайдера, совместимого с OpenAI, базовый URL с `/v1` и ваш API-ключ из консоли.

Kilo Code

Используйте провайдера, совместимого с OpenAI, базовый URL с `/v1` и ваш API-ключ из консоли.

Важно

Используйте провайдера, совместимого с OpenAI, базовый URL с `/v1` и ваш API-ключ из консоли.
Cursor работает в совместимом с OpenAI режиме, поэтому базовый URL должен содержать `/v1`.
После сохранения отправьте короткий промпт, чтобы убедиться, что маршрут `chat/completions` работает.
Запросы, отправляемые через маршрут `messages`, должны содержать поле `max_tokens`.

OpenAI-compatible ~/.codex /v1

Codex CLI

Расширение Codex для VS Code поддерживает API, совместимое с OpenAI, с собственным базовым URL и API-ключом.

Установка Codex CLI

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
После установки выполните команду `codex` для проверки. Codex читает авторизацию из `~/.codex/auth.json`, а конфигурацию — из `~/.codex/config.toml`.
Конфигурация: `~/.codex/config.toml` (Windows: `%USERPROFILE%\\.codex\\config.toml`)
Авторизация: `~/.codex/auth.json` (Windows: `%USERPROFILE%\\.codex\\auth.json`)

Необходимые значения

Провайдер: OpenAI-compatible
API-ключ: sk-YOUR_API_KEY
Базовый URL: https://api.xah.io/v1
Модель: gpt-5.4
Маршрут: chat/completions

Содержимое `~/.codex/config.toml`

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

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

Содержимое `~/.codex/auth.json`

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

Важно

Codex использует endpoint, совместимый с OpenAI, поэтому базовый URL должен содержать /v1.
После настройки перезагрузите VS Code, чтобы изменения вступили в силу.
Проверьте, открыв файл кода и попробовав пообщаться с Codex.

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid — это CLI-ассистент, позволяющий настраивать собственные модели через файл `settings.json`.

Установка Droid CLI

macOS / Linux: curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
После установки выполните команду `droid` для проверки.
Linux / macOS: `~/.factory/settings.json`
Windows: `%USERPROFILE%\\.factory\\settings.json`

Необходимые значения

Провайдер: openai
API-ключ: sk-YOUR_API_KEY
Базовый URL: https://api.xah.io/v1
Модель: gpt-5.4
Маршрут: chat/completions

Важно

Каждая запись в `customModels` должна иметь уникальный `id` и увеличивающийся `index` (0, 1, 2...).
Установите `provider` в значение `openai`, чтобы Droid использовал совместимый с OpenAI поток.
Можно добавить больше моделей, продублировав объект в массиве и изменив поля `model` и `id`.

Содержимое `~/.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"
        }
    ]
}

OpenCode

OpenCode может указать своему провайдеру Anthropic ваш endpoint и использовать тот же API-ключ.

Установка OpenCode

Установка через npm: npm install -g opencode-ai
После установки выполните команду `opencode` для проверки. Конфигурация находится в `~/.config/opencode/opencode.json` (или `.jsonc`).

Путь к конфигурации

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

Необходимые значения

API-ключ: sk-YOUR_API_KEY
Базовый URL: https://api.xah.io/v1
Модель: claude-opus-5
Маршрут: messages
Max tokens: 1024

Готовый блок конфигурации

{
    "$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-sonnet-4.6": {
                    "name": "claude-sonnet-4.6"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                }
            }
        }
    },
    "model": "ckey/claude-opus-5",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-5"
        }
    }
}

Важно

OpenCode следует указывать на endpoint с `/v1`.
Предпочтительно выбирать активную модель Claude, если ваше рабочее окружение рассчитано на инструменты в стиле Anthropic.
Если вы меняете модель в другом месте конфигурации, сохраняйте те же базовый URL и API-ключ, как указано ниже.
Запросы, отправляемые через маршрут `messages`, должны содержать поле `max_tokens`.

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw может использовать провайдера, совместимого с OpenAI, через файл `openclaw.json` с алиасом провайдера `ckey`.

Путь к конфигурации

Корень проекта: `./openclaw.json`
Windows: `%USERPROFILE%\\.openclaw\\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

Необходимые значения

Провайдер: ckey / OpenAI-compatible
API-ключ: sk-YOUR_API_KEY
Базовый URL: https://api.xah.io/v1
Модель: ckey/gpt-5.4
Маршрут: chat/completions

Готовый блок конфигурации

{
    "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-opus-5",
                        "name": "claude-opus-5"
                    },
                    {
                        "id": "claude-sonnet-4.6",
                        "name": "claude-sonnet-4.6"
                    }
                ]
            }
        }
    }
}

Важно

OpenClaw должен использовать `baseUrl` с `/v1`.
Оставьте `api` со значением `openai-completions` для совместимого с OpenAI потока.
Вы можете добавлять или удалять модели из списка, но алиас `ckey/` и API-ключ должны оставаться такими же, как в примере.

Настройте каждый клиент правильно

Что подготовить перед настройкой

Правила базового URL

Endpoints and commands

Text / hội thoại

Images

Audio

Video (task / async)

Embeddings / ranking / safety / search

Native provider routes

Cursor

Необходимые значения

Рекомендуемые шаги

Готовый блок конфигурации

Рекомендуемые модели

Важно

Claude Code

Установка Claude Code

Необходимые значения

Важно

Временная сессия Terminal

Временная сессия PowerShell

Постоянные настройки

Рекомендуемые модели

Расширения VS Code

Необходимые значения

Continue

Cline

Roo Code

Kilo Code

Рекомендуемые модели

Важно

Codex CLI

Установка Codex CLI

Необходимые значения

Рекомендуемые шаги

Содержимое `~/.codex/config.toml`

Содержимое `~/.codex/auth.json`

Рекомендуемые модели

Важно

Factory Droid

Установка Droid CLI

Необходимые значения

Важно

Содержимое `~/.factory/settings.json`

Рекомендуемые модели

OpenCode

Установка OpenCode

Путь к конфигурации

Необходимые значения

Готовый блок конфигурации

Рекомендуемые модели

Важно

OpenClaw

Путь к конфигурации

Необходимые значения

Готовый блок конфигурации

Рекомендуемые модели

Важно