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

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

Что такое OpenCode AI

OpenCode — это CLI-инструмент с искусственным интеллектом для разработки, созданный с расчётом на максимальную гибкость. Проект с открытым исходным кодом (GitHub opencode-ai) активно развивается сообществом. Основные возможности OpenCode:

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

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

Установка OpenCode выполняется одной командой в терминале:

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

Скрипт автоматически загружает и устанавливает бинарный файл opencode. После установки откройте новый терминал или выполните source ~/.bashrc (или ~/.zshrc), чтобы команда стала доступна.

Далее нужно настроить провайдер — указать, через какой сервис 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-. Пополнить баланс можно от 500 ₽ через СБП, банковскую карту или счёт для юридических лиц.

OpenCode Desktop — графический интерфейс

Для тех, кому удобнее работать в оконном интерфейсе, а не в терминале, существует OpenCode Desktop — графическая оболочка, которая предоставляет те же возможности AI-ассистента, но с визуальным управлением.

Скачать OpenCode Desktop можно с официального сайта opencode.ai. После установки Desktop-версии настройка API-провайдера выполняется аналогично CLI-версии — через тот же конфигурационный файл ~/.config/opencode/config.json. Все ваши настройки, модели и ключи будут автоматически подхвачены графической оболочкой.

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. Выбор зависит от задач и бюджета — актуальные цены в рублях за миллион токенов (цены на октябрь 2026):

Для большинства повседневных задач в IDE достаточно qwen/qwen3-coder или deepseek/deepseek-v4-pro — они хорошо справляются с основными языками программирования при умеренной стоимости. DeepSeek V4 Pro особенно выгоден: его цена за миллион выходных токенов (52,72 ₽) — одна из самых низких среди кодеров в каталоге. Claude Sonnet-5 пригодится для сложной архитектуры и код-ревью.

Всего в каталоге Hubris — 519 моделей, из них 23 бесплатные (с суффиксом :free в названии).

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

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 — это бесплатно? Сам инструмент OpenCode CLI и OpenCode Desktop — бесплатные и с открытым исходным кодом. Платить нужно только за API-запросы к моделям — стоимость зависит от выбранной модели и количества использованных токенов. В каталоге Hubris 23 бесплатные модели (с суффиксом :free), на которых можно работать без какой-либо оплаты.

Как скачать OpenCode? Установка выполняется одной командой: curl -fsSL https://opencode.ai/install | bash. Для Desktop-версии — скачайте установщик с opencode.ai. После установки настройте API-провайдер в ~/.config/opencode/config.json и укажите ваш ключ sk-gw-....

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

Какие модели работают в OpenCode? OpenCode поддерживает любую модель через OpenAI-совместимый API. Через Hubris доступно 519 моделей — от специализированных кодеров (qwen3-coder, deepseek-v4-pro) до универсальных (Claude, GPT) и 23 бесплатных. Полный список — в каталоге моделей. Для повседневного кодинга оптимальны qwen/qwen3-coder и deepseek/deepseek-v4-pro, для сложных задач — Claude Sonnet-5.

Чем 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 Desktop — что это? OpenCode Desktop — это графическая оболочка для OpenCode, которая позволяет работать с AI-ассистентом через оконный интерфейс, а не только через терминал. Скачивается с официального сайта opencode.ai. Настройка API выполняется так же, как и в CLI-версии — через файл ~/.config/opencode/config.json.