Claude Code Agent Teamsの使い方と運用ガイド｜並列AI開発を始める完全手順

2026年3月2日

Claude Code Agent Teamsとは？
SubagentsとAgent Teamsの違い
Agent Teamsを有効にする方法
- settings.jsonで設定する（推奨）
- シェル環境変数で設定する
表示モードの選択
- インプロセスモード（デフォルト）
- 分割ペインモード（tmux / iTerm2）
最初のAgent Teamを作成する
チームを操作するコマンド
コストとチームサイズの目安
- 推奨チームサイズ
ベストプラクティス
トラブルシューティング
現在の制限事項
FAQ

Claude Code Agent Teamsとは？

「複数のAIに並列で作業させたいけど、どうすればいいの？」と思ったことはありませんか？

Claude Code Agent Teamsは、複数のClaude Codeインスタンスがチームとして連携して動作するマルチエージェント機能です。2026年2月にリリースされた実験的機能で、1つのセッションがチームリーダーとして作業を調整し、複数のチームメイトが独立して並列作業を行います。

この記事で分かること：

Agent Teamsの基本概念とSubagentsとの違い
有効化の手順と表示モードの設定方法
実際の使い方と自然言語でのプロンプト例
コスト・チームサイズ・ベストプラクティス
トラブルシューティング一覧

対象読者： Claude Codeを使っている開発者、並列AI開発に興味がある方

結論： 「並列探索が価値を生む複雑なタスク」にAgent Teamsは最も効果的です。逆に、順序依存のシンプルなタスクはSubagentsや単一セッションの方が効率的です。

SubagentsとAgent Teamsの違い

従来のSubagentsとAgent Teamsの最大の違いはチームメイト同士が直接通信できるかどうかです。

	Subagents	Agent Teams
コンテキスト	独自のコンテキストウィンドウ。結果は呼び出し元に返される	独自のコンテキストウィンドウ。完全に独立
通信	メインエージェントにのみ結果を報告	チームメイトが互いに直接メッセージを送信
調整	メインエージェントがすべての作業を管理	自己調整を備えた共有タスクリスト
最適な用途	結果のみが重要な焦点を絞ったタスク	議論と協力が必要な複雑な作業
トークンコスト	低い：結果がメインコンテキストに要約される	高い：各チームメイトは個別のClaudeインスタンス

使い分けの基本原則：

ワーカーが互いに通信不要 → Subagentsを使う
チームメイトが発見を共有・議論する必要がある → Agent Teamsを使う

Agent Teamsを有効にする方法

Agent TeamsはデフォルトでOFFです。CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS環境変数を1に設定して有効化します。

settings.jsonで設定する（推奨）

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

settings.jsonは~/.claude/settings.json（グローバル）またはプロジェクト内の.claude/settings.jsonに配置します。

シェル環境変数で設定する

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

表示モードの選択

Agent Teamsには2種類の表示モードがあります。

インプロセスモード（デフォルト）

tmuxなしで動作するシンプルなモード。すべてのチームメイトがメインターミナル内で実行されます。

Shift+Down：チームメイトを切り替え
Enter：チームメイトのセッションを表示
Escape：現在のターンを中断
Ctrl+T：タスクリストを切り替え

分割ペインモード（tmux / iTerm2）

各チームメイトが独自のペインに表示されます。全員の作業をリアルタイムで確認でき、ペインをクリックして直接対話できます。

必要なもの：

tmux：brew install tmux（macOS）
または iTerm2 + it2 CLI + Python API の有効化

# settings.jsonで分割ペインを固定する場合
{
  "teammateMode": "tmux"
}

# コマンドラインで指定する場合
claude --teammate-mode in-process

最初のAgent Teamを作成する

有効化後はClaude Codeに自然言語で指示するだけです。

プロンプト例：CLIツール設計の多角的レビュー

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

Claudeはこの指示に基づいて：

共有タスクリストを持つチームを作成
UX・アーキテクチャ・批評の3つの視点でチームメイトを生成
問題を探索させ、発見を統合
完了時にチームをクリーンアップ

プロンプト例：並列コードレビュー

Create an agent team to review PR #142. Spawn three reviewers:
- 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.

チームを操作するコマンド

チームメイトに直接指示する

インプロセスモードではShift+Downでチームメイトを選択してメッセージを入力。分割ペインモードではペインをクリックして直接対話できます。

プラン承認を要求する

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

チームメイトはプランを提出し、リーダーが承認するまで読み取り専用モードで動作します。

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

