Claude Codeのagent teamsとは？複数のClaudeで開発する仕組みと使い方・注意点

「Claude Codeのagent teamsという機能を聞いたが、何ができるのかわからない」「サブエージェントとの違いがよくわからない」。AIを使った開発に取り組む企業の開発者から、こうした質問をいただく機会が増えています。

agent teamsは、Anthropicの開発の支援のツールClaude Codeで、複数のClaude Codeのセッションをチームとして協力させる機能です。公式の資料によると、1つのセッションがチームリーダーとなり、作業の調整や割り振り、結果のまとめを行い、ほかのセッション（チームメイト）がそれぞれの作業を進めます。

本記事では、Claude Codeの公式の資料の情報をもとに、agent teamsの仕組み、サブエージェントとの違い、有効にする方法と使い方、向いている作業、制限と注意点、業務で使うときのポイントまでを整理します。なお、agent teamsは実験的な機能であり、内容は今後変わる可能性があります。

確認したいポイント	結論	詳細
agent teamsとは？	複数のClaude Codeでチームを作る機能	1つのセッションがチームリーダーとなり、複数のClaude Codeに作業を割り振って、結果をまとめる機能です。
すぐに使える？	実験的な機能で初期状態は無効	公式の資料では、実験的な機能で初期状態では無効とされ、設定で有効にする必要があると案内されています。
サブエージェントとの違いは？	メンバー同士が直接やり取りする	agent teamsでは、メンバーが作業の一覧を共有し、互いに直接やり取りしながら協力して作業を進めます。
注意点は？	使う量と権限の管理が重要	メンバーごとに独立したセッションが動くため、使う量が増えやすく、権限の設定もリーダーから引き継がれます。

この記事でわかること

• Claude Codeのagent teamsの仕組みと、チームの構成
• サブエージェントとagent teamsの違いと、使い分け
• agent teamsを有効にする方法と、チームの始め方
• 表示の方法やモデルの選び方など、チームの操作
• 使う量や権限など、業務で使うときの注意点

AIを活用したシステム開発を検討している企業の方へ ネクストスケールでは、AI活用の戦略設計から、AIを活用したシステム開発、業務の自動化の仕組みづくり、利用ルールの整備、社員研修までを一気通貫で支援しています。支援内容や料金、導入事例をまとめた資料を無料でお送りします。 資料請求はこちら

Claude Codeのagent teamsとは

最初に、agent teamsがどのような機能なのかを確認しておきましょう。

Claude Codeとは

Claude Codeは、Anthropicが提供する、開発者がプログラミングの作業をClaudeに任せるためのツールです。コマンドラインやデスクトップのアプリなどから使え、コードの作成、修正、テストなどを依頼できます。

通常のClaude Codeでは、1つのセッションが順番に作業を進めます。大きな作業や、複数の観点からの検討が必要な作業では、1つのセッションだけでは時間がかかったり、見落としが出たりすることがあります。agent teamsは、こうした作業を複数のセッションで分担して進めるための機能です。

複数のClaude Codeをチームとして協力させる機能

公式の資料によると、agent teamsは、複数のClaude Codeのセッションを、チームとして協力させる機能です。チームは、次の2つの役割で構成されます。

チームリーダーは、チームを作り、チームメイトを起動し、作業を調整する、メインのClaude Codeのセッションです。チームメイトは、割り振られた作業をそれぞれ進める、別々のClaude Codeのセッションです。

公式の資料では、それぞれのチームメイトは、独立した1つのClaude Codeのセッションとされています。

作業の一覧を共有して協力する

公式の資料によると、agent teamsでは、共有の作業の一覧を使って協力し、チームメイト同士が直接やり取りします。リーダーが作業を作り、チームメイトがそれを進めていきます。

作業は、リーダーが明示的に割り振ることも、チームメイトが自分で引き受けることもできるとされています。

人のチームと同じように、リーダーが全体を見ながら作業を分担し、メンバーが協力して進めるイメージです。

実験的な機能

公式の資料では、agent teamsは実験的な機能で、初期状態では無効と案内されています。また、Claude Codeのバージョン2.1.32以降が必要とされています。

サブエージェントとの違い

Claude Codeには、サブエージェントという、作業の一部を別のエージェントに任せる機能もあります。agent teamsとの違いを表で整理します。

