Как пользоваться OpenCode: установка и первый сайт с нуля

OpenCode — программа, которая может сама работать с файлами на вашем компьютере. Вы открываете папку, описываете задачу обычными словами, а OpenCode создаёт или меняет код прямо внутри этой папки.

Это главное отличие от обычного чата с нейросетью. В чате вы получаете кусок кода и дальше разбираетесь с ним сами. OpenCode может создать файлы, найти ошибку, исправить её и проверить результат.

В этой инструкции соберём вещь, которую не стыдно показать клиенту: одностраничный сайт клининговой компании с работающим калькулятором стоимости. Заодно разберёмся, сколько стоит OpenCode, работает ли он в России и как не дать ему испортить важный проект.

Команды и варианты подключения сверены с официальной документацией 23 августа 2026 года. OpenCode развивается быстро, поэтому названия моделей и расположение кнопок со временем могут измениться.

Что такое OpenCode простыми словами

OpenCode — ИИ-агент для работы с кодом. «Агент» означает, что программа не только отвечает текстом, но и может выполнять действия: читать файлы, записывать изменения и запускать доступные команды.

Например, вы можете попросить:

• сделать сайт по описанию;
• добавить форму заявки на существующую страницу;
• найти причину ошибки;
• адаптировать сайт под телефон;
• объяснить незнакомый проект человеческим языком;
• обработать таблицу или написать небольшой рабочий скрипт.

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

Сам OpenCode не является нейросетью. Это оболочка, к которой подключается модель — например GPT, Claude, Gemini или другая. OpenCode передаёт модели вашу задачу, показывает ей нужные файлы и применяет предложенные изменения.

Поэтому один и тот же OpenCode может работать очень по-разному. Сильная модель обычно лучше понимает большой проект и реже ломает соседние части. Модель попроще может стоить дешевле, но потребует больше уточнений.

Чем OpenCode отличается от Claude Code и Codex

У Claude Code в центре находится Claude, у Codex — модели OpenAI. OpenCode не привязан к одной компании: пользователь сам выбирает модель и сервис, через который к ней подключаться.

Это одновременно плюс и минус.

Плюс — можно менять модели под задачу и бюджет. Сегодня использовать недорогой вариант для простой вёрстки, завтра подключить более сильную модель для сложного проекта.

Минус — первый запуск требует ещё одного решения. Недостаточно установить программу: нужно выбрать, какая модель будет отвечать и кто будет считать оплату.

Если хочется максимально простого старта в привычном приложении, можно начать с Codex. Если уже пользуетесь экосистемой Anthropic, логично посмотреть на Claude Code. OpenCode интереснее тем, кто хочет сам выбирать модели и не зависеть от одной платформы. Подробные инструкции у меня есть отдельно: про Claude Code и про Codex.

Сколько стоит OpenCode

Сам OpenCode бесплатный. Деньги обычно берут за работу подключённой нейросети.

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

При оплате через API расход часто считают в токенах. Для первого знакомства достаточно понимать это как объём текста и кода, который модель прочитала и написала. Чем больше проект и расплывчатее задача, тем выше расход.

Для старта разработчики рекомендуют OpenCode Zen — собственный сервис с моделями, которые проверены для работы в OpenCode. В списке могут быть варианты с пометкой Free, но их состав и условия меняются. Актуальные правила опубликованы в документации OpenCode Zen.

Если у вас уже есть ChatGPT Plus или Pro, OpenCode поддерживает вход через аккаунт OpenAI. Поддерживаются и некоторые другие подписки, например GitHub Copilot. Но подписка одного сервиса не превращается автоматически в ключ другого. Перед подключением лучше проверить актуальный список вариантов в документации OpenCode.

Работает ли OpenCode в России

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

Например, если сервис не регистрирует пользователей из России, не принимает российские карты или ограничивает обращения с российских IP-адресов, OpenCode не сможет отменить эти правила. Он только передаёт запросы выбранному сервису.

Получается, нужно отдельно проверить две вещи:

1. Устанавливается ли сам OpenCode. Обычно с этим проблем нет.
2. Доступен ли выбранный способ подключения к модели из вашего региона и с вашим способом оплаты.

Для теста не покупайте большой пакет заранее. Сначала зарегистрируйтесь, подключите одну модель и выполните короткую задачу. Если используете бесплатный вариант, не отправляйте туда коммерческие документы, персональные данные и закрытый код: условия обработки данных у разных моделей отличаются.

