blog

Claude Code Agentとは?サブエージェント・Agent Teams・Agent Viewの違いと使い方【2026年版】

目次

Claude Code Agentとは?エージェント機能の全体像

Claude Code Agent(エージェント機能)とは、Claude Codeが作業の一部を別のエージェントに任せたり、複数のエージェントを同時に動かしたりする仕組みの総称です。Claude Code自体が、コードを読み、ファイルを編集し、コマンドを実行するAIエージェントです。そのうえで「Agent」と名の付く機能は1つではなく、公式ドキュメント「エージェントを並列実行する」は、複数の作業を同時に進める方法としてサブエージェント・Agent View・Agent Teams・動的ワークフロー・Projectsの5つを挙げています(2026年11月1日に確認)。

5つの違いは、「誰が作業をまとめるか」「エージェント同士が連絡し合うか」「自分のパソコンで動くかクラウドで動くか」です。この記事では、まず5つの全体像と選び方を整理し、よく使うサブエージェントとAgent Viewを実際の画面で確かめたうえで、いちばん仕組みの大きいAgent Teamsを、有効化から操作・費用・制限・うまくいかないときの対処まで順に説明します。画面は2026年10月14日にClaude Code v2.1.299で実際に動かして撮ったものです。サブエージェントの定義ファイルの全項目と設定はサブエージェントの解説記事、インストールはインストール手順、Claude Codeそのものの概要はClaude Codeとはをご覧ください。

Claude Code Agent(Subagent)とAgent Teamsの解説

先に結論を3つにまとめます。

  • まずはサブエージェント:調査やレビューのように「結果だけ分かればよい」作業は、1つの会話の中でサブエージェントに任せるのがいちばん手軽です。組み込みのものをClaudeが自動で使うので、設定なしでも働いています。
  • 関係のない作業をいくつも抱えたらAgent View:シェルで claude agents を開き、作業ごとにバックグラウンドのセッションを渡して、終わったものや質問が来たものだけを見ます。
  • メンバー同士の話し合いが要るときだけAgent Teams:複数の観点で調べて突き合わせる作業に向きますが、実験的機能で既定は無効、メンバーの数だけ利用枠の消費も増えます。3〜5人以内・読み取り中心の作業から試すのが安全です。

「Agent」と呼ばれる5つの方法

公式の比較表を、使う人の目線で言い換えたものが次の表です。どの方法でも、実際に働くのはClaudeのセッションです。

方法 できること 向いている場面
サブエージェント 1つの会話の中で、別のエージェントが自分専用の文脈で作業し、要約だけを返す 検索結果やログが大量に出て、会話がそれで埋まってしまう作業
Agent View(claude agents) バックグラウンドで動く複数のセッションを、1つの画面から渡して見守る(研究プレビュー) 独立した作業がいくつかあり、任せておいて必要なときだけ見たい
Agent Teams リーダーがメンバーを作り、共有のタスク一覧とメンバー同士の連絡で進める(実験的・既定は無効) Claudeに作業を分けて割り振らせ、メンバーの足並みをそろえたい
動的ワークフロー Claudeが書いた台本が多数のサブエージェントを動かし、結果を突き合わせる コード全体の点検、数百ファイルの移行、複数の角度からの調査
Projects claude.ai/code やデスクトップアプリの1つの会話から、Claudeがクラウドで並行のセッション(スレッド)を始めて管理する(Pro・Max・Ultraで公開ベータ) 何日も続く作業を、パソコンの電源を切っても進めたい

方法そのものではない、支える道具

次の道具は、エージェントを動かす「方法」ではなく、上の5つを支えるものです。公式も別枠で説明しています。

  • ワークツリー:セッションごとに別のgitのチェックアウトを作り、並行するセッションが同じファイルを書き換えてぶつからないようにします。
  • セッション間メッセージ:自分で動かしている複数のセッションの間で、調べた結果や状態を渡せます。
  • /batch:1つの大きな変更を、ワークツリーで分けた5〜30個のサブエージェントに分けるスキルです。サブエージェントとワークツリーの組み合わせで、別の方法ではありません(詳しくは並列実行の解説)。
  • フォーク:/subtask は、ここまでの会話をすべて引き継いだサブエージェントを起動します。/fork は、セッション全体を新しいバックグラウンドのセッションに写して並べて動かします。

名前が似ていて混同しやすいもの

次は、Claude Codeの中で /agents を実行したときに表示された文です(2026年10月14日にClaude Code v2.1.299で実行。表示は英語のままです)。

> /agents
  The /agents wizard has been removed.

  Ask Claude to create or update subagents for you (e.g.
  "create a code-reviewer subagent that ..."),
  or edit the files directly:
    • .claude/agents/      (this project)
    • ~/.claude/agents/    (all projects)

  Docs: https://code.claude.com/docs/en/sub-agents

以前の対話式の作成画面は無くなり、Claudeに作成を頼むか、2つのフォルダのファイルを直接編集するよう案内されます。このように、Claude Codeの中で入力する /agents は、サブエージェントの定義ファイルの置き場所を案内するコマンドで、シェルで実行する claude agents は、バックグラウンドのセッションを管理するAgent Viewを開くコマンドです。名前は似ていますが別のものです。

名前 何のことか
Agent ツール Claudeがサブエージェント(Agent Teamsではメンバー)を起動するときに使う道具の名前です。permissions.deny に書くと、委任そのものを止められます
Claude Agent SDK Claude Codeを動かしているものと同じツールとエージェントの仕組みを、自分のアプリに組み込むライブラリです。上の5つとは別のものです(Claude Agent SDKの解説)
AGENTS.md リポジトリに置く、AIエージェント向けの指示ファイルです。公式ドキュメントでは、CLAUDE.mdと同じくプロジェクトの指示として読み込まれるファイルとして扱われています

動いている作業の確かめ方も、方法ごとに違います。バックグラウンドのセッションは claude agents、今のセッションの中のサブエージェントやバックグラウンドの作業は /tasks(終わったサブエージェントも並びます)、動的ワークフローは /workflows で確認します。

特定の作業を任せる専用の作業役を自分で作るときは、サブエージェントの作り方・設定で解説しています。

関連記事Claude Codeの/batchの使い方は?

どのAgent機能を使うか:3つの問いで選ぶ

公式は、方法を選ぶ手がかりとして次の3つの問いを挙げています。Agent Teamsのページでも、チームを組む前に「もっと軽い方法で足りないか」を確かめるよう案内しています。

  • 誰が作業をまとめるか:1つの会話の中でClaudeが任せて結果を集める→サブエージェント。自分で作業を渡して後で確認する→Agent View。Claudeが計画し、メンバーに割り振って監督する→Agent Teams。台本が手順を持つ→動的ワークフロー。
  • 作業どうしで連絡が必要か:サブエージェントは呼び出した会話へ結果を返し、Agent Viewのセッションは結果をあなたにだけ返します。メンバー同士が直接やり取りするのはAgent Teamsです。自分で動かしているセッション間で結果を渡したいだけなら、セッション間メッセージで足ります。
  • 同じファイルを触るか:同じファイルを編集するなら、ワークツリーで分けます。サブエージェントや自分で動かすセッションはワークツリーで分けられますが、Agent Teamsのメンバーはワークツリーで分けられません。メンバーごとに担当ファイルを分けて頼む必要があります。
結果だけ分かればよい? はい いいえ 作業どうしは無関係? いいえ メンバー同士の議論が要る? はい Agent Teams(実験的・既定は無効) 1問目が「はい」→ サブエージェント 2問目が「はい」→ Agent View
図2: 3つの方法の選び方。数百ファイルにまたがる大きな作業は動的ワークフロー、何日も続く作業はProjectsが候補になります(公式ドキュメント「エージェントを並列実行する」の問いをもとに作成)
こんなとき 選ぶ方法
調査やレビューの途中経過で、会話を埋めたくない サブエージェント
関係のない作業を3つ4つまとめて任せ、終わったものから見たい Agent View
複数の観点で調べた結果を、メンバー同士で突き合わせて結論を出したい Agent Teams
数百ファイルの移行や、コード全体の点検をしたい 動的ワークフロー
パソコンの電源を切っても、何日も続けたい Projects

