«О, мой Opencode: Быстрый старт с OpenCode — установка, настройка, запуск»

Установите Oh My Opencode и ускоряйте разработку.

Содержимое страницы

Oh My Opencode превращает OpenCode в многоагентскую среду для разработки: оркестратор делегирует работу специализированным агентам, которые выполняются параллельно.

агенты oh my opencode с ноутбуками и gpu

Самая простая ментальная модель, которую вам нужна: установите плагин, а затем используйте ключевое слово ultrawork (или ulw), когда требуется выполнение с полной мощностью нескольких агентов.

Это быстрое руководство охватывает установку и начальную конфигурацию. После того как вы настроите систему:

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

Почему существует Oh My Opencode

OpenCode — это агент ИИ для разработки с открытым исходным кодом, который работает как терминальный интерфейс и обрабатывает неинтерактивные запуски CLI для скриптов и автоматизации.

Oh My Opencode поднимает этот потолок гораздо выше. Он добавляет полноценный слой оркестрации, построенный вокруг агента “Сизиф”, сотрудничество нескольких специалистов и более тесную интеграцию инструментов. Результат — система, в которой сложные инженерные задачи — те, которые обычно требуют от вас ручного управления несколькими промптами — планируются, делегируются и проверяются в рамках одного рабочего процесса.

Два понятия возникают постоянно, так что закрепите их в первую очередь:

  • Режим Ultrawork: переключатель рабочего процесса, активируемый по ключевому слову. Добавление ultrawork или ulw к вашему промпту активирует параллельное фоновое выполнение, интеграцию LSP, управление контекстом и автоматическую декомпозицию задач — это не просто стилистический выбор.
  • Специализированные агенты: именованные роли, такие как @oracle для архитектуры и @librarian для исследований и документации. Вы можете вызывать их явно или позволить оркестратору автоматически направлять запросы к ним.

В этой статье термины Oh My Opencode, oh-my-opencode и Oh My OpenCode используются взаимозаменяемо — все они относятся к одному и тому же плагину в экосистеме OpenCode.

Предварительные требования и терминология

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

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

Для Oh My Opencode требуется настройка хотя бы одного провайдера. OpenCode загружает провайдеры из учетных данных, переменных окружения или файла проекта .env. Самый быстрый способ это устроить:

opencode auth login
opencode auth list

Учетные данные хранятся в ~/.local/share/opencode/auth.json.

Одна странность в названиях, о которой стоит знать заранее: исходный репозиторий на GitHub теперь называется oh-my-openagent (“ранее oh-my-opencode”), но название плагина и пакета в конфигурациях остается oh-my-opencode. Оба названия встречаются в сообщениях сообщества — это одно и то же.

Быстрый старт установки

Существует несколько путей (установщик CLI, ручное клонирование репозитория или “позволить агенту установить его”). Правильный выбор зависит от того, хотите ли вы повторяемый поток установки или полный ручной контроль.

Если у вас установлен Bun, bunx — это аналог npx для Bun, предназначенный для быстрого запуска пакетов npm без отдельного шага глобальной установки.

Чтобы установить bunx на Linux:

curl -fsSL https://bun.com/install | bash

Автоматическая установка через OpenCode

Вы можете выполнить промпт в OpenCode, и он автоматически установит OmO.

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Система задаст несколько вопросов о ваших подписках на LLM и зарегистрирует Oh My Opencode в плагинах OpenCode.

Ручной путь: запуск установщика Oh My Opencode через bunx или npx

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

Интерактивная установка:

bunx oh-my-opencode install
# или если вы предпочитаете инструменты npm
npx oh-my-opencode install

Неинтерактивная установка (полезно для скриптов провижинга, образов CI или “установок агентами”):

bunx oh-my-opencode install --no-tui \
  --claude=<yes|no|max20> \
  --openai=<yes|no> \
  --gemini=<yes|no> \
  --copilot=<yes|no>

Что делает установщик на высоком уровне:

  • регистрирует плагин в конфигурации OpenCode
  • генерирует назначения моделей, используя доступность провайдеров и правила резервных копий
  • записывает конфигурацию oh-my-opencode рядом с файлами конфигурации OpenCode

