Налаштування LLM API для Cursor, Claude Code, Codex

Налаштування клієнта для кожного інструмента

Оберіть інструмент у лівій колонці, щоб переглянути повну інструкцію. Наведені нижче приклади використовують ваш поточний API key та реальний Base 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 key та власним base URL.

Потрібні дані

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: 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-сумісну модель зі списку активних.
Після збереження надішліть короткий prompt, щоб підтвердити, що route 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
Model: claude-opus-5
Route: messages
Max tokens: 1024

Примітки

ANTHROPIC_BASE_URL не повинен містити /v1.
Віддавайте перевагу моделі, що підтримує route messages.
Якщо Claude Code просить спершу авторизуватися, завершіть вхід один раз, а потім запустіть із наведеними нижче змінними середовища.
Запити через route 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": "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
Model: claude-opus-5
Route: 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-сумісний 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.
Після збереження надішліть короткий prompt, щоб підтвердити, що route chat/completions працює.
Запити через route 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.
Config: ~/.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
Model: gpt-5.4
Route: 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 використовує 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
Model: 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
Model: claude-opus-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-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"
        }
    }
}

Примітки

OpenCode має вказувати на endpoint із /v1.
Віддавайте перевагу активній моделі Claude, якщо ваш робочий процес використовує інструменти в стилі Anthropic.
Якщо ви змінюєте модель в іншому місці конфігурації, зберігайте ті самі значення base URL та API key.
Запити через route messages мають містити додаткове поле max_tokens.

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw може використовувати OpenAI-сумісний provider через файл openclaw.json з alias 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
Model: 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-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"
                    }
                ]
            }
        }
    }
}

Примітки

OpenClaw має використовувати baseUrl із /v1.
Залишайте api зі значенням openai-completions для OpenAI-сумісного потоку.
Ви можете додавати або видаляти моделі зі списку, але alias ckey/ та API key краще зберігати згідно з прикладом.

Налаштування клієнта для кожного інструмента

Перед налаштуванням

Правила Base 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

Шлях конфігурації

Потрібні дані

Готовий блок для копіювання

Рекомендовані моделі

Примітки