おすすめの順番は、まず1つのセッションとサブエージェントで進め、独立した作業が増えたらAgent View、メンバー同士の話し合いが本当に必要になったらAgent Teams、です。次の2つの章で、サブエージェントとAgent Viewを、選ぶのに必要な深さで実際の画面つきで確かめます。

サブエージェント:1つの会話の中で作業を任せる

サブエージェントは、メインの会話とは別の文脈(コンテキスト)で特定の作業を担当するエージェントです。1つの会話で調査も実装も続けると、読み込んだファイルの中身や検索結果が会話の文脈にたまり、後の作業のための余地が減っていきます。調査やレビューのように「結果だけ分かればよい」作業を任せると、途中の検索結果やファイルの中身がメインの会話に流れ込まず、会話が長くなりすぎません。サブエージェントはメインの会話の履歴を受け取らず、Claudeが書いた作業の説明だけを持って始まります。定義の tools に Agent を含めればサブエージェントからさらにサブエージェントを起動でき、深さは既定でメインの会話の下に3階層までです。ここでは、ほかの方法と比べるのに必要なことだけをまとめます。定義ファイルの全項目、権限モードやフックの細かな設定は、Claude Codeのサブエージェントとはで解説しています。

最初から使える組み込みサブエージェント

Claude Codeには、必要に応じてClaudeが自動で使う組み込みのサブエージェントがあります。どれも、メインの会話の権限ルールを引き継ぎます。

名前 役割 使えるツール
Explore ファイルの検索、コードの検索、コードベースの調査 読み取り専用(書き込み・編集は不可)
Plan プランモードで、計画を出す前の調査 読み取り専用(書き込み・編集は不可)
general-purpose 調査と変更の両方が要る、複数の手順にまたがる作業 サブエージェントで使えるすべてのツール

このほか、/statusline の設定を手伝う statusline-setup、Claude Codeの使い方の質問に答える claude-code-guide などの補助用エージェントもあります。ExploreとPlanは、調査を速く安く済ませるため、CLAUDE.mdを読み込まずに始まります。

自分用のサブエージェントを1つ置いてみる

自分用のサブエージェントの実体は、先頭にYAMLの設定(フロントマター)を書いたMarkdownファイルです。Claude Codeに「こういう役割のサブエージェントを、この場所に作って」と頼めば、Claudeがファイルを作ります。必須の項目は name と description の2つです。置き場所で使える範囲が決まり、同じ名前があれば、組織の管理設定、起動時の --agents、プロジェクトの .claude/agents/、自分の ~/.claude/agents/、プラグインの順に優先されます。プロジェクト用をGitで共有すれば、チーム全員が同じサブエージェントを使えます(置き場所ごとの作り方はサブエージェントの解説記事にまとめています)。

公式ドキュメントは、定義の例としてコードレビュー役・デバッグ役・データ分析役・データベースの読み取り専用クエリ役の4つを載せています。役割ごとに使えるツールを絞るのが共通の考え方です。今回の画面では、小さなToDoアプリのフォルダに、次のファイルを .claude/agents/code-reviewer.md として置きました。

---
name: code-reviewer
description: コードの変更を読み、不具合と読みにくい箇所を指摘する。レビューを頼まれたときに使う
tools: Read, Grep, Glob
model: sonnet
---
あなたはコードレビュー担当です。変更されたファイルを読み、
不具合の可能性がある箇所と、読みにくい箇所を重要な順に挙げてください。
ファイルは変更しないでください。

description は、Claudeが「どの作業をこのサブエージェントに任せるか」を決める材料になります。任せたい場面を具体的に書くのがコツです。tools を読み取り用の3つに絞っているので、このサブエージェントはファイルを書き換えられません。

実際に任せた画面

Claude Codeを起動して「code-reviewer エージェントで app.js をレビューして。修正はしないで」と頼むと、会話に code-reviewer(Review app.js) の行が出て、サブエージェントが動き始めました。v2.1.299の対話モードでは、サブエージェントは既定でバックグラウンドで動くため、待っているあいだも入力欄は使えます。画面の下の一覧には、メインの会話(main)と code-reviewer が並び、使ったトークン数が表示されています。

Claude Code v2.1.299 で「code-reviewer エージェントで app.js をレビューして」と頼んだ画面。code-reviewer(Review app.js) の行と Backgrounded agent の表示、エージェント一覧に main と code-reviewer が並んでいる
自作のサブエージェント code-reviewer に app.js のレビューを任せた直後の画面。下の一覧で main と code-reviewer の動きが分かります(2026年10月14日にこの端末で実際に実行して撮影。Claude Code v2.1.299。ウィンドウの枠は描画したもので、文字は実行結果そのままです)

16秒ほどで「Agent “Review app.js” finished」と表示され、レビューの結果(重要度・箇所・内容と、読みにくい箇所)がメインの会話に返ってきました。サブエージェントが読んだファイルの中身そのものはメインの会話に入らず、まとめた結果だけが残ります。

サブエージェント code-reviewer が app.js のレビュー結果を返した画面。重要度・箇所・内容と読みにくい箇所が並び、最後に Agent Review app.js finished 16s と表示されている
サブエージェントの結果が返ってきた画面。最後の行に「Agent “Review app.js” finished · 16s」と出ています(2026年10月14日に実際に実行して撮影)
Claude Codeを起動してフォルダを信頼し、code-reviewer サブエージェントにレビューを任せてから、結果が返るまで(約55秒・音声なし。2026年10月14日に実際に実行して録画。ウィンドウの枠は描画したもので、文字は実行結果そのままです)

知っておきたい点を3つ挙げます。

  • 同時に動かせる数:1つのセッションで同時に動いているサブエージェントが20個に達すると、それ以上は起動できません(環境変数 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS で変えられます)。合計の起動回数には上限がありません。
  • 新しく作ったのに見つからないとき:セッションを始めたときに ~/.claude/agents/ が無かった場合は、Claude Codeを起動し直します。
  • サブエージェントは1つのセッションの中だけで動きます。独立したセッションを並べて管理したいときは、次の節のAgent Viewを使います。

Agent View(claude agents):独立した作業をまとめて任せる

Agent Viewは、バックグラウンドで動く複数のClaude Codeセッションを1つの画面で管理する機能です。シェルで claude agents を実行すると開きます。不具合の修正、プルリクエストのレビュー、テストの調査のように、互いに関係のない作業をいくつも渡し、終わったものや質問が来たものだけを開いて対応する、という使い方をします。2026年11月1日に公式ドキュメントで確認した時点でも、研究プレビュー(画面や操作キーが変わる可能性がある段階)です。

使い方の流れ

  1. 開く:作業したいフォルダで claude agents を実行します。まだ信頼していないフォルダでは、通常の claude と同じ「このフォルダを信頼するか」の確認が先に出ます。
  2. 任せる:下の入力欄に作業を書いてEnterを押すと、その作業用の新しいセッションがバックグラウンドで始まり、1行として表示されます。もう1つ書いてEnterを押すと、2つ目のセッションが並んで始まります(1つ目への追加の指示にはなりません)。
  3. のぞいて返事をする:矢印キーで行を選んでSpaceを押すと、そのセッションの最新の出力や、待っている質問が表示されます。返事を書いてEnterで送れます。
  4. 入る・戻る:行でEnter(または→)を押すと、そのセッションの会話に入って通常どおり操作できます。空の入力欄で←を押すと一覧に戻ります(Ctrl+Zでも抜けられます)。

実際に、ToDoアプリのフォルダで claude agents を開いた画面が次です。「Needs input(あなたの返事待ち)」「Working(作業中)」「Completed(完了)」の3つの欄があり、下に新しいセッションの作業を書く欄があります。見出しの行には、新しいセッションが使うモデルが表示されています。

ターミナルで claude agents を実行して開いた Agent View。Needs input・Working・Completed の3つの欄と、下に新しいセッションの作業を入力する欄がある
claude agents で開いたAgent View。3つの欄と、下の入力欄があります(2026年10月14日にこの端末で実際に実行して撮影。Claude Code v2.1.299。ウィンドウの枠は描画したもので、文字は実行結果そのままです)

