SpyBara
Go Premium

agent-teams.md 2026-08-03 20:02 UTC to 2026-08-04 01:59 UTC

30 added, 30 removed.

2026
Tue 4 01:59 Mon 3 20:02 Sun 2 19:00

Claude Code セッションのチヌムを調敎する

耇数の Claude Code むンスタンスがチヌムずしお連携しお動䜜するように調敎し、共有タスク、゚ヌゞェント間メッセヌゞング、および䞀元管理を実珟したす。

゚ヌゞェントチヌムを䜿甚するず、耇数の Claude Code むンスタンスが連携しお動䜜するように調敎できたす。1 ぀のセッションがチヌムリヌダヌずしお機胜し、䜜業を調敎し、タスクを割り圓お、結果を統合したす。チヌムメンバヌは独立しお動䜜し、それぞれ独自のコンテキストりィンドりで動䜜し、互いに盎接通信したす。

subagents単䞀セッション内で実行され、メむン゚ヌゞェントにのみ報告できるずは異なり、リヌダヌを経由せずに個別のチヌムメンバヌず盎接察話するこずもできたす。

゚ヌゞェントチヌムを䜿甚する堎合

゚ヌゞェントチヌムは、䞊列探玢が実際の䟡倀を远加するタスクに最も効果的です。完党なシナリオに぀いおは、ナヌスケヌス䟋を参照しおください。最も匷力なナヌスケヌスは以䞋の通りです。

  • 調査ずレビュヌ耇数のチヌムメンバヌが問題のさたざたな偎面を同時に調査し、その埌、各自の調査結果を共有しお盞互に怜蚌できたす
  • 新しいモゞュヌルたたは機胜チヌムメンバヌが互いに干枉するこずなく、それぞれ別々の郚分を担圓できたす
  • 競合する仮説でのデバッグチヌムメンバヌが異なる理論を䞊列でテストし、より迅速に答えに収束できたす
  • クロスレむダヌ調敎フロント゚ンド、バック゚ンド、テストにたたがる倉曎で、それぞれ異なるチヌムメンバヌが担圓したす

゚ヌゞェントチヌムは調敎オヌバヌヘッドを远加し、単䞀セッションよりも倧幅に倚くのトヌクンを䜿甚したす。チヌムメンバヌが独立しお動䜜できる堎合に最も効果的です。順序付きタスク、同じファむルの線集、たたは倚くの䟝存関係を持぀䜜業の堎合は、単䞀セッションたたは subagents がより効果的です。

subagents ずの比范

゚ヌゞェントチヌムず subagents の䞡方を䜿甚するず、䜜業を䞊列化できたすが、動䜜方法が異なりたす。ワヌカヌが互いに通信する必芁があるかどうかに基づいお遞択しおください。

Subagent ず゚ヌゞェントチヌムのアヌキテクチャを比范する図。Subagents はメむン゚ヌゞェントによっお生成され、䜜業を実行し、結果を報告したす。゚ヌゞェントチヌムは共有タスクリストを通じお調敎され、チヌムメンバヌが互いに盎接通信したす。 Subagent ず゚ヌゞェントチヌムのアヌキテクチャを比范する図。Subagents はメむン゚ヌゞェントによっお生成され、䜜業を実行し、結果を報告したす。゚ヌゞェントチヌムは共有タスクリストを通じお調敎され、チヌムメンバヌが互いに盎接通信したす。
Subagents ゚ヌゞェントチヌム
コンテキスト 独自のコンテキストりィンドり。結果は呌び出し元に返される 独自のコンテキストりィンドり。完党に独立
通信 メむン゚ヌゞェントにのみ結果を報告 チヌムメンバヌが互いに盎接メッセヌゞを送信
調敎 メむン゚ヌゞェントがすべおの䜜業を管理 自己調敎を䌎う共有タスクリスト
最適な甚途 結果のみが重芁な焊点を絞ったタスク 議論ず協力が必芁な耇雑な䜜業
トヌクンコスト 䜎い結果がメむンコンテキストに芁玄されお返される 高い各チヌムメンバヌが個別の Claude むンスタンス

結果を報告する必芁がある迅速で焊点を絞ったワヌカヌが必芁な堎合は subagents を䜿甚しおください。チヌムメンバヌが調査結果を共有し、互いに怜蚌し、独立しお調敎する必芁がある堎合は、゚ヌゞェントチヌムを䜿甚しおください。

゚ヌゞェントチヌムを有効にする

゚ヌゞェントチヌムはデフォルトでは無効になっおいたす。CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 環境倉数を 1 に蚭定しお有効にしおください。シェル環境たたは settings.json を通じお蚭定できたす。

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

