oh-my-claudecode のデプロイと活用術：32 人の専門エージェントがあなたの代わりに働き、効率を倍増させる

難易度: 中級 | 所要時間: 30 分 | 得られるもの: マルチエージェントのオーケストレーション、ゼロ構成デプロイ、チームパイプラインの構築習得

ターゲット: Claude Code をすでに使用している、または使用を検討している開発者、エージェントの連携効率をさらに向上させたいチーム。

必須環境: Node.js ≥18、tmux（クロスプラットフォームでオプション）、Claude Code CLI

1. プロジェクト概要

Claude Code 自体も非常に強力ですが、複雑なマルチモジュールプロジェクトに直面すると、単一のエージェントでは力不足を感じることがあります。複数の対話ウィンドウを頻繁に切り替えたり、コードレビュー、アーキテクチャ設計、テスト検証を手動で調整したりしなければならないからです。

oh-my-claudecode（以下、OMC）は、この問題を解決するために誕生しました。これは Claude Code のマルチエージェント・オーケストレーションレイヤーであり、そのコアコンセプトは以下の通りです：

Don't learn Claude Code. Just use OMC.

簡単に言えば、やりたいことを自然言語で伝えるだけで、OMC が 32 人の専門エージェントを自動的にスケジュールし、適切なモデル（Haiku / Sonnet / Opus）を選択してタスクを並列処理し、検証が通るまで実行し続けます。プロセス全体がゼロ構成であり、コマンドを覚える必要もありません。

プロジェクト URL: https://github.com/Yeachan-Heo/oh-my-claudecode

NOTE

npm パッケージ名とリポジトリ名が異なります。リポジトリ名は oh-my-claudecode ですが、公開されている npm パッケージ名は oh-my-claude-sisyphus です。インストール時に間違えないよう注意してください。

2. コア機能一覧

2.1 ゼロ構成で即利用可能

YAML や JSON の設定ファイルを書く必要はありません。インストール後、普通に話しかけるだけで動作します。インテリジェントなデフォルト値がシナリオの 90% をカバーしています。

2.2 32 人の専門エージェント

各エージェントには明確な責任範囲があり、OMC はタスクの種類に応じて最適なエージェントに自動的にルーティングします：

エージェント	役割	推奨モデル
`architect`	システムアーキテクチャ設計	Opus
`planner`	タスク分解と計画	Opus
`executor`	コード実装（デフォルト）	Sonnet
`code-reviewer`	コードレビュー	Opus
`security-reviewer`	セキュリティ監査	Sonnet
`test-engineer`	自動テスト	Sonnet
`explorer`	コードベースの探索	Haiku
`analyst`	深層分析	Opus
`debugger`	バグの特定と修正	Sonnet
`designer`	UI/UX デザイン	Sonnet
`writer`	ドキュメント作成	Haiku
`scientist`	データサイエンス・タスク	Sonnet
...	...	...

完全なリストは 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 内蔵 Skill ファイル
├── src/                 # コアソースコード
├── tests/               # テストスイート
├── CLAUDE.md            # エージェント実行時のメイン設定（OMC が Claude Code に注入）
├── AGENTS.md            # エージェントのディレクトリと説明
└── package.json

一般ユーザーが日常的に扱うのは主に以下のディレクトリです：

skills/ — カスタム Skill ファイル
.omc/ — 実行時に生成されるセッション、ステータス、計画ファイル

4. インストールと設定

4.1 前提条件

必須インストール：

Claude Code CLI — Max/Pro サブスクリプションまたは Anthropic API キーが必要です
Node.js ≥18 — OMC 自体は TypeScript/npm プロジェクトです

オプション（強く推奨）：

tmux — omc team およびレート制限の自動復帰機能が tmux に依存しています

各プラットフォームでの tmux インストール：

# macOS
brew install tmux

# Ubuntu / Debian
sudo apt install tmux

# Arch
sudo pacman -S tmux

# Windows ネイティブ（推奨）
winget install psmux

# Windows WSL2
sudo apt install tmux

WARNING

Windows ユーザーには psmux のインストールを推奨します。これは Windows ネイティブの tmux 実装であり、WSL2 なしで OMC の全機能を動作させることができます。

4.2 OMC のインストール（2 通りの方法）

方法 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

