Claude Code Agent Teams: マルチセッションガイド (2026)

- これはリサーチプレビュー機能であり、有効化の仕組みはすでに一度変わっています（v2.1.178 の前後で、手動でチームを作成するツールはもう存在しません）。本稿の内容は執筆時点（2026 年 8 月）の公式ドキュメントと照合しています - 依存する前に必ず最新のドキュメントを確認してください。

agent teams とは実際に何か

agent teams は Claude Code のリサーチプレビュー機能で、1 つの「チーム」の中で複数のセッションを並列に実行できます。リードエージェントが調整し、1 つ以上の teammate がタスクを実行します。各 teammate は独自のコンテキストウィンドウを持ち - リードや他の teammate とコンテキストを共有しません - そしてチーム全体が 1 つのタスクリストと直接メッセージングのチャンネル（メールボックス）を共有します。公式ドキュメント code.claude.com/docs/en/agent-teams（2026 年 8 月に確認）によると、これは独立した Claude Code セッションの上に乗る調整レイヤーであり - 新しいモデルでも、別の API でもありません。

混同を避けるために一言: agent teams は AgentKit の「advisor」や「kongming」ペルソナではありません - それらはまったく異なる仕組みで動作します（最後の率直な評価を参照）。

agent teams と subagents の比較

すでに Claude Code subagents に慣れているなら、ドキュメントからの直接比較（要約）は次のとおりです:

手短に言うと、subagent は「作業を委任して結果を受け取る」、agent teams は「グループが一緒に働き、互いに直接メッセージを送り合う」ものです。subagent のオーケストレーションをさらに大規模にするには、subagent を大規模にオーケストレーションする方法を参照してください。

誰がプランを持つか: subagents / skills / agent teams / workflows

これが本記事の核心的な情報価値です - Claude Code のドキュメント（code.claude.com/docs/en/workflows、2026 年 8 月に確認）から直接引き出した 4 者比較で、私たちが確認した競合記事は EN・VI を問わずこれを完全な形で再現していません:

私たちが確認した競合記事のどれも、この正確な 4 者の枠組みを再現していません - ほとんどは agent teams を subagents とだけ比較し、skills と workflows は完全に省いています。workflows/ultracode の詳しい掘り下げは、Claude Code Dynamic Workflows を参照してください。

agent teams を有効にする - CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS

agent teams はデフォルトで無効です。settings.json で環境変数を指定して有効にします:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "true"
  }
}

覚えておく価値のあるいくつかの点（ドキュメントに基づく、2026 年 8 月に確認 - これに頼る前に、実際に実行している Claude Code のバージョンで確認してください）:

• インタラクティブセッションでのみ動作します - -p や Agent SDK 経由では動きません。
• 現在のセットアップ（v2.1.178 以降）では、一部の古い解説にあるように TeamCreate/TeamDelete ツールを手動で呼び出す必要はありません - それらのツールは現在のフローにはもう存在しません。手動でチームを作成する手順を説明しているガイドを見かけたら、それはおそらくこの変更より前に書かれたものです - Anthropic 自身が出している「変わる可能性がある」という警告の具体例です。

最初のチームを始める、そして共有タスクリスト

有効にしたら、視点を分けて取り組むのに十分な大きさのタスクで始めましょう。たとえば:

Spawn a team of 3 teammates to review this PR:
one for security, one for performance, one for test coverage.
Report findings back to me.

Claude Code はチーム全体のための共有タスクリストを作成します。おなじみの状態を持ちます: pending、in progress、completed。知っておくべきいくつかの仕組み:

• 依存関係によるブロック - タスクは、別のタスクが終わるのを待ってから開始できます。
• 自己取得またはリード割り当て - teammate は pending のタスクを自分で取ることも、リードが直接割り当てることもできます。
• 取得時のファイルロック - teammate が特定のファイルに触れるタスクを取ると、ロックによって 2 つの teammate が同じ箇所を同時に編集するのを防ぎます。

cross-session messaging - チームとは別の機能

ここで多くの競合（EN・VI）が線引きを曖昧にし、「チームのメッセージング」として扱っています。ドキュメントは実際にはこれを別の機能として扱っています: cross-session messaging は、2 つの独立した Claude Code セッション - 別のマシン上でも、あるいは Remote Control 経由でも - が、両方が同じ Claude 監督下のチームに属することなく、ListAgents/SendMessage（または /list-agents コマンド）を介してメッセージをやり取りできるようにします。