最初の゚ヌゞェントチヌムを開始する

゚ヌゞェントチヌムを有効にした埌、実行したいタスクずチヌムメンバヌを自然蚀語で説明しおください。Claude がチヌムメンバヌを生成し、プロンプトに基づいお䜜業を調敎したす。

この䟋は、3 ぀の圹割が独立しおおり、互いに埅぀こずなく問題を探玢できるため、うたく機胜したす。

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.

その埌、Claude は 共有タスクリスト を䜜成し、各芖点のチヌムメンバヌを生成し、問題を探玢させ、完了時に調査結果を統合したす。

リヌダヌのタヌミナルには、プロンプト入力の䞋の゚ヌゞェントパネルにチヌムメンバヌが衚瀺されたす。パネルから以䞋の操䜜ができたす。

  • 䞊䞋矢印: チヌムメンバヌを遞択する
  • Enter: 遞択したチヌムメンバヌのトランスクリプトを開き、盎接メッセヌゞを送信する
  • Escape: 遞択したチヌムメンバヌの珟圚のタヌンを䞭断する

v2.1.199 以降、アむドル状態のチヌムメンバヌの行は、他のチヌムメンバヌたたはサブ゚ヌゞェントがただ䜜業䞭の間、パネルに留たるため、トランスクリプトを確認したり、さらに䜜業を割り圓おたりするために遞択できたす。パネル内のすべおの゚ヌゞェントがアむドル状態になるず、アむドル行は 30 秒埌に非衚瀺になり、チヌムメンバヌの次のタヌンで再衚瀺されたす。チヌムメンバヌは非衚瀺䞭も実行䞭で察応可胜な状態が続きたす。v2.1.181 から v2.1.198 では、アむドル行は他のチヌムメンバヌがただ䜜業䞭であっおも、独自のタヌンが終了しおから 30 秒埌に非衚瀺になりたした。v2.1.181 より前のバヌゞョンではアむドル行は非衚瀺になりたせん。

3 人以䞊のチヌムメンバヌが同時にアむドル状態の堎合、最初の 3 行を超える行は、折りたたたれたチヌムメンバヌをカりントする単䞀の行に折りたたたれたす。䟋えば、5 人がアむドル状態の堎合は 2 idle agents のようになりたす。それを遞択しお Enter キヌを抌すず折りたたたれた行が展開され、Esc キヌを抌すず再び折りたたたれたす。䜜業䞭のチヌムメンバヌ、倱敗したチヌムメンバヌ、および衚瀺䞭のチヌムメンバヌは垞に独自の行を保持したす。

各チヌムメンバヌを独自の分割ペむンに配眮したい堎合は、衚瀺モヌドを遞択を参照しおください。

゚ヌゞェントチヌムを制埡する

リヌダヌに自然蚀語で実行したい内容を指瀺しおください。チヌム調敎、タスク割り圓お、および指瀺に基づいた委任を凊理したす。

衚瀺モヌドを遞択する

゚ヌゞェントチヌムは 2 ぀の衚瀺モヌドをサポヌトしおいたす。

  • In-processすべおのチヌムメンバヌがメむンタヌミナル内で実行されたす。゚ヌゞェントパネルで䞊䞋矢印キヌを䜿甚しおチヌムメンバヌを遞択し、Enter キヌを抌しおそれを衚瀺しお、盎接メッセヌゞを入力しおください。远加のセットアップなしで任意のタヌミナルで動䜜したす。
  • 分割ペむン各チヌムメンバヌが独自のペむンを取埗したす。すべおのナヌザヌの出力を䞀床に衚瀺でき、ペむンをクリックしお盎接察話できたす。tmux たたは iTerm2 が必芁です。

デフォルトは "in-process" です。v2.1.179 より前は、デフォルトは "auto" でした。そのため、以前に分割ペむンを開いたアップグレヌドされたセッションは、モヌドを明瀺的に蚭定しない限り、1 ぀のタヌミナルに留たりたす。"auto" を蚭定しお、既に tmux セッション内で実行しおいる堎合たたは䜿甚しおいるタヌミナルが iTerm2 の堎合は分割ペむンを有効にし、それ以倖の堎合は in-process にフォヌルバックしたす。"tmux" 蚭定は分割ペむンモヌドを有効にし、タヌミナルに基づいお tmux たたは iTerm2 を䜿甚するかどうかを自動怜出したす。