初回実行時には以下の設定ガイドが表示されます：

Claude Code 設定ディレクトリの確認
OpenClaw Gateway（オプション）
tmux セッションの検出

異常が発生した場合は、診断ツールを実行してください：

/omc-doctor

4.4 Team Mode の有効化（推奨）

Team Mode は OMC v4.1.7 以降のデフォルトのオーケストレーション方式です。Claude Code の設定で試験的機能を有効にする必要があります：

# ~/.claude/settings.json を編集

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

TIP

Team Mode が有効になっていない場合、OMC は警告を表示し、非 Team 実行モードにフォールバックします。完全に使えなくなるわけではありませんが、オーケストレーション能力は低下します。

5. 実行モードの詳細解説

OMC はタスクのシナリオに合わせて複数の実行モードを提供しています。これらの違いを理解することが効率的な活用の鍵となります。

5.1 Team Mode（推奨）⭐

適用シーン: アーキテクチャ、コーディング、レビュー、テストの連携が必要な複雑なマルチモジュールタスク。

Team Mode は厳格なパイプライン上で動作します：

team-plan → team-prd → team-exec → team-verify → team-fix（ループ）

タスクは計画から始まり、プロダクト設計、コード実行、検証を経て、fix 段階で問題が見つかれば実行段階に戻ります。プロセス全体は OMC が自動調整するため、介入は不要です。

基本的な使い方：

/team 3:executor "すべての TypeScript コンパイルエラーを修正して"

数字の 3 は、3 人の executor エージェントを使用して並列処理することを意味します。

CLI 版 tmux Workers (v4.4.0+)：

omc team 2:codex "auth モジュールのセキュリティをレビューして"
omc team 2:gemini "UI コンポーネントのアクセシビリティを再設計して"
omc team 1:claude "支払いフローを実装して"
omc team status auth-review
omc team shutdown auth-review

これらは完全に独立した tmux プロセスであり、実行完了後に自動的に終了し、リソースを占有しません。

5.2 Autopilot

適用シーン: 要件が明確で、人の介入をあまり必要とせず、エンドツーエンドで機能を完成させたい場合。

autopilot: build a REST API for managing tasks

Autopilot モードでは、単一の Lead エージェントが設計から実装までを一貫して担当し、パイプラインには依存しません。

5.3 Ralph（永続化モード）

適用シーン: 「一部完了して終了」を許さず、タスクを完全に完了させる必要がある場合。

Ralph モードは Ultrawork の並列能力に加え、verify/fix ループを備えています：

executor → verify → fix → verify（合格するまで）

ralph: auth モジュールをリファクタリングし、すべてのテストをパスさせて

Claude Code が「完了したように見える」のに、実際には検証せずに終了してしまうことが多い場合、Ralph が解決策になります。

5.4 Ultrawork（最大並列）

適用シーン: 大量の修正やリファクタリングを最高速度で行いたい場合。

ulw すべての ESLint エラーを修正して
ulw すべてのコンポーネント名を PascalCase に変更して

すべての修正を並列で実行し、前の完了を待たずに次へ進むため、「既知の問題リスト」の一括処理に適しています。

5.5 /ccg 3 モデルアドバイザー

適用シーン: Codex と Gemini の視点を同時に取得し、Claude で総合的に判断したい場合。

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

/ask codex と /ask gemini を呼び出し、最後に Claude が統合して出力します。バックエンド＋フロントエンドの合同レビューや、複数モデルによるクロスバリデーションが必要なシーンに最適です。

5.6 モード比較クイック参照

モード	並列実行	検証ループ	適用シーン
Team	✅ パイプライン多 Agent	✅ fix ループ	複雑なマルチモジュール連携
Autopilot	単一 Agent	❌	明確な要件の迅速な実装
Ralph	✅ Ultrawork 継承	✅	完全な納品が必要なタスク
Ultrawork	✅ 最大並列	❌	大量の修正・リファクタリング
/ccg	✅ 3 モデル同時	❌	アーキテクチャ＋UI の合同レビュー

6. 実践デモ

6.1 シナリオ 1：REST API の構築（Team Mode）

Team Mode を使ってタスク管理 REST API を構築する場合：

/team 2:executor "Express + TypeScript を使用して、CRUD 4 エンドポイントを含むタスク管理 REST API を実装して"

