OpenCode oh-my-openagent: руководство по использованию
Oh My OpenAgent(сокращённоOmO) — это плагин для улучшения AI-ассистента программирования с открытым исходным кодом, ранее называвшийсяoh-my-opencode。
oh-my-openagent работает поверх OpenCode, инструмента AI-программирования, превращая его в11 профессиональных AI-агентов, образующих команду разработки.
Объяснение в одном предложении:
Вы отправляете запрос → OmO автоматически организует параллельную работу нескольких AI → В несколько раз быстрее, чем один AI
В настоящее время имеет на GitHub54k+ звёзд, это самый популярный плагин OpenCode.
- Ссылка GitHub:https://github.com/code-yeongyu/oh-my-openagent
- Официальный сайт:https://ohmyopenagent.com/zh
Установка
Скопируйте и вставьте следующий промпт в ваш LLM-инструмент (OpenCode, Claude Code, AmpCode, Cursor и т. д.):
按照此链接说明安装并配置 oh-my-opencode:https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

После выполнения он установится сам. Во время установки могут быть параметры настройки API-ключа; вы можете настроить их или нет:

Познакомьтесь с 11 участниками ИИ-команды (агентами)
В OmO встроено 11 специализированных агентов, каждый со своей ролью:
Основные агенты
| Агент | Роль | Модель по умолчанию | Когда использовать |
|---|---|---|---|
| Sisyphus | Главный координатор, универсальный разработчик | Claude Opus | Точка входа для всех задач, автоматически оркеструет других агентов |
| Prometheus | Стратегический планировщик | Claude Opus / GPT-5.4 | Планирование сложных задач |
| Атлас | Управление задачами Todo | Kimi K2.5 | Отслеживание прогресса многошаговых задач |
Профессиональные агенты
| Агент | Роль | Модель по умолчанию | Специализируется на |
|---|---|---|---|
| Гефест | Автономный исполнитель глубокого уровня | GPT-5.3-codex | Длительные, высокоинтенсивные независимые задачи по программированию |
| Oracle | Консультант по архитектуре / эксперт по отладке | GPT-5.4 | Проектирование систем, поиск сложных ошибок |
| Momus | Высокоточный проверяющий | GPT-5.4 | Проверка кода, верификация вывода |
| Metis | Проверка плана | Claude Opus | Проверить, есть ли в плане Prometheus упущения |
Агенты инструментального типа (быстрые, недорогие)
| Агент | Роль | Модель по умолчанию | Почему использовать дешёвые модели |
|---|---|---|---|
| Исследование | Быстрый поиск по кодовой базе | MiniMax / Grok Code Fast | Задачи поиска не требуют высокого интеллекта; скорость важнее |
| Библиотекарь | Извлечение документов/кода | MiniMax (бесплатно) | Извлечение документов не требует глубоких рассуждений |
| Мультимодальный наблюдатель | Анализ скриншотов/визуальный анализ | Kimi K2.5 | Kimi отлично справляется с мультимодальным пониманием |
💡 Совет для начинающих: Вам не нужно вручную выбирать агентов. Sisyphus автоматически подберёт подходящую комбинацию агентов в зависимости от типа вашей задачи.
Три режима работы
Режим 1: ultrawork (самый простой)
Добавить в запросultraworkилиulw, всё автоматизировано:
ultrawork 帮我把这个 React 组件改成 TypeScript
Подходит для: ежедневных задач разработки, сценариев, где вы хотите, чтобы ИИ выполнял всё автоматически.
Режим 2: режим планирования Prometheus (самый точный)
нажмитеклавишу Tab, чтобы войти в режим Prometheus. ИИ сначала поймёт ваши требования через вопросы и ответы, сгенерирует подробный план выполнения и начнёт выполнение после вашего подтверждения.
Рабочий процесс:
- нажмите
TabПереключитесь в режим Prometheus - Опишите свои требования; ИИ задаст вам несколько уточняющих вопросов
- ИИ создаёт план выполнения, вы подтверждаете
- Enter
/start-workчтобы начать выполнение
Подходит для: разработки сложных функций, рефакторинга архитектуры и других сценариев, требующих точного планирования.
Режим 3: обычный разговор (самый гибкий)
Введите свой вопрос или требование напрямую, не добавляя никаких ключевых слов:
解释一下 src/auth.ts 里的 JWT 验证逻辑
Подходит для: лёгких задач, таких как вопросы, объяснение кода и небольшие изменения.
Сведения о файле конфигурации
OmO имеет два файла конфигурации с разными приоритетами:
- Конфигурация уровня проекта (более высокий приоритет):.opencode/oh-my-opencode.jsonc
- Конфигурация уровня пользователя (глобальное значение по умолчанию):~/.config/opencode/oh-my-opencode.jsonc
Файлы конфигурации поддерживают комментарии (формат JSONC) и автодополнение JSON Schema:
{
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
"agents": {
// 主协调 Agent,建议用 Claude Opus 系列或 Kimi
"sisyphus": {
"model": "anthropic/claude-opus-4-6"
},
// 架构顾问,建议用 GPT 系列
"oracle": {
"model": "openai/gpt-5.4",
"variant": "high"
}
}
}
Совет для новичков: Не изменяйте конфигурацию сразу после установки; настройки по умолчанию уже хороши.
Краткий справочник по распространённым командам
| Команда | Описание |
|---|---|
opencode |
Запустить OmO |
bunx oh-my-opencode install |
Установить/перенастроить плагин |
bunx oh-my-opencode doctor |
⟦5⟧Диагностировать проблемы конфигурации |
opencode auth login |
Войти в аккаунт провайдера ИИ |
opencode models |
Просмотреть все доступные модели |
bunx oh-my-opencode refresh-model-capabilities |
Обновить кэш возможностей моделей |
В интерфейсе диалога:
| Сочетание клавиш/Команда | Описание |
|---|---|
Tab |
Переключиться в режим планирования Prometheus |
/start-work |
Начать выполнение плана в режиме Prometheus |
ultrawork / ulw |
Добавьте в промпт, чтобы активировать полнофункциональный параллельный режим |
Устранение распространённых проблем
Вопрос: После установки запускopencodeне отображает функции OmO
Решение: Проверьте, правильно ли зарегистрирован плагин в файле конфигурации:
cat ~/.config/opencode/opencode.json
Убедитесьpluginполе содержит"oh-my-opencode". Если нет, запустите повторноbunx oh-my-opencode install。
Вопрос: Предупреждение во время выполнения "Using legacy package name"
Решение: Изменитьopencode.jsonназвание плагина в ... с"oh-my-opencode"в"oh-my-openagent":
{
"plugin": ["oh-my-openagent"]
}
Вопрос: Sisyphus Agent работает плохо, ощущается так же, как обычный Claude
Причина: Возможно, вы не используете модель Claude Opus или не добавляетеultrawork。
Решение:
- Убедитесь, что вы вошли в аккаунт Claude Pro/Max
- Add
ultraworkключевое слово в промпт - Запустите
bunx oh-my-opencode doctorчтобы проверить конфигурацию модели
Вопрос: Задача останавливается на полпути
Решение: Продолжайте отправлять промптыultrawork 继续之前的任务, Sisyphus возобновит прогресс через систему Todo.
Вопрос: Хотите отключить анонимные данные телеметрии
OmO по умолчанию включает анонимную телеметрию (использует PostHog, данные хешируются). Чтобы отключить её:
export OMO_SEND_ANONYMOUS_TELEMETRY=0 # 或 export OMO_DISABLE_POSTHOG=1Другие расширения