--- title: Установка OpenCode на Mac, Windows и Linux — пошаговая инструкция slug: opencode-ustanovka description: Как установить OpenCode на Mac, Windows и Linux за 5 минут: официальный установщик, npm, Docker и VS Code. Проверка версии, обновление и устранение ошибок установки. keywords: [opencode установка, как установить opencode, opencode windows, установить opencode на mac, opencode npm] h1: Установка OpenCode на Mac, Windows и Linux — пошаговая инструкция category: OpenCode tags: [opencode, установка, cli, инструменты] date: 2026-08-20 image: /images/articles/opencode-ustanovka.webp image_alt: Установка OpenCode на Mac, Windows и Linux — терминал с установщиком reading_time: ~6 мин author: Refertur canonical: https://ai-courses.refertur.net/articles/opencode-ustanovka/ faq: - q: Как установить OpenCode на Mac проще всего? a: Проще всего установить OpenCode на Mac одной командой в терминале: curl -fsSL https://opencode.ai/install | bash. Установщик сам скачает бинарник, добавит его в PATH и выведет подсказку, как запустить команду opencode. На macOS с Apple Silicon установка занимает меньше минуты. - q: Можно ли установить OpenCode на Windows? a: Да, OpenCode на Windows устанавливается через официальный установщик, через npm (npm i -g opencode-ai) или в WSL (подсистема Windows для Linux). Для работы с командной строкой в Windows рекомендуем Windows Terminal; в WSL установка идентична Linux-инструкции. - q: Как обновить OpenCode до последней версии? a: Обновить OpenCode можно той же командой установщика (curl -fsSL https://opencode.ai/install | bash) — она переустановит актуальную версию поверх старой. Либо выполнить npm update -g opencode-ai, если ставили через npm. Проверить версию: opencode --version. Актуальная версия на момент написания — 1.18.19. - q: Нужен ли Node.js для установки OpenCode? a: Для установки через официальный установщик Node.js не нужен — это автономный бинарник. Node.js требуется только для npm-способа установки и для некоторых расширений и плагинов. Рекомендуемая версия Node.js — 20 и выше. - q: Что делать, если команда opencode не найдена после установки? a: Если команда opencode не найдена, проверьте PATH: установщик обычно добавляет каталог в ~/.local/bin или ~/.opencode/bin. Перезапустите терминал или выполните source ~/.zshrc (для zsh). Альтернатива — вызывать полный путь к бинарнику, который установщик выводит в конце. - q: OpenCode и OpenChamber — это одно и то же? a: Нет. OpenCode — это терминальный ИИ-агент для работы с кодом (CLI). OpenChamber — веб-интерфейс и рабочее пространство поверх OpenCode с сессиями, агентами, браузером и планировщиком. Установка OpenChamber описана в отдельной статье. jsonld: {} --- # Установка 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) и выполните: ```bash curl -fsSL https://opencode.ai/install | bash ``` Установщик скачает актуальную версию, распакует её и добавит в PATH. После завершения перезапустите терминал и проверьте: ```bash opencode --version ``` Если команда не найдена, добавьте каталог установки в PATH: ```bash export PATH="$HOME/.opencode/bin:$PATH" ``` ### Способ 2: через npm Если у вас установлен Node.js версии 20 или выше: ```bash npm install -g opencode-ai opencode --version ``` ### Способ 3: через Homebrew ```bash brew install opencode ``` ## Установка OpenCode на Windows ### Способ 1: официальный установщик (Windows Terminal) Откройте Windows Terminal (или PowerShell) и выполните: ```powershell irm https://opencode.ai/install.ps1 | iex ``` После установки перезапустите терминал и проверьте `opencode --version`. ### Способ 2: через npm ```powershell npm install -g opencode-ai ``` ### Способ 3: WSL (рекомендуется для разработки) Установите WSL и запустите Linux-инструкцию из раздела ниже — OpenCode в WSL работает полноценно, включая Docker и Git. ## Установка OpenCode на Linux ### Debian/Ubuntu ```bash curl -fsSL https://opencode.ai/install | bash ``` ### Через пакетный менеджер ```bash # Arch Linux sudo pacman -S opencode ``` ### Через npm ```bash 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 ```bash # если установили через установщик 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](/articles/opencode-provaydery/) - Настройте MCP-серверы — [Подключение MCP к OpenCode](/articles/opencode-mcp/) - Установите OpenChamber для веб-интерфейса — [Установка OpenChamber](/articles/openchamber-ustanovka/) - Изучите полную документацию — [Документация OpenCode (рус.)](/docs/overview/) #### Следующие шаги ## Часто задаваемые вопросы - Как установить 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 — быстрая и простая задача на любой платформе. Выберите подходящий способ, проверьте версию и переходите к настройке моделей и агентов. Если понадобится помощь с настройкой инструментов разработки или автоматизацией процессов — обращайтесь. --- *Отчёт создан: refertur@yandex.ru · [refertur.net](https://refertur.net) · [t.me/realhikaz](https://t.me/realhikaz) · [WhatsApp](https://wa.me/+77054384888)* *SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в [WhatsApp](https://wa.me/+77054384888?text=%D0%97%D0%B4%D1%80%D0%B0%D0%B2%D1%81%D1%82%D0%B2%D1%83%D0%B9%D1%82%D0%B5%2C%20%D1%85%D0%BE%D1%87%D1%83%20%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0%D1%82%D1%8C%20%D1%81%D0%B5%D0%BE) — ответим в течение часа.*