Развертывание и приемы oh-my-claudecode: 32 профессиональных агента работают за вас, удваивая эффективность

Сложность: Средняя | Время: 30 минут | Результат: Освоение оркестрации мультиагентов, развертывание без конфигурации, создание командных конвейеров

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

Основные зависимости: Node.js ≥18, tmux (опционально для кроссплатформенности), Claude Code CLI

---

1. О проекте

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

oh-my-claudecode (далее OMC) создан для решения этой проблемы. Это уровень оркестрации мультиагентов для Claude Code, чья основная концепция гласит:

Не учите Claude Code. Просто используйте OMC.

Проще говоря, вам нужно лишь описать желаемый результат на естественном языке, и OMC автоматически задействует 32 профессиональных агента, выберет подходящие модели (Haiku / Sonnet / Opus) и будет выполнять задачи параллельно, пока они не пройдут верификацию. Весь процесс не требует настройки и запоминания команд.

Адрес проекта: https://github.com/Yeachan-Heo/oh-my-claudecode

---

2. Обзор ключевых особенностей

2.1 Готовность к работе без настройки (Zero-config)

Вам не нужно писать конфигурации YAML или JSON. После установки просто ставьте задачи обычными словами. Умные настройки по умолчанию покрывают 90% сценариев.

2.2 32 профессиональных агента

У каждого агента есть четкая сфера ответственности. OMC автоматически маршрутизирует задачу наиболее подходящему агенту:

Полный список определен в файле AGENTS.md.

2.3 Умная маршрутизация моделей

OMC автоматически выбирает модель в зависимости от сложности задачи:

• Haiku: Простой поиск, форматирование, легкие правки текста.
• Sonnet: Стандартная реализация, отладка, тесты (основная рабочая сила).
• Opus: Проектирование архитектуры, аудит безопасности, сложный рефакторинг.

Это позволяет оптимизировать расходы — по отзывам сообщества, экономия токенов составляет в среднем 30-50%.

2.4 Автоматическая параллелизация

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

2.5 Непрерывное выполнение (цикл verify/fix)

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

2.6 Самообучение навыкам (система Learner)

Опыт отладки, полученный в процессе работы, автоматически извлекается в переиспользуемые файлы Skill в директории .omc/skills/. При возникновении аналогичной проблемы в следующий раз контекст внедряется автоматически.

2.7 Интеграция с OpenClaw

Поддержка пересылки событий сессии Claude Code в OpenClaw Gateway для автоматических уведомлений и удаленного запуска через Telegram / Discord и другие каналы.

---

3. Полная структура проекта

oh-my-claudecode/
├── agents/              # Файлы определений 32 агентов
├── bridge/              # Мосты для OpenClaw / сторонних сервисов
├── docs/                # Документация, руководства по миграции, мониторинг
├── examples/            # Примеры рабочих процессов
├── hooks/               # Инъекции хуков Claude Code
├── missions/            # Определения миссий (задач)
├── research/            # Исследовательские модули
├── scripts/             # Служебные скрипты (OpenClaw Gateway Demo и др.)
├── skills/              # Встроенные навыки OMC
├── src/                 # Исходный код ядра
├── tests/               # Набор тестов
├── CLAUDE.md            # Основная конфигурация рантайма (внедряется в Claude Code)
├── AGENTS.md            # Справочник агентов и их описания
└── package.json

Для обычного пользователя наиболее важны:

• skills/ — пользовательские файлы навыков.
• .omc/ — сгенерированные во время работы файлы сессий, состояний и планов.

---

4. Установка и настройка

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

Обязательно:

• Claude Code CLI — требуется подписка Max/Pro или Anthropic API Key.
• Node.js ≥18 — OMC является проектом на TypeScript/npm.

Опционально, но крайне рекомендуется:

• tmux — функции omc team и автовосстановление при лимитах скорости зависят от tmux.

Установка tmux:

# macOS
brew install tmux

# Ubuntu / Debian
sudo apt install tmux

# Windows Native (рекомендуется)
winget install psmux

4.2 Установка OMC (два способа)

Способ 1: Через Marketplace (рекомендуется)

# Добавить источник плагина
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

# Установить плагин
/plugin install oh-my-claudecode

Способ 2: Глобальная установка через npm

npm i -g oh-my-claude-sisyphus@latest

После установки OMC активируется автоматически, и все команды / станут доступны.

4.3 Инициализация

# Запустить в любой директории
/setup
/omc-setup

Первый запуск поможет настроить директории, OpenClaw Gateway и проверить tmux.

4.4 Включение Team Mode (рекомендуется)

Team Mode — это основной способ оркестрации начиная с v4.1.7. Нужно включить экспериментальную функцию в настройках Claude Code:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

---

5. Глубокий анализ режимов выполнения

5.1 Team Mode (Рекомендуется) ⭐

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

Конвейер: plan → prd → exec → verify → fix (цикл).

Пример:

/team 3:executor "Исправить все ошибки компиляции TypeScript"

Число 3 означает использование 3 параллельных исполнителей.

5.2 Autopilot

Сценарий: Четкое требование, реализация фичи «под ключ» без вмешательства человека.

autopilot: build a REST API for managing tasks

5.3 Ralph (Персистентный режим)

Сценарий: Когда задача должна быть выполнена полностью, без варианта «выход при частичном успехе».

ralph: рефакторинг модуля auth, все тесты должны пройти

5.4 Ultrawork (Максимальный параллелизм)

Сценарий: Массовые исправления или рефакторинг, где важна скорость.

ulw исправить все ошибки ESLint

5.5 /ccg (Консультация трех моделей)

Сценарий: Когда нужны мнения Codex и Gemini, синтезированные Claude.

/ccg Review this PR — architecture (Codex) and UI components (Gemini)

---

6. Практические примеры

6.1 Сценарий 1: Создание REST API (Team Mode)

/team 2:executor "Реализовать REST API для управления задачами (CRUD) на Express + TypeScript"

OMC разделит задачу: architect спроектирует модель, executor напишет код, test-engineer подготовит тесты, а verifier все проверит.

6.2 Сценарий 2: Автоматическое исправление ошибок (Ultrawork)

ulw исправить все ошибки типов TS и предупреждения ESLint

6.3 Сценарий 3: Нечеткие требования (Deep Interview)

/deep-interview "Я хочу создать систему личного блога"

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

---

7. Устранение неполадок

Q1: Команда /team не работает. Убедитесь, что переменная CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS установлена в 1 в вашем settings.json.

Q2: Ошибки tmux в Windows. Установите psmux через winget install psmux и убедитесь, что он в системном PATH.

Q3: Навыки (Skills) не применяются. Проверьте, что ключевые слова в секции triggers файла навыка соответствуют контексту вашего запроса.

---

8. Продвинутые возможности

• Кастомные навыки: Используйте /learner для извлечения опыта в новые Skill-файлы.
• Уведомления: Настройте пуши в Telegram/Discord через omc config-stop-callback.
• Мониторинг: Используйте /oh-my-claudecode:hud setup для отслеживания состояния агентов в реальном времени.

Ссылки

• GitHub: https://github.com/Yeachan-Heo/oh-my-claudecode
• Сообщество Discord: https://discord.gg/PUwSMR9XNk