Как установить OpenCode на Windows

OpenCode на Windows устанавливается одной командой: npm install -g opencode-ai, также подойдут Chocolatey и Scoop. Разработчики рекомендуют запускать агент в WSL, но работает он и в обычной Windows. После установки агенту нужна модель. Из России её проще всего подключить через AI для кода от PurpleSchool: ключ оплачивается в рублях, VPN не нужен.

Ниже — какой способ установки выбрать, как настроить ключ в PowerShell и что делать с ошибками.

Что нужно перед установкой

• Node.js и npm — если ставите через npm. Проверьте командой npm --version.
• Терминал. Подойдёт Windows Terminal, а документация OpenCode также называет WezTerm и Alacritty.
• API-ключ для модели. Его можно получить после установки.

Как установить OpenCode на Windows

Все команды взяты из официальной документации. Выполняйте их в PowerShell.

Через npm

Самый простой вариант, если Node.js уже установлен:

npm install -g opencode-ai

Через Chocolatey

choco install opencode

Через Scoop

scoop install opencode

Другие способы

Есть также Mise (mise use -g github:anomalyco/opencode) и образ Docker. Установка через Bun на Windows, по данным документации, пока дорабатывается, поэтому использовать её не стоит.

Проверьте результат в новом окне терминала:

opencode --version

Если нужно приложение с окном, а не терминальный агент, смотрите статью OpenCode Desktop.

Windows или WSL

Документация OpenCode рекомендует WSL: так выше скорость работы с файлами и полнее поддержка терминала.

Если у вас уже есть WSL, установите агента внутри дистрибутива:

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

Диски Windows доступны внутри WSL через /mnt, например C: — это /mnt/c/. Для лучшей скорости держите репозиторий в файловой системе WSL, например в ~/code/.

Не смешивайте среды. Если агент работает в WSL, ключ тоже нужно задавать там. Переменную из PowerShell агент не увидит.

Как задать ключ

Получите ключ на странице AI для кода. Тарифы начинаются от 499 ₽ в месяц за 2,5 млн токенов, а новым пользователям доступна проба: 500 000 токенов на 7 дней.

Сохраните ключ в переменной окружения:

[Environment]::SetEnvironmentVariable("PURPLESCHOOL_API_KEY", "ваш ключ", "User")
$env:PURPLESCHOOL_API_KEY="ваш ключ"

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

if ($env:PURPLESCHOOL_API_KEY) { "ключ задан" } else { "ключа нет" }

В WSL добавьте строку в ~/.bashrc:

export PURPLESCHOOL_API_KEY="ваш ключ"

Как подключить модель

Создайте файл opencode.json в корне проекта:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "purpleschool": {
      "npm": "@ai-sdk/openai",
      "name": "PurpleSchool OpenAI Proxy",
      "options": {
        "baseURL": "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1",
        "apiKey": "{env:PURPLESCHOOL_API_KEY}"
      },
      "models": {
        "gpt-5.6-sol": {
          "name": "gpt-5.6-sol"
        }
      }
    }
  }
}

Ключ в файл не попадает: значение подставляется из переменной. Актуальный список моделей смотрите в личном кабинете. Подробный разбор полей есть в статье OpenCode в России.

Можно настроить всё автоматически одной командой. Ей нужен Node.js 22 или новее:

npx @purpleschool/ai-for-code

Как запустить OpenCode

Перейдите в папку проекта и запустите агента:

cd C:\Users\ВашеИмя\my-project
opencode

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

/models

В списке будет провайдер PurpleSchool OpenAI Proxy. Выберите модель и задайте простой вопрос, например «что делает этот проект?». Если агент ответил, настройка завершена.

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

opencode не является командой. Откройте новое окно терминала. Если не помогло, проверьте папку глобальных пакетов командой npm config get prefix и убедитесь, что она добавлена в PATH.

Выполнение сценариев отключено. PowerShell может блокировать запуск .ps1, включая обёртки npm. Разрешите подписанные сценарии для своего пользователя:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Интерфейс отображается неправильно. Старое окно консоли плохо справляется с терминальным интерфейсом. Запустите агента в Windows Terminal или другом современном терминале.

Модели нет в списке. OpenCode не нашёл конфиг. Проверьте, что вы запустили агента из папки с opencode.json, и что в файле нет ошибок JSON.

Ошибка 401. Переменная не задана в этом окне или ключ скопирован с ошибкой. Проверьте её командой из раздела о ключе.

Ключ не виден в WSL. Переменные Windows не передаются в WSL автоматически. Задайте ключ внутри дистрибутива.

Частые вопросы

OpenCode на Windows бесплатный? Программа бесплатна и имеет открытый код. Платить нужно за модель. Варианты разобраны в статье OpenCode Zen или свой ключ.

Нужен ли VPN для установки? Установка через npm в обычных условиях проходит без VPN. Для работы модели VPN также не нужен, если подключить её через российский шлюз.

Как обновить OpenCode? Для npm выполните npm install -g opencode-ai ещё раз. Для Chocolatey и Scoop используйте их команды обновления.

Можно ли подключить к OpenCode модели Claude? Да. На странице AI для кода есть инструкции для обоих протоколов, Anthropic API и OpenAI API.

Итог

Для быстрого старта установите OpenCode через npm install -g opencode-ai, а для постоянной работы лучше настроить WSL. Затем задайте ключ, опишите провайдера в opencode.json и выберите модель через /models. Ключ с оплатой в рублях и пробным балансом можно получить в AI для кода от PurpleSchool.