Что такое OpenCode и как начать работу

Данные на 26.10.2026, 13:30 МСК

OpenCode это open-source агент для программирования: он работает в терминале, как десктоп-приложение или расширение IDE и пишет код в вашем проекте. Сам OpenCode моделью не является: модели подключаются через Zen, ключ провайдера или OpenAI-совместимый шлюз. Ставится одной командой, например npm i -g opencode-ai.

Факты ниже по документации OpenCode и документации OpenCode 2 на 26.10.2026. Установку обеих версий через npm мы проверили сами.

Что такое OpenCode

OpenCode это харнесс: программа, которая даёт модели доступ к вашему проекту. Харнесс читает файлы, запускает команды, правит код и показывает вам, что сделал. Думает в этой связке модель, а OpenCode решает, что ей показать и какие инструменты дать.

Поэтому с OpenCode вы делаете два выбора: харнесс, в котором удобно работать, и модель, которую в него подключаете. Про выбор модели для кода есть отдельная статья: нейросеть для кода.

OpenCode open-source, лицензия MIT, репозиторий anomalyco/opencode на GitHub. Сам OpenCode бесплатный, платите вы только за модели.

OpenCode 1 и OpenCode 2: какую ставить

Сейчас у OpenCode две версии. Обе запускаются одной командой opencode, поэтому по умолчанию рядом не ставятся: новая установка заменит старую.

Учтите две вещи. Страница скачивания уже предлагает OpenCode 2. А brew install opencode без tap и официальный пакет Arch тоже ставят вторую версию. Если у вас настроена первая версия, по гайду миграции вторая читает её конфиг без переписывания.

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

macOS и Linux

Скрипт, вторая версия:

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

Первая версия ставится скриптом https://opencode.ai/install или через Homebrew-tap из таблицы выше.

Через npm

npm install -g @opencode/cli   # OpenCode 2
npm install -g opencode-ai     # OpenCode 1
opencode --version

Так это выглядело у нас 26.10.2026: версии 1.19.4 и 2.1.4.

В новых версиях npm появляется предупреждение install-scripts: npm не запустил скрипт postinstall, который выбирает бинарник под вашу систему. У нас opencode --version работал и с этим предупреждением. Если команда не запускается, поставьте пакет с флагом, который предлагает сам npm, например npm install -g --allow-scripts=@opencode/cli @opencode/cli. Через Bun и pnpm документация OpenCode 2 сразу даёт команды с разрешением скрипта.

OpenCode на Windows

Для первой версии OpenCode советует WSL, а ещё есть choco install opencode, scoop install opencode и npm install -g opencode-ai. Для второй менеджеры пакетов Windows не поддерживаются, бинарник и десктоп-приложение скачиваются со страницы загрузки.

Docker

docker run -it --rm ghcr.io/anomalyco/opencode

У второй версии образы с номером версии в теге, например ghcr.io/anomalyco/opencode:2.0.0.

Откуда брать модели

OpenCode Zen: что это

Zen это сервис самого OpenCode: список моделей, которые проверила команда OpenCode, с оплатой за запросы с баланса на opencode.ai. Подключается командой /connect, провайдер OpenCode. Часть бесплатных моделей Zen работает только внутри OpenCode. Подробности в документации Zen.

Другие источники

После установки модель ещё не подключена. Провайдер добавляется командой /connect прямо в интерфейсе OpenCode, список моделей открывает /models.

Чтобы подключить OpenCode через шлюз, нужно описать провайдера в opencode.json. Конфиги для обеих версий, служебная модель для заголовков сессий и MCP разобраны в статье подключить OpenCode со своим ключом. Ключ проверяется служебной моделью ais-test-1: она платную модель не вызывает, но баланс должен быть ненулевым (Подключение). Цены моделей на /modeli.

Бесплатные модели в OpenCode

В Zen бывают временно бесплатные модели. OpenCode прямо пишет, что они доступны ограниченное время, а список меняется, актуальный он держит в документации Zen. Перечень сюда не переносим, он устареет раньше статьи.

Что важно знать до выбора бесплатной модели:

• часть бесплатных моделей OpenCode явно не даёт в России, например Beam Free;
• у некоторых бесплатных моделей провайдер в бесплатный период может использовать ваши данные для улучшения модели, условия написаны у каждой модели в документации;
• скрыть бесплатные модели можно переменной OPENCODE_DISABLE_FREE_MODELS=1.

Через шлюз модели оплачиваются по токенам, бесплатного доступа мы не обещаем. Цены на /modeli.

Первые шаги в OpenCode

1. Перейдите в папку проекта и запустите opencode. 2. Выполните /init: OpenCode изучит проект и создаст в корне AGENTS.md. Этот файл стоит закоммитить, по нему агент понимает правила проекта. 3. Упоминайте файлы через @: OpenCode ищет их по имени. 4. Переключайтесь клавишей Tab между режимами Plan и Build. В Plan агент только предлагает план, в Build меняет код. 5. Если правка не та, /undo откатывает её, а /redo возвращает.

Кроме интерфейса в терминале есть команды для работы без него: opencode run запускает задачу одним сообщением, opencode serve поднимает сервер, opencode mcp управляет MCP-серверами. Полный список выводит opencode --help.

OpenCode, Claude Code, Codex и Kilo Code: чем отличаются

• OpenCode работает с любым провайдером и локальными моделями, модель можно менять под задачу.
• Claude Code это харнесс Anthropic. Claude Code с нашим ключом мы пока не проверяли, настройка в статье Claude Code из России.
• Codex это харнесс OpenAI на Responses API, настройка в статье Codex из России. Сравнение двух в статье Codex или Claude Code.
• Kilo Code живёт в VS Code, JetBrains и CLI и тоже подключает свой провайдер, разбор вместе с OpenCode в статье подключить OpenCode со своим ключом.
• Cline это расширение VS Code, Aider работает в терминале и делает коммиты в git; оба тоже подключают свой провайдер, разбор в статьях Cline и Aider.

Безопасность

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

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