OMC がタスクを自動分解します：

architect が API 構造とデータモデルを設計
executor が各エンドポイントを並列実装
test-engineer が統合テストを作成
code-reviewer がコードをレビュー
verifier がテストを実行して検証

あなたは最終結果を待つだけです。

6.2 シナリオ 2：すべてのエラーを自動修正（Ultrawork）

ulw すべての TypeScript 型エラーと ESLint 警告を修正して

CI/CD パイプラインや、レガシープロジェクトを引き継いだ際の迅速なクリーンアップに適しています。

6.3 シナリオ 3：要件が不明確な場合（Deep Interview）

自分でも何をすべきか確信が持てない場合：

/deep-interview "個人ブログシステムを作りたい"

Deep Interview はソクラテス式問答を用いて、ターゲット読者、技術スタックの好み、CMS の要否、SEO 要件などを明確にしていきます。作業途中の手戻りを防ぎます。

6.4 シナリオ 4：複数モデルによるクロスレビュー（/ccg）

/ccg この PR のバックエンド構造を Codex で、UI コンポーネントを Gemini でレビューして

6.5 シナリオ 5：レート制限からの自動復帰

Claude API のレート制限に達した場合：

omc wait          # 現在のステータスと復帰ガイドを表示
omc wait --start  # 自動復帰デーモンを起動
omc wait --stop   # デーモンを停止

TIP

レート制限の復帰は tmux のセッション状態検出に依存しているため、tmux がインストールされ正常に動作していることを確認してください。

7. トラブルシューティング

Q1: `/team` コマンドが無効で、"Team Mode 未有効" とエラーが出る

原因: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 環境変数が設定されていません。

解決策:

# ~/.claude/settings.json を編集し、以下を追加：
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Claude Code セッションを再起動すると反映されます。

Q2: `omc team` で tmux 関連のエラーが出る

原因: Windows ユーザーが tmux をインストールしていない、または tmux が PATH に通っていません。

解決策:

# Windows ネイティブ
winget install psmux

# macOS
brew install tmux

# インストールの確認
tmux -V

インストール済みでもエラーが出る場合は、psmux の bin ディレクトリがシステムの PATH に含まれているか確認してください。

Q3: Marketplace インストール後に OMC コマンドが効かない

原因: プラグインキャッシュが更新されていないか、インストールパスが正しくありません。

解決策:

# marketplace クローンの更新
/plugin marketplace update omc

# 再初期化
/setup

# 診断の実行
/omc-doctor

Q4: Claude Code でレート制限が出ても自動復帰しない

原因: omc wait --start が実行されていないか、tmux セッション内で実行されていません。

解決策:

# 必ず tmux セッション内で実行する
tmux new -s omc-watch
omc wait --start

デーモンが起動すると tmux のバックグラウンドで動作し、レート制限解除後に自動で Claude Code セッションを再開（resume）します。

Q5: OMC 更新後に異常な動作をする

原因: 旧バージョンのプラグインキャッシュと新しいコードの互換性がありません。

解決策:

# Marketplace インストールの場合：
/plugin marketplace update omc
/setup

# npm インストールの場合：
npm i -g oh-my-claude-sisyphus@latest
/omc-doctor

Q6: Skill ファイルが自動で注入されない

原因: Skill のトリガーワードが一致していないか、ファイルパスが間違っています。

解決策:

Skill ファイルは以下の 2 か所に配置され、優先度が異なります：

# プロジェクトレベル（高優先度）: .omc/skills/
# ユーザーレベル（低優先度）: ~/.omc/skills/

Skill ファイルの frontmatter にある triggers 配列に、対話中のキーワードが含まれているか確認してください：

---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]  # キーワード一致
source: extracted
---

8. 拡張 / 応用編

8.1 カスタム Skill の作成

OMC は実際のデバッグ経験から再利用可能な Skill を抽出できます：

/learner

抽出後、.omc/skills/ 下に YAML ファイルが生成されます。次回同様の問題が発生した際に自動注入され、手動での再学習が不要になります。

8.2 OpenClaw 連携

OMC は Claude Code セッションイベントを OpenClaw Gateway に転送し、リモートトリガーや通知を可能にします：

