cmuxでClaude Code / Gemini CLI / Cursorを並列実行するマルチエージェント開発

マルチエージェント開発という新しい働き方

こんにちは！今回は、cmuxを使って**複数のAIコーディングエージェントを同時に走らせる「マルチエージェント開発」**を解説していきます。

ひとりの開発者が複数のAIエージェントに別々のタスクを任せ、まるで小さなチームを率いるように開発を進める——これがマルチエージェント開発です。フロントエンドをひとつのエージェントに、バックエンドを別のエージェントに、テスト生成をさらに別のエージェントに担当させれば、自分は「指示と確認」に集中できます。

ただし、複数のエージェントを同時に動かすと**「どのエージェントが今どんな状態なのか」を見失う**のが最大の難所です。cmuxはまさにこの課題を解決するために設計されたターミナルです。

なぜcmuxがマルチエージェント開発に向くのか

通常のターミナルでも tmux や複数ウィンドウを駆使すれば、複数のエージェントを並行して動かすこと自体は可能です。では、なぜcmuxが「マルチエージェント向き」と言われるのでしょうか。理由は大きく3つあります。

1. 入力待ちが一目で分かる通知リング

AIエージェントは、ファイルの編集承認やコマンド実行の確認のたびに手を止めて入力待ちになります。エージェントが1つなら問題ありませんが、3つ4つと同時に動かすと「今どれが待っているのか」を探すだけで時間を浪費します。

cmuxはエージェントが入力待ちになると、そのペインに青い通知リングを表示し、サイドバーのタブにもバッジを付けます。別のワークスペースで作業していても見落とさないため、「待っているエージェントから順にさばく」運用が自然にできます。

2. ワークスペース単位でタスクを分離できる

cmuxはプロジェクトごとにワークスペースを作れます。各ワークスペースにはGitブランチ名・PR状態・作業ディレクトリ・リスニングポート・最新の通知テキストが表示されるため、複数の作業を並行しても状況を把握しやすいのが特徴です。

3. エージェントの種類を問わない

cmuxは特定のエージェント専用ツールではなく、ターミナル上で動くものなら何でも動かせます。Claude Code、Gemini CLI、CursorのCLI連携など、ペインごとに別のエージェントを起動して使い分けられます。

🔍 注目ポイント: マルチエージェント開発のボトルネックは「並列で動かすこと」ではなく「並列の状態を把握すること」です。cmuxの通知システムは、まさにこの把握コストを劇的に下げてくれます。

Claude Codeを複数同時に動かす

まずは同じエージェント、つまりClaude Codeを複数ペインで動かすパターンから見ていきましょう。これがマルチエージェント開発の最も基本的な形です。

ペインを分割してそれぞれでClaude Codeを起動

cmuxはMacネイティブなショートカットで画面を分割できます。プレフィックスキーは不要です。

# Cmd+D        で右に分割（垂直分割）
# Cmd+Shift+D  で下に分割（水平分割）

# それぞれのペインで Claude Code を起動
claude

たとえば左右に2分割し、左ペインでフロントエンドの実装、右ペインでバックエンドの実装を、それぞれ独立したClaude Codeセッションに任せます。お互いのコンテキストが混ざらないので、タスクの混線を防げます。

タスクを明確に切り分けるのがコツ

複数のClaude Codeを動かすときは、各セッションに重複しない、明確なスコープを与えるのが鉄則です。同じファイルを2つのエージェントが同時に編集すると、コンフリクトや上書きの原因になります。

モデルの使い分けで品質とコストを最適化

Claude Codeでは利用するモデルを選べます。タスクの難易度に応じて使い分けると、品質とコストのバランスを取れます。料金は100万トークンあたりの目安です。

複数のClaude Codeを並列で動かすなら、難所のリファクタリングや設計には上位モデルを、定型的な実装や雑務には軽量モデルを割り当てると、全体のコストを抑えつつスピードを保てます。

Gemini CLI・Cursorとの併用

cmuxの強みは、Claude Codeに限らず複数の種類のエージェントを並べられる点にあります。それぞれの得意分野を活かして役割分担しましょう。

ペインごとに別エージェントを起動する

同じワークスペース内で、ペインごとに異なるエージェントを立ち上げられます。

# 左ペイン: 主力の実装エージェント
claude

