OpenCode: что это, настройка, API-ключ и подключение к VS Code, JetBrains и PyCharm

OpenCode — это AI-ассистент с открытым исходным кодом, который работает в терминале и интегрируется с популярными редакторами кода: VS Code, PyCharm, IntelliJ IDEA, Rider и другими IDE JetBrains. Через стандартный OpenAI-совместимый API к нему можно подключить любую LLM-модель, платить рублями и работать напрямую через api.hubris.pw. Ниже — что такое OpenCode, как его установить, настроить API-ключ и подключить к вашей IDE.

Что такое OpenCode

OpenCode — это CLI-инструмент для работы с AI-моделями прямо в терминале, созданный с расчётом на максимальную гибкость. Его основные возможности:

• Открытый исходный код — весь код доступен на GitHub (проект opencode-ai), сообщество активно дорабатывает инструмент.
• Работа через терминал — основной интерфейс OpenCode — командная строка: можно генерировать код, рефакторить, искать ошибки и объяснять логику, не покидая терминал.
• Интеграция с IDE — плагины для VS Code и JetBrains (PyCharm, IntelliJ IDEA, Rider, WebStorm, GoLand) пробрасывают контекст из редактора в OpenCode.
• Поддержка любого провайдера — OpenCode работает с любым OpenAI-совместимым API, достаточно указать Base URL и API-ключ.

Как установить и настроить OpenCode

Установка занимает одну команду:

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

После установки нужно настроить провайдер — указать, через какой сервис OpenCode будет обращаться к моделям. Конфигурация хранится в ~/.config/opencode/config.json:

{
  "provider": {
    "hubris": {
      "api": "https://api.hubris.pw/v1",
      "key": "sk-gw-ваш_ключ"
    }
  },
  "model": "anthropic/claude-sonnet-5"
}

Где взять API-ключ для OpenCode: зарегистрируйтесь в личном кабинете Hubris, создайте ключ в разделе «API-ключи» — он будет начинаться с sk-gw-. Пополнить баланс можно от 300 ₽ через СБП, банковскую карту или счёт для юридических лиц.

OpenCode в VS Code

Для VS Code существует официальный плагин OpenCode в маркетплейсе расширений. Он запускает OpenCode-сервер локально и передаёт контекст из редактора — открытые файлы, выделенный код, структуру проекта.

1. Откройте Extensions (Ctrl+Shift+X), найдите OpenCode.
2. Нажмите Install.
3. После установки откройте командную палитру (Ctrl+Shift+P) и выберите OpenCode: Start Server.
4. Плагин подхватит конфиг из ~/.config/opencode/config.json — дополнительная настройка не требуется.

После запуска сервера в боковой панели появится чат OpenCode, через который можно отправлять запросы к моделям.

OpenCode в JetBrains — PyCharm, IntelliJ IDEA, Rider

Интеграция OpenCode с IDE JetBrains работает через плагин OpenCode IntelliJ Plugin:

1. Откройте Settings → Plugins → Marketplace.
2. Найдите OpenCode IntelliJ Plugin, нажмите Install и перезапустите IDE.
3. В настройках плагина (Settings → Tools → OpenCode) укажите Path to opencode binary — путь до бинарного файла, установленного командой выше.
4. Плагин автоматически считает конфигурацию провайдера из ~/.config/opencode/config.json.

OpenCode поддерживает все IDE JetBrains на платформе IntelliJ: PyCharm, IntelliJ IDEA, Rider, WebStorm, GoLand, PhpStorm, CLion.

Альтернатива: Kilo Code для JetBrains IDE

Если OpenCode кажется слишком CLI-ориентированным, для JetBrains IDE есть альтернатива — Kilo Code. Это плагин-агент с нативной интеграцией в IDE, который не требует установки отдельного CLI.

Установка Kilo Code в PyCharm и IntelliJ IDEA:

1. Settings → Plugins → Marketplace, поиск Kilo Code (publisher — Kilo Code AI).
2. Нажмите Install, перезапустите IDE — появится боковая панель Kilo Code.
3. В настройках выберите Custom OpenAI-compatible provider:
   • Base URL: https://api.hubris.pw/v1
   • API Key: ваш ключ sk-gw-...
   • Model: любая из каталога
4. Нажмите Test Connection — статус должен стать зелёным.

