Agent Teamsのコスト管理 — トークン消費を抑える設定

Agent Teamsを有効にすると何が変わるか

Agent Teamsは、複数のClaude Codeインスタンスを同時に起動する仕組みです。それぞれのチームメイトが独立したコンテキストウィンドウを持ち、並行して作業を進めます。1人のセッションが1本の会話履歴を積み上げるのに対し、Agent Teamsは人数分の会話履歴を同時に積み上げるため、トークン消費のペースが変わります。契約形態別の上限設定など基本的なコスト管理はClaude Codeのコスト管理で扱っているので、ここではAgent Teams特有の増分に絞って見ていきます。

Agent Teamsは既定では無効です。settings.jsonか環境変数でCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1を設定すると有効になります。

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Agent Teamsのトークン消費が跳ね上がる理由

チームメイトは、それぞれが個別のClaude Codeインスタンスとして起動し、フルのコンテキストウィンドウを1つずつ持ちます。planモードのチームメイトは標準的なセッションのおよそ7倍のトークンを消費します。これは要約だけを親に返すサブエージェントとは異なる設計です。

サブエージェントは、ログ処理やドキュメント調査のような雑多な作業を別のコンテキストウィンドウに逃がし、要約だけを親の会話へ返します。冗長な出力はサブエージェント側に留まり、親の会話には戻りません。Agent Teamsのチームメイトはこの隔離を持たず、フル機能のインスタンスとして稼働し続けます。だからこそ人数分のコストが直接乗ります。

トークン使用量は、チームメイトの人数と稼働時間にほぼ比例します。エンタープライズ導入全体の平均は開発者1人あたり1稼働日あたり約13ドル、月150〜250ドルとされていますが、この数字は通常セッションの目安であり、Agent Teamsを常用するチームはここに人数分の上乗せを見込む必要があります。

稼働中のチームメイトは、exitするまでトークンを消費し続けます。これはアイドル時でもバックグラウンドの消費要因になるため、シート利用枠はメンバーごとにリセットされる契約であっても、チームメイトを立てっぱなしにしている時間そのものがコストに直結します。

コストを左右する4つの要因

チームの人数は、最も影響が直接的な要因です。1つのタスクを3人のチームメイトに分けると、そのままコンテキストウィンドウを3つ同時に消費する計算になります。タスクを細かく分割しすぎず、本当に並行させる価値がある単位でチームを組むと、無駄な人数分の消費を避けられます。

起動プロンプトの中身は見落とされがちです。チームメイトはCLAUDE.md・MCPサーバー・スキルを起動時に自動で読み込みます。そのうえで起動プロンプトに書いた内容がすべて、起動直後からコンテキストに積み上がります。背景説明を長く書くほど、チームメイト1人あたりの初期コストが膨らみます。手順の詳細よりも、担当範囲と完了条件だけを渡す方が軽く済みます。

協調作業はSonnetを既定にする

複雑なアーキテクチャ判断や多段階の推論が必要な場面だけOpusに切り替えると、チーム全体の単価を抑えられます。それ以外の調整役の役目はSonnetで十分間に合います。チームメイトごとにモデルを指定できるため、レビュー担当や実装担当のような比較的定型的な役回りはSonnetに固定し、設計判断を担う1人だけOpusに切り替える、という編成も選べます。全員を同じモデルに揃える必要はありません。

使い終えたチームメイトを終了させる

終了忘れの影響は人数分だけ増幅されます。1人のセッションを閉じ忘れた場合の無駄は1人分ですが、3人チームを閉じ忘れると3人分の待機コストが同時に積み上がります。長時間チームを走らせたまま放置せず、完了したメンバーから早めに終了させます。タスクの完了条件をあらかじめ起動プロンプトに明記しておくと、チームメイト自身が「ここで終わり」と判断しやすくなり、終了の判断を人手で追いかける手間も減ります。

セッション全体の消費が膨らむ他の要因も点検する

Agent Teamsだけが原因とは限りません。長時間開いたセッションでは、待機中のスケジュールタスクが間隔ごとにフルコンテキストを送ります。他セッションからのクロスセッションメッセージがアイドル中に配信されたり、バックグラウンドで進む作業を待っているGoal(目標管理機能)へのチェックインが挟まったりする分も、消費を押し上げます。チームメイトの消費が疑わしいときは、こうしたバックグラウンドで動く要因も同時に点検すると切り分けが早くなります。