Ask the researcher teammate to shut down

チームをクリーンアップする

Clean up the team

⚠️ 必ずリーダーからクリーンアップしてください。チームメイトからは実行しないでください。

コストとチームサイズの目安

Agent Teamsは単一セッションより大幅に多くのトークンを消費します。各チームメイトが独自のコンテキストウィンドウを持つため、トークンコストはチームメイト数に比例してスケールします。

チームメイトがplan modeで動く場合、標準の約7倍のトークンが必要になることがあります
研究・レビュー・新機能開発では追加コストに見合う価値があります
ルーティンタスクには単一セッションの方が費用対効果が高い

推奨チームサイズ

3〜5人のチームメイトから始めるのがベストプラクティス
チームメイト1人あたり5〜6タスクが適切な負荷
15個の独立したタスクがある場合は3人のチームメイトが目安

ベストプラクティス

1. チームメイトに十分なコンテキストを渡す

チームメイトはリーダーの会話履歴を引き継ぎません。スポーンプロンプトにタスク固有の詳細を明示的に含めてください。

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

2. CLAUDE.mdを活用する

チームメイトは作業ディレクトリのCLAUDE.mdを自動で読み込みます。プロジェクト固有のガイダンス（コーディング規約・禁止事項など）をここに書いておくと全チームメイトに共有されます。cc-sddを使った仕様駆動開発と組み合わせると効果的です。

3. ファイル競合を避ける

2人のチームメイトが同じファイルを編集すると上書きが発生します。作業を分割し、各チームメイトが異なるファイルセットを担当するよう設計してください。

4. 監視しながら進める

チームを長時間放置すると無駄な努力のリスクが増します。チームメイトの進捗を定期的にチェックし、機能していないアプローチをリダイレクトしましょう。

5. まずリサーチ・レビューから始める

初めて使う場合は、コードを書かないタスク（PRレビュー・ライブラリ調査・バグ調査）から始めるのがおすすめです。並列探索の価値を最も分かりやすく体感できます。

トラブルシューティング

チームメイトが表示されない

インプロセスモードではShift+Downで既存のチームメイトをサイクル
タスクがチームを保証するほど複雑かどうか確認（シンプルすぎると単一セッションで処理される）
tmuxがインストールされているか確認：which tmux

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

チームメイトのスポーン前に権限設定で一般的な操作を事前承認しておくと中断を減らせます。

チームメイトがエラーで停止した

Shift+Downで出力を確認し、直接指示を送るか、置き換えチームメイトをスポーンしてください。

孤立したtmuxセッション

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

現在の制限事項

インプロセスチームメイトでのセッション再開不可（/resume・/rewindが機能しない）
タスクステータスが遅延することがある
セッションあたり1チームのみ（複数チームは不可）
ネストされたチーム（チームメイトがさらにチームを作る）は不可
分割ペインモードはVS Code統合ターミナル・Windows Terminal・Ghosttyでは非対応

FAQ

Q. Agent Teamsは無料プランでも使えますか？

A. Claude Codeの利用プランに依存します。各チームメイトが独自のClaudeインスタンスを使うため、トークン消費量が増大します。Pro/Maxプランなど十分なAPI利用枠があることを確認してください。

Q. チームメイトは何人まで作れますか？

A. 技術的な上限はありませんが、調整オーバーヘッドと収益逓減の観点から3〜5人が推奨です。それ以上増やしても作業が比例して速くなるわけではありません。

Q. SubagentsとAgent Teamsはどう使い分ければいい？

A. 「チームメイト同士が通信する必要があるか」が判断基準です。情報を共有・議論する必要があればAgent Teams、各ワーカーが独立して結果を返すだけならSubagentsを選びましょう。

Q. CLAUDE.mdはAgent Teamsでも有効ですか？

A. はい。チームメイトは作業ディレクトリのCLAUDE.mdを自動で読み込みます。全チームメイトへのプロジェクト共通ルールの共有に活用できます。

Q. Agent Teamsはどんなタスクには向いていませんか？

A. 順序依存のタスク・同じファイルを複数人が編集するタスク・依存関係が多い作業には不向きです。この場合は単一セッションかSubagentsを使ってください。

Claude CodeAgent Teams,AI開発,Claude Code,マルチエージェント,並列処理

Posted by Agent

Home

cc-sddで始める仕様駆動開発（SDD）｜Claude CodeにKiroスタイルを導入する完全ガイド

コメント一覧

まだ、コメントがありません