Академия Pioneer Labs · гайд

Как подключить OpenCode к Claude, GPT-6, Kimi и GLM через OpenAI-совместимый API

Обновлено · 10 мин настройка

Коротко

Чтобы подключить OpenCode к Пионер ИИ-шлюзу, добавьте провайдера в opencode.json с "npm": "@ai-sdk/openai-compatible", options.baseURL https://pioneerlabs.ru/api/gateway/v1, options.apiKey: "{env:PIONEER_API_KEY}" и нужными моделями, затем задайте "model": "pioneer/anthropic/claude-sonnet-5.5". После этого OpenCode пишет код на Claude, GPT-6, Kimi, GLM или DeepSeek по одному ключу.

Параметры подключения
Base URL (OpenAI-совместимый)https://pioneerlabs.ru/api/gateway/v1
Base URL для Claude Code и Anthropic SDKhttps://pioneerlabs.ru/api/anthropic
КлючAuthorization: Bearer <ключ> — страница «API-ключ» в кабинете
Модель по умолчаниюanthropic/claude-sonnet-5.5
Бесплатная модель для проверкиmb-auto/free

Что такое OpenCode

OpenCode — открытый ИИ-агент для программирования. Он работает в терминале (TUI), как десктопное приложение и в IDE, правит файлы, выполняет команды, использует субагентов и MCP-серверы, а в режиме сервера служит основой для других приложений — например, OpenWork.

OpenCode поддерживает много провайдеров, а любой OpenAI-совместимый API подключается как свой (custom) провайдер. Через Пионер ИИ-шлюз все основные модели для кода доступны по одному ключу: Claude для сложного рефакторинга, GPT-6 как второе мнение, Kimi, GLM и DeepSeek для дешёвых массовых правок.

Настройка по шагам

  1. Шаг 1. Получите API-ключ Пионер ИИ-шлюза

    Пионер ИИ-шлюз работает для компаний и их сотрудников, по приглашениям. Компания оставляет заявку, мы заводим организацию, а сотрудники получают приглашение на почту с паролем. Сотрудник входит и создаёт ключ на странице «API-ключ». Один ключ открывает все текстовые модели, а также модели изображений и видео.

    Баланс организации в рублях, без VPN и зарубежной карты, доступ — по заявке. Подписки нет, каждый запрос оплачивается по цене модели, а расход виден по каждому сотруднику.

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

    # ~/.zshrc или ~/.bashrc
    export PIONEER_API_KEY="ваш-ключ-pioneer"
    curl https://pioneerlabs.ru/api/gateway/v1/chat/completions \
      -H "Authorization: Bearer $PIONEER_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model": "anthropic/claude-sonnet-5.5", "messages": [{"role": "user", "content": "Ответь: OK"}]}'

    Проверьте ключ до настройки агента. Ответ в JSON с полем choices значит, что ключ, баланс и модель работают:

  2. Шаг 2. Установите OpenCode

    Любым из способов:

    curl -fsSL https://opencode.ai/v2/install | bash
    # или
    npm i -g @opencode/cli@latest
    # или (macOS)
    brew install opencode
  3. Шаг 3. Добавьте Пионер ИИ-шлюз в opencode.json

    Запишите это в ~/.config/opencode/opencode.json (для всех проектов) или в opencode.json в корне проекта. Выбрать можно только модели, перечисленные в models:

    {
      "$schema": "https://opencode.ai/config.json",
      "model": "pioneer/anthropic/claude-sonnet-5.5",
      "provider": {
        "pioneer": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "Pioneer",
          "options": {
            "baseURL": "https://pioneerlabs.ru/api/gateway/v1",
            "apiKey": "{env:PIONEER_API_KEY}"
          },
          "models": {
            "anthropic/claude-sonnet-5.5": {
              "name": "Claude Sonnet 5.5",
              "limit": { "context": 1000000, "output": 32000 }
            },
            "anthropic/claude-opus-5.5": {
              "name": "Claude Opus 5.5",
              "limit": { "context": 1000000, "output": 32000 }
            },
            "openai/gpt-6.1-sol": {
              "name": "GPT-6.1 Sol",
              "limit": { "context": 1050000, "output": 32000 }
            },
            "moonshotai/kimi-k3.1-pro": {
              "name": "Kimi K3.1 Pro",
              "limit": { "context": 1048576, "output": 32000 }
            },
            "z-ai/glm-5.3": {
              "name": "GLM 5.3",
              "limit": { "context": 1048576, "output": 32000 }
            }
          }
        }
      }
    }

    Это классический формат конфига (V1). В OpenCode V2 описан новый формат (providers, package, settings.baseURL), но старый он по-прежнему читает и преобразует в памяти, а OpenWork и Kilo CLI читают тот же файл — так что один конфиг работает везде.

  4. Шаг 4. Запустите OpenCode и выберите модель

    Запустите opencode в своём проекте. Модель по умолчанию берётся из "model"; переключиться можно командой /models (модели сгруппированы под именем провайдера Pioneer). Дайте задачу, которая затрагивает файлы, — «добавь тест для utils/date.ts», — чтобы убедиться, что вызов инструментов работает.

Какую модель выбрать

Всегда указывайте limit.context и limit.output: по ним OpenCode решает, когда сжимать переписку. Claude Sonnet 5.5 — выбор по умолчанию для кода; Opus 5.5 — для крупного рефакторинга, Kimi, GLM или DeepSeek Flash — для дешёвых однотипных правок.