項目	サブエージェント	agent teams
メンバーのやり取り	結果をメインのセッションに報告する	メンバー同士が直接やり取りする
作業の管理	メインのセッションが管理する	共有の作業の一覧で協力して進める
向いている作業	結果だけがほしい、独立した調べものや作業	発見を共有し、互いに検討しながら進める作業
提供の状況	通常の機能	実験的な機能（初期状態は無効）

サブエージェントは結果を報告する

サブエージェントは、メインのセッションから作業を任され、その結果をメインのセッションに報告する仕組みです。結果だけがほしい、独立した作業に向いています。

たとえば、複数のファイルをそれぞれ調べて要点を報告してもらうといった、互いに関係の少ない作業では、サブエージェントで十分なことが多くあります。

agent teamsはメンバー同士で協力する

公式の資料では、agent teamsは、チームメイトが発見を共有し、互いの考えに異議を唱え、自分たちで調整する必要がある場合に使うよう案内されています。

たとえば、原因のわからない不具合を、複数の仮説から同時に調べるといった作業では、チームメイト同士が発見を共有しながら進めることで、より効率よく原因に近づける場合があります。

使い分けの考え方

作業が独立していて、結果をまとめるだけでよい場合はサブエージェント、メンバー同士の協力や議論が必要な場合はagent teamsと使い分けるのが基本です。agent teamsは使う量が増えやすいため、本当にチームでの協力が必要な作業に絞って使いましょう。

agent teamsを有効にする方法

agent teamsは、初期状態では無効になっています。ここでは、有効にする方法を紹介します。

版を確認する

公式の資料によると、agent teamsにはClaude Codeのバージョン2.1.32以降が必要です。使っているClaude Codeのバージョンを確認し、古い場合は更新しましょう。

agent teamsは更新の頻度が高い機能のため、できるだけ最新の版を使うと、不具合の修正や機能の改善を取り込めます。

環境の変数を設定する

agent teamsは、「CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS」という環境の変数を設定して有効にします。公式の資料では、この変数がない場合は、セッションの開始の時点でチームが用意されず、Claudeがチームメイトを起動したり提案したりすることもないとされています。

解説では、Claude Codeの設定のファイル（settings.json）に、次のように書く方法が紹介されています。

{

  “env”: {

    “CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS”: “1”

  }

}

設定を変更した後は、Claude Codeを起動し直して、設定が反映されているかを確認しましょう。

チームで使う場合は、プロジェクトの設定のファイルに書いて共有する方法もありますが、実験的な機能のため、使う人の範囲を決めてから有効にすると安心です。

AIのエージェントを使った開発を進めたい方へ 社内の開発の体制や作りたいシステムを伺い、Claude CodeなどのAIの開発のツールの活用方法や、複数のエージェントを使う開発の進め方、安全な運用の設計を無料でご提案します。オンラインで30分からご相談いただけます。 相談予約はこちら

agent teamsの始め方

ここでは、agent teamsを有効にした後の、チームの始め方を紹介します。

チームを依頼する

公式の資料によると、agent teamsを有効にした後は、Claudeにエージェントのチームを作るよう伝え、作業の内容と、作りたいチームの構成を普段の言葉で説明します。Claudeがチームを作り、チームメイトを起動して、依頼にもとづいて作業を調整します。

エージェントのチームを作って、このアプリのコードを確認してください。

・1人はセキュリティの観点で確認する

・1人は処理の速さの観点で確認する

・1人はテストが十分かを確認する

最後に、それぞれの指摘をまとめて報告してください。

Claudeからチームを提案される場合

公式の資料によると、チームが始まる方法には、利用者がチームを依頼する方法と、Claudeが作業を並行して進めると効果的だと判断して、チームを提案する方法の2つがあります。

また、公式の資料では、Claude Codeは、チームを起動する前に確認を求めないとされています。チームが起動すると、使う量が増えるため、依頼の内容には注意しましょう。

サブエージェントが起動した場合

公式の資料によると、チームではなくサブエージェントが起動した場合は、改めて、エージェントのチームを明示的に依頼するよう案内されています。

依頼の文章に、「エージェントのチームを作って」とはっきり書くと、チームが起動しやすくなります。

チームの操作

ここでは、公式の資料にもとづいて、チームの表示や操作の方法を紹介します。

2つの表示の方法

