この記事の検証について
当サイトはClaude CodeによるGitHub Actions連携やVPS常時稼働の検証記事を書いてきました。
今回はAgent Teamsの公式ドキュメントを読み込み、手元のClaude Code（v2.1.218）の実際の設定と突き合わせて整理しています。
Agent Teamsって聞いたことはあるけど、結局何ができるんだ…？
subagentと何が違うのか、正直よくわかっていない…
有効化したら、ノートPCが一生手放せなくなったりしないか…？
こんなお悩みを全て解決していきます。
先に結論から言うと、Agent Teamsは並行して探索・議論させたい調査やレビューに向いた実験的機能です。
有効化はsettings.jsonに1行足すだけ。ただし常時動かし続けたいなら話が変わります。
ノートPCのスリープや再起動が命取りになるので、素直にVPSに任せたほうが安全です。
理由はシンプル。公式ドキュメントに、セッションを閉じるとteammateも一緒に消え、/resumeしても復元されないとはっきり書かれているからです。
この記事でわかること
- Agent Teamsの仕組みとsubagentとの違い
- 実際に確認した有効化の手順
- 向いている作業・向いていない作業の見分け方
- 常時動かす場合にVPSを検討すべき理由
それでは順番に見ていきましょう。
結論だけ知りたい人は→常時稼働の選択肢（ABLENET VPS）を見る
Claude Code「Agent Teams」とは何か
Agent Teamsは、複数のClaude Codeセッションを協調させる実験的機能です。
1つのセッションが「リード」役になり、作業を割り振って結果をまとめます。
「チームメイト」はそれぞれ独立したコンテキストウィンドウを持つ、別のClaude Codeインスタンスです。
- チームリード
- 作業を割り振り、結果を統合するメインセッション
- チームメイト
- 独立したコンテキストで動く、別のClaude Codeインスタンス
- 共有タスクリスト
- pending/in progress/completedの3状態を持つ作業一覧
- メールボックス
- エージェント同士が直接メッセージを送り合う仕組み
構成要素はこの4つ。タスクは自動で依存関係も管理され、依存先が完了すると自動で解放されます。
Yuu「チームを作る」という設定操作はもう不要です。teammateをspawnした瞬間にチームが自動で立ち上がります◎
サブエージェントとの違い
Claude Codeには、以前から「サブエージェント」という並列実行の仕組みがあります。
混同しやすいのですが、連携のしかたが根本的に違います。
- 呼び出し元だけに結果を報告
- 会話履歴は引き継がない
- 単発の調査・検証向き
- メンバー同士が直接メッセージを送れる
- 共有タスクリストを自分で拾える
- 並行して議論させたい作業向き
サブエージェントは「投げて、結果だけ受け取る」一方通行の設計です。
対してAgent Teamsは、メンバー同士が直接会話し、共有タスクリストを自分で拾いに行きます。
フロントエンド担当のteammateが、バックエンド担当のteammateにAPI変更を直接伝える——といった連携ができるのはAgent Teamsだけです。
じゃあ常にAgent Teamsを使えばいいのかな…？
Yuuいえ、トークン消費がteammateの人数分そのまま増えます。単発の調査ならサブエージェントで十分です◎
有効化の手順（実機で確認済み）
手元のClaude Code（v2.1.218。要件のv2.1.178以上を満たす）で、下記のsettings.jsonを読み込ませてもエラーは出ませんでした。
--teammate-modeフラグはclaude --helpにも表示されず、公式ドキュメント通り「隠しフラグ」でした。
Agent Teamsはデフォルトで無効になっています。有効化にはこの1行を足すだけです。
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}あとは自然な言葉でお願いするだけ。特別なコマンドを覚える必要はありません。
このCLIツールにTODOコメントを横断で拾う機能を追加したい。UX担当・技術設計担当・あえて反対意見を出す担当の3人でteammateを立てて、それぞれの視点で検討して。リードの入力欄の下にある「エージェントパネル」に、teammateの名前と状態が並びます。
↑↓キーで選んでEnterを押すと、そのteammateの会話に直接入って追加の指示を出せます。
タスクによっては、Agent Teamsではなくサブエージェントが立ち上がることがあります。
両方とも同じエージェントパネルに表示されるため見分けにくく、確実にチームを作りたいときは「agent teamを作って」と明示するのが安全です。
有効化したはずなのに、teammateが全然増えないんだけど…
Yuu環境変数の綴りをもう一度確認してください。CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS、ここが1文字違うだけで無効化されます◎
向いている作業・向いていない作業
公式ドキュメントは「並行して探索する価値がある作業」を強みとして挙げています。
- 競合する仮説をぶつけ合う調査・デバッグ 5人のteammateにお互いの説を否定し合わせる、という使い方が公式の例として紹介されています
- PRレビューを観点別に分担 セキュリティ・パフォーマンス・テストカバレッジを別々のteammateに任せる
- 新機能を層ごとに分担 フロント・バック・テストをそれぞれ別ファイルで担当させる
- 同じファイルを複数人が編集する作業 上書き事故の原因になる。ファイル単位で担当を分ける設計が前提
- 手順が決まった順番どおりの作業 依存関係が多いと調整コストのほうが大きくなる
- ちょっとした修正1つだけ 通常セッションのほうが速く、トークンも節約できる
逆に言えば、「1人で完結する作業」にAgent Teamsを使うのは非効率です。
teammateが増えるほどコーディネーションのオーバーヘッドも増え、トークン消費は人数分そのまま積み上がります。
とりあえず5人くらい立てておけば早く終わるってこと？
Yuuいいえ、公式ガイドも「3〜5人から」を推奨しています。15の独立タスクなら、まず3人で回すのが妥当だそうです◎
常時稼働で気をつけたい制限
ここが今回、いちばん伝えたいポイントです。
Agent Teamsは実験的機能で、「動かしっぱなし」を前提にした設計ではありません。
公式ドキュメントが挙げる既知の限界
- セッションを閉じるとteammateも消え、/resumeしても復元されない
- タスク完了の反映が遅れ、依存タスクが止まることがある
- 1セッションにつきチームは1つだけ。他セッションと共有できない
- teammateは自分のteammateを持てない（入れ子不可）
特に1つ目が重要です。/resumeしてもteammateは戻ってきません。
つまり「再開できるから大丈夫」ではなく、そもそもセッションを切らないこと自体に意味がある、という話になります。
ノートPCがスリープしただけでもteammate消えちゃうんじゃないか…？
Yuuセッションのプロセスが止まればteammateも一緒に止まります。数十分の作業なら気にしなくて大丈夫ですが、数時間放置する使い方には向きません◎
ノートPCかVPSか、動かす場所の判断
判断軸はシンプルです。「セッションを切らずに動かし続けたいか」の一点だけ。
PRレビューや小さな調査を数十分だけ回すなら、手元のノートPCで十分です。追加費用もかかりません。
一方、複数teammateに長時間かけて並行タスクを進めさせたいなら話が変わります。
ノートPCを閉じられない・スリープさせられない状態が続くのは、現実的にはかなりのストレスです。
ここで選択肢になるのが、電源を落とさない前提で動くVPS（仮想専用サーバー）です。
長時間の並行タスクを止めたくないなら
Agent Teamsはセッションが生きている間しか動きません。スリープ・再起動を気にせず動かし続けたいなら、月額固定で常時起動できるVPSという選択肢があります。AI関連ツールの常時稼働用途を想定したプランもあります。
VPS上でもAgent Teams自体の制限（1セッション1チーム・入れ子不可）は変わりません。変わるのは「セッションを維持しやすいかどうか」だけです。
契約前に必ず公式サイトで最新のプラン・料金をご確認ください。
VPSって結局どれを選べばいいのかな…種類が多くて迷っちゃう…
YuuAI関連ツールの常時稼働を想定したプランがあるかどうかで選ぶと、スペック選びで迷いにくいです◎
ノートPCとVPSの比較
あらためて整理すると、判断材料は3つだけです。
- セッションを切らずに済むか
- ノートPCはスリープ・再起動で切れる。VPSは電源を落とさない前提で動く
- コスト
- ノートPCは追加費用なし。VPSは月額固定（プラン次第）
- 向いている使い方
- ノートPCは数十分の調査・レビュー。VPSは長時間の並行タスク
数十分で終わる作業にVPSは要りません。「切れると困るかどうか」だけで決めれば十分です。
結局、俺はどっちを選べばいいんだ？
Yuu数十分で終わる作業なら、迷わずノートPCのままで大丈夫です◎
導入前のチェックリスト
始める前に確認すること
0 / 5 完了
特に3つ目。いきなり5人・10人で走らせず、まずは3人以内の小さいタスクで様子を見るのが安全です。
よくある質問
- Agent Teamsは無料プランでも使えますか？
-
いいえ。公式ドキュメントによると、Pro・Max・Team・Enterpriseのいずれかのプランが必要です。
- teammateを立てたつもりが、subagentが動いています
-
Claudeがタスクの内容からサブエージェントを選ぶことがあります。確実にチームを組みたいときは「agent teamを作って」と明示的に頼んでください。
- teammateが増えすぎて収拾がつきません
-
公式ガイドは3〜5人からのスタートを推奨しています。1teammateあたり5〜6タスクを目安に、多すぎる場合はリードに作業を細分化させてください。
- VPSを使えばteammateが消えなくなりますか？
-
いいえ、セッションのプロセスを止めなければteammateも消えない、というだけです。
VPS自体がAgent Teamsの制限（1セッション1チームなど）を解消するわけではありません。
まとめ
Agent Teamsは、並行して探索・議論させたい作業のための実験的機能です。
有効化はsettings.jsonへの1行追記だけ。まずはPRレビューのような分担しやすい作業で試してみてください。
そして長時間・止めずに動かしたくなったら、ノートPCの電源事情を気にする前に、常時起動の環境を検討する番です。
Yuuまずは1つ、分担しやすい小さいタスクで試してみてください◎
Agent Teamsを止めずに動かすなら
月額固定で電源を気にせず動かせるVPS。AI関連ツールの常時稼働用途を想定したプランもあります。
- AI関連ツールの常時稼働を想定したプラン
- 月額固定で使った分を気にしなくてよい
- 稼働実績99.99%以上
※価格・プランは変更されることがあるため、契約前に必ず公式サイトで最新情報をご確認ください
※本記事にはアフィリエイトリンクを含みます。仕様や料金は変更されることがあるため、契約前に必ず公式サイトで最新情報をご確認ください。
※Agent Teamsは実験的機能のため、将来的に仕様が変わる可能性があります。
