Opencode установка

Opencode установка: поставь CLI v2 из официальной документации, подготовь учебную папку и подключи модель через /connect и /models внутри OpenCode. Ниже - полный терминальный маршрут для Windows, macOS и Linux; для приложения Desktop отдельно показан выбор загрузки.

Проверено: 23 октября 2026 года, официальная документация OpenCode v2 и страница загрузки. Ниже - инструкция по этим источникам, а не отчёт об установке на всех трёх системах.

Opencode установка: какой вариант тебе выбрать?

CLI - версия для терминала: окна, куда вводят команды. Именно для неё дальше показаны подключение и проверка первого ответа. Desktop - обычное приложение с окном; его установщики перечислены отдельно. Сам OpenCode - агент для работы с файлами, а модель - ИИ, который отвечает на твои задачи.

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

Если ещё выбираешь инструмент, посмотри сравнение OpenCode и Claude Code.

Как не перепутать команды старой версии и v2?

На дату проверки официальные страницы показывают разные ветки. В русском введении остаются npm install -g opencode-ai и brew install anomalyco/tap/opencode. На текущей странице загрузки и в документации v2 указаны @opencode/cli и anomalyco/tap/opencode-v2.

Для новой установки по этой инструкции используй команды v2 ниже. Не выполняй все найденные способы подряд: несколько установок осложняют проверку того, какой именно файл запускается.

Особенно важно для Windows: документация v2 прямо говорит, что пакетные менеджеры Windows не поддерживаются. Старые советы про Chocolatey, Scoop или npm в Windows нельзя автоматически переносить на v2. Для нативного CLI возьми официальный архив; для первого знакомства можно остаться на Desktop.

Как поставить Desktop на Windows, macOS или Linux?

Открой официальную страницу загрузки и найди раздел OpenCode Desktop. Выбери установщик под свою систему и процессор.

1. На Windows проверь «Параметры → Система → О системе → Тип системы» и выбери x64 либо ARM64. Скачай соответствующий установщик и пройди его шаги.
2. На Mac посмотри тип процессора в меню «Об этом Mac». Для чипа Apple бери Apple Silicon, для процессора Intel - Intel.
3. На Linux выбери подходящий пакет. В документации v2 есть .deb, .rpm и AppImage с вариантами архитектуры; не устанавливай пакет другого семейства только потому, что он скачался.
4. Запусти приложение. Для первого проекта подготовь отдельную папку opencode-test без паролей, клиентских выгрузок и настоящего кода.

Открытое окно означает, что приложение запускается. Дальнейшие команды и учебная проверка этой статьи относятся к CLI v2; названия кнопок подключения Desktop здесь не проверены. Не отключай защиту системы целиком при проблеме с установщиком: сначала сверь источник файла и совместимость с системой.

Как установить CLI v2 через терминал?

Выбери один способ. Команды этого раздела сверены с документацией v2 23 октября 2026 года.

macOS и Linux: выбери скрипт, Homebrew или npm

Официальный установочный скрипт запускается в среде с bash:

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

Команда скачивает и сразу выполняет скрипт с сайта. Запускай её только с официальным адресом; если не хочешь выполнять удалённый скрипт, выбери другой способ. В обычный PowerShell эту команду вставлять не нужно.

Если у тебя уже есть Homebrew:

brew install anomalyco/tap/opencode-v2

Если уже пользуешься Node.js и npm:

node --version
npm --version
npm install -g @opencode/cli

Первые две команды проверяют наличие инструментов. Если Node.js или npm не находятся, выбери скрипт установки. Для готового установщика Desktop документация не предлагает предварительно ставить Node.js. Пакет CLI использует установочный скрипт для выбора исполняемого файла под платформу; запрет таких скриптов может помешать установке.

После выбранного способа закрой и снова открой терминал, затем проверь:

opencode --version

В ответе должен появиться номер версии v2, начинающийся с 2.. Если видишь 1., проверь, какую копию запускаешь: в macOS/Linux команда command -v opencode покажет путь. Конкретный номер обновления меняется со временем.

Windows: запусти бинарник из официального архива

В документации v2 открой список standalone CLI и скачай Windows x64 или ARM64. Распакуй архив в отдельную папку, найди в нём исполняемый файл OpenCode и открой PowerShell в этой папке. Для файла с именем opencode.exe проверка выглядит так:

.\opencode.exe --version

В ответе должна быть версия v2 с началом 2.. Если запуск из этой папки работает, а команда opencode из другого места не находится, терминал не видит папку программы. Можно добавить её в пользовательскую Path - список мест поиска программ. Ниже используем полный путь к файлу, поэтому менять Path для учебной проверки не потребуется.

WSL - отдельная Linux-среда внутри Windows. Если ты уже работаешь в ней, используй Linux-маршрут и запускай агент в том же окружении, где лежит проект. Для Desktop или нативного бинарника WSL не обязателен.

Как подготовить учебную папку перед запуском CLI?

Создай отдельную папку opencode-test в своём пользовательском каталоге. В текстовом редакторе сохрани в ней два обычных текстовых файла с именами README.md и opencode.jsonc. Проверь полные имена: Windows может скрывать расширения, а файл README.md.txt - другое имя.