公式の資料によると、agent teamsには2つの表示の方法があります。「in-process」では、すべてのチームメイトがメインのターミナルの中で動きます。もう1つは、画面を分割してチームメイトごとに表示する方法で、tmuxや、iTerm2などのターミナルで使えるとされています。

iTerm2で画面を分割して表示する場合は、「it2」というコマンドを入れ、iTerm2の設定でPythonのAPIを有効にする必要があると案内されています。

チームメイトの確認

公式の資料によると、リーダーのターミナルでは、入力欄の下にあるエージェントの一覧に、チームメイトが表示されます。各チームメイトの進み具合を確認しながら作業を進められます。

作業の途中で方向を修正したい場合は、リーダーに指示を出して、チームの作業を調整してもらいましょう。操作の詳しい方法は、公式の資料で確認できます。

チームメイトのモデルを選ぶ

公式の資料によると、チームメイトは、初期の状態ではリーダーのモデルの選択を引き継がないとされています。「Default（leader’s model）」を選ぶと、チームメイトがリーダーの現在のモデルに従うようになります。一方、考える深さの設定は、リーダーから引き継がれるとされています。

チームメイトのモデルによって、作業の質と使う量が変わります。作業の難しさに合わせて選びましょう。

チームの情報の保存の場所

公式の資料によると、チームの設定は「~/.claude/teams/チーム名/config.json」に、作業の一覧は「~/.claude/tasks/チーム名/」に保存されます。

作業の一覧を確認すると、チームがどのような作業を、どの順番で進めているかを把握できます。

agent teamsが向いている作業

公式の資料で紹介されている例などをもとに、agent teamsが向いている作業を紹介します。

複数の観点での確認（コードレビュー）

公式の資料では、並行してコードレビューを行う例が紹介されています。セキュリティ、処理の速さ、テストなど、異なる観点からチームメイトが同時に確認することで、1つの観点だけでは見落としやすい問題を見つけやすくなります。

1つのセッションで複数の観点を順番に確認すると、最初の観点に引っ張られて、ほかの観点が浅くなることがあります。観点ごとに担当を分けることで、それぞれの確認を深められます。

原因のわからない問題の調査

原因のわからない不具合を、複数の仮説から同時に調べる作業にも向いています。チームメイトが互いの発見を共有し、仮説を検証し合うことで、原因の特定を進めやすくなります。

1つの仮説にこだわって調べ続けてしまう、といった思い込みによる見落としを減らせる可能性があります。

大きな機能の開発

画面、処理、テストなど、分担しやすい複数の部分からなる機能の開発にも活用できます。ただし、同じファイルを複数のチームメイトが同時に変更すると、変更がぶつかることがあるため、担当の範囲を分けて依頼しましょう。

開発の前に、リーダーに全体の計画を作ってもらい、内容を確認してからチームメイトに作業を始めてもらうと、方向のずれを防げます。

向いていない作業

小さな修正や、1つの流れで順番に進める作業は、チームにするよりも、1つのセッションやサブエージェントで進めるほうが効率的です。チームにすると、使う量が増え、調整の手間も増えます。

また、同じファイルを多くの人で同時に変更する必要がある作業も、変更がぶつかりやすく、チームには向いていません。

制限と注意点

agent teamsは実験的な機能のため、いくつかの制限があります。

チームの入れ子はできない

公式の資料によると、チームメイトが自分のチームメイトを起動することはできず、チームを管理できるのはリーダーだけです。

大きな作業を複数の段階に分けたい場合は、リーダーに全体の段取りを考えてもらい、段階ごとにチームの作業を進めるといった工夫が必要です。

非対話のモードではチームを起動しない

公式の資料によると、「-p」を指定した非対話のモード（Agent SDKのセッションを含む）では、Claudeはチームメイトを起動しないとされています。自動化の仕組みに組み込む場合は注意が必要です。

公式の資料では、この場合、Claudeが名前を付けたサブエージェントは、agent teamsが有効でも通常のサブエージェントとして動くとされています。

権限の設定はリーダーから引き継がれる

公式の資料によると、チームメイトは、リーダーの権限の設定で始まります。リーダーで確認を省く設定にしていると、チームメイトも同じ設定で動くことになるため注意が必要です。

複数のエージェントが同時に確認なしで動くと、意図しない変更が短い時間で広がるおそれがあります。

使う量が増えやすい

