Вайб-кодинг с OpenCode: гайд по open-source агенту в терминале

Если вы искали бесплатную альтернативу Claude Code с открытым кодом, OpenCode — самый очевидный кандидат. Идея та же: агент живёт в терминале рядом с вашим проектом, а не в отдельном редакторе. Разница в философии: Claude Code сделан Anthropic вокруг моделей Claude, а в OpenCode модель и провайдера выбираете вы сами.

В этом гайде разберём, что такое OpenCode и как он устроен, чем он отличается от Claude Code, как выглядит рабочий процесс вайб-кодинга в нём и как подключить свою модель. Подключение покажем на примере Kumo: один base URL и один ключ открывают весь каталог флагманских моделей с оплатой российской картой.

OpenCode — это open-source проект: исходный код открыт, инструмент можно свободно установить, изучить и использовать без подписки. Запускается он командой opencode в каталоге проекта и разворачивает полноценный TUI-интерфейс прямо в терминале: история диалога, просмотр изменений, переключение моделей — всё без выхода из консоли. Это не автодополнение и не чат сбоку от редактора, а агент, которому вы отдаёте задачу целиком.

Работает он итерациями: читает нужные файлы, предлагает изменения, редактирует код, запускает тесты и команды, смотрит на результат и правит дальше. Ваша роль — ставить задачу, смотреть диффы и принимать решения. Это и есть вайб-кодинг в его терминальной форме: вы управляете направлением, агент выполняет механическую работу.

Ключевое отличие от большинства аналогов — независимость от вендора. OpenCode поддерживает десятки LLM-провайдеров: Anthropic, OpenAI, Google и другие, а также любые кастомные сервисы с OpenAI-совместимым API. Инструмент ничего не стоит сам по себе; ваши расходы — это токены выбранного провайдера, и только они.

Контекст проекта агент берёт из файла с инструкциями в корне репозитория — там описывают стек, соглашения и типичные команды, аналогично файлу CLAUDE.md у Claude Code. Один раз потратив десять минут на такой файл, вы заметно поднимете качество каждой сессии.

Устанавливается OpenCode одной командой — через пакетный менеджер вроде npm или brew либо скриптом с официального сайта. После установки перейдите в каталог проекта и запустите opencode: агент подхватит структуру репозитория и откроет интерфейс.

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

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

Сходств между ними больше, чем различий: оба — терминальные агенты, оба работают с целым проектом, оба строят план, правят код и запускают команды. Если вы освоили один, второй покажется знакомым с первых минут. Мы подробно разбирали Claude Code в отдельной статье серии — рабочий процесс оттуда почти целиком переносится и на OpenCode.

Claude Code — продукт Anthropic, спроектированный вокруг моделей Claude. Это его сила: инструмент и модель развиваются вместе, поведение агента отточено под конкретное семейство моделей, и из коробки всё работает без настройки. Но и рамка та же: вы работаете внутри экосистемы Anthropic и с её моделями.

OpenCode делает противоположную ставку — на открытость. Код открыт, провайдера и модель выбираете вы: хоть Claude, хоть GPT, хоть DeepSeek, хоть свой корпоративный endpoint. Модель можно менять прямо по ходу работы под конкретную задачу. Цена этой свободы — чуть больше настройки на старте, а качество работы агента зависит от того, какую модель вы выбрали.

Честный вывод: это не вопрос «лучше или хуже», а вопрос приоритетов. Нужен максимально отлаженный опыт с Claude — берите Claude Code. Нужны открытый код, свобода выбора модели и контроль над стеком — берите OpenCode. Ничто не мешает попробовать оба: терминальные агенты не конфликтуют друг с другом.

Самая недооценённая возможность OpenCode — кастомные провайдеры. Любой сервис, говорящий на OpenAI API, можно добавить как источник моделей: указать base URL, API-ключ и список моделей — и они появятся в переключателе наравне со встроенными. Так подключают локальные модели, корпоративные прокси и API-шлюзы.

Точные названия полей конфигурации мы здесь намеренно не приводим — они описаны в официальной документации OpenCode, а готовый конфиг под Kumo лежит в разделе Integrations дашборда и в /docs. Суть в любом случае простая: один JSON-блок с адресом и ключом.

Зачем это нужно на практике? Один OpenAI-совместимый endpoint вроде Kumo даёт доступ сразу ко всему каталогу: Claude Opus 5 и Claude Sonnet 5, GPT-5.6, Gemini 3 Flash, DeepSeek V4 Pro и другим моделям. Вместо трёх аккаунтов у трёх лабораторий — один ключ и один баланс, а модель вы переключаете под задачу прямо в интерфейсе агента.

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

Работайте маленькими итерациями. Одна задача — одна сессия: агент внёс правки, вы посмотрели дифф, прогнали тесты, закоммитили. Частые коммиты — ваша страховка: если агент ушёл не туда, вы теряете десять минут, а не день. Не стесняйтесь прерывать и переформулировать — это нормальная часть процесса.

Главный экономический рычаг OpenCode — переключение моделей под задачу. Рутину — переименования, шаблонный код, простые тесты, черновики коммит-сообщений — отдавайте недорогим моделям вроде Gemini 3 Flash или DeepSeek V4 Pro. Сложный рефакторинг, архитектурные решения и запутанные баги — флагманам вроде Claude Opus 5 или GPT-5.6. Такая дисциплина ощутимо снижает средний чек без потери качества там, где оно критично.

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

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

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

Кому он подойдёт меньше: тем, кто хочет максимально готовый опыт без какой-либо настройки, и тем, кто предпочитает работать в графическом редакторе, а не в консоли. В таком случае посмотрите Claude Code или IDE-агентов — мы сравнивали их в обзоре инструментов для вайб-кодинга из этой серии.

Kumo — OpenAI-совместимый API-шлюз, то есть ровно тот тип провайдера, под который в OpenCode предусмотрено кастомное подключение. Один base URL https://api.kumorouter.com/v1, один ключ, один предоплаченный баланс — и в переключателе моделей появляется весь каталог: Claude Opus 5, Claude Sonnet 5, Claude Haiku 4.5, GPT-5.6, Gemini 3 Flash, Grok 4.5, DeepSeek V4 Pro и десятки других. Идея «дешёвая модель для рутины, флагман для сложного» перестаёт требовать трёх аккаунтов и трёх балансов.

Экономика честная: вы платите только за фактические токены, без подписок, seats и минимальных платежей. Эффективная ставка на 30–50% ниже официального прайса лабораторий — точная экономия зависит от профиля нагрузки и объёма, а цена каждой модели видна до того, как вы потратите первый токен. Баланс пополняется российской картой или через СБП, без VPN и зарубежных карт.

Контроль тоже на месте: на каждый API-ключ можно поставить лимиты и алерты, а под отдельный проект или клиента — завести отдельный ключ. Модель никогда не подменяется: запросили Claude Sonnet 5 — получили именно его, и каждый ответ сообщает, какая модель его обслужила. Тела промптов Kumo не логирует — только биллинговые метаданные.

Готовый конфиг для OpenCode с точными названиями полей лежит в разделе Integrations дашборда Kumo, подробности — в /docs. Регистрация на /signup, ключ выдаётся сразу — дальше можно вайб-кодить.