Ручной путь: клонирование репозитория и запуск скрипта установки

Существует также “человеческий” ручной поток: клонируйте репозиторий, установите зависимости, затем запустите скрипт установки, который определяет расположение вашей конфигурации OpenCode, создает резервную копию и объединяет настройки.

git clone https://github.com/code-yeongyu/oh-my-opencode.git ~/.oh-my-opencode
cd ~/.oh-my-opencode
npm install
npm run install

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

Быстрый контрольный список проверки

После установки проверьте три вещи:

  • файл конфигурации Oh My Opencode существует в известном месте
  • специализированные агенты могут быть вызваны
  • срабатывание ключевого слова ultrawork работает как ожидалось

Примеры для копирования:

# Показать файл конфигурации плагина (попробуйте местоположение, соответствующее вашей настройке)
cat .opencode/oh-my-opencode.json
cat ~/.config/opencode/oh-my-opencode.json

# Быстрый тест агента
opencode run "Use @oracle to analyse the architecture of the current project"

# Быстрый тест срабатывания ultrawork
opencode run "ulw list all configuration files in this project"

Если все три проверки пройдены, вы действительно готовы — не просто установлены.

Конфигурация и настройка

Где хранится конфигурация и как работает приоритет

Oh My Opencode ищет файлы конфигурации в порядке приоритета, где конфигурация на уровне проекта имеет приоритет над пользовательской. Документированный порядок поиска:

  • .opencode/oh-my-opencode.json (уровень проекта, самый высокий приоритет)
  • ~/.config/opencode/oh-my-opencode.json (уровень пользователя на macOS и Linux)
  • %APPDATA%\opencode\oh-my-opencode.json (уровень пользователя на Windows)

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

Поддержка JSONC для адекватных конфигураций

И OpenCode, и Oh My Opencode поддерживают JSONC, что означает, что вы можете оставлять комментарии и запятые в конце строк в файлах конфигурации, не нарушая процесс парсинга. Это особенно полезно для документирования причин выбора определенных лимитов или моделей.

Ключевое слово “ultrawork” и что оно включает

ultrawork (или ulw) — это переключатель режима, к которому вы будете обращаться чаще всего. Вставьте его в описание задачи, и система включит фоновое параллельное выполнение, интеграцию LSP, управление контекстом и автоматическую декомпозицию задач. Это не подсказка для модели — это жесткий триггер, который меняет структуру всего запуска.

Параллелизм и фоновые задачи

Oh My Opencode предоставляет управление параллелизмом для фонового выполнения через sisyphus.max_concurrent_tasks.

Не гонитесь за высоким параллелизмом здесь. У каждого плана провайдера есть потолок — например, Claude Max20 ограничивается 3 параллельными задачами — и превышение этого порога приводит к нестабильным завершениям и сложным для отладки тайм-аутам. Начинайте консервативно и увеличивайте только после чистых запусков.

Минимальная конфигурация параллелизма выглядит так:

{
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  }
}

Параллелизм 2 — безопасная отправная точка для большинства планов.

Маршрутизация моделей для отдельных агентов и категорий

Oh My Opencode построен на идее, что разные задачи выигрывают от разных моделей, поэтому конфигурация поддерживает:

  • выбор моделей, вариантов и расширений промптов для отдельных агентов
  • маршрутизацию на основе категорий для “быстрой” и “глубокой” работы
  • резервные модели, когда ваш предпочтительный провайдер недоступен

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

Разрешение моделей происходит слоями: ваше явное переопределение побеждает, затем резервный провайдер, затем системное значение по умолчанию. Цепочка резервных копий начинается с ваших нативных провайдеров и может опускаться до альтернатив, таких как GitHub Copilot, если ничего другого нет — это означает, что неправильно настроенный агент вряд ли провалится молча; он просто использует более слабую модель.