入力欄に「README.md を読んで、このプロジェクトの内容を1文で説明して」と書いてEnterを押すと、セッションが始まり、数秒で Completed の欄に移りました。セッションには自動で名前(ここでは readme-project-summary)が付き、行に結果の冒頭が表示されます。

Agent View で README.md の内容説明を頼んだセッション readme-project-summary が Completed の欄に入り、1 completed と表示されている画面
任せたセッションが完了し、Completed の欄に入った画面。「1 completed」と表示されています(2026年10月14日に実際に実行して撮影)

一覧には、このほかにピン留めしたセッションの「Pinned」(Ctrl+Tで固定)や、レビュー待ちのプルリクエストがあるセッションの「Ready for review」のまとまりも出ます。失敗したセッションと止めたセッションは Completed の欄にまとまります。スクリプトから状態を調べたいときは claude agents --json が使えます。

シェルから直接任せる・止める

Agent Viewを開かずに、シェルから直接バックグラウンドのセッションを始めることもできます。

claude --bg "認証まわりのテストが不安定な原因を調べて"
claude --bg --name "flaky-test" "認証まわりのテストが不安定な原因を調べて"

--bg の作業内容は、-p の値ではなく、そのまま引数として書きます(-p と一緒には使えません)。始めると短いIDが表示され、claude attach <ID> で会話に入る、claude logs <ID> で最近の出力を見る、claude stop <ID> で止める、といった操作ができます。自作のサブエージェントをそのセッションの主役にしたいときは、claude --agent code-reviewer --bg "…" のように --agent を付けます。

ファイルの編集はワークツリーで分かれる

Agent Viewから任せたセッション(と claude --bg で始めたセッション)は、ファイルを編集する前に、.claude/worktrees/ の下に作るGitのワークツリーへ移ります。並行して動く複数のセッションが、同じファイルを書き換えてぶつかることを防ぐためです。ただし、開いていたセッションを←や /background で後ろに回した場合、すでにワークツリーの中にいる場合、フォルダがGitのリポジトリでない場合、書き込み先が作業フォルダの外の場合、設定の worktree.bgIsolation を "none" にした場合は、ワークツリーへ移りません。セッションを削除すると、Claudeが作ったワークツリーも一緒に消えるため、残したい変更は先にコミットしておきます。

注意点

  • 利用枠の消費:バックグラウンドのセッションも、対話のセッションと同じように契約プランの利用枠を使います。10個を並行して動かせば、1つのときの約10倍の速さで枠を使います。
  • 自分のパソコンで動く:セッションはこの端末の上で動きます。スリープしても保たれますが、電源を切ると止まります。パソコンを閉じても進めたいときは、クラウドで動くProjectsやWeb版のClaude Codeを使います。
  • 使わないとき:設定の disableAgentView を true にするか、環境変数 CLAUDE_CODE_DISABLE_AGENT_VIEW を設定すると、Agent Viewとバックグラウンドのエージェントを無効にできます。
  • 古い版の場合:claude agents を実行してサブエージェントの一覧が表示されて終わるときは、Agent Viewが使えない環境です。claude update で最新版にします。

Agent Teamsとは:メンバー同士が話し合うチーム

Agent Teams(エージェントチーム)は、1つのClaude Codeセッションがチームリードになり、複数のメンバー(独立したClaude Codeセッション)に作業を割り振って進める、実験的な機能です。既定では無効で、環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を 1 にすると使えます。メンバーはそれぞれ自分の文脈で動き、共有のタスク一覧とメッセージでやり取りします。リーダーを通さず、あなたが特定のメンバーへ直接指示することもできます(2026年11月1日に公式ドキュメント「Claude Code セッションのチームを調整する」で確認)。

Lead Agent タスク分割・調整・統合 Member A フロントエンド担当 Member B バックエンド担当 Member C テスト・レビュー担当 Shared Task List Inter-Agent Messaging(メンバー間の直接通信)
図1: Claude Code エージェントチームの基本構造。Lead Agentが複数メンバーにタスクを割り当て、共有タスクリストとエージェント間メッセージングで状態を同期します。(公式ドキュメント「Orchestrate teams of Claude Code sessions」をもとに作成)

ここまでのサブエージェントとの違いを、公式の比較をもとに表にします。

比べる点 サブエージェント Agent Teams
文脈 自分専用の文脈。結果は呼び出した会話に返る 自分専用の文脈。メンバーごとに完全に独立
連絡 呼び出した会話に結果を返す(Claudeが名前を付けたサブエージェント同士はメッセージを送れる) メンバー同士が直接メッセージを送る
まとめ役 メインのエージェントがすべてを管理する メッセージと共有のタスク一覧で、メンバーが自分たちで調整する
向いている作業 結果だけが大事な、焦点の絞れた作業 議論と協力が必要な、複雑な作業
トークンの消費 少ない(結果が要約されて戻る) 多い(メンバーごとに別のClaudeが動く)

この先は、Agent Teamsを使うと決めた人に向けて、有効化、最初のチームの作り方、操作、仕組み、使いどころ、費用、制限、うまくいかないときの対処を順に説明します。

Agent Teamsを有効にする:環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を1にする

Agent Teamsは既定で無効です。この環境変数が無いと、セッション開始時にチームは作られず、Claudeもメンバーを作ったり提案したりしません。有効にする方法は2つです。

  • その場だけ試す:起動するときに付けます。
    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
  • いつも有効にする:settings.json の env に書きます。
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

settings.jsonの場所と書き方は、公式ドキュメント「Settings」をご覧ください。有効にする前に、次の3点を確認します。

  • 最新版にしておく:実験的機能で変更が多いので、claude --version で版を確認し、claude update で更新します(この記事の画面は v2.1.299)。
  • 対話モードで使う:メンバーの起動には対話モードが必要です。-p を付けた非対話モード(Agent SDKを含む)では、有効にしてもメンバーは起動されません。
  • 頼んでいないのにチームが組まれることがある:有効にすると、Claudeが名前を付けて起動したサブエージェントがメンバーとして起動するようになります。意図しないときは、値を 0 に戻します(保存すると、起動中のセッションにもすぐ反映されます)。

Agent Teamsで最初のチームを作る:普通の言葉で役割を伝える

有効にしたら、作業の内容と、欲しいメンバーの役割を普通の言葉で伝えるだけです。リーダー(最初のセッション)がメンバーを作り、共有のタスク一覧に作業を並べて割り振り、終わったら結果をまとめます。公式ドキュメントの例は、役割が互いに独立していて、待ち合わせなしに調べられる次のような頼み方です。

CLI ツールを設計しています。UX、技術アーキテクチャ、反対意見を言う役の
3人のメンバーを作って、それぞれの観点から調べてください。

(公式の例文を日本語にした言い換えです。原文は英語です。)

この記事の画面では、小さなToDoアプリのフォルダで次のように頼みました。

エージェントチームを作って、2人のメンバーで調べて。1人は app.js の不具合、
1人は README.md の改善案を担当。ファイルは変更しないで。各メンバーはSonnetで

リーダーは appjs-bug-hunter と readme-reviewer の2人を作り、2人は並行して調べ始めました。先に終わった appjs-bug-hunter の結果がリーダーに届くと、リーダーは「README の担当はまだ調査中なので、そろったらまとめて報告します」と答えています。入力欄の下のエージェント一覧には、main(リーダー)と2人のメンバーが並び、それぞれの状態(待機中・作業中)と使ったトークン数が表示されます。

Agent Teams を有効にした Claude Code で2人のメンバーを作った画面。appjs-bug-hunter からの結果がリーダーに届き、下のエージェント一覧に main・appjs-bug-hunter・readme-reviewer が並んでいる
Agent Teamsで2人のメンバーを作った画面。appjs-bug-hunter の結果がリーダーに届き、下のパネルに main・appjs-bug-hunter・readme-reviewer が並んでいます(2026年10月14日にこの端末で実際に実行して撮影。Claude Code v2.1.299。ウィンドウの枠は描画したもので、文字は実行結果そのままです)

