Як встановити OpenCode на Windows через WSL у 2026 році
Практичний гайд зі встановлення OpenCode на Windows через WSL 2 та Ubuntu: команди, підключення моделі, налаштування проєкту й troubleshooting.
OpenCode можна встановити на Windows через npm, Chocolatey, Scoop, Docker або готові релізи. Офіційна документація рекомендує WSL для кращої сумісності та продуктивності термінального workflow. [1]
WSL дає Linux-середовище всередині Windows без повноцінної віртуальної машини чи dual boot. Це зручно для Node.js, Git hooks, package managers і shell-команд.
Windows залишається вашим desktop, Ubuntu — середовищем розробки, а WSL 2 з’єднує їх.
Скріншот секції why-wslВиконайте команди в PowerShell від імені адміністратора, потім завершіть перше налаштування Ubuntu.
Відкрийте PowerShell як адміністратор
Знайдіть PowerShell у Start menu, натисніть правою кнопкою та виберіть Run as administrator.
Встановіть WSL
Виконайте wsl --install. Microsoft вказує, що команда вмикає потрібні компоненти та встановлює Ubuntu за замовчуванням. [2]
Перезавантажте Windows
Якщо WSL уже встановлений і команда показує лише help, виконайте wsl --list --online, а потім wsl --install -d Ubuntu. [2]
Завершіть налаштування Ubuntu
Відкрийте Ubuntu, створіть Linux username і password. Вони окремі від Windows-акаунта.
Перевірте WSL 2
Виконайте wsl --list --verbose. Ubuntu має показувати version 2. Якщо version 1 — запустіть wsl --set-version Ubuntu 2. [2]
Перевірка WSL
Перед встановленням OpenCode переконайтеся, що Ubuntu працює на WSL 2.
Відкрийте Ubuntu
Запустіть Ubuntu через Start menu або Windows Terminal. Це має бути Linux shell, а не PowerShell.
Оновіть пакети
Виконайте sudo apt update, щоб оновити metadata пакетів.
Встановіть OpenCode
Офіційна команда: curl -fsSL https://opencode.ai/install | bash. Якщо Node.js уже є в Ubuntu, можна використати npm install -g opencode-ai. [1]
Перевірте команду
Виконайте opencode --version. Якщо команда не знайдена, перезапустіть Ubuntu shell і перевірте Linux PATH.
Важливо
Встановлюйте OpenCode в тому Linux-середовищі, де запускаються проєкт і його dependencies.
Використовуйте Linux filesystem
Створіть workspace через mkdir -p ~/projects і зберігайте активні репозиторії в /home/<user>/projects. /mnt/c працює, але часто повільніший.
Відкрийте repository
Наприклад: cd ~/projects && git clone <repository-url>. Не додавайте API keys чи .env у prompts.
Запустіть OpenCode
Виконайте opencode, потім /connect для OpenCode Zen або іншого провайдера.
Ініціалізуйте контекст
Запустіть /init. OpenCode створить AGENTS.md із правилами проєкту. [1]
Почніть із малої задачі
Попросіть пояснити файл, додати один тест або виправити відтворюваний баг. Для складних змін спочатку просіть plan.
opencode: command not found — переконайтеся, що встановили OpenCode всередині Ubuntu, а не лише в PowerShell. Перевірте which node, which npm і повторіть npm install.
Проєкт повільний — перенесіть його з /mnt/c/Users/... до ~/projects/my-app у Linux filesystem.
Ubuntu на WSL 1 — перевірте wsl --list --verbose і виконайте wsl --set-version Ubuntu 2.
Встановлення зависло на 0% — спробуйте wsl --install --web-download -d Ubuntu. [2]
Модель не відповідає — перевірте /connect, API key, quota, billing і вибрану модель.
Перевірте Linux PATH, розташування проєкту та версію WSL — це вирішує більшість проблем.
Скріншот секції troubleshootingПрацюйте в Git branch
Так зміни OpenCode легко переглядати й відкотити.
Починайте з Plan mode
Особливо для auth, payments, migrations та великих refactor.
Захищайте secrets
Не вставляйте .env і production credentials у prompts.
Перевіряйте результат
Запускайте test, typecheck, linter або build.
Так. Офіційно також доступні Chocolatey, Scoop, npm, Docker, Mise та готові релізи. WSL рекомендований для сумісності й продуктивності.
Windows 10 версії 2004 і вище та Windows 11.
Для WSL workflow встановлюйте й запускайте OpenCode всередині Ubuntu, разом із Node.js, package manager та проєктом.
Виконайте `wsl --list --verbose` у PowerShell. Ubuntu має працювати на version 2.
Пов'язані статті
Скільки коштує розробка AI асистента у 2026: RAG чатбот, база знань, CRM, Telegram та підтримка
Практичний гід для бізнесу: від чого залежить ціна розробки AI асистента у 2026 році, що входить у RAG чатбот, інтеграції з CRM, Telegram, guardrails, оцінювання, моніторинг і супровід.
AI-assisted attacks і prompt injection у 2026: нова поверхня атак для продуктів з AI
Практичний гайд з безпеки AI-функцій: prompt injection, tool abuse, excessive agency, RAG poisoning, data leakage, output handling, human approval gates і permissions для AI agents.
AI для розробки лендінгів: де він реально прискорює запуск, а де псує конверсію
Дослідження про використання AI у розробці лендінгів: v0, Webflow AI, Builder.io, Framer-подібні AI builders, генерація UX, copy, SEO, персоналізація, A/B тести, ризики шаблонності, безпеки, доступності та технічного боргу.
AI SEO / GEO у 2026: ваші наступні клієнти — не люди, а агенти
Пошук зміщується від кліків до відповідей. Боти та AI-агенти сканують, цитують, рекомендують і дедалі частіше купують. Дізнайтесь, що таке AI SEO / GEO, чому класичного SEO вже недостатньо, і як PAS7 Studio допомагає брендам перемагати у «агентному» вебі.
Професійна розробка для вашого бізнесу
Створюємо сучасні веб-рішення та боти для бізнесу. Дізнайтеся, як ми можемо допомогти вам досягти цілей.