Claude Code セッションのチームを調整する

​

エージェントチームを使用する場合

• 調査とレビュー：複数のチームメンバーが問題のさまざまな側面を同時に調査し、その後、各自の調査結果を共有して相互に検証できます
• 新しいモジュールまたは機能：チームメンバーが互いに干渉することなく、それぞれ別々の部分を担当できます
• 競合する仮説でのデバッグ：チームメンバーが異なる理論を並列でテストし、より迅速に答えに収束できます
• クロスレイヤー調整：フロントエンド、バックエンド、テストにまたがる変更で、それぞれ異なるチームメンバーが担当します

​

subagents との比較

​

エージェントチームを有効にする

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

​

最初のエージェントチームを開始する

I'm designing a CLI tool that helps developers track TODO comments across
their codebase. Spawn three teammates to explore this from different angles:
one on UX, one on technical architecture, one playing devil's advocate.

• 上下矢印: チームメンバーを選択する
• Enter: 選択したチームメンバーのトランスクリプトを開き、直接メッセージを送信する
• Escape: 選択したチームメンバーの現在のターンを中断する

​

エージェントチームを制御する

​

表示モードを選択する

• In-process：すべてのチームメンバーがメインターミナル内で実行されます。エージェントパネルで上下矢印キーを使用してチームメンバーを選択し、Enter キーを押してそれを表示して、直接メッセージを入力してください。追加のセットアップなしで任意のターミナルで動作します。
• 分割ペイン：各チームメンバーが独自のペインを取得します。すべてのユーザーの出力を一度に表示でき、ペインをクリックして直接対話できます。tmux または iTerm2 が必要です。

{
  "teammateMode": "auto"
}

claude --teammate-mode auto

• tmux：システムのパッケージマネージャーを通じてインストールしてください。プラットフォーム固有の手順については、tmux wiki を参照してください。
• iTerm2：it2 CLI をインストールし、iTerm2 → Settings → General → Magic → Enable Python API で Python API を有効にしてください。

​

チームメンバーとモデルを指定する

Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for
each teammate.

​

チームメンバーのプラン承認を要求する

Spawn an architect teammate to refactor the authentication module.
Require plan approval before they make any changes.

​

チームメンバーと直接通信する

• In-process モード：エージェントパネルで上下矢印キーを使用してチームメンバーを選択し、Enter キーを押してそのセッションを表示して、メッセージを入力してください。選択したチームメンバーで x を押してそれを停止してください。Ctrl+T を押してタスクリストを切り替えてください。
• 分割ペインモード：チームメンバーのペインをクリックして、セッションと直接対話してください。各チームメンバーは独自のターミナルの完全なビューを持っています。

​

タスクを割り当てて要求する

• リーダーが割り当て：リーダーにどのタスクをどのチームメンバーに与えるかを指示してください
• 自己要求：タスクを完了した後、チームメンバーは独立して次の未割り当て、ブロック解除されたタスクを選択します

​

チームメンバーをシャットダウンする

Ask the researcher teammate to shut down

​

hooks で品質ゲートを実施する

• TeammateIdle：チームメンバーがアイドル状態になろうとしているときに実行されます。終了コード 2 でフィードバックを送信し、チームメンバーを動作させ続けてください。
• TaskCreated：タスクが作成されているときに実行されます。終了コード 2 で作成を防止し、フィードバックを送信してください。
• TaskCompleted：タスクが完了としてマークされているときに実行されます。終了コード 2 で完了を防止し、フィードバックを送信してください。

​

エージェントチームの動作方法

​

Claude がエージェントチームを開始する方法

• チームメンバーをリクエストする：並列作業から利益を得るタスクを Claude に提供し、明示的にチームメンバーをリクエストしてください。Claude は指示に基づいてチームメンバーを生成します。
• Claude がチームメンバーを提案する：Claude がタスクが並列作業から利益を得ると判断した場合、チームメンバーの生成を提案する可能性があります。進行する前に確認してください。

​

アーキテクチャ

• チーム設定：~/.claude/teams/{team-name}/config.json
• タスクリスト：~/.claude/tasks/{team-name}/

​

チームメンバーに subagent 定義を使用する

Spawn a teammate using the security-reviewer agent type to audit the auth module.

​

権限

​

コンテキストと通信

• 自動メッセージ配信：チームメンバーがメッセージを送信すると、受信者に自動的に配信されます。リーダーは更新をポーリングする必要はありません。
• アイドル通知：チームメンバーが完了して停止すると、リーダーに自動的に通知します。
• 共有タスクリスト：すべてのエージェントはタスクステータスを表示でき、利用可能な作業を要求できます。
• チームメンバーメッセージング：その名前で特定のチームメンバーにメッセージを送信します。全員に到達するには、受信者ごとに 1 つのメッセージを送信してください。

​

トークン使用量

​

ユースケース例

​

並列コードレビューを実行する