agent teamsでは、各チームメイトが独立したセッションとして動くため、1つのセッションで作業する場合に比べて、使う量が増えやすくなります。プランの利用枠や、APIの費用に注意しましょう。

チームメイトのモデルの選び方によっても、使う量は変わります。調べものなど比較的簡単な作業を担当するチームメイトには、使う量の少ないモデルを選ぶといった工夫も考えられます。

そのほかの制限

解説では、画面の中で動くチームメイトはセッションの再開ができない、作業の状況の表示が遅れることがある、1つのセッションで1つのチームまでといった制限も紹介されています。実験的な機能のため、内容は変わる可能性があります。

AIを活用した開発の体制づくりを検討している方へ ネクストスケールの支援内容やAIを活用したシステム開発の進め方、料金プラン、導入事例をまとめた資料をご用意しています。社内での検討資料としてもご活用ください。 資料請求はこちら

チームへの依頼の例

ここでは、agent teamsに依頼するときの文章の例を紹介します。

不具合の原因の調査

エージェントのチームを作って、ログインが時々失敗する不具合の原因を調べてください。

・1人は通信の処理を調べる

・1人はデータベースの処理を調べる

・1人は最近の変更の履歴を調べる

それぞれの発見を共有し合い、最も可能性の高い原因と、その根拠をまとめてください。

コードの変更は行わず、調査の結果だけを報告してください。

新しい機能の設計の検討

エージェントのチームを作って、通知の機能の設計を検討してください。

・1人は利用者の使いやすさの観点で案を出す

・1人は性能と費用の観点で案を出す

・1人は2人の案の問題点を指摘する

最後に、おすすめの設計の案と、その理由をまとめてください。

このように、役割、作業の範囲、最後にほしい成果を明確に伝えると、チームが効率よく協力できます。「コードの変更は行わない」のように、してはいけないことも伝えておくと安心です。

社内でagent teamsを試す進め方

会社でagent teamsを試す場合は、段階を踏んで進めることが大切です。

調査や確認の作業から始める

最初は、コードの確認や、不具合の調査など、コードを変更しない作業から試すと安心です。チームの動き方や、使う量の感覚をつかめます。

試す際は、練習用のプロジェクトや、影響の小さいプロジェクトを使うとよいでしょう。

効果と費用を比べる

1つのセッションで作業した場合と比べて、作業の質や時間がどれくらい変わったか、使う量がどれくらい増えたかを確認しましょう。効果が費用に見合う作業を見つけることが大切です。

うまくいった依頼の文章は、チームで共有して使い回すと、ほかのメンバーも効率よく使えるようになります。

ルールを決めて共有する

どの作業でagent teamsを使うか、権限の設定、人数の目安などを、開発のチームのルールとして決めて共有しましょう。

ルールは、実際に使いながら見直していくことが大切です。実験的な機能のため、仕様の変更にもあわせて更新しましょう。

上手に使うコツ

agent teamsを効率よく使うためのコツを紹介します。

チームの役割を具体的に伝える

各チームメイトに何を担当させるかを具体的に伝えると、作業の重なりや抜けを防げます。役割が重ならないよう、観点や担当の範囲を分けて依頼しましょう。

コードを変更する作業では、チームメイトごとに担当するファイルやフォルダを分けると、変更のぶつかりを防げます。

人数は少なく始める

最初は、2〜3人の少ない人数から始めましょう。人数が多いほど、使う量や調整の手間が増え、結果の確認も大変になります。

使い方に慣れてきたら、作業の内容に合わせて人数を調整していきましょう。

最後にまとめてもらう

作業の最後に、リーダーにチームメイトの結果をまとめて報告してもらうと、全体の結果を把握しやすくなります。

まとめの報告には、チームメイトの間で意見が分かれた点も含めてもらうと、判断の材料が増えます。

結果は人が確認する

チームで作業しても、誤りやセキュリティ上の問題が含まれることがあります。コードのレビューとテストを必ず行い、品質を人が確認しましょう。

複数のエージェントの変更が組み合わさると、個々の変更では問題がなくても、全体として問題が起きることがあります。全体の動作の確認も忘れずに行いましょう。

業務で使うときのポイント

agent teamsを業務で使う場合は、次のポイントを押さえておきましょう。

検証の環境で作業させる

