OpenCode AI для начинающих: как установить агента, подключить модель и выполнить первую задачу
OpenCode работает в терминале, читает файлы текущего проекта и может менять их после вашего разрешения. Для первого запуска не нужен большой репозиторий. Безопаснее взять отдельную папку с двумя-тремя файлами и пройти короткий цикл: установка, подключение модели, план, одна правка и ручная проверка.
Что понадобится
OpenCode не является самой моделью. Это агент, к которому подключается провайдер: Anthropic, OpenAI, Google, локальная модель или другой совместимый сервис. Поэтому заранее решите, какой учетной записью или API-ключом будете пользоваться.
Еще нужны терминал, Git и тестовая папка. Не начинайте из домашней директории: тогда агент получит слишком широкую область обзора.
Установите OpenCode одним способом
Для macOS и Linux в официальной документации указан установочный скрипт. Также доступны npm и Homebrew. Выберите один вариант, чтобы в системе не оказалось нескольких разных копий.
curl -fsSL https://opencode.ai/install | bash
После установки закройте и заново откройте терминал, затем выполните opencode --version. В Windows разработчики рекомендуют WSL; есть и варианты установки через npm, Chocolatey или Scoop.
Подготовьте учебный проект
Создайте папку opencode-first-task, добавьте в нее простой HTML-файл и инициализируйте Git. В файле можно оставить заголовок, поле имени и кнопку без проверки ввода. Сделайте исходный коммит. Он станет точкой возврата, если агент изменит лишнее.
Откройте терминал именно в этой папке и запустите opencode. Команда /init помогает создать проектные инструкции. Прочитайте получившийся файл: команды запуска и тестирования должны соответствовать реальному проекту, а секретов в нем быть не должно.
Подключите провайдера и модель
Внутри OpenCode выполните /connect, выберите провайдера и пройдите предложенный способ авторизации. Для API-ключа используйте хранилище учетных данных OpenCode или переменную окружения, а не файл проекта.
После подключения выберите доступную модель. Для первой задачи важнее не максимальная мощность, а предсказуемый доступ и понятная стоимость. Если провайдер списывает деньги за запросы, установите лимит на его стороне.
Проверить соединение можно нейтральным запросом:
Прочитай файлы проекта. Ничего не меняй. Объясни, как сейчас работает форма и какие два риска есть у проверки имени.
Если агент описал файлы, которых в папке нет, остановитесь и проверьте текущую директорию.
Сначала попросите план
В OpenCode можно переключаться между режимами планирования и внесения изменений. Начните с плана и ограничьте задачу:
Добавь проверку поля имени. Пустое значение и строка короче двух символов не должны отправляться. Покажи сообщение рядом с полем. Не меняй стили и структуру страницы. Сначала перечисли файлы и шаги, код пока не пиши.
Хороший план на такую задачу состоит из нескольких понятных действий. Если агент предлагает подключить фреймворк, переписать страницу или установить пакет, верните его к исходным ограничениям.
Разрешите одну правку и проверьте результат
После согласования плана переключитесь в режим изменений. Когда OpenCode закончит, не принимайте его отчет как доказательство.
Проверьте git diff, откройте страницу и вручную пройдите три случая: пустое поле, одна буква и корректное имя. Убедитесь, что исходное поведение формы не сломалось. В Git должны быть только те строки, которые относятся к проверке.
Если изменение не подходит, попросите исправить конкретный дефект. Команда /undo помогает откатить последние действия агента, но контрольный коммит все равно надежнее: он виден вне OpenCode и не зависит от истории сессии.
Частые ошибки первого запуска
Первая ошибка: агент запущен не из той папки. Вторая: ключ сохранен в .env, который попал в Git. Третья: пользователь сразу просит «улучшить весь проект» и получает десятки несвязанных правок.
Не выдавайте агенту доступ к рабочим базам, облачной консоли и платежам ради учебной формы. Сначала освойте локальный цикл и подтверждения.
Этот же цикл используется и в более крупных проектах: задача, план, малая правка, diff, тест и коммит. На курсе "Вайб-кодинг на максималках" «Вайбкодинг на максималках» он продолжается до базы данных, деплоя и защиты проекта. OpenCode там не является основным инструментом, поэтому упоминание относится именно к процессу, а не к отдельному уроку по этому агенту.
OpenCode готов к работе, когда вы точно знаете текущую папку, понимаете, какая модель подключена, и можете независимо проверить каждую правку. Первую сессию стоит закончить одним небольшим коммитом, а не большой перестройкой проекта.