readme-reviewer も作業を終えると、リーダーが2人の結果をまとめました。2人とも「存在しないidを渡すと落ちる」という同じ不具合に気づいていたことや、直す順番(app.jsの不具合を先に直し、そのあとREADMEに注意事項を書く)まで、チームとしての結論になっています。

readme-reviewer も作業を終え、リーダーが2人の結果をまとめて報告している画面。Teammate readme-reviewer finished の表示がある
2人目のメンバー readme-reviewer も作業を終え、リーダーが結果をまとめた画面(2026年10月14日に実際に実行して撮影)
Agent Teamsを有効にしたClaude Codeに2人のメンバーで調べるよう頼み、メンバーの作成から結果のまとめまで(約78秒・音声なし。2026年10月14日に実際に実行して録画。ウィンドウの枠は描画したもので、文字は実行結果そのままです)

チームができたかどうかの見分け方:Claudeは、チームではなく通常のサブエージェントを使うことがあります。サブエージェントも同じ一覧に表示されるので、一覧だけではチームができたか分かりません。チームにしたいときは、今回のように「エージェントチームを作って」「◯人のメンバーを作って」とはっきり頼み、サブエージェントが動いたときは言い直して頼みます。メンバーに呼び名を付けてほしいときは、頼む文に名前を書いておくと、あとの指示で名前を使えます。

チームの動かし方:メンバーへの指示・表示・人数・タスク

メンバーを選んで直接指示する

各メンバーは、それぞれが独立したClaude Codeのセッションです。リーダーを通さずに、特定のメンバーへ追加の指示や質問を送れます。インプロセス(既定)の表示モードでは、入力欄の下のエージェント一覧から操作します。

  • ↑↓キー:一覧でメンバーを選ぶ
  • Enter:選んだメンバーの会話を開き、そのまま入力するとそのメンバーへ届く
  • Esc:選択を外す(メンバーの会話を見ているときは、そのメンバーの今の作業を中断する)
  • x:選んだメンバーを止める
  • Ctrl+T:共有のタスク一覧を表示する・隠す

メンバーの会話を開いているとき、普通の文章とスキルはそのメンバーへ、組み込みコマンドはリーダーのセッションへ届きます。/compact・/clear・/rewind はリーダーの会話に作用するので実行前に確認が出ます。/model と /fast はリーダー向けの設定で、この画面からは実行できません。メンバーのモデルと高速モードは、起動した時点で固定されます。

全員が待機中になると、待機中の行は30秒後に一覧から隠れますが、メンバーは動いたままで、次の作業が始まると再び表示されます。名前を指定して連絡すれば、隠れた行も戻ります。3人以上が同時に待機中になると、最初の3行より後は「2 idle agents」のように1行にまとまり、Enterで開けます。作業中・失敗したメンバーと、いま見ているメンバーは、いつも自分の行を持ちます。

> 入力欄(リーダーへの指示) main(リーダー) › appjs-bug-hunter 作業中 readme-reviewer 待機中 ↑↓:メンバーを選ぶ Enter:会話を開いて指示 Esc:選択を外す(会話中は今の作業を中断) x:選んだメンバーを止める Ctrl+T:共有のタスク一覧を表示・非表示 ※一覧の並びは上の実画面をもとにした模式図です
図3: インプロセス(既定)の表示で、メンバーを選んで直接指示するときのキー操作(公式ドキュメントのキー一覧をもとに作成)

表示モード:同じ画面か、画面を分けるか

モード 中身 必要なもの
インプロセス(既定) すべてのメンバーがメインのターミナルの中で動く。一覧で選んで操作する どのターミナルでも使える
分割ペイン メンバーごとに画面を分け、全員の出力を同時に見られる。ペインをクリックして操作する tmux、または it2 コマンドを入れたiTerm2

切り替えは ~/.claude/settings.json の teammateMode で行います。"auto" にすると、tmuxの中、または it2 を入れたiTerm2で動かしているときだけ分割ペインになります。"tmux" は分割ペインを使う設定で、tmuxかiTerm2かを自動で判別し、"iterm2" はiTerm2の分割ペインを明示します。1回だけ変えるときは claude --teammate-mode auto と起動します(このフラグは実験的で、claude --help には出ません)。

{
  "teammateMode": "auto"
}

tmuxとiTerm2の準備(分割ペイン)

分割ペインは、VS Codeの統合ターミナル、Windows Terminal、Ghosttyでは使えません。tmuxはmacOSで最もよく動くとされ、iTerm2では tmux -CC から入るのが公式のおすすめです。iTerm2の it2 を使うには、iTerm2の設定(Settings → General → Magic)で Python API を有効にします。tmuxはお使いのOSのパッケージマネージャーで入れます(手順はtmux公式のインストール案内にあります)。

人数とメンバーのモデルを決める

Claudeが作業に合わせて人数を決めるほか、「4人のメンバーを作って、並行してこれらのモジュールを直して。各メンバーはSonnetで」のように、人数とモデルを指定できます。メンバーのモデルは、次のうち最初に当てはまるものに決まります。

  1. 頼む文で、そのメンバーに指定したモデル
  2. サブエージェントの定義から作ったメンバーなら、その定義の model(inherit ならリーダーのモデル)
  3. 環境変数 CLAUDE_CODE_SUBAGENT_MODEL(inherit 以外が設定されているとき)
  4. リーダーが今使っているモデル

組織が使えるモデルを制限している場合は、許可されていないモデルが指定されても、許可された別のモデルか、リーダーのモデルに置き換わります。思考の深さ(effort)は、既定ではリーダーのものを引き継ぎます。

実装の前に、計画を出させる

複雑で危険の大きい作業では、メンバーに実装の前に計画を立てさせられます。リーダーをプランモードにしてからメンバーを頼むと、そのメンバーは計画ができるまで読み取り専用で動きます。計画ができると、メンバーはリーダーに承認を求めますが、この承認はリーダーのセッションが、あなたの確認なしにすぐ行います。承認後のメンバーの編集やコマンドは、通常どおり許可の確認を通ります。動いているメンバーの会話を開いて Shift+Tab でプランモードにした場合は、その計画を自動では承認せず、リーダーが読んで承認するか差し戻します。計画の中身を人が確かめたいときは、メンバーの会話を開いて読んでください。

タスクの割り振りと取り合い

共有のタスク一覧が、チームの作業を調整します。リーダーがタスクを作り、メンバーが順に進めます。タスクの状態は「保留中・進行中・完了」の3つで、ほかのタスクに依存するタスクは、依存先が完了するまで取れません。割り振りは次の2通りで、メンバーが同時に同じタスクを取る衝突は、ファイルのロックで防がれます。

  • リーダーが割り当てる:どのタスクをどのメンバーに任せるかを、リーダーに伝える
  • メンバーが自分で取る:タスクが終わったら、メンバーが次の未割り当てで依存の解けたタスクを自分で取る

チームを正しく終了する(シャットダウンと後片付け)

  1. メンバーの作業が終わったか確かめる:一覧で全員が待機中になり、リーダーが結果をまとめたことを確認します。
  2. メンバーを名前で終わらせる:「researcher のメンバーを終了させて」のように頼みます。リーダーが終了を依頼し、メンバーは承諾して終わるか、理由を添えて断ります。実行中の処理があるメンバーは、それを終えてから止まるため、時間がかかることがあります。
  3. セッションを終える:チームの設定フォルダ(~/.claude/teams/ 配下)はセッションの終了時に自動で片付くので、別の後片付けは要りません。タスク一覧のフォルダ(~/.claude/tasks/ 配下)は残ります。
  4. 分割ペインを使った場合:tmuxのセッションが残っていないか tmux ls で確かめます。

フックで品質のルールを決める

メンバーの作業の節目では、フックでルールを強制できます。

フック 動くとき(終了コード2で止める)
TeammateIdle メンバーが待機に入る直前。コード2で、フィードバックを返して作業を続けさせる
TaskCreated タスクを作るとき。コード2で、作成を止めてフィードバックを返す
TaskCompleted タスクを完了にするとき。コード2で、完了を止めてフィードバックを返す

Agent Teamsの仕組み:リーダー・メンバー・タスク一覧・メールボックス

