OpenCode и ChatGPT: интеграция AI-агента для разработки

Что такое OpenCode и зачем он нужен разработчику

OpenCode — это открытый AI-агент для написания кода, который работает в терминале, IDE или как десктопное приложение. Его главная особенность — полная независимость от вендора: вы можете подключать любую модель из более чем 75 провайдеров, включая локальные. Проект имеет открытый исходный код, насчитывает свыше 195 000 звёзд на GitHub и используется более 16 миллионами разработчиков ежемесячно.

OpenCode автоматически загружает нужные языковые серверы (LSP), поэтому модель работает не с голым текстом файлов, а с типами и ошибками. Это позволяет агенту глубже понимать контекст проекта. Кроме того, OpenCode поддерживает многопоточные сессии: можно запустить несколько агентов параллельно на одном проекте и делиться ссылками на сессии для отладки.

Для аутентификации OpenCode поддерживает вход через GitHub Copilot и ChatGPT Plus/Pro, что даёт доступ к моделям OpenAI без отдельного API-ключа.

Способы подключения ChatGPT к OpenCode

Существует два основных способа интеграции ChatGPT с OpenCode. Первый — использование официального OAuth-плагина, который позволяет авторизоваться через подписку ChatGPT Plus/Pro и получить доступ к моделям GPT-5.2, GPT-5.2 Codex, GPT-5.1 и другим. Плагин перехватывает запросы OpenCode к OpenAI SDK и преобразует их для работы с ChatGPT backend. Он автоматически управляет OAuth-токенами, поддерживает многопоточные разговоры и stateless-режим.

Второй способ — подключение через OpenAI-совместимый API-прокси. Для этого достаточно указать в конфигурационном файле OpenCode base URL и API-ключ от стороннего сервиса, предоставляющего доступ к моделям ChatGPT. Этот метод не требует плагинов и правок кода, а настройка занимает около двух минут. Он подходит тем, кто хочет использовать API без привязки к подписке ChatGPT.

Установка и настройка OAuth-плагина для OpenCode

Для установки плагина выполните команду в терминале:

npx -y opencode-openai-codex-auth@latest

Если у вас устаревшая версия OpenCode (v1.0.209 и ниже), добавьте флаг --legacy. После установки необходимо добавить плагин в конфигурационный файл ~/.config/opencode/opencode.jsonc, а затем выполнить аутентификацию:

opencode auth login

Если браузерный callback не срабатывает (например, при работе через SSH или WSL), выберите опцию «ChatGPT Plus/Pro (Manual URL Paste)» и вставьте полный redirect URL. Плагин поддерживает 22 предварительно настроенных варианта моделей, включая GPT-5.2, GPT-5.2 Codex, GPT-5.1, Codex Max и Codex Mini. Для каждой модели можно настроить уровень reasoning effort, включая xhigh для самых сложных задач.

Подключение через API-прокси: быстрый старт

Если вы предпочитаете не использовать плагин, можно подключить OpenCode к ChatGPT через любой OpenAI-совместимый API. Для этого отредактируйте файл ~/.config/opencode/opencode.jsonc, добавив блок provider.openai:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.llm-gate.tech/v1",
        "apiKey": "ваш_ключ"
      }
    }
  }
}

Ключ можно получить после регистрации на соответствующем сервисе. На балансе обычно есть тестовые средства (например, $0.25) для проверки соединения. После сохранения конфигурации все запросы к провайдеру openai будут направляться через указанный endpoint. Модели переключаются в конфиге или прямо в интерфейсе OpenCode. Доступны семейства GPT-5.6 (sol, terra, luna), GPT-5.5, GPT-5.4 и GPT-5.4-mini.

Сравнение OAuth-плагина и API-прокси

OAuth-плагин использует вашу подписку ChatGPT Plus/Pro, поэтому не требует отдельного API-ключа и оплаты по токенам. Он даёт доступ к эксклюзивным моделям Codex (GPT-5.2 Codex, Codex Max, Codex Mini), которые оптимизированы для задач программирования. Плагин автоматически управляет токенами и поддерживает stateless-режим, что важно для многопоточных разговоров.