/usageでAgent Teamsのコストを確認する

Pro・Max・Team・Enterpriseのプランでは、/usageのプラン利用状況にAttribution欄が表示されます。スキル・サブエージェント・プラグイン・個別のMCPサーバーごとの使用割合を示す欄です。稼働中のチームメイトはexitするまでトークンを消費し続けるため、その分は/usageのプラン利用状況全体の増分として現れます。

チームメイトごとの消費をリアルタイムに追いたい場合は、Claude CodeのOpenTelemetryで利用量とコストを可視化する方法が使えます。ユーザー単位・モデル単位の内訳を自前の基盤に流し込めます。

チームメイトが長時間アイドルになると、プロンプトキャッシュが失効し、次のリクエストで全体の再処理が発生します。キャッシュの有効期間や再処理の仕組みは、Anthropic APIのPrompt Cachingを理解するにまとめています。

Team・Enterpriseのシート利用枠は、5時間のローリングウィンドウと週次ウィンドウでリセットされます。重いAgent Teamsの実行で枠を使い切っても、時間が経てば枠は回復するため、大規模なチーム実行は枠のリセット直後に寄せると余裕を持って進められます。

Agent Teamsはコンテキスト分離をチーム運営に広げた発想

サブエージェントは、細かいやり取りを表に出さず「隔離してコストを抑える」設計です。要約だけが親の会話に戻り、冗長な出力はサブエージェント側に留まります。Agent Teamsはこの発想を、複数人が同時に動く協調作業まで広げたものです。

ただし方向性は逆です。サブエージェントが隔離で消費を絞り込むのに対し、Agent Teamsは並行させて速度を稼ぐ設計であり、コストは人数分そのまま乗ります。速度と引き換えにコストが増える点は、導入前に見積もっておきましょう。

タスクが本当に並行を必要としているか、順番にこなしても十分間に合うかを先に切り分けると、Agent Teamsを使う場面と、通常のセッションやサブエージェントで済ませる場面をはっきり区別できます。

よくある質問

Agent Teamsとサブエージェント(Task tool)は何が違いますか

サブエージェントは1回の呼び出しで作業が完結し、要約だけを親の会話に返します。Agent Teamsのチームメイトはフル機能のインスタンスとして起動し、明示的に終了させるかセッションが終わるまで稼働し続けます。稼働時間が長引きやすい点が、コスト管理のうえで最大の違いです。

MCPサーバーを多く登録していると、Agent Teamsのコストはどう変わりますか

チームメイト1人ごとに、同じMCPサーバー一覧が起動時に読み込まれます。サーバー数が多い環境ほど、人数分のコストが積み重なります。普段からMCPサーバーを整理しておくと、Agent Teams導入時の増分を抑えられます。

Agent Teamsのコストはどのくらい増えますか

チームメイトがplanモードで動作する場合、標準的なセッションのおよそ7倍のトークンを消費します。人数を絞り、上の要因表に沿って運用すれば増分は見積もりやすくなります。

Agent Teamsをオフにすると、通常の課金に戻りますか

環境変数を外すか、settings.jsonからCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSの設定を削除すれば、既定の無効状態に戻り、通常のセッション課金に戻ります。

Agent Teamsの利用枠を使い切った場合、いつ回復しますか

Team・Enterpriseのシート利用枠は5時間のローリングウィンドウと週次ウィンドウでリセットされます。API従量やクラウドプロバイダー経由の契約では、利用枠という概念自体がなく、消費した分がそのまま請求に反映されます。

まとめ

Agent Teamsは、複数のフル機能インスタンスを並行稼働させる分、通常のセッションよりトークンを多く使う設計です。人数を絞り、起動プロンプトを軽くし、協調作業にはSonnetを既定にし、使い終えたら終了させる。この4点を運用ルールに落とし込めば、コストの見通しが立てやすくなります。

導入したての段階では、まず1〜2人の小さなチームで試し、/usageのプラン利用状況で実際の増分を確認してから、チーム規模を広げていくと見積もりの精度が上がります。

チーム全体のコスト可視化や契約形態別の上限設定はClaude Codeのコスト管理にまとめています。Agent Teamsの表示切り替えやtmux連携はteammateModeでAgent Teamsの表示方法を切り替えるを参照してください。