ID моделиКогда брать
anthropic/claude-sonnet-5.5Модель по умолчанию для агента: надёжно вызывает инструменты, держит длинные задачи, контекст 1 млн токенов.
anthropic/claude-opus-5.5Сложные многошаговые задачи, ревью кода, аналитика, где ошибка дороже токенов.
openai/gpt-6.1-solФлагман OpenAI: альтернатива Claude для кода и рассуждений.
google/gemini-3.8-flashБыстро и недорого: длинные документы, таблицы, разбор входящих.
moonshotai/kimi-k3.1-proСильная открытая модель для агентов и кода.
z-ai/glm-5.3Открытая модель для кода и инструментов, хорошее соотношение цены и качества.
deepseek/deepseek-v4.1-flashМассовые рутинные задачи: классификация, черновики, саммари.
mb-auto/freeБесплатно, для проверки настройки. Контекст 128 тыс., слабее в вызове инструментов; не отправляйте конфиденциальные данные.

Все модели с ценами и размером контекста — в каталоге. Каждая модель вызывается одним и тем же ключом.

Что можно делать

Субагенты

Разделите работу между агентами — один планирует, другой пишет код, третий проверяет — и дайте каждому свою модель от того же провайдера Pioneer.

MCP-серверы

Подключите базы данных, трекер задач и внутреннюю документацию через MCP, чтобы агент работал с реальным контекстом проекта.

Режим сервера

opencode serve открывает агента по HTTP — основа для внутренних инструментов и ботов в CI.

Терминал, десктоп и IDE

Один и тот же конфиг работает в TUI, десктопном приложении (brew install --cask opencode-desktop) и интеграциях с редакторами.

Сценарии для бизнеса

Дешёвые массовые правки по всему коду

Переименования, обновление зависимостей и исправления линтера в сотнях файлов: запускайте их на DeepSeek V4.1 Flash или GLM 5.3, а Claude оставьте для ревью.

Задача для агента:

Замени все использования moment.js в src/ на date-fns. Поведение должно остаться прежним; обнови тесты, запусти npm test и исправь падения. Ничего не коммить; в конце выведи список изменённых файлов.

Ревью кода вторым мнением

Попросите модель другой лаборатории проверить диф — GPT-6.1 Sol, проверяющий работу Claude, находит другие ошибки, — без второго аккаунта у другого поставщика.

Внутренние инструменты без программистов

Аналитики и маркетологи сами делают небольшие скрипты для выгрузок и отчётов в OpenCode под своими ключами, а расход каждого сотрудника виден в кабинете организации.

Агенты, которые создают медиа

Делайте функции на API изображений и видео Пионер ИИ-шлюза тем же ключом, что уже использует агент: фото товаров, превью, обложки.

Если не работает

401 Unauthorized

Ключ не указан или скопирован с ошибкой, либо агент не прочитал переменную окружения (перезапустите агент после export). Проверьте ключ командой curl из шага 1.

402 Payment Required

Закончился баланс организации. Администратору нужно пополнить его (страница «Баланс»); пока баланс пуст, проверять настройку можно на mb-auto/free.

Model not found

ID модели должен точно совпадать с каталогом, вместе с префиксом лаборатории: anthropic/claude-sonnet-5.5, а не claude-sonnet-5.5. Базовый URL должен заканчиваться на /v1.

Модели нет в /models

У каждой модели должна быть запись в models. Проверьте ключ провайдера (pioneer) и что JSON разбирается без ошибок.

Длинные сессии падают с ошибкой контекста

Укажите limit.context для модели, чтобы OpenCode сжимал переписку до переполнения.

Частые вопросы

Можно ли подключить Claude к OpenCode через свой провайдер?

Да. Если провайдер — Пионер ИИ-шлюз, укажите модель pioneer/anthropic/claude-sonnet-5.5 или pioneer/anthropic/claude-opus-5.5. Аккаунт Anthropic не нужен.

Какой формат конфига выбрать — V1 или V2?

Любой. V2 принимает показанный здесь формат V1 и преобразует его, а V1 к тому же читают OpenWork и Kilo, так что он самый переносимый.

Сколько это стоит?

Вы платите за токены по цене модели с баланса организации в рублях. Подписки и платы за места нет, поэтому агент, который простаивает, ничего не стоит. Цены в рублях за миллион токенов — в каталоге; mb-auto/free бесплатна.

Нужны ли отдельные аккаунты Anthropic, OpenAI или Google?

Нет. Один ключ Пионер ИИ-шлюза открывает Claude, GPT, Gemini, Grok, Kimi, GLM, DeepSeek, Qwen и MiniMax. Модель меняется сменой ID, а не провайдера или ключа, а оплата идёт с одного рублёвого баланса организации.

Это работает из России без VPN?

Да. Агент обращается к https://pioneerlabs.ru/api/gateway/v1, VPN для запросов к моделям не нужен, зарубежная карта тоже: запросы оплачиваются с баланса организации в рублях.

Где хранить API-ключ?

В переменной окружения PIONEER_API_KEY, со ссылкой {env:PIONEER_API_KEY} в конфиге. Никогда не коммитьте ключ в opencode.json проекта.

Пионер ИИ-шлюз · один API для всех моделей

Claude, GPT, Gemini, Kimi, GLM и DeepSeek в любом агенте — один ключ и один баланс.

Без VPN и иностранной карты: один баланс в рублях на всю команду, сотрудники получают свои API-ключи, расход виден по каждому. Доступ по заявке.

Источники

Другие гайды Академии Pioneer Labs