エージェントチームは何をしてくれる機能?サブエージェントとの違い
リーダー1人とメンバーが共有タスクで動く仕組み
室谷代表取締役まず機能の輪郭からいきましょうか。エージェントチームはClaude Codeの機能の一つで、複数のインスタンスがチームとして連携する仕組みなんですよね。
1つのセッションがリーダーになって、タスクを割り振って結果を統合する。Claude Code自体がまだなら、Claude Codeとは?読み方・できること・使い方を完全解説【2026年最新】のほうが先に頭に入ると思います。
1つのセッションがリーダーになって、タスクを割り振って結果を統合する。Claude Code自体がまだなら、Claude Codeとは?読み方・できること・使い方を完全解説【2026年最新】のほうが先に頭に入ると思います。
テキトー教師DotAI 認定講師たしかに。1人の作業者に指示を出すんじゃなくて、小さなチームを組ませるイメージです。
メンバーはそれぞれ独立したコンテキストウィンドウを持っていて、リーダーを挟まずに互いに直接やり取りできるんですよ。
メンバーはそれぞれ独立したコンテキストウィンドウを持っていて、リーダーを挟まずに互いに直接やり取りできるんですよ。
室谷代表取締役そこが面白いところで。共有タスクリストがあって、メンバーが自分から次のタスクを取りに行ける。
中央で全部捌かなくていいわけです。
中央で全部捌かなくていいわけです。
テキトー教師DotAI 認定講師最初に戸惑うのが、リーダーがいるのにメンバー同士が喋る、という点なんですよね。単一セッションの発想とはかなり違います。
サブエージェントとの違いはコンテキスト・通信・調整の3点

