OpenCode: скачивание и установка на Linux, macOS, Windows и в Docker
Введение
Эта страница только об установке. Ежедневная работа с OpenCode — модели,
агенты, навыки, рабочие приёмы — в следующей статье:
OpenCode V2.
Выберите один способ ниже, проверьте через
opencode --version, затем переходите к разделу
«Подключение модели».
Только V2: сначала удалите установку V1, сделанную пакетным менеджером, —
установщик V2 через curl заменяет бинарник V1. Поддерживаемые файлы
конфигурации V1 продолжают работать, намеренно ломаются только плагины и
серверный API.
Установочный скрипт
Рекомендуется для Linux, macOS и WSL2:
curl -fsSL https://opencode.ai/v2/install | bash
После установки перезапустите терминал, чтобы применилось обновление PATH, затем проверьте, как описано в разделе «Проверка, обновление, сервис».
npm, Bun, pnpm, yarn
Любая ОС с Node.js, имя пакета V2:
npm install -g @opencode/cli
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
yarn global add @opencode/cli
Bun и pnpm требуют явного флага сборки для postinstall-скрипта, который выбирает нативный бинарник. Если оболочка говорит «команда не найдена», глобальный каталог bin не в PATH — см. «Решение проблем».
Homebrew
macOS и Linux, tap V2:
brew install anomalyco/tap/opencode-v2
Arch Linux
AUR, бета-пакет V2:
paru -S opencode-beta
Docker без установки
Версионные теги, установка вообще не нужна:
docker run -it --rm ghcr.io/anomalyco/opencode:2.0.0
Замените тег на нужный релиз. Для настоящей работы смонтируйте каталог проекта, иначе агент видит только файловую систему контейнера.
Настольное приложение и отдельный бинарник
Сборки для настольного приложения под macOS, Windows и Linux (deb, rpm, AppImage) плюс отдельные архивы zip и tar.gz для CLI по платформам можно найти на главной странице документации V2:
Заметки по Windows
Пакетные менеджеры Windows для V2 не поддерживаются — используйте npm или отдельный zip со страницы документации выше. WSL2 идёт по пути скрипта для Linux. Настольное приложение — самый гладкий нативный вариант для Windows.
Проверка, обновление, сервис
opencode --version
opencode upgrade
opencode service status
Обновление до закреплённой версии выбранным пакетным менеджером:
opencode upgrade 2.0.21 --method bun
Решение проблем
- Команда не найдена после установки: перезапустите терминал (обновление PATH) или запустите установщик заново; с npm проверьте, что глобальный каталог bin есть в PATH.
- Запускается не та версия: бинарник V1 перекрывает V2 — удалите установку V1 из пакетного менеджера, затем переустановите V2 и снова проверьте opencode --version.
- Сервис завис после обновления: opencode service restart, затем opencode service status; автоматическая установка не перезапускает работающий сервер.
- Docker не видит файлы: вы забыли про монтирование тома — агент работает с файловой системой контейнера, пока каталог проекта не смонтирован внутрь.
Следующий шаг: OpenCode V2 — сначала раздел «Подключение модели».
Автор статьи: Клавдия Кондакова