Как установить OpenCode на Windows без WSL

Для первого знакомства проще всего использовать обычное приложение OpenCode Desktop.

1. Откройте официальную страницу загрузки.
2. В разделе OpenCode Desktop нажмите Windows (x64).
3. Запустите скачанный файл и установите приложение.
4. Создайте в «Документах» пустую папку cleaning-site.
5. Запустите OpenCode и откройте эту папку как новый проект.

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

Что такое WSL и нужен ли он вам

WSL — встроенная в Windows возможность запустить среду Linux. Её любят разработчики, потому что многие инструменты для сайтов и программ в Linux работают предсказуемее.

Для первого знакомства с OpenCode WSL не нужен. Можете пропустить этот раздел и работать в обычном приложении.

Возвращаться к WSL имеет смысл, если OpenCode Desktop не запускает нужные команды, медленно работает с большим проектом или вы уже разрабатываете в Linux. Сама команда установки выглядит так:

wsl --install

После перезагрузки Windows внутри WSL отдельно устанавливают OpenCode. Подробности есть в официальной инструкции для Windows и в инструкции Microsoft по WSL.

Установка на macOS и Linux

Для macOS на странице загрузки есть отдельные версии для процессоров Apple и Intel. Для Linux доступны пакеты .deb и .rpm. Это такой же понятный путь, как установка любого другого приложения.

Если вы привыкли к терминалу, официальная команда для macOS и Linux выглядит так:

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

На Mac можно установить OpenCode через Homebrew:

brew install anomalyco/tap/opencode

Новичку не нужно выбирать терминал только потому, что им пользуются разработчики. Берите Desktop, а к командам переходите, когда для них появится реальная причина.

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

После первого запуска OpenCode попросит выбрать, через какой сервис обращаться к нейросети. В приложении этот раздел обычно находится в настройках, в пункте Providers. Слово provider здесь означает просто «сервис, который даёт доступ к модели».

Для понятного первого запуска можно выбрать OpenCode Zen:

1. Откройте настройки OpenCode и раздел Providers.
2. Найдите OpenCode Zen и нажмите подключение.
3. Перейдите по предложенной ссылке, войдите в аккаунт и создайте API-ключ.
4. Скопируйте ключ и вставьте его в OpenCode.
5. Откройте список моделей и выберите подходящую. Для теста можно взять вариант с пометкой Free, если он доступен.

В терминальной версии тот же процесс запускается командой /connect, а список моделей открывается командой /models.

Не отправляйте API-ключ сообщением самому агенту. Он не нужен в тексте задачи. Ключ вводится только в специальном окне подключения.

Если OpenCode Zen вам недоступен, можно подключить OpenAI, OpenRouter или другой сервис, в котором вы смогли легально зарегистрироваться и получить ключ. Не выбирайте случайную модель только по красивому названию: для работы с файлами ей должны хорошо даваться программирование и вызов инструментов.

Первая задача: делаем сайт клининговой компании

Мы специально возьмём одностраничный сайт без сервера, базы данных и оплаты. Его можно открыть двойным щелчком по файлу, но результат уже похож на реальную рабочую заготовку для малого бизнеса.

Откройте в OpenCode созданную папку cleaning-site и отправьте такой запрос:

Такой запрос хорош не из-за длины. В нём есть конкретный результат, исходные данные, правила расчёта и границы. Агенту не приходится угадывать цены, телефон или содержание страницы.

После выполнения в папке появится файл index.html. Откройте папку через Проводник и дважды нажмите на файл. Сайт запустится в обычном браузере.

Как проверить, что сайт действительно работает

Фраза OpenCode «готово» ничего не гарантирует. Результат считается готовым, только если его проверили руками.

Для нашего сайта достаточно пяти проверок:

1. Введите площадь 20 м² и выберите поддерживающую уборку. Результат должен быть 3000 ₽, потому что сработал минимальный заказ.
2. Введите 50 м² и выберите поддерживающую уборку. Должно получиться 4000 ₽.
3. Для 50 м² и генеральной уборки должно получиться 7500 ₽.
4. Нажмите кнопку «Рассчитать стоимость» вверху страницы. Она должна прокрутить страницу к калькулятору.
5. Сузьте окно браузера примерно до ширины телефона. Текст не должен вылезать за экран, а кнопки должны оставаться удобными.