チームは次の4つでできています。

構成要素 役割
チームリード メンバーを作り、作業を調整するメインのセッション。最後までリーダーで、途中でメンバーに替えることはできません
メンバー 割り当てられたタスクに取り組む、別々のClaude Codeセッション
タスク一覧 メンバーが取って完了させる、共有の作業項目の一覧
メールボックス エージェント同士の連絡用。各エージェントの受信箱は ~/.claude/teams/{チーム名}/inboxes/{エージェント名}.json にあり、相手の受信箱への書き込みに成功したときだけ「送信した」と扱われます

チームの設定は ~/.claude/teams/{チーム名}/config.json に、タスク一覧は ~/.claude/tasks/{チーム名}/ に、セッションから決まる名前(session- と セッションIDの先頭8文字)で保存されます。設定ファイルはセッションの終了時に消えますが、タスク一覧のフォルダは残り、cleanupPeriodDays の期間で片付きます。設定ファイルにはセッションIDなどの実行中の状態が入っているため、手で編集したり、あらかじめ書いておいたりしても、次の更新で上書きされます。プロジェクトの .claude/teams/teams.json のようなファイルは設定として認識されません。

サブエージェントの定義を、メンバーの役割として使う

「security-reviewer」「test-runner」のような役割は、サブエージェントの定義として1回書いておけば、サブエージェントとしても、チームのメンバーとしても使えます。頼むときに「security-reviewer のエージェントタイプで、認証モジュールを監査するメンバーを作って」のように名前を指定します。メンバーに反映される項目は次のとおりです。

定義の項目 メンバーでの扱い
tools メンバーが使えるツールをこの一覧に限る(インプロセスでは、メッセージ送信とタスク操作のツールが自動で加わる)
model 頼む文でモデルを指定しなかったときに使う
disallowedTools インプロセスのメンバーから、一覧のツールを外す(自動で加わるメッセージ送信とタスク操作のツールは残る)
effort・autoCompactWindow インプロセスのメンバーに反映される(autoCompactWindow は v2.1.296 以降。分割ペインでは無視)
本文(指示文) インプロセスでは既定の指示に追加される。分割ペインでは既定の指示の代わりに使われる
skills 反映されない。メンバーはプロジェクトとユーザーの設定からスキルを読み込む
mcpServers 分割ペインのメンバーには反映される。インプロセスでは無視され、プロジェクトとユーザーの設定から読み込む

もう動いていないインプロセスのメンバーにリーダーがメッセージを送ると、そのメンバーは同じセッションの中で保存された会話から戻ります(セッションを再開した後は戻りません)。プロジェクトの .claude/agents/ にある定義は、そのフォルダを信頼している場合だけ、戻ったメンバーに再び反映されます。

権限と文脈

  • 権限:メンバーは、リーダーの権限モードで始まります(dontAsk モードだけは引き継ぎません)。リーダーが --dangerously-skip-permissions で動いていれば、全メンバーも同じです。起動後に個別のメンバーの権限モードは変えられますが、起動時にメンバーごとに分けることはできません。メンバーの許可の確認はリーダーの画面に出るので、そこで答えます。
  • 起動時のフラグ:インプロセスのメンバーは、リーダーの許可・拒否のルールの下で動くので、--allowedTools・--disallowedTools・--tools がそのまま効きます。分割ペインのメンバーには --allowedTools が渡らないため、事前に許可したい操作は、リーダーを起動するときに --settings の permissions.allow に書きます。
  • メンバー間のメッセージ:受け取ったメンバーには「ほかのClaudeセッションからのメッセージ」と伝わり、あなたに代わって許可を出したり、拒否された操作をほかのメンバー経由で通したりはできません。
  • 文脈:メンバーは起動時に、通常のセッションと同じCLAUDE.md・MCPサーバー・スキルを読み込み、リーダーから頼む文(スポーンプロンプト)を受け取ります。リーダーの会話の履歴は引き継がれません。
  • MCPサーバーの影響:メンバーも自分のセッションでMCPサーバーを読み込みます。使っていないサーバーが多いと、メンバーの数だけ文脈とトークンを使うので、チームを組む前に /mcp で使っていないサーバーを無効にしておくと、消費を抑えられます(MCPのツール定義は既定で遅延読み込みされ、使うまでは名前などだけが文脈に入ります)。

使いどころ:Agent Teamsが力を出す作業・向かない作業

公式が挙げる、メンバーを並べる価値の大きい作業は次の4つです。

  • 調査と相互レビュー:複数のメンバーが別の観点から調べ、結果を持ち寄って検証し合う
  • 新しいモジュールや機能の並行開発:各メンバーが別の部分を持ち、互いの作業を邪魔しない
  • 競合する仮説によるデバッグ:メンバーが別々の説を同時に確かめ、早く原因に絞る
  • 層をまたぐ変更:フロントエンド・バックエンド・テストを、それぞれ別のメンバーが持つ

例1:並列コードレビュー

1人のレビュアーは、一度に1種類の問題に目が向きがちです。観点を分けると、セキュリティ・性能・テストの網羅が同時に丁寧に見られます。公式の例は、メンバーごとに別の観点を割り当てて、重なりを避けています。

PR #142 をレビューする3人のメンバーを作ってください。
- 1人はセキュリティへの影響
- 1人は性能への影響
- 1人はテストの網羅
それぞれレビューして、結果を報告してください。

(公式の例文の日本語への言い換えです。)各メンバーは同じPRを別のフィルターで見て、リーダーが終わった後に3人の結果をまとめます。

例2:競合する仮説でデバッグ

原因がはっきりしないとき、1つのエージェントは、もっともらしい説を1つ見つけたところで調べるのをやめがちです。公式の例は、メンバーを意図的に対立させ、自分の説を調べるだけでなく、ほかの説を崩しに行かせます。

アプリが1回のメッセージの後に終了してしまうと報告が来ています。
5人のメンバーを作って、別々の仮説を調べさせてください。
お互いの説を反証し合う、科学的な議論のように進めて、
合意が出たら、その結果を調査メモに反映してください。

議論の形にするのが肝です。順番に調べると、最初の説に引きずられます(アンカリング)。独立した調査役が互いに反証を試みれば、最後に残った説が本当の原因である可能性が高くなります。

例3:担当ファイルを分けて、新機能を並行して作る

フロントエンド・バックエンド・テストのように、触るファイルが分かれる作業は、並行して進めやすい例です。同じファイルを2人が編集すると上書きが起きるため、頼む文でメンバーごとの担当ファイルを先に決めます(次の文は当サイトで作った例文で、公式の例文ではありません)。

ToDoアプリに「期限日」の機能を足したいです。3人のメンバーを作ってください。
- ui担当:src/ui/ だけを編集する
- api担当:src/api/ だけを編集する
- test担当:tests/ だけを編集し、2人の実装が終わってからテストを書く
お互いの担当のファイルは編集せず、仕様で迷ったら担当のメンバーへ質問してください。

test担当のように、ほかのメンバーの完了を待つ役割があるときは、共有のタスク一覧の「依存」が働き、依存先のタスクが完了するまでは取れません。

例4:大きなリファクタリングを、モジュールごとに分ける

複数のモジュールにまたがる書き換えは、モジュールごとにメンバーを分けると並行して進められます。ただし、モジュール同士が呼び合う部分があると、順番の制約が出ます。公式の考え方に沿って、担当の境目と進め方を先に決めて頼みます(当サイトで作った例文です)。

src/ 以下の4つのモジュール(auth・billing・search・notify)で、
古いログ出力の書き方を新しい書き方に置き換えたいです。
4人のメンバーを作り、1人が1モジュールだけを担当してください。
各メンバーは自分のモジュールのファイル以外を編集せず、
共通の部品(src/common/)は私が確認するまで変更しないでください。
終わったら、変更したファイルの一覧と、迷った点を報告してください。

共通の部品のように、全員が関わるファイルは、メンバーに任せず自分で確認する側に残すと、上書きの事故を防げます。

Agent Teamsが向かない作業

  • 前の結果が次の入力になる、順番どおりに進める作業
  • 複数のメンバーが同じファイルを編集しそうな作業
  • 依存関係の多い作業
  • トークンの消費を厳しく抑えたい作業
  • 止まっては困る本番の仕組みへの組み込み(実験的機能のため)