В README.md вставь учебные данные:

# Учебная проверка
Назначение папки: проверить чтение файлов.
Контрольное слово: СЕВЕР.

В opencode.jsonc сохрани настройки по официальной схеме разрешений v2:

{
  "$schema": "https://opencode.ai/config.json",
  "permissions": [
    { "action": "*", "resource": "*", "effect": "ask" },
    { "action": "shell", "resource": "*", "effect": "deny" },
    { "action": "subagent", "resource": "*", "effect": "deny" },
    { "action": "edit", "resource": "*", "effect": "deny" },
    { "action": "external_directory", "resource": "*", "effect": "deny" }
  ]
}

Пример запрещает встроенные правки, shell-команды, запуск помощников и проверяемый доступ вне проекта. Остальные действия требуют подтверждения. Это ограничения инструментов, а не изоляция всей операционной системы: в v2 более поздние глобальные правила и правила агента могут переопределять проектные. Для первого опыта используй обычные настройки без собственных агентов и широких разрешений. Если у тебя уже настроены такие переопределения, сначала сверь их с документацией.

Когда оба файла готовы, открой терминал в учебной папке. Если создал её непосредственно в домашнем каталоге, на macOS/Linux введи:

cd ~/opencode-test
opencode

На Windows перед выходом из папки программы сохрани полный путь к ней: скопируй его из адресной строки Проводника. Затем перейди в учебную папку. Пример для PowerShell:

Set-Location "$HOME\opencode-test"
& 'C:\Tools\OpenCode\opencode.exe'

Во второй строке замени пример C:\Tools\OpenCode\opencode.exe настоящим полным путём к распакованному файлу. Кавычки сохраняй: они нужны и для путей с пробелами. Этот запуск не требует настройки Path.

Как подключить модель и проверить первый ответ?

Провайдер - сервис, который даёт доступ к моделям. Для проверки нужен аккаунт с доступной моделью и подходящим способом входа. Условия регистрации, оплаты и доступности проверь у самого сервиса; установленный OpenCode не создаёт такой доступ автоматически.

Внутри терминального интерфейса OpenCode введи:

/connect

Выбери своего провайдера и следуй его шагам подключения. В v2 доступны разные методы, включая API-ключ и вход через браузер. API-ключ - секретный ключ доступа, который выдаёт сервис. Вставляй его только в поле подключения, не в сообщение агенту и не в учебный файл. Если доступ ещё не оформлен, сначала получи его у выбранного сервиса на его условиях.

Затем открой список и выбери доступную модель:

/models

Коротко: opencode запускается в терминале системы, а /connect и /models вводятся внутри интерфейса OpenCode. Эти шаги описаны для CLI/TUI v2, не для окна Desktop.

Отправь первую задачу:

Прочитай README.md в текущей папке. Назови назначение папки и контрольное слово. Не меняй файлы, не запускай команды и не обращайся к другим каталогам.

Если появится запрос на чтение, проверь имя файла и разреши только это действие. Отклони запрос на правку, запуск команды или выход за пределы папки. При неожиданном запросе останови проверку и сверь настройки; не разрешай всё сразу ради ответа.

Проверь результат сам:

• В ответе указаны назначение «проверить чтение файлов» и слово «СЕВЕР».
• После ответа содержимое README осталось прежним.
• Ты не одобрял лишних действий; при сомнении уточни путь прочитанного файла.

Совпавшие факты показывают, что ответ соответствует учебному файлу. Дополнительно проверь в истории действий, что агент действительно прочитал README.md из нужной папки. Это проверка базового запуска, не качества генерации кода и не всех возможных обращений к файлам. Следующие шаги собраны в маршруте начала работы с вайбкодингом.

Дальше - постановка задач и проверка изменений. Посмотри программу ClaudeBase: в материалах по Claude Code и Codex показано, как ставить задачи агенту и проверять результат. Программа открыта без оплаты; материалы базы доступны по подписке. Тарифы Claude и OpenAI оплачиваются отдельно.

Перед первой правкой настоящего проекта сделай резервную копию. Дай агенту одну ограниченную задачу, посмотри изменения и только после этого продолжай: на одну команду отмены полагаться не стоит.

Что проверить, если OpenCode не запускается или не отвечает?

Ищи сбой на том шаге, где он появился. Повторная установка клиента не исправляет автоматически доступ к провайдеру.

Последние команды взяты из справки устранения сбоев v2. На Windows без настроенной Path вызови их через полный путь к исполняемому файлу, как при первом запуске, добавив после него service status или service restart. Перезапуск затрагивает общий фоновый сервис, поэтому не делай его во время другой важной сессии. Перед отправкой ошибки в поддержку удали из сообщения ключи, содержимое закрытых файлов и личные данные.

Источники

Открыты и сверены 23 октября 2026 года:

• OpenCode v2: установка CLI и Desktop.
• Официальные загрузки по системам.
• Запуск терминального интерфейса v2.
• Подключение провайдера и выбор модели.
• Разрешения v2 и правила доступа к файлам.
• Устранение сбоев фонового сервиса.
• Старое русское введение для сверки различий команд.