室谷代表取締役で、よく混ざるのがサブエージェントとの違い。コンテキスト・通信・調整の3点で性格が変わるんですよね。
テキトー教師DotAI 認定講師並べるとこうです。
| 観点 | サブエージェント | エージェントチーム |
|---|---|---|
| コンテキスト | 独自を持つが結果は呼び出し元に返る | 完全に独立 |
| 通信 | 呼び出し元に結果を返す | メンバー同士が直接メッセージ |
| 調整 | メインエージェントが全作業を管理 | メッセージで自己調整+共有タスクリスト |
| 向く用途 | 結果だけ重要の集中タスク | 議論と協力が要る複雑な作業 |
| トークン | 低い(結果が要約される) | 高い(人数分のインスタンス) |
テキトー教師DotAI 認定講師現場感覚で言うと、サブエージェントは結果だけ返ってくればいい調査に向いていて、チームは途中で議論してほしい作業に向いている。この差が一番デカいんですよ。
室谷代表取締役経営目線で言うと、チームはメンバー人数分のClaudeインスタンスが走るので、原価がそのまま人数比例になるんですよね。結果だけ欲しいなら安い方で十分、という判断が要ります。
実験的機能なのでデフォルトは無効という前提
室谷代表取締役ただ、いまの話を聞いてすぐ使おうとはならないんですよ。2026年11月時点で実験的機能扱いで、デフォルトは無効。
明示的にオンにしないと動きません。
明示的にオンにしないと動きません。
テキトー教師DotAI 認定講師そうなんですよね。しかもチームメイトの生成にはインタラクティブセッションが必要で、-p の非インタラクティブモードだとチームメイトは生まれず、名前付きサブエージェントが普通のサブエージェントとして動くだけになります。
ここ、ハマる人多いんですよ。
ここ、ハマる人多いんですよ。
室谷代表取締役実験的というのは、仕様が動く前提で読むべきだということでもあります。実際の有効化の手順は次のセクションで見ますけど、変わるものとして扱うのが安全です。
テキトー教師DotAI 認定講師まず単一セッションで足りないかを一度考えてから、ってことですね。
使うための設定:settings.jsonと環境変数で有効にする
実験フラグは settings.json の env に1行
エージェントチームは既定では無効なので、まず有効化のスイッチを入れます。手順はこの通りです。
~/.claude/settings.jsonを開くenvの中にCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSを"1"で追加する- 保存する(実行中のセッションにも再適用されるので、立ち上げ直しは不要)
- 環境変数で切り替えたい場合は、シェル側で同じ名前の変数を
1に設定する。オフに戻すときは"0"
json
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
室谷代表取締役設定自体は1行なんですよね。ここでつまずく人、わりといるんじゃないですか。
テキトー教師DotAI 認定講師現場でよく聞くのは、どこに書くか迷うパターンです。
env の中に入れる、というのが最初の壁になりますね。
室谷代表取締役保存すれば今のセッションに効くのも地味にありがたい。設定をいじるたびに開き直すの、正直めんどくさいんですよ。
テキトー教師DotAI 認定講師最初に投げるならこのプロンプト
室谷代表取締役最初からコードを書かせるのは避けたほうがよくて。公式が例に挙げているのは、調査とレビューと仮説の反証なんですよね。
テキトー教師DotAI 認定講師たしかに。いきなり実装を任せるより、読むだけの仕事から入ったほうが安全です。
具体的にはこうです。
具体的にはこうです。
- 調査:3つの視点(UX/技術アーキテクチャ/悪魔の代弁者)から探索する3人のチームメイトをスポーンして
- 並列レビュー:PR #142 を3人のチームメイトでレビュー(セキュリティ/パフォーマンス/テストカバレッジ)
- 仮説の反証:5人のチームメイトに異なる仮説を調査させ、科学的議論のように互いの理論を反証させる
室谷代表取締役レビューを観点ごとに分けるのは分かりやすい。同じファイルを触らないので、待ち時間だけ減って質は落ちない。
テキトー教師DotAI 認定講師反証役を混ぜるのが面白いところで。1人で考えてると自分の案に寄っていくんですよ、これが。
非インタラクティブモードではチームが組まれない
テキトー教師DotAI 認定講師ここは先に知っておきたいところで。
-p を付けた非インタラクティブ実行だと、チームメイトは生成されないんですよね。
室谷代表取締役なるほど、自動実行の側に流したときはチームにならない、と。仕組みに組み込む前に知っておきたい話です。
テキトー教師DotAI 認定講師その場合、名前付きのサブエージェントは普通のサブエージェントとして動きます。Agent SDK のセッションも同じ扱いです。
室谷代表取締役チームの体験をそのまま自動化に持っていける前提で組むと、そこでズレる。最初は手元の対話セッションで試す、という順番が安全なんですよね。
どんな作業で効くのか、単一セッションのほうがいいのはどんな時か
調査・レビュー・機能追加は、分けた瞬間に効く
室谷代表取締役公式が「効果的」と挙げてる場面が4つあって。調査とレビュー、新しいモジュールや機能の追加、競合する仮説でのデバッグ、それからフロント・バック・テストみたいなレイヤーまたぎなんですよね。
要は独立して進められる仕事です。
要は独立して進められる仕事です。
テキトー教師DotAI 認定講師現場感覚で言うと、調査系は分けた瞬間に効きますね。3つの視点から調べて、って頼むと、片方が見落とした前提を別の子が拾ってくるんですよ。
相互検証が自然に起きるのが大きいです。
相互検証が自然に起きるのが大きいです。
室谷代表取締役これ、経営目線で言うと「見落としのコスト」が下がるのが本体なんですよ。レビューをセキュリティ・パフォーマンス・テストカバレッジで分ければ、人間が1周で見切れない観点を同時に潰せる。
テキトー教師DotAI 認定講師競合仮説のデバッグも面白くて。5人に違う仮説を持たせて互いに反証させる、という使い方が公式に出てます。
1人で延々悩むより収束が早いんですよ。
1人で延々悩むより収束が早いんですよ。
順番が決まってる作業は、1人でやったほうが早い
テキトー教師DotAI 認定講師逆に、順序付きのタスクとか、同じファイルを編集する作業は単一セッションのほうが効果的なんですよ。依存関係が多いと、調整のオーバーヘッドで足を引っ張り合う感じになります。
室谷代表取締役チームにすると「誰が何を先にやるか」の合意コストが乗るんですよね。並列化できる度合いが低い仕事ほど、そのコストだけ残る。
テキトー教師DotAI 認定講師たしかに。前の工程が終わらないと次が動かない作業を任せると、待ち時間だけ増えて、サブエージェントで十分だったなという結論になりがちです。
3〜5人から、1人5〜6タスク、ファイルは分ける
室谷代表取締役規模はどう置くのが現実的なんです?
テキトー教師DotAI 認定講師公式だと、ほとんどのワークフローは3〜5人で始めるのが推奨で。独立したタスクが15個あるなら3人がいい出発点、1人あたり5〜6個が目安と書かれてます。
最初はコードを書かない調査・レビューから入るのが安全です。
最初はコードを書かない調査・レビューから入るのが安全です。
室谷代表取締役ファイルは分ける、と。同じファイルに複数人が触ると、せっかくの並列が衝突で消えるんですよね。
MYUUU でも担当範囲を切ってから回すようにしてます。
MYUUU でも担当範囲を切ってから回すようにしてます。
テキトー教師DotAI 認定講師初めて触る人は、いきなり大きいタスクを投げがちなんですよ。小さめに割って、まず1人が1ファイル、を守るだけで体感が変わります。
トークン代はどこまで増える?モデル指定で費用を抑える方法
アクティブなメンバー数に比例して増える仕組みとキャッシュの扱い
室谷代表取締役まず素朴な疑問として、チームを組むとトークン代はどこまで膨らむのか。公式には「アクティブなメンバー数に比例して増える」と書かれていて、要は人数分の処理が並走するイメージなんですよね。
テキトー教師DotAI 認定講師現場感覚でもそこが一番怖いところで。3人動かせばその分だけ消費が寄っていくので、最初は「思ったより減らないな」と感じる人が多いんですよ。
室谷代表取締役しかもキャッシュの扱いが独特で。in-processのチームメイトのリクエストは、メイン会話のキャッシュTTLのバケット対象外なんですよ。
Claudeのサブスクリプション利用時も既定は5分保持で、1時間に延ばしたいなら subagentPromptCacheTtl を 1h に設定する必要がある。
Claudeのサブスクリプション利用時も既定は5分保持で、1時間に延ばしたいなら subagentPromptCacheTtl を 1h に設定する必要がある。
テキトー教師DotAI 認定講師そこ、ハマる人多いんですよ。長めの調査を投げて戻ってきたら、思ったほど効いてない、みたいな。
時間のかかる作業ほどキャッシュの設定を見直したほうがいいですね。
時間のかかる作業ほどキャッシュの設定を見直したほうがいいですね。
メンバーのモデルはどこで決まるか(優先順位と一括固定)
メンバーのモデル決定優先順位
- 01スポーンのプロンプトで指定したモデル最優先
- 02サブエージェント定義のmodelinheritならリーダーのモデル
- 03CLAUDE_CODE_SUBAGENT_MODEL環境変数での指定
- 04リーダーの現在のモデル何も指定しない場合の最終フォールバック
室谷代表取締役で、メンバーがどのモデルで動くかは優先順位が決まっていて。スポーンのプロンプトで指定したモデルが最優先、次がサブエージェント定義のmodel、inheritならリーダーのモデル。
その次が CLAUDE_CODE_SUBAGENT_MODEL で、最後にリーダーの現在のモデル。
その次が CLAUDE_CODE_SUBAGENT_MODEL で、最後にリーダーの現在のモデル。
テキトー教師DotAI 認定講師つまり何も指定しないと、気づかないうちに全員がリーダーと同じ重いモデルで走ってる可能性があると。
室谷代表取締役そうなんですよ。全チームメイトを1つのモデルに固定したいなら、CLAUDE_CODE_SUBAGENT_MODEL と CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 を両方設定する。
これで一括で揃うので、コストの上限が見積もりやすくなるんですよね。
これで一括で揃うので、コストの上限が見積もりやすくなるんですよね。
テキトー教師DotAI 認定講師予算を先に決めてからチームを組む、という順番が大事ですね。
組み込みのExploreをhaikuにして普段の調査を安くする
室谷代表取締役もう一個、地味に効くのが組み込みのExplore。既定では親の会話と同じモデルで動くので、調査のたびに重いモデルが動いてる状態になりうる。
テキトー教師DotAI 認定講師調査って回数が多いじゃないですか。一回一回は軽くても、積み上がると効いてくるんですよね。
室谷代表取締役そこでExploreをユーザー側かプロジェクト側で再定義して、model に haiku を指定しておく。普段の下調べはそれで足りることが多いので、ここは素直に落としたほうがいい。
テキトー教師DotAI 認定講師高いモデルは「ここぞ」に取っておく、という配分ができるわけですね。
日常タスクは単一セッション、重い調査だけチームに寄せる
室谷代表取締役結局、全部をチームに寄せると費用対効果が崩れるんですよ。公式にも、日常的なタスクは単一セッションのほうが費用対効果が高いと書かれていて。
テキトー教師DotAI 認定講師実感としても、ちょっとした修正をチームに投げると、調整のやり取りだけで終わることがありますからね。
室谷代表取締役MYUUUだと、重い調査やレビューみたいに「並列で走らせた分だけ価値が出る」作業にだけ予算を寄せて、日常は単一で回す。時給で換算すると、その切り分けができてるかどうかがそのまま効いてくるんですよね。
テキトー教師DotAI 認定講師人数を増やすこと自体が目的にならないように、というところですね。
表示の切り替え:in-processと分割ペイン、並列開発の組み方
in-processはどのターミナルでも動き、パネルで切り替える
室谷代表取締役まず試すなら in-process から、という話なんですけど。全チームメイトがメインのターミナル内で動くので、どのターミナルでも動くんですよね。
環境を選ばないのは導入の敷居として大きいです。
環境を選ばないのは導入の敷居として大きいです。
テキトー教師DotAI 認定講師現場でよく聞くのが「メンバーが見当たらない」なんですよ。in-process だとエージェントパネルを上下キーで選んで Enter で表示を切り替えるので、そこさえ押さえれば解決します。
室谷代表取締役あ、パネルを開かないと気づけないやつですね。
テキトー教師DotAI 認定講師そうなんです。アイドル状態の行は全体がアイドルになってから30秒で非表示になります。
次のターンでまた出てくるので、消えたからといって止まったわけじゃないです。
次のターンでまた出てくるので、消えたからといって止まったわけじゃないです。
分割ペインはtmuxかiTerm2が前提(it2 CLIとPython APIの準備)
in-process と 分割ペインの比較
in-process
- 全チームメイトがメインのターミナル内で動く
- どのターミナルでも動く(環境を選ばない)
- エージェントパネルを上下キーで選び Enter で表示切替
- アイドル行は全体がアイドルになってから30秒で非表示(次ターンで再表示)
分割ペイン
- メンバーごとに専用ペインが割り当てられる
- tmux か iTerm2 が前提
- iTerm2 は it2 CLI 導入+Python API 有効化が必要
- tmux は which tmux で導入確認
- tmux をインストールする(
which tmuxで入っているか確認できる) - iTerm2 を使う場合は it2 CLI を導入する
- iTerm2 の設定で Python API を有効にする(設定画面の場所は公式ヘルプで確認を)
- その上でチームを起動すると、メンバーごとに専用ペインが割り当てられる
室谷代表取締役各メンバーが自分のペインを持つと、並列で走ってる感じが一気に見えるんですよね。ただ tmux か iTerm2 が前提になる。
ここで止まる人が多そうだなと。
ここで止まる人が多そうだなと。
テキトー教師DotAI 認定講師最初に戸惑うのがまさにそこで、iTerm2 の場合は it2 CLI を入れて、さらに Python API を有効にしないと分割ペインにならないんですよ。tmux 側は入っているかをコマンドで確認するところからですね。
室谷代表取締役ターミナル側の下準備が要る、と。プロダクト側で吸収しきれてない部分がまだ残ってるんですね。
teammateModeをautoにすると環境で自動的に切り替わる
テキトー教師DotAI 認定講師毎回モードを考えるのが面倒なら、
~/.claude/settings.json に teammateMode を "auto" で入れておく手があります。tmux か iTerm2 の中なら分割ペイン、それ以外は in-process に自動で切り替わります。
室谷代表取締役それはいいですね。環境ごとに人が判断しなくていいのは運用が楽なんですよ。
チームで配る設定ファイルに一行入れておけば揃うわけですし。
チームで配る設定ファイルに一行入れておけば揃うわけですし。
テキトー教師DotAI 認定講師単発で試したいときは
--teammate-mode auto をセッション起動時に付けることもできます。ただ実験的な扱いのオプションで、ヘルプには表示されないので、そこは留意しておいたほうがいいです。git worktreeで作業ディレクトリを分けて衝突を避ける
室谷代表取締役並列で書かせると必ずぶつかるのがファイルなんですよね。各メンバーに別々のファイルセットを担当させるのが推奨ではあるんですけど、同じリポジトリで動いてると境目が曖昧になりがちで。
テキトー教師DotAI 認定講師そこは git worktree で作業ディレクトリを分けるのが相性いいです。メンバーごとに別ディレクトリを持たせれば、同じファイルを取り合わなくて済みます。
公式に手順として書かれている話ではないので、あくまで運用の工夫としてですけど。
公式に手順として書かれている話ではないので、あくまで運用の工夫としてですけど。
室谷代表取締役ディレクトリが分かれてると、レビューも「この変更はこの担当」って追いやすい。時給で換算すると、衝突の解消に消える時間が一番もったいないので、先に潰しておくのは投資として安いんですよ。
テキトー教師DotAI 認定講師たしかに。まずは分けずに少人数で回して、ぶつかり始めたら worktree を切る、くらいの順番でも間に合うと思います。
既存のサブエージェント定義をチームメイトとして使い回す
security-reviewerやtest-runnerを指名してスポーンする
室谷代表取締役役割の定義を毎回プロンプトで書き直すの、正直いちばん無駄なんですよね。project とか user スコープで作ったサブエージェント定義って、チームメイトの型としてそのまま指名できるんですよ。
テキトー教師DotAI 認定講師そこ、気づかないまま毎回ゼロから書いてる人が多いんですよね。security-reviewer を型に指定して認証まわりを監査させる、みたいな形で使えます。
室谷代表取締役頼み方も普通の文でよくて、「security-reviewer のエージェントタイプでチームメイトをスポーンして、auth モジュールを監査して」みたいな感じです。plugin スコープの定義も同じように型として使えます。
テキトー教師DotAI 認定講師現場でよく聞くのは、test-runner を型にしておくと「テスト回す係」の指示が毎回ブレない、という声です。定義が1か所に集約されるのが効くんですよね。
引き継がれる設定と、表示モードで変わる設定
チームメイト定義の再利用:引き継がれる設定と表示モードで変わる設定
定義側から引き継がれる設定
- tools
- model
- disallowedTools
- effort
- autoCompactWindow
表示モードで挙動が変わる設定
- skills
- mcpServers
- 本文:in-processは追記/分割ペインはデフォルトのシステムプロンプトを置き換え
- in-processではSendMessageやTask系ツールが追加される
室谷代表取締役で、どこまで引き継がれるかが地味に重要で。tools、model、disallowedTools、effort、それから autoCompactWindow までは定義側から効きます。
テキトー教師DotAI 認定講師逆に skills と mcpServers は表示モードで挙動が変わるんですよ。ここ、初めて触る人がだいぶ戸惑うところで。
室谷代表取締役本文の扱いも違って、in-process なら追記、分割ペインだと本文がデフォルトのシステムプロンプトを置き換える。同じ定義でも振る舞いが変わるわけです。
テキトー教師DotAI 認定講師だから「ペイン表示に切り替えたら急に口調が変わった」みたいなことが起きるんです。ツールも in-process だと SendMessage や Task 系が足されるので、同じ定義でも前提が違うと思っておいた方がいいです。
TeammateIdle・TaskCreated・TaskCompletedで作業ルールを強制する
室谷代表取締役定義の再利用は便利なんですけど、抜けやすい確認って人力だとどうしても漏れるんですよ。ここは hooks で機械的に止めるのが運用として強い。
テキトー教師DotAI 認定講師hooks は3つで、終了コード2を返すと止められる、という動きが肝ですね。
- TeammateIdle:アイドル化しようとした時に実行。終了コード2でフィードバックして稼働を続けさせる
- TaskCreated:タスク作成時に実行。終了コード2で作成を阻止
- TaskCompleted:タスク完了時に実行。終了コード2で完了を阻止
室谷代表取締役たとえば「レビュー観点が埋まっていないタスクは完了させない」みたいなゲートを置ける。定義文を毎回書き直す工数より、ゲートを1個置くほうが安く済むんですよね。
テキトー教師DotAI 認定講師そうなんですよね。ルールを文章でお願いするんじゃなくて、通らないと先に進めない形にする。
そこがチーム運用の分かれ目なんだと思います。
そこがチーム運用の分かれ目なんだと思います。
権限・セキュリティと、いま分かっている制限事項
権限モードはリーダーに引きずられる
室谷代表取締役権限まわり、地味に怖いところなんですよね。in-processのチームメイトって、リーダーの現在の権限ルールの下で動くんですよ。
テキトー教師DotAI 認定講師たしかに。リーダーがacceptEditsやauto、bypassPermissionsのモードになっていると、メンバーも同じモードで動いちゃうんですよね。
室谷代表取締役チームメイトごとの権限モードはスポーン時に指定できなくて、常にリーダーのモードで開始する。ROIで考えると、レビュー専任のメンバーだけ厳しめに、みたいな設計ができないわけです。
テキトー教師DotAI 認定講師現場でよく聞くのは「メンバー側だけ権限を絞りたい」なんですけど、今はリーダーを緩めない運用が基本になりますね。
エージェント間メッセージにかかる2つのチェック
室谷代表取締役メンバー同士が直接やり取りするわけですから、メッセージの安全性はどうなってるんです?
テキトー教師DotAI 認定講師自動分類器による2段のチェックがあります。1つは、他エージェントから中継された「承認済み」という主張を、ユーザー確認ではなく信頼できない入力として扱うことです。
室谷代表取締役なるほど、承認の伝言ゲームは信じない、と。
テキトー教師DotAI 認定講師もう1つが配信前の内容確認です。プレーンメッセージでも、シャットダウン要求やプラン承認応答のような構造化メッセージでも、ブロックされたものは受信者に届きません。
セッション再開で復元されない、1セッション1チーム、ネスト不可などの制限
いま分かっている制限事項
セッション再開で復元されない
in-processのチームメイトはセッションの再開や巻き戻しでは復元されない
1セッション1チーム
1セッションにつき正確に1チームだけ
チームメイトはチームをスポーン不可
チームメイト自身がチームを作ることはできない
リーダーの交代・昇格は不可
リーダーの交代や昇格ができない
タスク状態の更新が遅れることがある
タスク状態の更新タイミングが遅延する場合がある
シャットダウンに時間がかかる
現在のリクエストやツール呼び出しが終わってから実行されるため
サブエージェントはフォアグラウンドのみ
チームメイト自身のサブエージェントはフォアグラウンド実行のみ
室谷代表取締役制限事項、ここでまとめておきますか。
テキトー教師DotAI 認定講師まずin-processのチームメイトは、セッションの再開や巻き戻しでは復元されません。ここ、ハマる人多いんですよ。
セッション管理の細かい話はClaude Codeのセッション完全ガイドにまとまってます。
セッション管理の細かい話はClaude Codeのセッション完全ガイドにまとまってます。
室谷代表取締役再開したつもりでメンバーがいない、という事故ですね。加えて1セッションにつき正確に1チームだけ、チームメイト自身はチームをスポーンできない、リーダーの交代や昇格も不可、と。
テキトー教師DotAI 認定講師あとはタスク状態の更新が遅れることがある、シャットダウンは現在のリクエストやツール呼び出しが終わってからなので時間がかかる、チームメイト自身のサブエージェントはフォアグラウンド実行のみ、というあたりも頭に入れておきたいです。
メンバーが見えない・動かないときの確認手順
まず表示まわりで確認する順番はこんな感じです。
- in-processの場合、エージェントパネルで上下キーを押してメンバーを選び、Enterで表示を確認する
- アイドル行は全体がアイドル化してから30秒後に非表示になる(次のターンで再表示される)
- 分割ペインを指定した場合は
which tmuxでtmuxが入っているか確認する - 孤立したtmuxセッションが残っている場合は
tmux lsで一覧を見て、tmux kill-session -t <session-name>で終了する
室谷代表取締役あと、タスクが単純すぎるとClaudeがそもそもチームを組まないこともあるんですよね。
テキトー教師DotAI 認定講師あります。権限プロンプトが多いなら事前承認を設定しておく。
分割ペインはtmuxかiTerm2が必須なので、そこが無いとそもそも表示されません。
分割ペインはtmuxかiTerm2が必須なので、そこが無いとそもそも表示されません。
室谷代表取締役実験的機能ですから、前提を理解してから回すのが結局いちばん安いんですよ。事故で止まる時間を時給で数えると、そのほうが高くつくので。
よくある質問
Q1. チームメイト同士が同じファイルを触ってケンカしたらどうなる?
室谷代表取締役そこはぶつかる前提で組むのがいいんですよね。同じファイルを2人に触らせると、後から書いた方が上書きするので・・・
テキトー教師DotAI 認定講師現場でよく聞くのが「並列にしたら差分がぐちゃぐちゃになった」なんですよ。ファイルの担当を分ける、みたいな地味な対策が結局いちばん効きます。
室谷代表取締役衝突したら人間が仲裁する運用にしてます。マージまで自動でやらせると、壊れたときに原因を追うのがしんどいので。
Q2. チームの設定はリポジトリに入れて共有していい?
テキトー教師DotAI 認定講師ここ、最初に戸惑うのが「設定ファイルを Git に上げるべきか」問題なんですよね。
室谷代表取締役プロジェクト単位で構成を揃えたいなら共有したいところですけど、環境変数のほうに個人のマシン事情が混ざるので、分けて管理するのが無難ですかね。
テキトー教師DotAI 認定講師そうなんですよね。プロジェクトに効く設定と、その人だけの設定を分けておくと事故が減ります。
Q3. 暴走が心配です。動いているチームを止めるには?
室谷代表取締役これ、導入時に必ず聞かれるんですけど、止め方と権限の絞り方を先に決めておくのが鉄板で。
テキトー教師DotAI 認定講師初めて触る人は、止め方より先に「どこまで勝手にやっていいか」を決めておくと安心です。権限を絞るほど速度は落ちるので、そこはトレードオフですね。
室谷代表取締役止める手間より、勝手に本番系を触らないことのほうが大事で。そこだけは最初に握っておくべきなんですよ。
Q4. チームメイトには日本語で指示していい?
テキトー教師DotAI 認定講師はい、普通に日本語で大丈夫です。ただ指示が曖昧だと、チーム全員が同じ勘違いを並列でやらかすので。
室谷代表取締役一人に伝えるより、明確に書くコストが上がるんですよね。ここは手間を惜しまないほうが結果的に速い。
テキトー教師DotAI 認定講師現場感覚で言うと、指示書を1枚作っておくと、その後のターンが全部軽くなります。
Q5. 他のコーディングエージェントのツールと何が違う?
室谷代表取締役単体で速く書く系のツールとは、軸が違うんですよね。速さで選ぶというより、作業を分けられるかで選ぶ感じで。
テキトー教師DotAI 認定講師たしかに。1人で全部やったほうが速い場面は今もありますし、乗り換えというより「並列にできる仕事が増えた」くらいの捉え方が近いです。
室谷代表取締役ただ挙動はアップデートで変わるので、比較するときは公式の最新情報を見たほうがいいです。
まとめ
室谷代表取締役結局、エージェントチームは速く書くための機能というより、仕事を分けて並べるための機能なんですよ。だから先に決めるのは設定じゃなくて、分け方と権限なんですよね。
テキトー教師DotAI 認定講師現場でも、いきなり全部並列にするより、1つの作業を2人に分けるところから始めたほうがうまくいきます。分割ペインで様子を見るのがちょうどいい入口です。
室谷代表取締役MYUUU だと、まず狭い作業をチームに投げて、時給換算でペイするかを見る感じで。ペイしないなら単一セッションに戻せばいい。
テキトー教師DotAI 認定講師小さく試して、残った疑問は公式の最新情報で埋める。その順番が一番はやいですね。