Spawn three teammates to review PR #142:
- One focused on security implications
- One checking performance impact
- One validating test coverage
Have them each review and report findings.

​

競合する仮説で調査する

Users report the app exits after one message instead of staying connected.
Spawn 5 agent teammates to investigate different hypotheses. Have them talk to
each other to try to disprove each other's theories, like a scientific
debate. Update the findings doc with whatever consensus emerges.

​

ベストプラクティス

​

チームメンバーに十分なコンテキストを提供する

Spawn a security reviewer teammate with the prompt: "Review the authentication module
at src/auth/ for security vulnerabilities. Focus on token handling, session
management, and input validation. The app uses JWT tokens stored in
httpOnly cookies. Report any issues with severity ratings."

​

適切なチームサイズを選択する

• トークンコストは線形にスケール：各チームメンバーは独自のコンテキストウィンドウを持ち、独立してトークンを消費します。詳細については、エージェントチームトークンコストを参照してください。
• 調整オーバーヘッドが増加：より多くのチームメンバーは、より多くの通信、タスク調整、および競合の可能性を意味します
• 収穫逓減：ある時点を超えると、追加のチームメンバーは作業を比例的に高速化しません

​

タスクを適切にサイズ設定する

• 小さすぎる：調整オーバーヘッドが利益を超える
• 大きすぎる：チームメンバーはチェックインなしで長時間動作し、無駄な努力のリスクが増加します
• ちょうど良い：関数、テストファイル、またはレビューなど、明確な成果物を生成する自己完結型ユニット

​

チームメンバーが完了するまで待つ

Wait for your teammates to complete their tasks before proceeding

​

調査とレビューから開始する

​

ファイルの競合を回避する

​

監視と操舵

​

トラブルシューティング

​

チームメンバーが表示されない

• In-process モードでは、チームメンバーはプロンプト入力の下のエージェントパネルに表示されます。上下矢印キーを使用して 1 つを選択し、Enter キーを押して表示してください。
• アイドル状態で消えたチームメンバー行は停止されていなく、非表示になっています。アイドル行は 30 秒後に非表示になり、チームメンバーの次のターンで再表示されます。チームメンバーに名前でメッセージを送信して、それを戻してください。
• Claude に提供したタスクがチームを必要とするほど十分複雑であることを確認してください。Claude はタスクに基づいてチームメンバーを生成するかどうかを決定します。
• 明示的に分割ペインをリクエストした場合は、tmux がインストールされ、PATH で利用可能であることを確認してください。
  which tmux
  
• iTerm2 の場合、it2 CLI がインストールされ、Python API が iTerm2 の設定で有効になっていることを確認してください。

​

権限プロンプトが多すぎる

​

チームメンバーがエラーで停止する

• 直接追加の指示を与える
• 作業を続行するために置き換えチームメンバーを生成する

​

リーダーが作業完了前にシャットダウンする

​

孤立した tmux セッション

tmux ls
tmux kill-session -t <session-name>

​

制限事項

• In-process チームメンバーでのセッション再開なし：/resume と /rewind は in-process チームメンバーを復元しません。セッションを再開した後、リーダーは存在しなくなったチームメンバーにメッセージを送信しようとする可能性があります。これが発生した場合は、リーダーに新しいチームメンバーを生成するよう指示してください。
• タスクステータスが遅延する可能性：チームメンバーはタスクを完了としてマークできず、依存タスクをブロックすることがあります。タスクが立ち往生しているように見える場合は、作業が実際に完了しているかどうかを確認し、タスクステータスを手動で更新するか、リーダーにチームメンバーをナッジするよう指示してください。
• シャットダウンが遅い可能性：チームメンバーは現在のリクエストまたはツール呼び出しを完了してからシャットダウンし、時間がかかる可能性があります。
• セッションあたり 1 つのチーム：セッションは正確に 1 つのチームを持ち、そのセッションにスコープされています。追加の名前付きチームを作成したり、セッション間でチームを共有したりすることはできません。
• ネストされたチームなし：チームメンバーは独自のチームメンバーを生成できません。リーダーのみがチームを管理できます。
• リーダーは固定：メインセッションはその生涯のリーダーです。チームメンバーをリーダーに昇格させたり、リーダーシップを譲渡したりすることはできません。
• 権限は生成時に設定：すべてのチームメンバーはリーダーの権限モードで開始します。生成後に個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。
• 分割ペインには tmux または iTerm2 が必要：デフォルトの in-process モードは任意のターミナルで動作します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。

​

次のステップ

• 軽量委任：subagents はセッション内で調査または検証用のヘルパーエージェントを生成し、エージェント間調整が必要ないタスクに適しています
• 手動並列セッション：Git worktrees を使用すると、自動チーム調整なしで複数の Claude Code セッションを自分で実行できます
• アプローチを比較：subagent とエージェントチームの比較を参照して、並べて比較してください