Kilo Code — форк Roo Code с улучшенной поддержкой JetBrains IDE: для PyCharm, Rider и IntelliJ IDEA он предпочтительнее, так как интегрируется напрямую, а не через прокси-сервер. Подробное сравнение — в статье Roo Code, Kilo Code, OpenCode: как подключить AI-ассистент к IDE.

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

OpenCode принимает любую модель через API. Выбор зависит от задач и бюджета — актуальные цены в рублях за миллион токенов:

Модель	Вход (₽/1M)	Выход (₽/1M)	Для чего
qwen/qwen3-coder	37,91	126,37	Python, TypeScript, Go — генерация и рефакторинг
qwen/qwen3-coder-flash	24,65	123,21	Быстрые правки, автодополнение
cohere/north-mini-code:free	0	0	Пробный режим, простые задачи
anthropic/claude-sonnet-5	252,73	1 263,61	Сложная архитектура, код-ревью
deepseek/deepseek-v4-pro	131,71	263,41	Бюджетный вариант для повседневной работы

Для большинства повседневных задач в IDE достаточно qwen/qwen3-coder или deepseek/deepseek-v4-pro — они хорошо справляются с основными языками программирования при умеренной стоимости. Claude Sonnet-5 пригодится для сложной архитектуры и код-ревью.

Всего в каталоге Hubris — более 500 моделей, из них 22 бесплатные.

Типичные проблемы и решения

OpenCode не запускается — «command not found». Бинарный файл opencode должен быть в системном PATH. После установки откройте новый терминал или выполните source ~/.bashrc (или ~/.zshrc).

Плагин OpenCode в IntelliJ не видит бинарный файл. Проверьте путь в Settings → Tools → OpenCode → Path to opencode binary. Путь должен быть абсолютным (например, /usr/local/bin/opencode или /home/имя/.local/bin/opencode).

Kilo Code не видит Node.js в PyCharm. Плагин требует Node.js ≥18 в системном PATH. Установите через менеджер пакетов или nvm, затем перезапустите IDE.

Ошибка 401 при подключении к API. Проверьте, что ключ активен в личном кабинете и баланс больше нуля. Ключ должен начинаться с sk-gw-.

Kilo Code просит одобрить каждое действие. Переключите режим с Manual Approval на Auto-approve read operations в настройках плагина.

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

Что такое OpenCode и чем он отличается от других AI-ассистентов? OpenCode — CLI-инструмент с открытым исходным кодом, который работает через терминал и подключается к IDE через плагины. В отличие от GitHub Copilot или Cursor, вы сами выбираете провайдера и модель, а платите только за токены без фиксированной подписки.

Как получить API-ключ для OpenCode? Зарегистрируйтесь в Hubris, пополните баланс от 300 ₽ (СБП, карта или счёт для юрлиц) и создайте ключ в разделе «API-ключи». Формат ключа — sk-gw-.... Этот же ключ подойдёт для Kilo Code, Roo Code и других инструментов с поддержкой OpenAI-совместимого API.

OpenCode бесплатный? Сам инструмент OpenCode — бесплатный и с открытым исходным кодом. Платить нужно только за API-запросы к моделям — стоимость зависит от выбранной модели и количества использованных токенов. В каталоге Hubris более 20 бесплатных моделей (с суффиксом :free), на которых можно работать без оплаты.

Чем OpenCode отличается от Kilo Code и Roo Code? OpenCode — CLI-first инструмент с плагинами для IDE. Kilo Code — плагин-агент, форк Roo Code с нативной интеграцией в JetBrains IDE. Для терминальной работы выбирайте OpenCode, для PyCharm/Rider/IntelliJ IDEA — Kilo Code, для VS Code — подойдут все три. Подробное сравнение — в статье Roo Code, Kilo Code, OpenCode: как подключить AI-ассистент к IDE.

Как подключиться к OpenCode из России? Через Hubris — запросы к API идут через российский сервер, оплата в рублях через СБП, банковскую карту или счёт для юрлиц. Зарубежные карты не нужны.

Какие модели поддерживает OpenCode? OpenCode работает с любой моделью, доступной через OpenAI-совместимый API. Через Hubris доступно более 500 моделей — от специализированных кодеров (qwen3-coder) до универсальных (Claude, DeepSeek) и бесплатных (:free). Полный список — в каталоге моделей.

OpenCode Desktop — что это? OpenCode Desktop — это графическая оболочка для OpenCode, которая позволяет работать с AI-ассистентом через оконный интерфейс, а не только через терминал. Скачивается с официального сайта opencode.ai.