Яндекс ГПТ в ИИ-агентах за 15 минут: готовые конфиги для OpenCode, Pi и Hermes

Один из пользователей Habr протестировал Yandex AI Studio и выяснил, что подключение YandexGPT (Яндекс ГПТ) к трём популярным инструментам для работы с ИИ-агентами (программами, которые выполняют задачи самостоятельно, шаг за шагом) сводится к трём параметрам: адрес сервера, ключ и идентификатор папки в облаке. Никаких самописных переходников. Ниже разбираю каждый шаг и нюансы, на которых можно споткнуться.

Что понадобится?

• Аккаунт в Yandex Cloud с включённым биллингом (без этого запросы просто не пройдут).
• API-ключ и Folder ID (идентификатор папки проекта в консоли Yandex Cloud).
• Один из инструментов: OpenCode, Pi или Hermes. Для Claude Code схема другая, об этом отдельно.
• Минимальное знакомство с редактированием JSON- и YAML-файлов.
• Время: 10-15 минут на каждый клиент.

Пошаговая инструкция

1. Получите API-ключ и Folder ID

Зайдите в консоль Yandex Cloud, создайте сервисный аккаунт или используйте существующий. Скопируйте API-ключ и Folder ID. Убедитесь, что биллинг включён: без активного платёжного аккаунта модель не ответит.

2. Подключите OpenCode

Откройте файл ~/.config/opencode/opencode.json и вставьте конфигурацию. Адаптер @ai-sdk/openai-compatible берёт на себя совместимость, вам остаётся указать базовый URL, ключ и заголовок с Folder ID.

{
  "provider": {
    "yandex": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Yandex",
      "options": {
        "baseURL": "https://ai.api.cloud.yandex.net/v1",
        "apiKey": "<API_key>",
        "headers": {
          "OpenAI-Project": "<folder_ID>"
        }
      },
      "models": {
        "yandexgpt-5.1": {
          "id": "gpt://<folder_ID>/yandexgpt-5.1",
          "name": "YandexGPT Pro 5.1"
        }
      }
    }
  }
}

Модель указывайте полным URI (полный адрес ресурса): gpt://<folder_ID>/yandexgpt-5.1. Короткое имя не сработает.

3. Подключите Pi

Файл настроек лежит по пути ~/.pi/agent/models.json. Тип провайдера: openai-completions. Две функции, которые Яндекс ГПТ пока не поддерживает, нужно явно отключить.

{
  "providers": {
    "yandex": {
      "baseUrl": "https://ai.api.cloud.yandex.net/v1",
      "api": "openai-completions",
      "apiKey": "<API_key>",
      "authHeader": true,
      "headers": {
        "OpenAI-Project": "<folder_ID>"
      },
      "compat": {
        "supportsDeveloperRole": false,
        "supportsReasoningEffort": false
      },
      "models": [
        {
          "id": "gpt://<folder_ID>/yandexgpt-5.1",
          "name": "YandexGPT Pro 5.1"
        }
      ]
    }
  }
}

Блок compat критичен: если не выставить оба значения в false, клиент будет отправлять неподдерживаемые параметры и получать ошибки.

4. Подключите Hermes

Hermes принимает YAML-конфигурацию. Заголовок OpenAI-Project передаётся прямо в секции headers.

model:
  default: "gpt://<folder_ID>/yandexgpt-5.1"
  provider:
    custom
  base_url: "https://ai.api.cloud.yandex.net/v1"
  api_key: "<API_key>"
  headers:
    OpenAI-Project: "<folder_ID>"

5. А что с Claude Code?

Claude Code работает через Anthropic Messages API, а не через OpenAI-совместимый протокол. Подключить его напрямую к Яндексу нельзя. Потребуется промежуточный шлюз-переводчик (gateway), который принимает запросы в формате Anthropic и пересылает их в формате OpenAI. Автор оригинальной статьи не приводит готового конфига для этого сценария.

Что делать с этим прямо сейчас?

Разработчику и автору, который автоматизирует контент: можно подключить Яндекс ГПТ в привычную среду разработки за 10 минут и использовать российскую модель для генерации текстов, разбора кода, работы с данными. Готовый конфиг копируется и работает.

Маркетологу и предпринимателю в РФ: YandexGPT доступна без VPN, данные обрабатываются в российском облаке. Для задач, где важна локализация данных и соответствие требованиям по хранению, это практичный выбор. Платите в рублях, без привязки к зарубежным платёжным системам.

Тем, кто раньше использовал GigaChat: по опыту автора оригинальной статьи, подключение GigaChat к OpenCode потребовало «написания собственного слоя совместимости» из-за разницы протоколов. С Яндекс ГПТ эта проблема решена на стороне Яндекса: OpenAI-совместимый эндпоинт (точка подключения, совместимая со стандартом OpenAI) работает сразу.

Главное, что стоит вынести: российская модель впервые подключается к западным dev-инструментам так же просто, как GPT или Claude. Скопируйте конфиг, вставьте ключ и попробуйте сегодня, пока задача свежая.

По материалам Habr AI