Настройка LLM API: Cursor, Claude Code, Codex

Правильная настройка каждого клиента

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

# 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-fable-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-fable-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-fable-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-fable-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-fable-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-fable-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"} ] }'

OpenAI-compatible chat/completions /v1

Cursor

Cursor следует использовать через OpenAI-совместимый путь с кастомным API key и кастомным base URL.

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

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Модель: gpt-5.4
Route: chat/completions
Требование к тарифу: Требуется тариф Cursor с поддержкой кастомных API endpoint.

Готовый блок для копирования

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-совместимый поток, поэтому base URL должен включать `/v1`.
Если модель не работает в Cursor, переключитесь на другую активную OpenAI-совместимую модель.
После сохранения отправьте короткий промпт, чтобы подтвердить работу `chat/completions`.

Anthropic-compatible messages root URL

Claude Code

Claude Code настраивается через переменные окружения Anthropic, но base 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 Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io
Модель: claude-fable-5
Route: messages
Max tokens: 1024

Примечания

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

Временная shell-сессия

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-4.6",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

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

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

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

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Модель: claude-fable-5
Route: messages or chat/completions
Max tokens: 1024

Continue

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

Cline

Используйте OpenAI-совместимый provider, base URL с `/v1` и ваш API key из Console.

Roo Code

Используйте OpenAI-совместимый provider, base URL с `/v1` и ваш API key из Console.

Kilo Code

Используйте OpenAI-совместимый provider, base URL с `/v1` и ваш API key из Console.

Примечания

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

OpenAI-compatible ~/.codex /v1

Codex CLI

Расширение Codex для VS Code поддерживает OpenAI-совместимый API с кастомным base URL и API key.

Установить Codex CLI

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

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

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Модель: gpt-5.4
Route: chat/completions

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

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

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

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

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

Примечания

Codex использует OpenAI-совместимые endpoint, поэтому Base 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`

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

Provider: openai
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Модель: gpt-5.4
Route: 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 provider на ваш endpoint и использовать тот же API key.

Установить 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 Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Модель: claude-fable-5
Route: 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-fable-5": {
                    "name": "claude-fable-5"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                },
                "deepseek-v4-flash": {
                    "name": "deepseek-v4-flash"
                },
                "deepseek-v4-pro": {
                    "name": "deepseek-v4-pro"
                },
                "glm-5.2": {
                    "name": "glm-5.2"
                },
                "gpt-5.5": {
                    "name": "gpt-5.5"
                }
            }
        }
    },
    "model": "ckey/claude-fable-5",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-fable-5"
        }
    }
}

Примечания

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

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw может использовать OpenAI-совместимый provider через `openclaw.json` с алиасом provider `ckey`.

Путь к конфигу

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

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

Provider: ckey / OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Модель: ckey/gpt-5.4
Route: 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-fable-5",
                        "name": "claude-fable-5"
                    },
                    {
                        "id": "gpt-5.6-sol",
                        "name": "gpt-5.6-sol"
                    },
                    {
                        "id": "deepseek-v4-flash",
                        "name": "deepseek-v4-flash"
                    },
                    {
                        "id": "deepseek-v4-pro",
                        "name": "deepseek-v4-pro"
                    },
                    {
                        "id": "glm-5.2",
                        "name": "glm-5.2"
                    }
                ]
            }
        }
    }
}

Примечания

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

Правильная настройка каждого клиента

Перед настройкой

Правила Base URL

SDK

Запрос Anthropic API

Стриминг Anthropic API

OpenAI-совместимый запрос

OpenAI-совместимый стриминг

Запрос Anthropic API

Стриминг Anthropic API

OpenAI-совместимый запрос

OpenAI-совместимый стриминг

Запрос Anthropic API

Стриминг Anthropic API

OpenAI-совместимый запрос

OpenAI-совместимый стриминг

Запрос Gemini (Google)

Запрос Ollama

Отправить локальное изображение как base64

Отправить изображение по URL

Base URL

Модель

API Key

Cursor

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

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

Готовый блок для копирования

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

Примечания

Claude Code

Установить Claude Code

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

Примечания

Временная shell-сессия

Временная 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

Путь к конфигу

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

Готовый блок для копирования

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

Примечания