Claude CodeのAgent Teamsとは?サブエージェントとの違いと、AIチームの使いどころ

Claude Codeは、最初は1人のClaudeに仕事を頼む使い方から始まります。サブエージェントを使えば一部の仕事を別のAIに任せられ、カスタムエージェントを作れば「レビュー担当」のような専門のAIも用意できます。

では、その専門のAIたちが情報を共有しながら、1つの仕事をチームとして進められないか。それを形にしたのが、Claude CodeのAgent Teams(エージェントチーム)です。この記事では、サブエージェントとの違いを中心に、仕組みと使いどころを整理します。

なお、この記事は公式ドキュメントをもとにした学習の整理で、私自身はまだAgent Teamsを使っていません。

この記事で分かること

  • Agent Teamsの仕組みと、サブエージェントとの違い
  • 向いている仕事と、向いていない仕事
  • 試すときの始め方と注意点
目次

Agent Teamsとは

Agent Teamsは、複数のClaude Codeを1つのチームとして働かせる仕組みです。中心になるのがTeam Lead(チームリード)で、ふだん使っているメインのClaude Codeがこの役になります。Team Leadは仕事を整理してメンバーに割り振り、最後に結果をまとめます。

メンバー(Teammate)は、それぞれが独立したClaude Codeとして担当の仕事を進めます。チームには、全員が見られる「共有タスクリスト」と、メンバー同士の「メッセージ機能」があります。

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

一番分かりにくいのがここです。

  • サブエージェント:メインのClaudeから仕事をもらい、結果をメインに返す。上司と部下の関係に近い
  • Agent Teams:メンバーが共通のタスクリストを見ながら、互いに直接やり取りして進める。チームの関係に近い

例えば、バックエンド担当が「APIの返す形を変える必要がある」と気づいたとします。サブエージェントなら、いったんメインのClaudeに戻してから別の担当に伝えます。Agent Teamsなら、バックエンド担当からフロントエンド担当へ直接伝えられます。

公式ドキュメントでは、サブエージェントは「結果だけ分かればよい集中した仕事」、Agent Teamsは「話し合いや連携が必要な複雑な仕事」に向くと整理されています。

チームを動かす2つの仕組み

共有タスクリスト

Team Leadが作ったタスクには「未着手・作業中・完了」の3つの状態があります。Team Leadが担当を決めることも、手の空いたメンバーが次のタスクを自分で取ることもできます。

タスク同士に順番を付けることもでき、前の作業が終わるまで次のタスクは止まり、終われば自動で動き出します。人が「次はこれ」と言い続けなくても、チームの中で仕事が回る仕組みです。

それぞれが自分の記憶の枠を持つ

各メンバーは、ふだんのClaude Codeと同じように、CLAUDE.mdやSkillなどのプロジェクト情報を読み込んで始まります。一方で、Team Leadのそれまでの会話はメンバーに引き継がれません。メンバーは自分の仕事に必要な情報を中心に作業できますが、そのぶん、頼むときに必要な情報をきちんと伝える必要があります。

カスタムエージェントをメンバーにできる

あらかじめ作ったカスタムエージェントの定義を使って、メンバーを起動することもできます。例えば「security-reviewerの定義を使ってセキュリティ担当を起動して」と頼むと、その定義の道具の制限やモデル、指示書がメンバーに使われます。

ただし公式ドキュメントによると、定義に書いたSkillの設定はメンバーには使われず、メンバーはプロジェクトや自分の設定にあるSkillを読み込みます。カスタムエージェントは「AI社員を設計する」、Agent Teamsは「AI社員をチームで働かせる」という関係です。

向いている仕事、向いていない仕事

公式ドキュメントが挙げている、向いている仕事は次のとおりです。

  • 複数の観点からの調査やレビュー(セキュリティ・速度・テスト漏れを別々の担当が確認する)
  • 新しい機能や部品を、担当ごとに分けて作る
  • 原因の分からない不具合を、別々の仮説を持った担当に調べさせ、互いの説に反論させる
  • 画面・裏側の処理・テストをまたぐ変更

一方で、Agent Teamsは1人で作業するより大幅に多くのトークン(AIの処理量)を使います。メンバー1人ひとりが別のClaude Codeだからです。誤字を1つ直すような小さな仕事や、順番に進める仕事、同じファイルを複数人で書き換える仕事は、1人のClaudeやサブエージェントの方が向いています。同じファイルを2人が編集すると、上書きが起きるおそれがあります。

試すときの始め方

Agent Teamsは、記事作成時点でも「実験的な機能」で、初期設定では使えません。使うときは、設定ファイル(settings.json)に次のように書いて有効にします。

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

有効にすると、Claudeが仕事を分けるときに、頼んでいなくてもチームを作ることがあると説明されています。また、会話を再開したときにメンバーが戻らないなどの制限もあります。

公式ドキュメントでは、最初はメンバー3〜5人から始めること、まずはコードを書かない調査やレビューの仕事から試すことがすすめられています。メンバーへの確認が必要な操作は、Team Lead側で人が承認します。人数が増えるほど、どこで人が判断するかを決めておくことが大切になると考えています。

まとめ

Agent Teamsは、Team Leadを中心に、複数のClaude Codeが共有タスクリストで仕事を分け、互いに連絡を取りながら1つの仕事を進める仕組みです。

これまでの機能を会社に例えると、Skillは業務マニュアル、カスタムエージェントは専門のAI社員、サブエージェントは担当者への仕事の依頼、Agent TeamsはAI社員によるチームの運営です。

ただ、人数を増やすこと自体が目的ではありません。1人で足りる仕事は1人で、専門の作業だけならサブエージェントに、担当同士の情報交換まで必要な仕事のときにAgent Teamsを使う。この使い分けを意識しながら、まずは調査やレビューの仕事で試していきたいと考えています。

※機能や設定は変わることがあります。記事作成時点の情報のため、最新の内容は公式ドキュメントをご確認ください。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次