Установка OpenCode на Mac, Windows и Linux — пошаговая инструкция
Установка OpenCode на Mac, Windows и Linux — пошаговая инструкция
Установка OpenCode занимает около пяти минут и не требует сложной настройки: достаточно выполнить одну команду в терминале, выбрать способ установки под свою операционную систему и проверить версию. В этой инструкции разберём все способы установки OpenCode — на Mac, Windows и Linux — а также обновление, удаление и частые ошибки.
Что такое OpenCode и зачем он нужен
OpenCode — это бесплатный ИИ-агент с открытым исходным кодом, который работает прямо в терминале и помогает писать, изменять и рефакторить код. Он подключается к языковым моделям (GPT, Claude, Gemini и другим через провайдеров), читает файлы проекта, выполняет команды и автоматизирует рутинные задачи разработки.
Ключевые возможности:
Системные требования
| Компонент | Требование |
|---|---|
| Операционная система | 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 — быстрая и простая задача на любой платформе. Выберите подходящий способ, проверьте версию и переходите к настройке моделей и агентов. Если понадобится помощь с настройкой инструментов разработки или автоматизацией процессов — обращайтесь.
*Отчёт создан: [email protected] · [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) — ответим в течение часа.*
Нужен аудит, SEO или разработка?
Сделаем продвижение, сайт, сервис или калькулятор под вашу задачу — ответим в течение часа.
Написать в WhatsAppTelegram