Академия 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 SDK | https://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. Получите 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. Установите OpenCode
Любым из способов:
curl -fsSL https://opencode.ai/v2/install | bash # или npm i -g @opencode/cli@latest # или (macOS) brew install opencodeШаг 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. Запустите 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-ключи, расход виден по каждому. Доступ по заявке.