どちらを使うか: Claude 自身に 1 つの共有タスクリストを通じてグループを調整させたいなら、agent teams を使います。自分で操縦する独立したセッションがいくつかあり、必要なときにメッセージをやり取りさせたいだけなら、cross-session messaging が適した軽量なツールです - そのために完全なチーム機構をオンにする必要はありません。

プラットフォームに関する注意: cross-session messaging は現在 macOS/Linux でのみ動作します - ネイティブな Windows サポートはまだありません。WSL2 は Linux として扱われるので、そこでは動作します。チームの分割ペイン表示モードにも tmux または iTerm2 が必要で、Windows Terminal では明示的に動作しません。競合（EN・VI）でこれに触れているものは 1 つも見ていません - このサイトの読者には Windows で作業している開発マシンが多いことを考えると、指摘する価値があります。

agent view - 並列バックグラウンドセッションのダッシュボード

関連していて混同しやすい機能: agent view は claude agents で開きます。並列で動くバックグラウンドセッションを一覧表示するダッシュボードで - agent teams とは違い、セッション間のメッセージングはありません。純粋に監視用の画面です。これもリサーチプレビューです。

よくある混同を正しておく価値があります: セッションごとの専用 git worktree による分離は agent view の仕組み（バックグラウンドセッション用）であり、agent teams のデフォルト動作ではありません。一部の解説は agent teams が teammate ごとに別の worktree を自動生成し、一種の「パラレルワールド」のようなものだと説明しています - しかし agent teams のアーキテクチャドキュメントにはそのような仕組みは記載されておらず、リード/teammate/タスクリスト/メールボックスだけが説明され、自動 worktree への言及はありません。

現実的なユースケース: 並列 PR レビュー

公式ドキュメントで最も強力なユースケース（そして私が実際に手を伸ばすもの）は、並列の PR レビューです: 3 つの teammate を立ち上げ、それぞれが同じ PR を異なる視点 - セキュリティ、パフォーマンス、テストカバレッジ - で読み、あなたに報告します。各 teammate は独自のコンテキストを持つので、同じ差分を読んでも互いに干渉しません。

正直に言うと: このウォークスルーは Anthropic 自身が文書化したユースケースをモデルにしたもので、具体的な数値（問題の件数、PR の件数）を伴う実際の実行ではありません。「Y 分で X 件の問題を発見」のような正確な数字を挙げている別のレビューを見かけたら、それが本当に実行したものなのか、単にドキュメントを言い換えているだけなのかを問う価値があります。もう 1 つ試す価値のあるパターン: 難しいバグを複数の teammate に与えて競合する仮説で取り組ませ、リードにどの仮説が証拠に最も合うかをまとめさせる、というものです。

どちらのパターンも、サブタスクが本当に別々のコンテキストから利益を得る場合にのみ効果を発揮します - 同じ差分を異なる視点で読む、あるいは、ある teammate の思い込みが別の teammate を汚染することなく異なる根本原因の理論を追う、といった場合です。ほとんど逐次的な作業（実装してからテスト、それからドキュメント化）には、チームを丸ごと立ち上げるより、単純な subagent のチェーンのほうがたいてい安く、推論も簡単です。

制限 - まだできないこと

これはリサーチプレビューなので、ドキュメントは現在の制限を率直に列挙しています - 重要なワークフローをこの機能に賭ける前に読む価値があります:

• 実行中の teammate の再開不可 - ターミナルを閉じた後は再開できず、セッションを閉じるとその teammate は失われます。
• タスクステータスの遅延 - タスクリストは teammate が今していることを常にリアルタイムで反映するとは限りません。
• 1 セッションにつき 1 チーム - 1 つのリードセッションの下で複数のチームを並列に実行することはできません。
• ネストされたチームは不可 - teammate は自分のサブチームを立ち上げられません。
• 分割ペインには tmux/iTerm2 が必要で、Windows Terminal では動作しません（cross-session messaging と同じ注意点）。

これが、本記事が「リサーチプレビュー」を繰り返し強調する理由でもあります: 有効化の仕組みはすでに一度変わっており（手動のチーム作成ツールの手順が削除された）、この制限リストも変わる可能性が十分にあります。ここで説明されている正確な詳細や挙動に、本番で不可欠なワークフローを、再確認せずに固定しないでください。

