Подключение агентов и редакторов к API

Поставьте Codex CLI

npm install -g @openai/codex
codex --version

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Положите ключ в переменную

macOS и Linux, строка в ~/.zshrc или ~/.bashrc

export KOSAREVA_API_KEY="ВАШ_API_КЛЮЧ"

Windows, затем откройте новое окно терминала

setx KOSAREVA_API_KEY ВАШ_API_КЛЮЧ

Опишите провайдера

Файл ~/.codex/config.toml, на Windows C:\Users\ИМЯ\.codex\config.toml. Строки model и model_provider стоят до таблицы, иначе Codex их не прочитает.

model = "gpt-6-1-sol"
model_provider = "kosareva"

[model_providers.kosareva]
name = "kosareva.cloud"
base_url = "https://api.kosareva.cloud/v1"
env_key = "KOSAREVA_API_KEY"
wire_api = "responses"

Провайдера можно задать только в этом общем файле: в .codex/config.toml внутри проекта он не работает. Вход в аккаунт OpenAI не нужен.

Запустите и проверьте

codex

В сессии выполните /status: там видны модель и провайдер. Первое сообщение модели уже платное.

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Поставьте opencode

Linux и macOS

curl -fsSL https://opencode.ai/install | bash

Любая система через npm

npm install -g opencode-ai

На Windows разработчики советуют WSL, npm тоже подходит.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Сохраните ключ

В папке проекта запустите opencode, выполните /connect, прокрутите список до пункта Other и введите:

Provider id

kosareva

API key

ВАШ_API_КЛЮЧ

Опишите провайдера

Файл ~/.config/opencode/opencode.json. Значения limit подсказывают агенту, сколько контекста осталось.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kosareva": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "kosareva.cloud",
      "options": {
        "baseURL": "https://api.kosareva.cloud/v1"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5",
          "limit": {
            "context": 1000000,
            "output": 32000
          }
        },
        "deepseek-v4-1-flash": {
          "name": "DeepSeek V4.1 Flash",
          "limit": {
            "context": 1048576,
            "output": 32000
          }
        }
      }
    }
  },
  "model": "kosareva/claude-sonnet-5-5",
  "small_model": "kosareva/deepseek-v4-1-flash"
}

Проверьте

opencode auth list

В списке должен быть kosareva, а в сессии команда /models покажет модели из файла. Обе команды показывают настройки, годность ключа они не проверяют.

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽. Агенту удобно завести отдельный ключ с лимитом в рублях: он работает сам, в том числе по расписанию.

Пропишите адрес и модель

Файл ~/.hermes/config.yaml, на Windows %LOCALAPPDATA%\hermes\config.yaml. То же настраивает мастер hermes model, пункт Custom endpoint.

model:
  default: claude-sonnet-5-5
  provider: custom
  base_url: https://api.kosareva.cloud/v1
  api_key: ВАШ_API_КЛЮЧ
  context_length: 1000000

Оставьте строку context_length: размера окна в ответе /v1/models нет, а Hermes запускает только модели с окном от 64 000 токенов.

Проверьте

hermes doctor

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Поставьте OpenClaw

Нужен Node.js 24.16+ или 26.1+.

Linux, macOS и WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

Windows

iwr -useb https://openclaw.ai/install.ps1 | iex

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽. Агенту удобно завести отдельный ключ с лимитом в рублях.

Пропишите провайдера

Файл ~/.openclaw/openclaw.json. В fallbacks стоит модель подешевле: на неё агент перейдёт сам, если основная недоступна.

{
  "models": {
    "mode": "merge",
    "providers": {
      "kosareva": {
        "baseUrl": "https://api.kosareva.cloud/v1",
        "apiKey": "ВАШ_API_КЛЮЧ",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-5-5",
            "name": "Claude Sonnet 5.5",
            "input": [
              "text",
              "image"
            ],
            "contextWindow": 1000000,
            "maxTokens": 32000
          },
          {
            "id": "deepseek-v4-1-flash",
            "name": "DeepSeek V4.1 Flash",
            "input": [
              "text",
              "image"
            ],
            "contextWindow": 1048576,
            "maxTokens": 32000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kosareva/claude-sonnet-5-5",
        "fallbacks": [
          "kosareva/deepseek-v4-1-flash"
        ]
      }
    }
  }
}