Практическая стартовая конфигурация, которую можно адаптировать (рекомендуется JSONC):

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",

  // Держите параллелизм консервативным, пока не доверитесь лимитам вашего провайдера
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  },

  // Настройка агентов
  "agents": {
    "oracle": {
      "enabled": true,
      "model": "openai/gpt-5.2",
      "variant": "high",
      "temperature": 0.7,
      "prompt_append": "Предоставьте краткие компромиссы и четкую рекомендацию"
    },
    "librarian": {
      "enabled": true,
      "model": "google/gemini-3.1-pro"
    }
  },

  // Маршрутизация категорий для быстрых запросов и более глубокой работы
  "categories": {
    "quick": { "model": "opencode/gpt-5-nano" },
    "visual-engineering": { "model": "google/gemini-3.1-pro" }
  }
}

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

Интеграция MCP и хуки

Oh My Opencode поддерживает серверы MCP (Model Context Protocol) через блок конфигурации, где вы определяете команду сервера, аргументы и переменные окружения.

На практике более простой путь — управлять MCP напрямую через OpenCode, используя группу команд opencode mcp — она обрабатывает добавление, перечисление и аутентификацию OAuth без необходимости вручную трогать файлы конфигурации.

Примеры рабочих процессов для копирования

Два примера ниже специально оформлены как “реальные репозитории”: они показывают, как активировать оркестрацию, как нацеливаться на специализированных агентов и как сохранять результаты проверяемыми.

Пример: Архитектурный обзор с Oracle и картой репозитория

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

Запустите его из корня вашего проекта:

opencode

OpenCode по умолчанию запустит свой терминальный интерфейс при запуске без аргументов.

Затем попросите Oracle провести архитектурный анализ и составить конкретный план рефакторинга или модуляризации:

Use @oracle to analyse the architecture of this repository.
Identify the key bounded contexts, major dependency edges, and the highest risk components.
End with a refactoring plan that can be executed in small PRs.

Для логирования или скриптов пропустите TUI полностью и используйте opencode run:

opencode run "Use @oracle to analyse the architecture of this repository and propose a staged refactor plan"

Команда opencode run передает промпт напрямую и завершает работу после выполнения — именно то, что вам нужно для шагов CI или автоматизированных конвейеров.

Пример: Реализация полнофункциональной функции с оркестрацией ultrawork

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

Начните с промпта ultrawork:

opencode run "ultrawork implement a new /health endpoint with readiness and liveness checks, add tests, update documentation, and verify it runs locally"

Ключевое слово ultrawork активирует всех настроенных специализированных агентов, параллелизм фоновых задач и более глубокое использование инструментов одним махом. Вам не нужны отдельные промпты для планирования, реализации и тестирования.

Когда вы используете ultrawork, вы все еще можете явно управлять поведением агентов. Например, вы можете сначала принудительно спроектировать архитектуру:

opencode run "ultrawork ask @oracle to design the endpoint contract and dependencies first, then implement with minimal changes and add tests"

Комбинация ultrawork с явным упоминанием агентов, таких как @oracle, — это золотая середина: вы получаете полную оркестрацию, но все еще контролируете, какой специалист принимает критически важные архитектурные решения.

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

Устранение неполадок и лучшие практики

Ключевое слово Ultrawork не срабатывает

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

На практике самые быстрые исправления:

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

Скрипт установки не может найти вашу конфигурацию OpenCode

Проверьте, установлен ли OpenCode (opencode --version), затем явно установите переменную окружения пути к конфигурации перед повторным запуском установщика.

Слишком много фоновых задач или проблемы с дросселированием

Если вы столкнулись с лимитами скорости, тайм-аутами или нестабильными завершениями, решение всегда одно: уменьшите параллелизм и перезапустите. Гонка за большим параллелизмом, когда ваш провайдер уже дросселирует вас, — это проигрышная битва.

Когда не следует использовать ultrawork

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

Хорошее правило:

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

Примечание о соответствии условиям провайдеров

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

Готовы погрузиться глубже? Статья Глубокое погружение в специализированных агентов объясняет роль каждого агента, требования к моделям и варианты развертывания на собственном хосте. Для честных данных о производительности и сообщенных сообществом рисках биллинга см. статью об опыте использования Oh My Opencode.