Установка OpenCode на Mac, Windows и Linux — пошаговая инструкция

Установка OpenCode занимает около пяти минут и не требует сложной настройки: достаточно выполнить одну команду в терминале, выбрать способ установки под свою операционную систему и проверить версию. В этой инструкции разберём все способы установки OpenCode — на Mac, Windows и Linux — а также обновление, удаление и частые ошибки.

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

OpenCode — это бесплатный ИИ-агент с открытым исходным кодом, который работает прямо в терминале и помогает писать, изменять и рефакторить код. Он подключается к языковым моделям (GPT, Claude, Gemini и другим через провайдеров), читает файлы проекта, выполняет команды и автоматизирует рутинные задачи разработки.

Ключевые возможности:

• Генерация и редактирование кода прямо в терминале
• Работа с Git: коммиты, ветки, пул-реквесты
• Подключение MCP-серверов (базы, браузер, API)
• Создание собственных агентов и скиллов
• Автономный режим для полностью автоматизированных задач
• Интеграция с OpenChamber для работы через веб-интерфейс

Системные требования

Компонент	Требование
Операционная система	macOS 12+, Windows 10/11, Linux (glibc 2.35+)
Процессор	x64 или ARM (Apple Silicon, ARM64)
Оперативная память	от 4 ГБ (рекомендуется 8+ ГБ)
Диск	от 200 МБ свободного места
Интернет	Требуется для загрузки модели и работы API

Важно: на macOS ниже 12.6 и Linux со старой версией glibc (< 2.35) часть функций Cloudflare Workers runtime и некоторые команды могут работать с предупреждениями. Рекомендуется использовать актуальные версии ОС.

Установка OpenCode на Mac

Способ 1: официальный установщик (рекомендуется)

Откройте Терминал (Spotlight → Terminal) и выполните:

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

Установщик скачает актуальную версию, распакует её и добавит в PATH. После завершения перезапустите терминал и проверьте:

opencode --version

Если команда не найдена, добавьте каталог установки в PATH:

export PATH="$HOME/.opencode/bin:$PATH"

Способ 2: через npm

Если у вас установлен Node.js версии 20 или выше:

npm install -g opencode-ai
opencode --version

Способ 3: через Homebrew

brew install opencode

Установка OpenCode на Windows

Способ 1: официальный установщик (Windows Terminal)

Откройте Windows Terminal (или PowerShell) и выполните:

irm https://opencode.ai/install.ps1 | iex

После установки перезапустите терминал и проверьте opencode --version.

Способ 2: через npm

npm install -g opencode-ai

Способ 3: WSL (рекомендуется для разработки)

Установите WSL и запустите Linux-инструкцию из раздела ниже — OpenCode в WSL работает полноценно, включая Docker и Git.

Установка OpenCode на Linux

Debian/Ubuntu

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

Через пакетный менеджер

# Arch Linux
sudo pacman -S opencode

Через npm

npm install -g opencode-ai

Проверка установки и первый запуск

1. Проверьте версию: opencode --version — должна отобразиться версия (например, 1.18.19).
2. Проверьте помощь: opencode --help — список команд.
3. Запустите: opencode — начнётся интерактивная сессия.
4. Подключите провайдера модели (например, OpenAI или Anthropic) — инструкция в статье про провайдеры OpenCode.

Обновление OpenCode

Способ установки	Команда обновления
Официальный установщик	curl -fsSL https://opencode.ai/install | bash
npm	npm update -g opencode-ai
Homebrew	brew upgrade opencode

Рекомендуется обновляться раз в 1–2 недели: проект развивается быстро, новые версии добавляют функции и исправляют ошибки.

Удаление OpenCode

# если установили через установщик
rm -rf ~/.opencode
rm /usr/local/bin/opencode  # если бинарник был там

# если через npm
npm uninstall -g opencode-ai

Частые ошибки и их решение

Ошибка	Причина	Решение
command not found: opencode	PATH не настроен	Добавьте каталог установки в PATH или перезапустите терминал
curl: command not found	Нет curl в системе	Установите curl (на Windows используйте PowerShell-установщик)
Permission denied	Нет прав на запись	Запустите установщик без sudo (ставит в домашний каталог) или исправьте права
npm not found	Нет Node.js	Установите Node.js 20+ или используйте официальный установщик
Unsupported macOS version	ОС старше 12.6	Обновите macOS или используйте WSL/Docker

Что дальше

После установки OpenCode переходите к следующему шагу:

• Подключите модели провайдеров — Провайдеры моделей в OpenCode
• Настройте MCP-серверы — Подключение MCP к OpenCode
• Установите OpenChamber для веб-интерфейса — Установка OpenChamber
• Изучите полную документацию — Документация OpenCode (рус.)

Следующие шаги

Часто задаваемые вопросы

• Как установить OpenCode на Mac проще всего? — Одной командой curl -fsSL https://opencode.ai/install | bash; на Apple Silicon — меньше минуты.
• Можно ли установить OpenCode на Windows? — Да: PowerShell-установщик, npm или WSL (рекомендуется).
• Как обновить OpenCode? — Повторным запуском установщика или npm update -g opencode-ai.
• Нужен ли Node.js для установки? — Нет, если используете официальный установщик; только для npm-способа.
• Что делать, если команда не найдена? — Проверьте PATH и перезапустите терминал.
• OpenCode и OpenChamber — это одно и то же? — Нет: OpenCode — CLI-агент, OpenChamber — веб-интерфейс поверх него.

Заключение

Установка OpenCode — быстрая и простая задача на любой платформе. Выберите подходящий способ, проверьте версию и переходите к настройке моделей и агентов. Если понадобится помощь с настройкой инструментов разработки или автоматизацией процессов — обращайтесь.

---

Отчёт создан: [email protected] · refertur.net · t.me/realhikaz · WhatsApp SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в WhatsApp — ответим в течение часа.