# 右上ペイン: 別系統のエージェントで並行作業
gemini

# 右下ペイン: 検証やドキュメント生成用にもう一系統

複数の系統のエージェントを併用するメリットは、得意分野の違いを活かせることと、一方の出力をもう一方にレビューさせる「クロスチェック」ができることです。たとえば一方のエージェントが書いたコードを、別系統のエージェントに「設計上の問題点を指摘して」と依頼すれば、視点の偏りを減らせます。

Cursorとの使い分け

Cursorのようなエディタ統合型のAIツールは、ファイルを開きながらのインライン編集や対話的な修正が得意です。一方、cmux上で動かすCLI型のエージェントは、長時間の自律タスクやコマンド実行を伴う作業に向いています。

🔄 使い分けのポイント: 「画面を見ながら細かく直す」局面はエディタ統合型、「タスクを投げて待つ」局面はターミナル上のエージェント、と局面で分けるのが現実的です。cmuxの内蔵ブラウザを併用すれば、実装→ブラウザ確認→修正のループもターミナルから離れずに回せます。

併用時の注意点

複数の種類のエージェントを同じリポジトリで動かす場合、同時に同じファイルを編集させないことが重要です。担当範囲を明確に分け、こまめにコミットして変更を区切ると、どのエージェントの変更かを追いやすくなります。Claude Codeのチェックポイント機能（Rewind / Fork）を使えば、エージェントの変更を時系列でさかのぼれるので、併用時の安全網になります。詳しくはClaude CodeのRewind・Forkで作業をさかのぼるを参照してください。

通知システムで並列タスクを管理する

マルチエージェント開発の生命線は通知システムです。ここを使いこなせるかどうかで、並列作業の快適さが大きく変わります。

通知リングと未読ジャンプ

エージェントが入力待ちになると、ペインに青い通知リングが表示され、サイドバーのタブにバッジが付きます。複数のエージェントを動かしているときは、通知が来たペインから順に対応していくのが基本の流れです。

# Cmd+I        通知パネルを表示
# Cmd+Shift+U  最新の未読通知にジャンプ

Cmd+Shift+U を押すたびに未読の通知へ次々とジャンプできるので、複数のエージェントが同時に入力待ちになっても、ペインを目で探す必要がありません。

cmux notifyでタスク完了を通知する

cmuxはCLIから手動で通知を送れます。長時間かかるビルドやテストの完了を知らせるのに便利です。

# 基本的な通知の送信
cmux notify "ビルドが完了しました"

# ビルドの成否で通知を出し分ける
npm run build && cmux notify "ビルド成功" || cmux notify "ビルド失敗"

Claude Codeのフックと連携する

cmuxはターミナルエスケープシーケンス（OSC 9 / OSC 99 / OSC 777）やCLIコマンド、エージェントフックを通じて通知を検知します。Claude Codeのフック機能から cmux notify を呼び出すように設定しておけば、エージェントがタスクを完了したときや承認を求めるときに自動で通知が届きます。

# Claude Code がレビューを待っているときに通知を送る例
# .claude/settings.json のフック設定から cmux notify を呼び出す

cmux notify "Claude Codeがレビューを待っています"

実践ワークフロー例

ここからは、マルチエージェント開発の具体的なワークフローを3つ紹介します。いずれもcmuxの画面分割・ワークスペース・通知システムを組み合わせたものです。

1. フルスタック開発：1人で前後を同時進行

フロントエンドとバックエンドを並行して進めるパターンです。

# ワークスペース「my-app」を作成（Cmd+N）

# 左ペイン:   Claude Code（フロントエンド実装）
# 右上ペイン: Claude Code（API・バックエンド実装）
# 右下ペイン: 内蔵ブラウザで localhost を確認
#
# Cmd+D で左右分割 → 右ペインで Cmd+Shift+D で上下分割
# 右下ペインで Cmd+Shift+L でブラウザを開く

フロント担当のエージェントがAPIの仕様待ちになったら、バックエンド担当の進捗を確認して仕様を確定させ、再開する——という流れを通知リングを見ながら回します。

2. 並列実装：機能ごとにエージェントを割り当てる

独立した複数の機能を、それぞれ別のエージェントに同時実装させるパターンです。タスク間の依存が少ないほど効果を発揮します。