Отдельно проверьте, что на странице указан город Казань, телефон совпадает с заданием, а OpenCode не придумал «10 лет на рынке» или «5000 довольных клиентов».

Если расчёты неверны, не просите «переделать сайт». Назовите точный пример, который сломался. Так модель исправит калькулятор и с меньшей вероятностью затронет нормальный дизайн.

Как попросить о правке

Первый вариант почти всегда приходится доводить. Это нормально: работа с ИИ-агентом состоит из коротких циклов «задача — проверка — уточнение».

Допустим, калькулятор считает правильно, но пользователь не понимает, почему для маленькой квартиры получилось 3000 ₽. Напишите:

Здесь мы называем проблему, нужное изменение и то, что трогать нельзя. Формулировка «сделай нормально» такой информации не даёт.

Если не нравится внешний вид, тоже говорите предметно: «на телефоне кнопка прилипает к краю», «заголовок занимает четыре строки», «цены плохо заметны». Чем конкретнее обратная связь, тем полезнее следующий результат.

Как отменить неудачное изменение

У OpenCode есть команда /undo, которая отменяет последнее сообщение вместе с изменениями файлов. Команда /redo возвращает отменённое.

Но есть важная деталь: для отката файлов OpenCode использует Git. Git — система, которая хранит историю изменений проекта. Если папка не является Git-репозиторием, полагаться на /undo нельзя.

Самый простой вариант для первого опыта — перед крупной правкой сделать копию папки cleaning-site. Для регулярной работы установите Git for Windows, откройте терминал в папке проекта и один раз выполните:

git init

Никуда в интернет проект не отправится. Команда только включит локальную историю в этой папке.

Перед работой с настоящим сайтом лучше сохранить текущее состояние отдельным коммитом или хотя бы резервной копией. ИИ-агент может понять задачу неправильно, а команда отмены — не повод отказываться от обычной страховки.

Как безопасно работать с настоящим проектом

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

Перед работой проверьте четыре вещи:

• в папке нет паролей, ключей и клиентских выгрузок;
• есть резервная копия или история Git;
• задача говорит, какие файлы можно менять;
• после работы вы проверите сайт сами, а не поверите отчёту агента.

Не давайте задачу «изучи всё и улучши как считаешь нужным». Лучше разделить её: сначала попросить разобраться и написать план, затем согласовать один блок и только потом разрешить изменения.

Для существующего сайта полезен такой запрос:

После проверки плана можно дать отдельную команду на реализацию. Так проще заметить, если агент собирается менять не те части проекта.

Типичные проблемы первого запуска

Не получается подключить модель. Проверьте, тот ли сервис вы выбрали и его ли API-ключ вставили. Ключ OpenRouter нельзя вводить как ключ OpenAI. При сомнениях удалите подключение и создайте новый ключ в личном кабинете сервиса.

Модель не отвечает. Возможные причины — закончился баланс, бесплатный вариант убрали, сервис недоступен в вашем регионе или модель временно перегружена. Выберите другую доступную модель и отправьте короткий тестовый запрос.

OpenCode просит разрешить действие. Прочитайте, что именно он собирается сделать. Создание index.html внутри учебной папки ожидаемо. Установка программы, удаление большого числа файлов или доступ за пределы проекта — повод отказать и уточнить задачу.

Сайт открылся, но калькулятор не работает. Скопируйте в OpenCode точные значения: что ввели, что ожидали и что получили. Не ограничивайтесь фразой «сломалось».

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

Кому подойдёт OpenCode

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

Если любые слова вроде API-ключа и Git пока только мешают, начните с OpenCode Desktop, бесплатной тестовой модели и отдельной папки. Не нужно сначала становиться разработчиком и устанавливать Linux внутри Windows.

Главное — не воспринимать OpenCode как волшебную кнопку. Хороший результат появляется, когда вы даёте конкретные данные, ограничиваете задачу и проверяете то, что получилось. В нашем примере это не абстрактный «сайт под ключ», а страница с двумя известными тарифами и тремя расчётами, которые можно проверить за минуту.

Что важно запомнить

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

На Windows новичку проще начать с OpenCode Desktop. WSL — это дополнительная среда Linux для более серьёзной разработки, а не обязательный первый шаг.

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

В Telegram-канале я показываю, как с помощью нейросетей автоматизирую процессы в бизнесе, запускаю и продвигаю соло-проекты. Подписывайтесь по кнопке ниже.