API-прокси, в свою очередь, не требует подписки ChatGPT — оплата идёт по токенам, часто по более низким ценам, чем официальные тарифы OpenAI (например, на 50% дешевле). Этот способ проще в настройке и не зависит от версии OpenCode. Однако он не предоставляет доступ к специализированным моделям Codex — только к стандартным GPT-моделям. Выбор между ними зависит от ваших задач: если вам нужны эксклюзивные модели и вы уже имеете подписку — выбирайте плагин; если важна гибкость и низкая цена — API-прокси.

Конфигурация моделей и параметров

OpenCode поддерживает гибкую настройку моделей через конфигурационные файлы. Для OAuth-плагина используются предустановленные варианты (variants), которые можно выбрать в интерфейсе или в файле opencode-modern.json (для версии v1.0.210+) или opencode-legacy.json (для старых версий). Каждый вариант включает модель, уровень reasoning effort и другие параметры. Например, для GPT-5.2 Codex можно установить reasoning_effort: xhigh для максимальной глубины анализа.

При использовании API-прокси модель указывается в конфиге или прямо в команде OpenCode. Например:

opencode run "напиши функцию сортировки" --model =openai/gpt-5.6-luna --variant =medium

Также можно задать модель по умолчанию в файле конфигурации. Важно помнить, что GPT-5 модели могут быть «темпераментными» — разработчики рекомендуют использовать официальные конфиги для вашей версии OpenCode. Старые модели GPT-5.0 объявлены устаревшими.

Безопасность и управление ключами

При работе с API-ключами важно не допустить их попадания в публичные репозитории. OpenCode позволяет хранить ключ в переменной окружения вместо прямого указания в конфигурационном файле. Например, можно задать переменную OPENAI_API_KEY и ссылаться на неё в конфиге:

"apiKey": "${OPENAI_API_KEY}"

OAuth-плагин использует официальную аутентификацию OpenAI (тот же метод, что и в Codex CLI), поэтому ключи не требуются — токены обновляются автоматически. Плагин предназначен только для личного использования и не должен применяться в коммерческих сервисах или многопользовательских приложениях. Разработчики несут ответственность за соблюдение условий использования OpenAI.

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

Практические примеры использования

После настройки OpenCode с ChatGPT вы можете выполнять типичные задачи разработки. Например, попросить агента написать функцию, исправить ошибки в тестах или реорганизовать код. Команда может выглядеть так:

opencode run "исправь сломанные тесты в модуле auth"

Агент проанализирует проект через LSP, поймёт типы и ошибки, и предложит изменения. Можно запустить несколько сессий параллельно: одна будет работать над бэкендом, другая — над фронтендом. Результаты каждой сессии можно сохранить и поделиться ссылкой для ревью.

Для быстрой проверки интеграции выполните:

opencode run "запиши hello world в test.txt" --model =openai/gpt-5.2 --variant =medium

Если всё настроено правильно, агент создаст файл с указанным содержимым. Это простой тест, который подтверждает, что связка работает.

Ограничения и рекомендации

При использовании OAuth-плагина учитывайте, что он предназначен только для личного использования и не подходит для коммерческих сервисов или API-реселлеров. Для production-среды рекомендуется использовать официальный OpenAI Platform API. Плагин требует стабильного интернет-соединения и может быть чувствителен к сетевым ограничениям (например, в корпоративных сетях).

При работе через API-прокси обращайте внимание на стоимость токенов — разные модели имеют разную цену. Тестового баланса обычно хватает на несколько десятков запросов, но для регулярной работы потребуется пополнение. Также убедитесь, что выбранный провайдер поддерживает нужные вам модели и не имеет скрытых ограничений по скорости.

OpenCode не хранит ваш код, но при использовании облачных моделей данные передаются на сервер провайдера. Если это критично, рассмотрите возможность подключения локальных моделей через OpenCode.

Вопросы и ответы