こうした作業は、1つのセッションかサブエージェントのほうが向いています。日常の調査やレビューはサブエージェントで足ります。今回の画面のように、2つの観点の結果を突き合わせて結論を出したいときに、Agent Teamsが役に立ちます。

Claude Code・AIエージェントの業務導入をご検討の方は、自社での開発実例を公開しているクリスタルメソッドの無料相談をご利用ください。

Agent Teamsをうまく使うコツ:人数・タスクの大きさ・文脈の渡し方

役割を分ける4つの考え方

  • 役割が重ならないようにする:「セキュリティ」「性能」「テスト」のように、見る観点やファイルの持ち主がメンバーごとに違うと、同じ作業を2人がやる無駄が出ません。
  • 任せる範囲を言葉にする:どのフォルダ・どのファイルを触ってよいか、触ってはいけないかを、頼む文に書きます。
  • リーダーの会話の履歴に頼らない:メンバーはリーダーの履歴を持たないので、前提は頼む文かCLAUDE.mdに書きます。
  • 成果物の形を決める:「重要度つきの指摘の一覧」「変更したファイルの一覧」のように、報告の形を指定すると、リーダーが結果をまとめやすくなります。

うまくいきにくいのは、役割を細かく分けすぎる形(人数が増えて費用だけが増える)と、頼む内容の細かさがメンバーごとにばらばらな形(あるメンバーには細かく、別のメンバーには「いい感じに」と頼む)です。後者は、全員に同じ粒度で、成果物と範囲を書くと防げます。

1つのタスクの大きさ 小さすぎ 連絡の手間が 利点を上回る ちょうどよい 関数1つ・ テスト1ファイル・ レビュー1件 大きすぎ 確認なしに長く 走って無駄が出る 人数は3〜5人から・1人あたり5〜6タスクが目安 15の独立したタスクでも、まず3人から
図4: メンバーに渡すタスクの大きさと人数の目安(公式ドキュメントのベストプラクティスをもとに作成)

そのほかのコツ

  • メンバーに文脈を十分に渡す:メンバーはCLAUDE.mdなどを自動で読みますが、リーダーの会話は引き継ぎません。対象のフォルダ、見てほしい点、前提(使っている技術など)、報告の形(重要度つきで、など)を、頼む文に書きます。
  • 人数は3〜5人から:上限はありませんが、人数が増えるほど費用と連絡の手間が増え、ある人数を超えると作業は比例して速くなりません。公式は、15個の独立したタスクがあっても、まず3人から始めるのがよい、としています。散らばった5人より、焦点の定まった3人のほうがうまくいくことが多いとも書いています。
  • タスクの大きさをそろえる:小さすぎると連絡のほうが重くなり、大きすぎると確認なしに長く走って無駄が増えます。関数1つ、テストファイル1つ、レビュー1件のように、成果物がはっきりした自己完結の単位が適切です。リーダーがタスクを十分に作らないときは、細かく分けるよう頼みます。1人あたり5〜6個が目安です。
  • リーダーが先に実装を始めたら:「メンバーの作業が終わるのを待ってから進めて」と伝えます。
  • 読み取り中心の作業から始める:PRのレビュー、ライブラリの調査、不具合の調査のように、境界がはっきりしていてコードを書かない作業から試すと、並列で調べる価値を、並列で書く難しさなしに確かめられます。
  • ファイルの担当を分ける:2人のメンバーが同じファイルを編集すると上書きが起きます。メンバーごとに別のファイルを持たせます。
  • リーダーを「調整だけ」にする専用のモード:ほかの解説記事に出てくる「Delegate Mode」は、2026年10月21日に確認した公式のAgent Teamsと権限モードの文書には記載がありませんでした。リーダーが先に実装を始めてしまうときは、上のように「メンバーの作業が終わるのを待って」と言葉で伝えます。
  • 見守って、方向を直す:進み具合を確かめ、うまくいっていない進め方は直し、結果は来た順にまとめます。放置する時間が長いほど、無駄になる危険が上がります。

CLAUDE.mdには、チーム全員が守るルールを書く

メンバーは起動時に、通常のセッションと同じようにCLAUDE.mdを読み込みます。担当ファイルの分け方、変更してはいけない場所、コミットの書き方のように、全員に守らせたいルールは、頼む文に毎回書くより、CLAUDE.mdに1回書いておくほうが確実です。メンバー別に別々のCLAUDE.mdを読ませる仕組みは、公式ドキュメントには記載がありません。リーダーの会話の履歴は引き継がれないので、その作業だけの指示は頼む文に書きます。

誤って中断した・閉じたときの復旧

  • 端末を閉じた・セッションを再開した:インプロセスのメンバーは /resume では戻りません。再開したセッションのリーダーが、もういないメンバーに連絡しようとすることがあります。その場合は新しいメンバーを作るよう伝えます。タスク一覧のフォルダ(~/.claude/tasks/ 配下)は残るので、どこまで進んだかの手がかりになります。
  • メンバーを途中で止めたい:一覧でメンバーを選んで x を押すか、メンバーの会話を開いて Esc でその時点の作業を中断します(Esc は会話を見ているときだけ中断になり、一覧では選択を外します)。
  • 残った分割ペインのtmux:下の「うまくいかないとき」の表のとおり、tmux ls で見つけて終わらせます。

手動の並列セッション(ワークツリー)との使い分け

作業を自分で分けて、別々のターミナルで動かしたいだけなら、Gitのワークツリー(作業用の別のチェックアウト)で自分でセッションを並べる方法もあります。違いを表にまとめます。

比べる点 Agent Teams ワークツリーで自分で並べる
作業の分け方 リーダーが計画して割り振る あなたが分けて、各セッションに頼む
メンバー間の連絡 メッセージで直接やり取りする 自動の連絡はない(必要なら、セッション間メッセージで渡す)
タスクの管理 共有のタスク一覧 自分で管理する
ファイルの上書き メンバーはワークツリーで分けられない。担当ファイルを分けて頼む セッションごとに別のコピーを編集するので起きにくい
向いている場面 観点を持ち寄って突き合わせたい、役割が互いに関わる作業 独立した作業を、自分で管理しながら並べたい

ワークツリーを使った並列実行は並列実行の解説で扱っています。

実例:16のエージェントでCコンパイラを作った研究(公式エンジニアリングブログ)

Anthropicのエンジニアリングブログ「Building a C compiler with a team of parallel Claudes」(2026年2月5日)は、16のエージェントでRust製のCコンパイラを一から作らせた実験です。約2,000回のClaude Codeセッションと約2万ドルのAPI費用で、10万行のコンパイラができ、Linux 6.9をx86・ARM・RISC-Vでビルドできたと書かれています。ただし、この実験は各エージェントを別々のDockerコンテナで動かし、タスクをロックファイルで取り合う、Gitを使った仕組みでした。ブログ自身が「初期の研究プロトタイプ」と位置づけ、まとめ役のエージェントも、正式な連絡の仕組みも無かった、としています。この記事で扱う Agent Teams 機能そのものの事例ではない点に注意してください。参考になるのは、テストの仕組みが十分でないとClaudeは別の問題を解いてしまうこと、そして役割(重複の整理・性能・設計の批評・文書など)を分けて並行で動かせることです(出典:Anthropic)。

CLAUDE.md・AGENTS.md・Skills・サブエージェントの役割分担

Agent機能を使い始めると、「ルールはどこに書くか」で迷います。公式ドキュメントの説明をもとに整理すると、次のようになります(2026年11月1日確認)。

置くもの 効き方と、サブエージェント・メンバーへの届き方
CLAUDE.md・AGENTS.md 会話の始めに読み込まれるプロジェクトの決まり。カスタムのサブエージェントやAgent Teamsのメンバーにも届きます(組み込みのExploreとPlanは読み込みません)
Skills くり返し使う手順や指示を、必要なときに会話の中で動かすもの。メンバーはプロジェクトとユーザーのスキルを読み込みます
サブエージェントの定義 役割ごとの説明書(システムプロンプト・使えるツール・モデル)。サブエージェントとしても、Agent Teamsのメンバーの役割としても使えます