# ワークスペース「parallel-impl」を作成

# 左上ペイン: Claude Code → 機能A（ログイン画面）
# 右上ペイン: Claude Code → 機能B（検索フィルタ）
# 下ペイン:   Gemini CLI  → 各機能のテスト生成
#
# 通知リングが光ったペインから順に承認・確認していく
# Cmd+Shift+U で入力待ちのエージェントへ次々ジャンプ

🔄 並列作業のコツ: 各エージェントへの最初の指示で「触ってよいディレクトリ」と「触ってはいけない範囲」を明示しておくと、衝突を大幅に減らせます。指示の段階で役割を切り分けるのが、並列実装を成功させる最大のポイントです。

3. レビュー：実装エージェントとレビューエージェントを分ける

実装したコードを、別系統のエージェントにレビューさせるパターンです。視点を分けることで、見落としを減らせます。

# ワークスペース「review」を作成

# 左ペイン: 差分を確認
git diff main...feature-branch

# 右上ペイン: 別エージェントに「設計とセキュリティの観点でレビューして」と依頼
# 右下ペイン: 内蔵ブラウザでPRページを表示（Cmd+Shift+L）

実装したエージェントとは別のエージェントにレビューを任せることで、「自分が書いたコードを自分で甘く評価する」バイアスを避けられます。レビュー指摘を受けて修正する際は、また別のペインで実装エージェントに戻す、という往復もスムーズです。

マルチエージェント運用のベストプラクティス

ここまでの内容を、実際の運用に落とし込むためのコツとしてまとめます。

1. ①役割は最初に切り分ける: 各エージェントに「担当範囲」と「触らない範囲」を明示する。衝突は事前設計で防ぐのが基本です。
2. ②通知から対応する習慣をつける: ペインを目で探さず、Cmd+Shift+U で未読通知に飛ぶ。これだけで体感の効率が変わります。
3. ③モデルを難易度で使い分ける: 難所は上位モデル、定型作業は軽量モデル。並列だからこそコスト設計が効いてきます。
4. ④こまめにコミットする: どのエージェントの変更かを追えるよう、作業の区切りで小さくコミットする。
5. ⑤レビューは別系統に任せる: 実装とレビューを分け、視点の偏りをなくす。
6. ⑥tmuxと併用する: リモートサーバーでの作業はtmux、ローカルのマルチエージェント開発はcmux、と使い分けると最強です。

🔒 安全運用Tips: 複数のエージェントが自律的にコマンドを実行する環境では、承認プロンプトを安易に全許可しないことが大切です。通知リングで入力待ちを確実に拾い、実行内容を確認してから承認する運用を徹底しましょう。

よくある質問

🎮 理解度チェック

Q1: マルチエージェント開発における通知リングの役割は？

Q2: 複数エージェントの衝突を防ぐ基本方針は？

Q3: 難易度に応じたモデルの割り当てとして適切なのは？

📝 まとめ

今回は、cmuxを使ったマルチエージェント開発について学びました！

ひとりの開発者が複数のAIエージェントを率いて開発する時代において、cmuxは「並列の状態を把握する」コストを劇的に下げてくれるツールでしたね。覚えておきたいポイントをまとめます：

• 通知リングで把握: 入力待ちのエージェントが一目で分かる（Cmd+Shift+U で未読ジャンプ）
• 役割を切り分ける: 担当ディレクトリ・ブランチを分け、衝突を事前に防ぐ
• エージェントを併用: Claude Code・Gemini CLI・Cursorを局面で使い分ける
• モデルを使い分ける: 難所は上位モデル、定型作業は軽量モデルでコスト最適化
• フックで自動通知: cmux notify をClaude Codeのフックに組み込んでアイドル時間を削減

マルチエージェント開発は、慣れるほど「自分はディレクター、エージェントはチームメンバー」という感覚に近づいていきます。まずは2ペインから始めて、通知リングを頼りに少しずつ並列度を上げていきましょう。

cmuxそのものの基本をおさらいしたい方はcmuxでAIコーディングを加速するを、エージェントの変更を安全にさかのぼる方法はClaude CodeのRewind・Forkで作業をさかのぼるを、操作を速くするショートカットはClaude Codeのショートカットもぜひチェックしてみてください！