複数のエージェントが同時に作業するため、本番の環境ではなく、開発や検証の環境で作業させるのが基本です。本番の前に検証の環境で動作を確かめる考え方は、ステージング環境とは？本番・開発・テスト環境との違いと構築時の注意点を解説でも紹介しています。

あわせて、変更の履歴を管理する仕組みを使い、チームの変更を元に戻せる状態にしておくと安心です。

関連記事：ステージング環境とは？本番・開発・テスト環境との違いと構築時の注意点を解説

権限の設定を慎重に決める

チームメイトはリーダーの権限の設定を引き継ぐため、リーダーの権限の設定を、必要な範囲に絞っておくことが大切です。確認を省く設定で多くのエージェントを動かすのは避けましょう。

特に、ファイルの削除や外部への送信など、影響の大きい操作は、確認を求める設定にしておきましょう。

費用を管理する

使う量が増えやすいため、どの作業でagent teamsを使うかをチームで決め、利用の状況を定期的に確認しましょう。

効果の大きい作業に絞って使うことで、費用に見合う効果を得やすくなります。

実験的な機能であることを踏まえる

agent teamsは実験的な機能で、動作や仕様が変わる可能性があります。業務の重要な流れをagent teamsだけに頼らないよう、ほかの方法でも作業を続けられる体制にしておきましょう。

最新の仕様は、Claude Codeの公式の資料や変更の履歴で確認しましょう。

AIのエージェントを使った業務の自動化の考え方は、AIエージェント 自動化｜RPAとの違い・自動化の5段階・失敗しない設計手順でも詳しく解説しています。

関連記事：AIエージェント 自動化 RPAとの違い・自動化の5段階・失敗しない設計手順【2026年版】

Claude Codeのagent teamsに関するよくある質問

最後に、agent teamsについてよく寄せられる質問と、その回答を紹介します。

agent teamsは追加の料金がかかる？

agent teamsの利用自体に別の料金があるとは案内されていませんが、各チームメイトが独立したセッションとして動くため、使う量が増えます。プランの利用枠やAPIの費用に注意しましょう。

VS Codeのターミナルでも画面を分割できる？

公式の資料では、画面を分割して表示する方法として、tmuxやiTerm2が案内されています。解説では、VS Codeのターミナルでは分割の表示を使えないと紹介されています。その場合は、in-processの表示を使いましょう。

チームメイトは何人まで作れる？

人数の上限は、公式の資料で確認しましょう。人数が多いほど使う量や確認の手間が増えるため、作業に必要な最小の人数から始めるのがおすすめです。

作業の内容によっては、2人のチームでも十分な効果が得られることがあります。

社員がAIの開発のツールを安全に使いこなせるよう、生成AI活用研修などで基礎をそろえておくのも効果的です。

AIを活用した開発を業務に定着させたい方へ Claude CodeなどのAIの開発のツールの導入と設定から、複数のエージェントを使う開発の設計、セキュリティと運用のルールづくり、社員向けの研修まで、伴走して支援します。お気軽にご相談ください。 相談予約はこちら

まとめ｜agent teamsの特徴を理解し、協力が必要な作業で活用しよう

Claude Codeのagent teamsは、複数のClaude Codeのセッションをチームとして協力させる実験的な機能です。チームリーダーが作業を調整し、チームメイトが共有の作業の一覧と直接のやり取りで協力して作業を進めます。初期状態では無効で、バージョン2.1.32以降で、環境の変数を設定して有効にします。

メンバー同士の協力や議論が必要な作業に向いている一方、使う量が増えやすく、権限はリーダーから引き継がれるといった点に注意が必要です。詳しくは、Claude Codeの公式の資料「Orchestrate teams of Claude Code sessions」で確認できます。

ネクストスケールでは、AI活用の戦略設計から、AIを活用したシステム開発、業務の自動化の仕組みづくり、利用ルールの整備、社員研修までを一気通貫で支援しています。支援の詳細はAIシステム開発やAIコンサル・AX伴走支援のページで紹介していますので、AIを活用した開発をどこから進めるか迷っている場合も、お気軽にご相談ください。

AIを活用したシステム開発を一緒に進めませんか 開発の体制の整理から、AIの開発のツールの導入と設定、安全な開発の環境とルールづくり、AIを活用したシステム開発、社員への定着までをご支援します。しつこい営業はいたしませんので、まずは無料相談をご利用ください。 相談予約はこちら