Запустите мастер

openclaw onboard --install-daemon

Проверьте

openclaw doctor
openclaw gateway status

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Поставьте расширение

Нужен VS Code 1.106 или новее. Откройте вкладку расширений, найдите «kosareva» и нажмите Install. Страница расширения в Marketplace.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Подключите ключ

Нажмите Ctrl+Shift+P, выполните команду «kosareva.cloud: Подключить ключ» и вставьте ключ. Адрес вводить не нужно, ключ хранится в защищённом хранилище редактора.

Добавьте модели в чат

В чате VS Code откройте Manage Language Models, нажмите Add Models, выберите kosareva.cloud и отметьте нужные модели. Без этого шага модели в списке не появятся.

Проверьте

Подключение ключа уже проверяет его бесплатно: расширение читает профиль и показывает баланс. Команда «kosareva.cloud: Проверить связь» отправляет запрос к модели, поэтому платная и сначала спрашивает подтверждение.

Расширение не ставится в Cursor и другие сборки на базе VS Code: на Open VSX его нет. Cline, Kilo Code и Copilot работают в том же редакторе рядом с ним.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Добавьте свой адрес

Отдельно ставить ничего не нужно, хватит VS Code. В чате откройте Manage Language Models, нажмите Add Models и выберите Custom Endpoint. Укажите название группы и ключ, тип API поставьте Chat Completions.

Опишите модель

VS Code откроет файл chatLanguageModels.json. В url нужен полный адрес с /chat/completions, а сумма maxInputTokens и maxOutputTokens не должна превышать окно модели. Строку apiKey, которую заполнил VS Code, оставьте как есть.

[
  {
    "name": "kosareva.cloud",
    "vendor": "customendpoint",
    "apiKey": "${input:kosarevaApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "claude-sonnet-5-5",
        "name": "Claude Sonnet 5.5",
        "url": "https://api.kosareva.cloud/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 968000,
        "maxOutputTokens": 32000
      }
    ]
  }
]

Подписка и вход в GitHub для локального чата не нужны. Без входа назначьте свою модель в настройках chat.utilityModel и chat.utilitySmallModel, для второй подойдёт deepseek-v4-1-flash. В компаниях должна быть включена политика Bring Your Own Language Model Key in VS Code.

Проверьте

Выберите модель в чате: появится группа kosareva.cloud. Список берётся из файла и ключ не проверяет, а первое сообщение модели уже платное.

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Поставьте расширение

Во вкладке расширений VS Code найдите Cline и нажмите Install. Остальные настройки редактора не меняются.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Заполните поля

В настройках Cline в поле API Provider выберите OpenAI Compatible:

Base URL

https://api.kosareva.cloud/v1

API Key

ВАШ_API_КЛЮЧ

Model ID

claude-sonnet-5-5

Для неизвестной модели Cline считает окно равным 128 000 токенов. Чтобы использовать всё окно, в Context Window Size поставьте значение из каталога. Экономная модель: deepseek-v4-1-flash.

Проверьте

Cline подгружает список моделей с нашего адреса. Список появился, значит адрес и ключ верные. Первое сообщение модели уже платное.

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Поставьте расширение

Во вкладке расширений VS Code найдите Kilo Code, откройте стрелку рядом с Install и выберите Install Pre-Release Version. Это канал распространения в Marketplace, так советует сама документация Kilo.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Добавьте провайдера

Откройте настройки Kilo, вкладку Providers, прокрутите вниз и нажмите Custom provider:

Provider ID

kosareva

Display name

kosareva.cloud

Provider API

OpenAI Compatible

Base URL

https://api.kosareva.cloud/v1

API key

ВАШ_API_КЛЮЧ

Задайте размер контекста