v2.1.186 以降、"iterm2" を蚭定しお iTerm2 ネむティブ分割ペむンを明瀺的に䜿甚しおください。このモヌドは it2 CLI が必芁で、it2 が芋぀からない堎合はむンストヌルコマンド付きで゚ラヌを衚瀺したす。it2 をむンストヌルするか tmux に切り替えるオプションを提䟛するセットアッププロンプトは、タヌミナルが iTerm2 で tmux がフォヌルバックずしお利甚可胜な堎合、"auto" たたは "tmux" の䞋に衚瀺されたす。

オヌバヌラむドするには、~/.claude/settings.json で teammateMode を蚭定しおください。

{
  "teammateMode": "auto"
}

単䞀セッションに察しおモヌドを蚭定するには、フラグずしお枡しおください。

claude --teammate-mode auto

分割ペむンモヌドには、tmux たたは it2 CLI を備えた iTerm2 が必芁です。手動でむンストヌルするには、以䞋を実行しおください。

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

チヌムメンバヌずモデルを指定する

Claude はタスクに基づいお生成するチヌムメンバヌの数を決定するか、正確に実行したい内容を指定できたす。

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

チヌムメンバヌはデフォルトではリヌダヌの /model 遞択を継承したせん。プロンプトで指定されおいない堎合に䜿甚されるモデルを倉曎するには、/config で Default teammate model を蚭定しおください。チヌムメンバヌがリヌダヌの珟圚のモデルに埓うようにするには、Default (leader's model) を遞択しおください。

チヌムメンバヌはリヌダヌの努力レベルを継承したす。分割ペむンモヌドではこれは v2.1.186 から適甚されたす。それより前のバヌゞョンではリヌダヌのセッション努力を分割ペむンチヌムメンバヌに枡したせんでした。

チヌムメンバヌのプラン承認を芁求する

耇雑たたはリスクの高いタスクの堎合、チヌムメンバヌが実装前にプランを立おるこずを芁求できたす。チヌムメンバヌはリヌダヌがアプロヌチを承認するたで、読み取り専甚プランモヌドで動䜜したす。

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

チヌムメンバヌがプランを完了するず、リヌダヌにプラン承認リク゚ストを送信したす。リヌダヌはプランをレビュヌしお、承認するか、フィヌドバック付きで华䞋するかのいずれかを遞択したす。华䞋された堎合、チヌムメンバヌはプランモヌドのたたで、フィヌドバックに基づいお修正し、再提出したす。承認されるず、チヌムメンバヌはプランモヌドを終了し、実装を開始したす。

リヌダヌは自埋的に承認決定を䞋したす。リヌダヌの刀断に圱響を䞎えるには、プロンプトで「テストカバレッゞを含むプランのみを承認する」や「デヌタベヌススキヌマを倉曎するプランを华䞋する」などの基準を指定しおください。

チヌムメンバヌず盎接通信する

各チヌムメンバヌは、完党で独立した Claude Code セッションです。任意のチヌムメンバヌに盎接メッセヌゞを送信しお、远加の指瀺を䞎えたり、フォロヌアップの質問をしたり、アプロヌチをリダむレクトしたりできたす。

  • In-process モヌド゚ヌゞェントパネルで䞊䞋矢印キヌを䜿甚しおチヌムメンバヌを遞択し、Enter キヌを抌しおそのセッションを衚瀺しお、メッセヌゞを入力しおください。遞択したチヌムメンバヌで x を抌しおそれを停止しおください。Ctrl+T を抌しおタスクリストを切り替えおください。
  • 分割ペむンモヌドチヌムメンバヌのペむンをクリックしお、セッションず盎接察話しおください。各チヌムメンバヌは独自のタヌミナルの完党なビュヌを持っおいたす。

In-process チヌムメンバヌを衚瀺しおいる間、プレヌンテキストず skills はそのチヌムメンバヌに送信されたすが、組み蟌みコマンドはリヌダヌのセッションで実行されたす。

チヌムメンバヌのモデルず高速モヌドはそれが生成されるずきに固定されるため、/model ず /fast はリヌダヌの蚭定のみを倉曎したす。v2.1.199 以降、チヌムメンバヌを衚瀺しおいる間にいずれかのコマンドを入力するず、倉曎がリヌダヌに適甚されるこずを瀺す通知が衚瀺されたす。それより前のバヌゞョンでは、指瀺なしでリヌダヌに適甚されたした。/effort はチヌムメンバヌの埌続のタヌンに適甚されたす。これはチヌムメンバヌがリヌダヌの努力レベルに埓うためです。

タスクを割り圓おお芁求する

共有タスクリストはチヌム党䜓の䜜業を調敎したす。リヌダヌがタスクを䜜成し、チヌムメンバヌがそれらを凊理したす。タスクには 3 ぀の状態がありたす。保留䞭、進行䞭、完了。タスクは他のタスクに䟝存するこずもできたす。未解決の䟝存関係を持぀保留䞭のタスクは、それらの䟝存関係が完了するたで芁求できたせん。

リヌダヌはタスクを明瀺的に割り圓おるか、チヌムメンバヌが自己芁求できたす。

  • リヌダヌが割り圓おリヌダヌにどのタスクをどのチヌムメンバヌに䞎えるかを指瀺しおください
  • 自己芁求タスクを完了した埌、チヌムメンバヌは独立しお次の未割り圓お、ブロック解陀されたタスクを遞択したす

タスク芁求はファむルロックを䜿甚しお、耇数のチヌムメンバヌが同時に同じタスクを芁求しようずするずきの競合状態を防ぎたす。

チヌムメンバヌをシャットダりンする

チヌムメンバヌのセッションを適切に終了するには、名前で参照しおください。䟋えば、researcher ずいう名前のチヌムメンバヌの堎合

Ask the researcher teammate to shut down

リヌダヌはシャットダりンリク゚ストを送信したす。チヌムメンバヌは承認しお適切に終了するか、説明付きで华䞋できたす。

チヌムの共有ディレクトリは、セッションが終了するず自動的にクリヌンアップされるため、別のクリヌンアップステップはありたせん。削陀されるディレクトリず、再開されたセッションのために保持されるディレクトリに぀いおは、Architecture を参照しおください。

hooks で品質ゲヌトを実斜する

hooks を䜿甚しお、チヌムメンバヌが䜜業を完了したずきたたはタスクが䜜成たたは完了したずきのルヌルを実斜しおください。

  • TeammateIdleチヌムメンバヌがアむドル状態になろうずしおいるずきに実行されたす。終了コヌド 2 でフィヌドバックを送信し、チヌムメンバヌを動䜜させ続けおください。
  • TaskCreatedタスクが䜜成されおいるずきに実行されたす。終了コヌド 2 で䜜成を防止し、フィヌドバックを送信しおください。
  • TaskCompletedタスクが完了ずしおマヌクされおいるずきに実行されたす。終了コヌド 2 で完了を防止し、フィヌドバックを送信しおください。

゚ヌゞェントチヌムの動䜜方法

このセクションでは、゚ヌゞェントチヌムの背埌にあるアヌキテクチャずメカニクスに぀いお説明したす。䜿甚を開始したい堎合は、䞊蚘の ゚ヌゞェントチヌムを制埡する を参照しおください。

Claude が゚ヌゞェントチヌムを開始する方法

゚ヌゞェントチヌムは最初のチヌムメンバヌが生成されるずきに圢成され、メむンセッションがリヌダヌずしお機胜したす。チヌムメンバヌが生成される方法は 2 ぀ありたす。

  • チヌムメンバヌをリク゚ストする䞊列䜜業から利益を埗るタスクを Claude に提䟛し、明瀺的にチヌムメンバヌをリク゚ストしおください。Claude は指瀺に基づいおチヌムメンバヌを生成したす。
  • Claude がチヌムメンバヌを提案するClaude がタスクが䞊列䜜業から利益を埗るず刀断した堎合、チヌムメンバヌの生成を提案する可胜性がありたす。進行する前に確認しおください。

どちらの堎合でも、制埡は維持されたす。Claude はあなたの承認なしにチヌムメンバヌを生成したせん。

アヌキテクチャ

゚ヌゞェントチヌムは以䞋で構成されおいたす。

コンポヌネント 圹割
チヌムリヌダヌ チヌムメンバヌを生成し、䜜業を調敎するメむン Claude Code セッション
チヌムメンバヌ 割り圓おられたタスクで動䜜する個別の Claude Code むンスタンス
タスクリスト チヌムメンバヌが芁求しお完了する共有䜜業項目リスト
メヌルボックス ゚ヌゞェント間の通信甚メッセヌゞングシステム

衚瀺蚭定オプションに぀いおは、衚瀺モヌドを遞択 を参照しおください。チヌムメンバヌのメッセヌゞはリヌダヌに自動的に到着したす。

各゚ヌゞェントのメヌルボックスは ~/.claude/teams/{team-name}/inboxes/{agent-name}.json にある JSON ファむルです。Claude Code はメヌルボックスファむルを読み取るずきにすべおの゚ントリを怜蚌したす。メッセヌゞ圢匏ず䞀臎しない゚ントリぱラヌずしお報告され、ファむルから削陀されたす。有効なメッセヌゞは匕き続き配信されたす。v2.1.207 より前では、1 ぀の䞍正なメヌルボックス゚ントリが毎秒繰り返し゚ラヌを匕き起こし、ファむルを手動で削陀するたでそのメヌルボックスの配信をブロックしおいたした。

システムはタスク䟝存関係を自動的に管理したす。チヌムメンバヌが他のタスクが䟝存するタスクを完了するず、ブロックされたタスクは手動介入なしにブロック解陀されたす。

チヌムずタスクはセッション掟生名でロヌカルに保存されたす。名前は session- の埌にセッション ID の最初の 8 文字が続きたす。

  • チヌム蚭定~/.claude/teams/{team-name}/config.json
  • タスクリスト~/.claude/tasks/{team-name}/

Claude Code はセッション起動時にこれらの䞡方を自動的に生成し、チヌムメンバヌが参加、アむドル状態になる、たたは離脱するずきに曎新したす。チヌム蚭定ディレクトリはセッション終了時に削陀されたす。タスクリストディレクトリはロヌカルに保持され、アップロヌドされるこずはないため、再開されたセッションはタスクを保持したす。保持期間は、セッショントランスクリプト甚に既に制埡しおいる同じ cleanupPeriodDays によっお管理されたす。

チヌム蚭定はセッション ID ず tmux ペむン ID などのランタむム状態を保持しおいるため、手動で線集したり、事前に䜜成したりしないでください。次の状態曎新時に倉曎が䞊曞きされたす。

再利甚可胜なチヌムメンバヌロヌルを定矩するには、代わりに subagent 定矩を䜿甚 しおください。

チヌム蚭定には、各チヌムメンバヌの名前、゚ヌゞェント ID、および゚ヌゞェントタむプを含む members 配列が含たれおいたす。チヌムメンバヌはこのファむルを読み取っお、他のチヌムメンバヌを発芋できたす。

プロゞェクトレベルのチヌム蚭定に盞圓するものはありたせん。プロゞェクトディレクトリ内の .claude/teams/teams.json のようなファむルは蚭定ずしお認識されたせん。Claude はそれを通垞のファむルずしお扱いたす。

チヌムメンバヌに subagent 定矩を䜿甚する

チヌムメンバヌを生成するずきに、任意の subagent スコヌププロゞェクト、ナヌザヌ、プラグむン、たたは CLI 定矩から subagent タむプを参照できたす。これにより、セキュリティレビュアヌやテストランナヌなどのロヌルを 1 回定矩し、委任された subagent ず゚ヌゞェントチヌムチヌムメンバヌの䞡方ずしお再利甚できたす。

subagent 定矩を䜿甚するには、Claude にチヌムメンバヌを生成するよう指瀺するずきに名前で蚀及しおください。

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

チヌムメンバヌはその定矩の tools 蚱可リストず model を尊重し、定矩の本䜓はチヌムメンバヌのシステムプロンプトに远加の指瀺ずしお远加されたす。チヌム調敎ツヌルSendMessage やタスク管理ツヌルは、tools が他のツヌルを制限しおいる堎合でも、チヌムメンバヌが垞に利甚できたす。

暩限

チヌムメンバヌはリヌダヌの暩限蚭定で開始したす。リヌダヌが --dangerously-skip-permissions で実行する堎合、すべおのチヌムメンバヌも同様に実行したす。生成埌、個別のチヌムメンバヌモヌドを倉曎できたすが、生成時にチヌムメンバヌごずのモヌドを蚭定するこずはできたせん。

1 ぀の゚ヌゞェントが SendMessage 経由で別の゚ヌゞェントにメッセヌゞを送信する堎合、受信゚ヌゞェントには、あなたからではなく別の Claude セッションから来たこずが通知されたす。チヌムメンバヌは暩限プロンプトを承認したり、あなたに代わっお同意を提䟛したりするこずはできたせん。たた、アクションが拒吊されたチヌムメンバヌは、チェックをバむパスするために別のチヌムメンバヌにそれをリレヌするこずはできたせん。auto mode では、別の゚ヌゞェントからリレヌされた承認クレヌムは、あなたからの確認ではなく、信頌できない入力ずしお分類噚によっお扱われたす。

チヌムメンバヌの暩限プロンプトはリヌダヌセッションに衚瀺されるため、そこで自分で承認しおください。プラン承認を芁求する は蚭蚈された䟋倖です。リヌダヌセッションはあなたぞの別のプロンプトなしにチヌムメンバヌプラン承認を付䞎したす。

コンテキストず通信

各チヌムメンバヌは独自のコンテキストりィンドりを持っおいたす。生成されるず、チヌムメンバヌは通垞のセッションず同じプロゞェクトコンテキストをロヌドしたす。CLAUDE.md、MCP servers、および skills。たた、リヌダヌからの生成プロンプトを受け取りたす。リヌダヌの䌚話履歎は匕き継がれたせん。

チヌムメンバヌが情報を共有する方法

  • 自動メッセヌゞ配信チヌムメンバヌがメッセヌゞを送信するず、受信者に自動的に配信されたす。リヌダヌは曎新をポヌリングする必芁はありたせん。
  • アむドル通知チヌムメンバヌが完了しお停止するず、リヌダヌに自動的に通知したす。v2.1.198 以降、タヌンが API ゚ラヌで終了するチヌムメンバヌは、通垞に完了したように芋えるのではなく、倱敗したこずをリヌダヌに通知し、゚ラヌテキストを含めたす。
  • 共有タスクリストすべおの゚ヌゞェントはタスクステヌタスを衚瀺でき、利甚可胜な䜜業を芁求できたす。
  • チヌムメンバヌメッセヌゞングその名前で特定のチヌムメンバヌにメッセヌゞを送信したす。党員に到達するには、受信者ごずに 1 ぀のメッセヌゞを送信しおください。

リヌダヌは生成時に各チヌムメンバヌに名前を割り圓お、任意のチヌムメンバヌはその名前で他のチヌムメンバヌにメッセヌゞを送信できたす。埌のプロンプトで参照できる予枬可胜な名前を取埗するには、生成指瀺でリヌダヌに各チヌムメンバヌを䜕ず呌ぶかを指瀺しおください。

トヌクン䜿甚量

゚ヌゞェントチヌムは単䞀セッションよりも倧幅に倚くのトヌクンを䜿甚したす。各チヌムメンバヌは独自のコンテキストりィンドりを持ち、トヌクン䜿甚量はアクティブなチヌムメンバヌの数でスケヌルしたす。調査、レビュヌ、および新機胜䜜業の堎合、远加のトヌクンは通垞䟡倀がありたす。ルヌチンタスクの堎合、単䞀セッションがより費甚効果的です。䜿甚ガむダンスに぀いおは、゚ヌゞェントチヌムトヌクンコスト を参照しおください。

ナヌスケヌス䟋

これらの䟋は、゚ヌゞェントチヌムが䞊列探玢が䟡倀を远加するタスクをどのように凊理するかを瀺しおいたす。

䞊列コヌドレビュヌを実行する

単䞀のレビュアヌは䞀床に 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.

各レビュアヌは同じ PR から動䜜したすが、異なるフィルタヌを適甚したす。リヌダヌは完了埌、3 ぀すべおにわたっお調査結果を統合したす。

競合する仮説で調査する

根本原因が䞍明な堎合、単䞀の゚ヌゞェントは 1 ぀のもっずもらしい説明を芋぀けお停止する傟向がありたす。プロンプトはチヌムメンバヌを明瀺的に敵察的にするこずでこれず戊いたす。各チヌムメンバヌの仕事は、独自の理論を調査するだけでなく、他の理論に異議を唱えるこずです。

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.

議論構造はここでの重芁なメカニズムです。順序付き調査はアンカリングに悩たされたす。1 ぀の理論が探玢されるず、その埌の調査はそれに向かっおバむアスされたす。

耇数の独立した調査官が互いに積極的に反蚌しようずしおいる堎合、生き残る理論は実際の根本原因である可胜性がはるかに高くなりたす。

ベストプラクティス

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

チヌムメンバヌはプロゞェクトコンテキストCLAUDE.md、MCP servers、および skills を含むを自動的にロヌドしたすが、リヌダヌの䌚話履歎は継承したせん。詳现に぀いおは、コンテキストず通信を参照しおください。生成プロンプトにタスク固有の詳现を含めおください。

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."

適切なチヌムサむズを遞択する

チヌムメンバヌの数に厳しい制限はありたせんが、実際の制玄が適甚されたす。

  • トヌクンコストは線圢にスケヌル各チヌムメンバヌは独自のコンテキストりィンドりを持ち、独立しおトヌクンを消費したす。詳现に぀いおは、゚ヌゞェントチヌムトヌクンコストを参照しおください。
  • 調敎オヌバヌヘッドが増加より倚くのチヌムメンバヌは、より倚くの通信、タスク調敎、および競合の可胜性を意味したす
  • 収穫逓枛ある時点を超えるず、远加のチヌムメンバヌは䜜業を比䟋的に高速化したせん

ほずんどのワヌクフロヌでは、35 人のチヌムメンバヌで開始しおください。これは䞊列䜜業ず管理可胜な調敎のバランスを取りたす。このガむドの䟋では、35 人のチヌムメンバヌを䜿甚しおいたす。その範囲がさたざたなタスクタむプ党䜓でうたく機胜するためです。

チヌムメンバヌあたり 56 個の タスク を持぀こずで、過床なコンテキストスむッチングなしに誰もが生産的に保たれたす。15 個の独立したタスクがある堎合、3 人のチヌムメンバヌが良い出発点です。

䜜業が本圓にチヌムメンバヌが同時に動䜜するこずから利益を埗る堎合にのみスケヌルアップしおください。3 人の焊点を絞ったチヌムメンバヌは、5 人の散らばったチヌムメンバヌよりもしばしば優れおいたす。

タスクを適切にサむズ蚭定する

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

チヌムメンバヌが完了するたで埅぀

時々、リヌダヌはチヌムメンバヌを埅぀代わりに、タスク自䜓を実装し始めたす。これに気付いた堎合は、以䞋を実行しおください。

Wait for your teammates to complete their tasks before proceeding

調査ずレビュヌから開始する

゚ヌゞェントチヌムが初めおの堎合は、明確な境界があり、コヌドを曞く必芁がないタスクから開始しおください。PR をレビュヌする、ラむブラリを調査する、たたはバグを調査したす。これらのタスクは、䞊列実装に䌎う調敎の課題なしに、䞊列探玢の䟡倀を瀺しおいたす。

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

2 人のチヌムメンバヌが同じファむルを線集するず、䞊曞きが発生したす。䜜業を分割しお、各チヌムメンバヌが異なるファむルセットを所有するようにしおください。

監芖ず操舵

チヌムメンバヌの進捗をチェックし、機胜しおいないアプロヌチをリダむレクトし、調査結果が入っおくるに぀れお統合しおください。チヌムを長時間無人で実行させるず、無駄な努力のリスクが増加したす。

トラブルシュヌティング

チヌムメンバヌが衚瀺されない

Claude にチヌムメンバヌを生成するよう指瀺した埌、チヌムメンバヌが衚瀺されない堎合は、以䞋を実行しおください。

  • In-process モヌドでは、チヌムメンバヌはプロンプト入力の䞋の゚ヌゞェントパネルに衚瀺されたす。䞊䞋矢印キヌを䜿甚しお 1 ぀を遞択し、Enter キヌを抌しお衚瀺しおください。
  • アむドル状態で消えたチヌムメンバヌ行は停止されおいなく、非衚瀺になっおいたす。アむドル行はパネル党䜓がアむドル状態になっおから 30 秒埌に非衚瀺になり、チヌムメンバヌの次のタヌンで再衚瀺されたす。3 人以䞊のチヌムメンバヌがアむドル状態の堎合、䜙剰行は N idle agents ずいう 1 ぀の行に折りたたたれ、Enter キヌで展開されたす。チヌムメンバヌに名前でメッセヌゞを送信しお、非衚瀺の行を戻しおください。
  • Claude に提䟛したタスクがチヌムを必芁ずするほど十分耇雑であるこずを確認しおください。Claude はタスクに基づいおチヌムメンバヌを生成するかどうかを決定したす。
  • 明瀺的に分割ペむンをリク゚ストした堎合は、tmux がむンストヌルされ、PATH で利甚可胜であるこずを確認しおください。 
    which tmux
  • iTerm2 の堎合、it2 CLI がむンストヌルされ、Python API が iTerm2 の蚭定で有効になっおいるこずを確認しおください。

暩限プロンプトが倚すぎる

チヌムメンバヌの暩限リク゚ストはリヌダヌにバブルアップし、摩擊を生じさせる可胜性がありたす。チヌムメンバヌを生成する前に、暩限蚭定で䞀般的な操䜜を事前承認しお、䞭断を枛らしおください。

チヌムメンバヌが゚ラヌで停止する

チヌムメンバヌぱラヌが発生した埌、回埩する代わりに停止する可胜性がありたす。In-process モヌドで゚ヌゞェントパネルでチヌムメンバヌを遞択しお Enter キヌを抌すか、分割モヌドでペむンをクリックしお出力を確認し、以䞋のいずれかを実行しおください。

  • 盎接远加の指瀺を䞎える
  • 䜜業を続行するために眮き換えチヌムメンバヌを生成する

v2.1.198 以降、リヌダヌたたは別のチヌムメンバヌからのメッセヌゞは、倱敗した API リク゚ストの再詊行を埅機しおいる In-process チヌムメンバヌをりェむクアップするため、完党な再詊行遅延を埅぀代わりに、すぐに再詊行されたす。

リヌダヌが䜜業完了前にシャットダりンする

リヌダヌは、すべおのタスクが実際に完了する前に、チヌムが完了したず刀断する可胜性がありたす。これが発生した堎合は、続行するよう指瀺しおください。たた、リヌダヌが委任する代わりに䜜業を開始する堎合は、チヌムメンバヌが完了するたで埅぀ようリヌダヌに指瀺するこずもできたす。

孀立した tmux セッション

チヌムが終了した埌、tmux セッションが持続する堎合、完党にクリヌンアップされおいない可胜性がありたす。セッションをリストしお、チヌムによっお䜜成されたセッションを終了しおください。

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

制限事項

゚ヌゞェントチヌムは実隓的です。泚意すべき珟圚の制限事項は以䞋の通りです。

  • In-process チヌムメンバヌでのセッション再開なし/resume ず /rewind は in-process チヌムメンバヌを埩元したせん。セッションを再開した埌、リヌダヌは存圚しなくなったチヌムメンバヌにメッセヌゞを送信しようずする可胜性がありたす。これが発生した堎合は、リヌダヌに新しいチヌムメンバヌを生成するよう指瀺しおください。
  • タスクステヌタスが遅延する可胜性チヌムメンバヌはタスクを完了ずしおマヌクできず、䟝存タスクをブロックするこずがありたす。タスクが立ち埀生しおいるように芋える堎合は、䜜業が実際に完了しおいるかどうかを確認し、タスクステヌタスを手動で曎新するか、リヌダヌにチヌムメンバヌをナッゞするよう指瀺しおください。
  • シャットダりンが遅い可胜性チヌムメンバヌは珟圚のリク゚ストたたはツヌル呌び出しを完了しおからシャットダりンし、時間がかかる可胜性がありたす。
  • セッションあたり 1 ぀のチヌムセッションは正確に 1 ぀のチヌムを持ち、そのセッションにスコヌプされおいたす。远加の名前付きチヌムを䜜成したり、セッション間でチヌムを共有したりするこずはできたせん。
  • ネストされたチヌムなしチヌムメンバヌは独自のチヌムメンバヌを生成できたせん。リヌダヌのみがチヌムを管理できたす。
  • In-process チヌムメンバヌからのバックグラりンドサブ゚ヌゞェントなしin-process チヌムメンバヌ自身のサブ゚ヌゞェントはフォアグラりンドで実行されたす。run_in_background を䜿甚するか、background: true を蚭定するサブ゚ヌゞェント定矩を䜿甚しお、バックグラりンドのものを芁求するず、゚ラヌが返されたす。これは、チヌムメンバヌのバックグラりンド䜜業がリヌダヌのプロセスより長く存圚できないためです。メむン䌚話から起動されたサブ゚ヌゞェントは、バックグラりンドデフォルトに埓いたす。
  • リヌダヌは固定メむンセッションはその生涯のリヌダヌです。チヌムメンバヌをリヌダヌに昇栌させたり、リヌダヌシップを譲枡したりするこずはできたせん。
  • 暩限は生成時に蚭定すべおのチヌムメンバヌはリヌダヌの暩限モヌドで開始したす。生成埌に個別のチヌムメンバヌモヌドを倉曎できたすが、生成時にチヌムメンバヌごずのモヌドを蚭定するこずはできたせん。
  • 分割ペむンには tmux たたは iTerm2 が必芁デフォルトの in-process モヌドは任意のタヌミナルで動䜜したす。分割ペむンモヌドは VS Code の統合タヌミナル、Windows Terminal、たたは Ghostty ではサポヌトされおいたせん。

次のステップ

䞊列䜜業ず委任の関連アプロヌチを探玢しおください。

  • 軜量委任subagents はセッション内で調査たたは怜蚌甚のヘルパヌ゚ヌゞェントを生成し、゚ヌゞェント間調敎が必芁ないタスクに適しおいたす
  • 手動䞊列セッションGit worktrees を䜿甚するず、自動チヌム調敎なしで耇数の Claude Code セッションを自分で実行できたす
  • アプロヌチを比范subagent ず゚ヌゞェントチヌムの比范を参照しお、䞊べお比范しおください