全員に守らせたい決まりはCLAUDE.md(またはAGENTS.md)に、くり返す手順はSkillsに、役割ごとの指示と権限はサブエージェントの定義に書く、と分けると重なりません。CLAUDE.mdの書き方はメモリ(CLAUDE.md)の解説、SkillsはClaude Code Skillsの解説をご覧ください。

メンバーへ頼む文の例:対象・観点・前提・報告の形を入れる

メンバーはリーダーの会話を見ていないので、頼む文(スポーンプロンプト)がそのまま仕事の説明書になります。公式ドキュメントは、次のように対象のフォルダ、見る観点、前提となる技術、報告の形までを1つの文に入れる例を挙げています(原文は英語で、次はその言い換えです)。

セキュリティレビュー担当のメンバーを作って、次のように頼んでください。
「src/auth/ の認証モジュールをセキュリティの観点でレビューしてください。
トークンの扱い、セッション管理、入力の検証を重点的に見てください。
このアプリはJWTトークンをhttpOnlyのCookieに保存しています。
見つけた問題は、重大度をつけて報告してください。」

反対に、「認証まわりをいい感じに見て」のような頼み方では、メンバーは対象も報告の形も推測するしかなく、リーダーが結果をまとめにくくなります。

費用:Agent機能ごとの利用枠の減り方

サブエージェントもAgent ViewもAgent Teamsも、機能そのものに追加料金はありません。ただし、どれも別のエージェントが自分でリクエストを送るため、契約プランの利用枠(APIキーで使う場合は従量課金)を同じように使います。公式は、複数のセッションやサブエージェントを同時に動かすとトークンの使用量が増える、と注意しています。方法ごとの増え方は次のとおりです。

方法 利用枠の使い方(公式の説明)
サブエージェント サブエージェントが送るリクエストも、メインの会話と同じ利用上限に数えられます。モデルを指定しなければメインの会話と同じモデルで動くので、軽い作業には model: haiku などを指定すると抑えられます
Agent View バックグラウンドのセッションも対話のセッションと同じように利用枠を使い、10個を並行して動かせば10倍の速さで枠を使います
Agent Teams トークンの使用量は、動いているメンバーの数と、それぞれが動く時間に応じて増えます。メンバーが計画モードで動く場合は、通常のセッションの約7倍のトークンを使うと説明されています
同じ時間に動くエージェントの数=枠の減る速さ 1つのセッション +サブエージェント Agent View ×3 Agent Teams 3人 +リーダー 箱1つ=同時に動く1つのClaude(実際の量は作業の長さで変わる)
図5: 同時に動くClaudeの数が増えるほど、利用枠は速く減ります(公式の説明をもとにした模式図で、実測の比率ではありません)

Agent Teamsの費用について、公式の費用の解説(コストを効果的に管理する)は、調査・レビュー・新機能のように並行する価値がある作業なら増えた分に見合うことが多く、いつもの作業は1つのセッションのほうが費用を抑えられる、としています。プランごとの利用枠はClaude Codeの料金、APIキーで使う場合の単価はAPI料金の解説をご覧ください。

公式が挙げる、費用を抑える方法は次のとおりです。

  • メンバーにはSonnetを使う(能力と費用のバランスがよい)
  • チームを小さくする(費用はおよそ人数に比例する)
  • 頼む文(スポーンプロンプト)を焦点の定まったものにする(最初から各メンバーの文脈に入る)
  • 作業が終わったメンバーは終わらせる(動いているメンバーは、終了するかセッションが終わるまでトークンを使い続ける)

インプロセスのメンバーのキャッシュは、既定で5分間だけ保たれます。1時間にしたいときは subagentPromptCacheTtl を 1h にしますが、1時間のキャッシュの書き込みは、APIでは高い単価で課金されます。

どのプランで使うか

Claude Codeは、Free以外の有料プラン(Pro、Max、Ultra、Team、Enterprise)に含まれ、利用枠はそのプランのほかの利用と共有されます(2026年11月1日に claude.com/pricing の表記で確認。旧称 Max 20x のプランは Ultra に改名されています)。Agent Teamsは、メンバーの数だけ別のセッションが動くため、同じ時間でも枠を速く使います。公式は、Agent Teams向けの推奨プランを定めていません。まず小さな作業(メンバー2〜3人・読み取り中心)で1回あたりの消費を見て、足りなければ利用上限の解説やClaude Codeの料金でプランを選びます。

Agent Teamsの制限と注意:実験的機能として知っておくこと

Agent Teamsは実験的機能で、公式は次の制限を挙げています(2026年10月21日確認)。止まっては困る本番の作業に全面的に使うのは、安定版になるまで控えるのが無難です。

  • セッションを再開してもメンバーは戻らない:/resume や /rewind では、インプロセスのメンバーは復元されません。リーダーが存在しないメンバーに連絡しようとしたら、新しいメンバーを作るよう伝えます。
  • タスクの状態が遅れることがある:メンバーが完了の印を付け忘れ、後に続くタスクが止まる場合があります。作業が実際に終わっているか確かめて、状態を直すか、リーダーに促してもらいます。
  • 終了に時間がかかることがある:メンバーは実行中の処理を終えてから止まります。
  • 1セッションにつき1チーム:チームを複数作ったり、セッションをまたいで共有したりはできません。
  • チームの入れ子は不可:メンバーが自分のメンバーを作ることはできません。
  • メンバーのサブエージェントはバックグラウンドで動かない:インプロセスのメンバーが起動するサブエージェントは、前面で動きます。
  • リーダーは変えられない:最初のセッションが最後までリーダーです。
  • 権限は起動時に決まる:起動後に個別のメンバーの権限モードは変えられますが、起動時にメンバーごとに分けることはできません。
  • 分割ペインは環境を選ぶ:VS Codeの統合ターミナル、Windows Terminal、Ghosttyでは使えません。

安全面では、複数のメンバーが同時に自分で操作する構成は、1つのエージェントに比べて、ファイルや外部サービスへの影響が広がりやすくなります。書き込める範囲、実行できるコマンド、接続できる宛先を権限の設定で絞ってから使います。読み取りだけで済む作業なら、今回のように「ファイルは変更しないで」と頼みます。また、Webページや外部のファイルを読むメンバーは、悪意のある指示文を取り込む入口になりえます(プロンプトインジェクション)。読み込む範囲を絞り、実行前の確認を省かないようにします。リスクの全体像はセキュリティの解説で整理しています。複数のセッションが同時に動くと、問題が起きた箇所の特定も難しくなるため、メンバーごとに担当ファイルを分け、誰が何をしたかを会話の記録で確かめられるようにしておきます。

Agent Teamsがうまくいかないとき:よくあるつまずきと対処

症状 確かめること・対処
メンバーが一覧に出ない インプロセスでは、入力欄の下のエージェント一覧に出ます(↑↓で選んでEnter)。待機のまま消えた行は、隠れているだけで止まってはいません(名前を指定して連絡すると戻ります)。頼んだ作業がチームを組むほど複雑でなかった可能性もあるので、「エージェントチームを作って」と、はっきり頼み直します。分割ペインを頼んだなら、which tmux でtmuxが使えるか、iTerm2では it2 とPython APIの設定を確認します
サブエージェントのつもりがメンバーになる 有効にしている間は、Claudeが名前を付けたサブエージェントがメンバーとして起動します。サブエージェントに戻すなら、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を 0 にします。ユーザー設定の値は、シェルの環境変数より優先されます。ただし、プロジェクト設定・ローカル設定・--settings の env が 1 なら、そちらが優先され、組織の管理設定で有効にされている場合は、管理者に変更を頼みます
許可の確認が多すぎる メンバーの許可の確認はリーダーに集まります。メンバーを作る前に、よく使う操作を権限の設定で許可しておくと減ります
メンバーが途中で止まった エラーの後に回復せず止まることがあります。メンバーの会話を開き、追加の指示を直接送るか、代わりのメンバーを作って続けさせます。リーダーが全タスクの完了前に「終わった」と判断することもあるので、そのときは続けるよう伝えます
tmuxのセッションが残った tmux ls で一覧を見て、チームが作ったものを tmux kill-session -t セッション名 で終わらせます