Без limit Kilo не сжимает историю, и она растёт, пока модель не откажет. Задать его можно только в файле ~/.config/kilo/kilo.jsonc, на Windows обычно C:\Users\ИМЯ\.config\kilo\kilo.jsonc.

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "kosareva/claude-sonnet-5-5",
  "provider": {
    "kosareva": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "kosareva.cloud",
      "options": {
        "baseURL": "https://api.kosareva.cloud/v1",
        "apiKey": "{env:KOSAREVA_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5",
          "tool_call": true,
          "limit": {
            "context": 1000000,
            "output": 32000
          }
        }
      }
    }
  }
}

Ключ берётся из переменной KOSAREVA_API_KEY, задайте её до запуска VS Code. Такая ссылка работает только в общем файле, в kilo.jsonc проекта Kilo её игнорирует.

Проверьте

Нажмите Fetch models в окне провайдера: Kilo запросит /v1/models. Список появился, значит адрес и ключ верные. Автодополнения и Cloud Agent с нашим ключом нет.

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Откройте настройки моделей

Откройте Cursor Settings, раздел Models. В новых версиях названия полей могут отличаться.

Впишите адрес и ключ

OpenAI API Key

ВАШ_API_КЛЮЧ

Override OpenAI Base URL

https://api.kosareva.cloud/v1

Добавьте модель

В списке моделей добавьте имя вручную и выберите его в чате:

Модель

claude-sonnet-5-5

Проверьте ключ

Что делает кнопка Verify и тратит ли она деньги, мы не знаем, поэтому проверяйте ключ отдельно.

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Поставьте Zed

Сборки для всех систем на zed.dev/download.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Добавьте провайдера

Выполните agent: open settings, в разделе LLM Providers нажмите Add Provider и укажите название, адрес, модель и размер контекста. Или то же файлом settings.json:

{
  "language_models": {
    "openai_compatible": {
      "kosareva.cloud": {
        "api_url": "https://api.kosareva.cloud/v1",
        "available_models": [
          {
            "name": "claude-sonnet-5-5",
            "display_name": "Claude Sonnet 5.5",
            "max_tokens": 1000000
          }
        ]
      }
    }
  }
}

В Zed max_tokens это окно контекста, потолок ответа задаёт max_output_tokens. Ключ в файл не пишите: Zed спросит его в окне провайдера и сохранит в системном хранилище.

Проверьте

В панели агента выберите провайдера и модель. Своей бесплатной проверки у Zed нет, а первое сообщение модели уже платное.

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Поставьте расширение

Во вкладке расширений VS Code найдите Continue и нажмите Install.

Создайте ключ

Откройте раздел «API-ключи» в кабинете и нажмите «Создать ключ». Если вы регистрируетесь впервые, кабинет сначала покажет вход и главную страницу, оттуда перейдите в «API-ключи». Для запросов нужен баланс, пополнение от 50 ₽.

Опишите модель

Файл ~/.continue/config.yaml, на Windows C:\Users\ИМЯ\.continue\config.yaml. provider: openai здесь значит формат запросов, а не вендора модели. Строка capabilities нужна для режима агента.

name: kosareva-cloud
version: 0.0.1
schema: v1

models:
  - name: Claude Sonnet 5.5
    provider: openai
    model: claude-sonnet-5-5
    apiBase: https://api.kosareva.cloud/v1
    apiKey: ВАШ_API_КЛЮЧ
    capabilities: [tool_use]

Ключ в этом файле лежит открытым текстом, не добавляйте его в репозиторий. Автодополнения с нашим ключом нет.

Проверьте

Модель появится в списке чата, но это только чтение файла: ключ так не проверить.

Бесплатно проверить ключ можно запросом ниже: он читает список моделей и денег не тратит.

Поставьте расширение

Нужен Chrome 116 или новее. Откройте страницу в Chrome Web Store и нажмите «Установить».

Войдите

Откройте расширение и войдите через Google или кодом на почту. Ключ и адрес вводить не нужно: у расширения свой ключ, основной ключ в браузер не попадает.

Проверьте

После входа расширение показывает баланс. Любой вопрос тратит попытку или деньги: бесплатно доступны 3 вопроса на моделях с пометкой, по умолчанию это gemini-3-1-flash-lite, до 8 000 символов.

На служебных страницах Chrome и в самом магазине расширение не работает.