率直な AgentKit の観点: そのペルソナは teammate になれるか

ずばりの疑問: AgentKit の advisor と kongming は agent team の中で teammate として動けるのか。いいえ、永続的な teammate としては動けません。

• kongming はワンショットです: プロンプトを 1 回入力すると答えが 1 回返ってきて、双方向のやり取りはありません。
• advisor はインタビューリレー型です: 質問を一度に 1 つずつ行い、その合間にメインセッションへ戻ります - 並列で動きメールボックスを通じてメッセージする独立したセッションではありません。

どちらも、teammate に必要な永続的で複数ターンのメッセージングのために作られてはいません（docs.agentkit.best/en/beta/concepts/advisory-supervision、2026 年 8 月に確認）。

ただし、うやむやにせずはっきり述べる価値のある本当のニュアンスがあります: Claude Code では、プロジェクト/ユーザー/プラグインのレベルで定義された任意のエージェントタイプを使って teammate を立ち上げられます - そして AgentKit のランタイムアダプターは、キットのエージェントをネイティブな Claude Code の subagent 定義としてインストールします。ですから技術的には、AgentKit キットのタスク実行エージェント（advisor/kongming ではない）を teammate として指定できます。それは「AgentKit が既製のチームを提供する」ことと同じではありません - 境界をはっきり述べておきます: AgentKit は作業を委任するためのペルソナ/skill を提供する有料キットであり、agent teams はあなた自身がそれらを組み込む Claude Code の無料の調整機構です - AgentKit がパッケージ化した「チーム」製品ではありません。詳しくは AgentKit の完全レビュー を参照してください。

よくある質問（FAQ）

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS は何をするのか?

これは（settings.json で設定する）環境変数で、Claude Code の agent teams 機能を有効にします。まだリサーチプレビューのため、デフォルトでは無効です。インタラクティブセッションでのみ動作し、-p や Agent SDK 経由では動きません。

agent teams は subagents とどう違うのか?

subagent は呼び出し元セッションのコンテキスト内で動作し、タスクを受け取って結果を返し、双方向のメッセージングはありません。agent teams は複数の独立したセッション（各 teammate が独自のコンテキストを持つ）が関わり、タスクリストを共有し、実行中にメールボックスを通じて直接メッセージをやり取りします - トークンコストは明らかに高くなります。

cross-session messaging は Windows で動作するか?

まだネイティブには動作しません - 現在は macOS/Linux でのみ動作します。WSL2 は Linux として扱われるので、そこでは動作します。チームの分割ペイン表示モードにも tmux または iTerm2 が必要で、Windows Terminal では動作しません。

チームのトークンコストは単一セッションと比べてどうか?

明らかに高くなります。各 teammate がメインセッションとコンテキストを共有せず並列で動く完全なセッションだからです。ドキュメントは固定の数値を示していません - 1 つのエージェントが逐次的に作業すれば済む場合ではなく、本当に並列の視点が必要なときにだけこれを使いましょう。

ターミナルを閉じた後にチームを再開できるか?

まだできません。現在の制限によれば、実行中の teammate はセッションを閉じた後は再開できず - ターミナルを閉じるとその teammate は失われます。これはドキュメントが自ら率直に列挙している制限の 1 つです。

この機能は日常業務に使えるほど安定しているか?

あまりそうではありません - まだリサーチプレビューで、有効化の仕組みはすでに一度変わっています（手動のチーム作成ツールの手順が削除された）。重要でない並列の探索で試すのは問題ありません。ただ、まだ多くの安定性を要する状態を考えると、必須の日常ワークフローを構築する対象にはまだ向きません。

まとめ

agent teams はまだリサーチプレビューです - 並列の探索（1 つの問題に対する複数視点の同時検討）には強力ですが、subagent や skill がすでに扱えるより単純な逐次作業の代替ではありません。「誰がプランを持つか」の 4 者比較表を判断の近道として手元に置いてください: 逐次的な指示に従う単一エージェント - subagent/skill、互いにメッセージし合う長く協働的なセッション - agent teams、1 つのコンテキストウィンドウより大きい作業や数百の subagent を必要とする作業 - workflow。まずは重要でないもので試し、制限をよく読み、いつでも変わりうる詳細に本番プロセスを固定しないでください。