どのAgent機能を使うか迷ったときの判断(監修者の運用から)

監修者・河合継は、1年以上Claude Codeを日常の業務で使い、サブエージェントとAgent Teamsを使い分けています。その運用で得た判断の目安を補足します。

  • まずは単体+サブエージェントで足りることが多い:本当に複数の役割が同時に必要な作業は意外と限られます。多くは、1つのセッションに調査用のサブエージェントを足す程度で回り、いきなりチームを組むと管理が重くなりました。
  • 「役割を分けると速くなるか」を描けてから入れる:なんとなく強力そうだから、で入れると、各エージェントの結果を束ねる手間が利点を上回ります。役割分担がはっきり描ける作業に絞るのがコツでした。
  • 並行で動くぶん費用も増える前提で見る:トークンの消費、権限の設定の誤り、並行して動くことで不具合の原因を追いにくくなること、の3つは実際に起きやすい失敗です。CLAUDE.mdに運用のルールを書き、ファイルを変更する前に自動でバックアップを取るフックを入れて、こうした失敗を防いでいます。

よくある質問

Q. Claude Code Agentとは何ですか?

A. Claude Codeが作業の一部を別のエージェントに任せたり、複数のエージェントを同時に動かしたりする機能の総称です。公式は、サブエージェント・Agent View・Agent Teams・動的ワークフロー・Projectsの5つの方法を挙げています。Claude Code自体も、コードを読み、編集し、コマンドを実行するAIエージェントです。

Q. サブエージェント・Agent View・Agent Teamsはどう使い分けますか?

A. 結果だけ分かればよい作業は、1つの会話の中で動くサブエージェントに任せます。互いに関係のない作業を並べて任せ、終わったものから確かめたいならAgent View(claude agents)を使います。メンバー同士が調べた結果を突き合わせる必要がある作業だけ、Agent Teamsを使います。

Q. /agents と claude agents の違いは何ですか?

A. Claude Codeの中で入力する /agents は、サブエージェントの定義ファイルの置き場所(.claude/agents/ と ~/.claude/agents/)を案内するコマンドです。シェルで実行する claude agents は、バックグラウンドのセッションを1つの画面で管理するAgent Viewを開くコマンドです。

Q. Agent Viewとは何ですか?

A. バックグラウンドで動く複数のClaude Codeセッションを、1つの画面から渡して見守る機能です。シェルで claude agents を実行して開き、入力欄に作業を書くとセッションが始まります。2026年11月1日の確認時点で研究プレビューです。

Q. Claude Code Agent Teamsとは何ですか?

A. Claude Codeで、1つのセッションがチームリードとなり、複数のメンバー(それぞれ独立したClaude Codeセッション)に作業を割り振って進める実験的機能です。メンバーは共有のタスク一覧とメッセージで連携し、あなたも特定のメンバーへ直接指示できます。既定では無効です。

Q. Agent Teamsはどうやって有効にしますか?

A. 環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を 1 にします。起動時に CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude と付けるか、settings.json の env に書きます。メンバーの起動には対話モードが必要で、-p を付けた非対話モードでは起動されません。

Q. Agent Teamsとサブエージェントの違いは何ですか?

A. サブエージェントは1つの会話の中で作業をして結果を呼び出し元へ返す働き手で、まとめ役はメインのエージェントです。Agent Teamsはメンバーごとに独立したセッションで、共有のタスク一覧とメンバー同士の直接のメッセージで進み、あなたもメンバーに直接指示できます。そのぶんトークンの消費は多くなります。

Q. チームができたのか、サブエージェントが動いているのかを見分けられますか?

A. エージェント一覧の表示だけでは見分けられません。サブエージェントもメンバーも同じ一覧に並ぶためです。チームにしたいときは「エージェントチームを作って」「3人のメンバーを作って」のようにはっきり頼みます。

Q. Agent Teamsは何人で使うのがよいですか?

A. 人数に決まった上限はありませんが、公式は多くの作業で3〜5人から始めることを勧めています。人数を増やすほどトークンの消費と連絡の手間が増え、ある人数を超えると作業は人数に比例しては速くなりません。

Q. エージェント機能に追加料金はかかりますか?

A. サブエージェント・Agent View・Agent Teamsとも、機能そのものに追加料金はありません。ただし、別のエージェントが動くぶん、使ったトークンは契約プランの利用枠(APIキーの場合は従量課金)から消費されます。Agent Teamsは動いているメンバーの数に応じて増えます。

Q. 頼んでいないのにチームが組まれるのはなぜですか?

A. Agent Teamsを有効にすると、Claudeが名前を付けて起動したサブエージェントがメンバーとして起動するためです。サブエージェントのままにしたいときは、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を 0 に戻します。

Q. セッションを再開(/resume)するとメンバーも戻りますか?

A. 戻りません。/resume や /rewind では、インプロセスのメンバーは復元されません。リーダーが存在しないメンバーに連絡しようとしたら、新しいメンバーを作るよう伝えます。

まとめ

Claude Code Agentは、作業を別のエージェントに任せたり、複数のエージェントを並べて動かしたりする機能の総称です。公式の5つの方法のうち、日常的に使うのはサブエージェント・Agent View・Agent Teamsの3つです。

  • 選び方:結果だけ分かればよい作業はサブエージェント、独立した作業をまとめて任せたいならAgent View、メンバー同士の話し合いが要る作業がAgent Teamsです。
  • Agent Teamsの使い方:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効にし、「エージェントチームを作って」と役割を伝えます。3〜5人から、読み取り中心の作業から、担当ファイルを分けて、終わったメンバーは終わらせます。
  • 注意:どの方法も利用枠を使い、Agent Teamsは人数に応じて増えます。再開(/resume)でメンバーは戻らず、1セッションに1チームの制限があります。

サブエージェントの細かな設定はサブエージェントの解説記事、日々の基本の操作はClaude Codeの使い方で確認できます。

参考文献

「エージェントを並列実行する」「チームを調整する」「Agent View」は2026年11月1日に、そのほかは2026年10月21日に内容を確認しました。



Claude Code・AIエージェントの業務活用をご検討の方へ

クリスタルメソッドは、Claude Codeを日々の業務で使いながら、AIエージェント・社員AIの導入と開発効率化を支援しています。自社サイトの表示速度をAI社員(Claude Code)で12.89秒→2.03秒に短縮した実例も事例記事として公開しています。「自社の開発・業務にAIをどう組み込むか」といったご相談を承っています。

AIニュースのまとめをメールで

毎週月曜、海外AIニュースの日次ダイジェストを1週間分まとめてお届けします。無料・いつでも配信を停止できます。

監修

河合 継(クリスタルメソッド株式会社 代表取締役)

AI・ディープラーニングに関する特許16件の発明者。過去、国立がん研究センターとの共同研究や、テレビ番組でのAI解説実績を持つAI研究者として、AIの研究開発を主導している。
運営会社について | 編集方針

Read next

あわせて読みたい

  • 対話・チャットLLMのイメージ

    Claude Codeのサブエージェントとは?仕組み・作り方・設定・使い方をわかりやすく解説【2026年版】

    Claude Codeのサブエージェントとは Claude Codeのサブエージェントとは、メインの会話から特定の作業を任される、専用の文脈(コンテキスト)を持...

  • Claude Code branch/fork・並行実行の使い分け完全ガイドのイメージ

    Claude Code の /fork とは?/branch・/subtask との違いと会話を分けて並行で進める方法【2026年10月】

    Claude Code の /fork は、今の会話をそのまま新しいバックグラウンドセッションへコピーし、自分は元の会話で作業を続けるためのコマンドです。コピー...

  • 対話・チャットLLMのイメージ

    Claude Code /batchの使い方|Message Batches APIとの違い・並列実行【2026年版】

    監修 河合 継(クリスタルメソッド株式会社 代表取締役) AI・ディープラーニングに関する特許16件の発明者。過去、国立がん研究センターとの共同研究や、テレビ番...

View more