Claude CodeのAgent Teamsを使う前に知っておくこと

Agent Teamsは、複数のClaude Codeセッションを協調させ、独立した担当へ仕事を分ける仕組みです。サブエージェントが親セッションの一部として要約を返すのに対し、チームは並列調査や相互レビューのようにセッション間で役割を持たせます。利用可否や設定はバージョン・プランで変わるため、/helpと公式ドキュメントを先に確認してください。

有効化して試す

Agent Teamsは実験的機能で既定では無効です。PowerShellの現在のプロセスで試す例は次のとおりです。公式のAgent Teams手順

$env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1"
claude

対話セッションで担当と目的を明示して依頼します。現行仕様では、-pやAgent SDKの非対話実行ではteammateとして起動しません。また、有効化中は通常の名前付き分担もteammateになる場合があるため、利用量と担当一覧を確認します。試行を終えて無効にする際は、設定ファイルにも同じ環境変数が残っていないかを見直します。

向く作業

同じファイルを同時に編集する前に、独立した調査を分けます。

• 担当A：仕様公式資料と実装を照合し、URLと不明点を返す。
• 担当B：テスト再現手順と不足している検査を返す。
• 担当C：レビュー差分の問題を根拠付きで返す。

各結果は親が照合して統合します。共有作業ツリーの編集は担当ファイルを分け、並列数に伴う利用量も確認します。

「API仕様を調べる」「既存テストを読む」「UI差分をレビューする」のように独立して進められる仕事を分担します。共有作業ツリーで同じファイルを書かせると競合が起きるため、担当ファイルやブランチを分け、最後に親が差分を統合します。各担当には目的、対象範囲、完了条件、返す形式を明記します。

担当A: 公式資料と現行実装を照合し、URLと未確認点を返す
担当B: テストを読み、再現手順と不足テストを返す
担当C: 差分をレビューし、重大度順に指摘する

コストと境界

並列化してもモデル呼び出しが無料になるわけではなく、コンテキストを各担当が読むため利用量が増えます。小さな修正や同じファイルを連続編集する作業では、通常セッションの方が結果を追いやすいでしょう。チームが自動でコミット、push、外部サービスへ投稿するような依頼は、権限と成果物を限定します。

Agent Teamsは拡張機能の全体像でサブエージェントやMCPとの違いを確認し、必要ならサブエージェントの定義から始めます。実機検証はしていません。

実務では、最初に読み取り専用の担当を置き、結果を親が採用してから編集担当へ渡します。担当ごとに同じ巨大なログを読ませず、対象ファイルと返却形式を制限すると、利用量と重複作業を抑えられます。

親は各担当へ同じゴールを渡すだけでなく、互いに依存する成果物があるかを明記します。レビュー担当の指摘を実装担当へ渡す時も、根拠となる行と再現条件を残します。

チームを有効にする設定は、組織や個人の設定に残ります。試験終了時に環境変数を外し、作成された共有タスクや作業セッションを一覧で整理します。

単独の専門担当から始める場合はサブエージェントの定義、外部イベントを渡す場合はChannelsへ進みます。