# 設定ガイドの起動
/oh-my-claudecode:configure-notifications
# → "OpenClaw Gateway" を選択

~/.claude/omc_config.openclaw.json を手動で設定する場合：

{
  "enabled": true,
  "gateways": {
    "my-gateway": {
      "url": "https://your-gateway.example.com/wake",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "method": "POST",
      "timeout": 10000
    }
  },
  "hooks": {
    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
  }
}

サポートされているフックイベント：session-start、stop、keyword-detector、ask-user-question、pre-tool-use、post-tool-use。

8.3 通知システム（Telegram / Discord / Slack）

omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"
omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678"

セッション終了時にサマリーをグループへ自動プッシュし、メンションタグのインクリメンタル更新もサポートします。

8.4 OpenClaw + OMC 共同ワークフロー

OpenClaw の自動化能力と OMC のマルチエージェント連携を組み合わせることで、以下が可能になります：

OpenClaw が Discord/Telegram のメッセージを監視し、Claude Code セッションをトリガー
OMC が Claude Code 内で 32 人のエージェントを使い複雑なタスクを完了
OpenClaw Gateway が結果をチャットチャネルにプッシュバック

これにより、日常のチャットツールから指示を出せる 24 時間稼働のマルチインテリジェンスアシスタントが手に入ります。

この連携アーキテクチャについては scripts/openclaw-gateway-demo.mjs を参照してください。

8.5 パフォーマンス監視とデバッグ

OMC は実行中に .omc/ ディレクトリ内に様々なファイルを生成します：

.omc/sessions/*.json        # セッションサマリー
.omc/state/agent-replay-*.jsonl  # 実行リプレイログ
.omc/plans/                 # タスク計画
.omc/research/              # リサーチ出力

リアルタイムのオーケストレーション状態を確認するには HUD を実行します：

/oh-my-claudecode:hud setup
omc hud

参照リンク

プロジェクトページ: https://github.com/Yeachan-Heo/oh-my-claudecode
npm パッケージ: https://www.npmjs.com/package/oh-my-claude-sisyphus
完全ドキュメント: https://yeachan-heo.github.io/oh-my-claudecode-website
CLI リファレンス: https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#cli-reference
Discord コミュニティ: https://discord.gg/PUwSMR9XNk

1. プロジェクト概要

2. コア機能一覧

2.1 ゼロ構成で即利用可能

2.2 32 人の専門エージェント

2.3 インテリジェントなモデルルーティング

2.4 自動並列化

2.5 永続的な実行（verify/fix ループ）

2.6 スキルの自己学習（Learner システム）

2.7 OpenClaw 連携

3. プロジェクト構造の全容

4. インストールと設定

4.1 前提条件

4.2 OMC のインストール（2 通りの方法）

4.3 初期設定

4.4 Team Mode の有効化（推奨）

5. 実行モードの詳細解説

5.1 Team Mode（推奨）⭐

5.2 Autopilot

5.3 Ralph（永続化モード）

5.4 Ultrawork（最大並列）

5.5 /ccg 3 モデルアドバイザー

5.6 モード比較クイック参照

6. 実践デモ

6.1 シナリオ 1：REST API の構築（Team Mode）

6.2 シナリオ 2：すべてのエラーを自動修正（Ultrawork）

6.3 シナリオ 3：要件が不明確な場合（Deep Interview）

6.4 シナリオ 4：複数モデルによるクロスレビュー（/ccg）

6.5 シナリオ 5：レート制限からの自動復帰

7. トラブルシューティング

Q1: /team コマンドが無効で、"Team Mode 未有効" とエラーが出る

Q2: omc team で tmux 関連のエラーが出る

Q3: Marketplace インストール後に OMC コマンドが効かない

Q4: Claude Code でレート制限が出ても自動復帰しない

Q5: OMC 更新後に異常な動作をする

Q6: Skill ファイルが自動で注入されない

8. 拡張 / 応用編

8.1 カスタム Skill の作成

8.2 OpenClaw 連携

8.3 通知システム（Telegram / Discord / Slack）

8.4 OpenClaw + OMC 共同ワークフロー

8.5 パフォーマンス監視とデバッグ

参照リンク

Q1: `/team` コマンドが無効で、"Team Mode 未有効" とエラーが出る

Q2: `omc team` で tmux 関連のエラーが出る