Cursor Subagentとは？なぜ今注目されているのか
独立したコンテキスト
親エージェントから独立したコンテキストウィンドウを持ち、メイン会話を圧迫しない
並列実行可能
複数のサブエージェントを同時に実行し、処理時間を短縮
デフォルトサブエージェント
Explore（コード探索）、Bash（シェル）、Browser（ブラウザ）を標準搭載
コスト効率
重い処理をサブに任せ、親は意思決定に集中。トークン消費も抑制
サブエージェントの仕組み：親エージェントから独立したAIアシスタント
室谷代表取締役Cursor の Subagent、要はエージェントがエージェントを呼べる仕組みですね。親エージェントがタスクを分解して、サブエージェントに任せる。
テキトー教師.AI認定講師そうです。それぞれ独立したコンテキストウィンドウを持つので、メインの会話を圧迫しない。
あたかもチームメンバーに仕事を振る感覚に近い。
あたかもチームメンバーに仕事を振る感覚に近い。
室谷代表取締役この設計、コスト効率の面でも理にかなってる。重い処理をサブに投げて、親は意思決定に集中できる。
テキトー教師.AI認定講師最初に戸惑うのが「サブエージェントは履歴を引き継がない」ところですが、それがむしろ良いんです。親が要約して渡す形になります。
コンテキスト分離と並列実行で得られるメリット
室谷代表取締役並列実行が地味に効く。複数のサブエージェントを同時に走らせて、それぞれ別のコードベースを探索させられる。
テキトー教師.AI認定講師従来は逐次的にやっていた処理が、一気に片付く。時間が半分以下になるケースも。
室谷代表取締役あと、コンテキスト分離のおかげで、トークン消費も抑えられる。特に Explore は高速モデルを使って並列検索するので、単体でやるよりコストが下がる。
テキトー教師.AI認定講師その恩恵は初めて触る人でも実感しやすい。普通に使ってるだけで自動的に効率化される。
Cursor 2.4で導入されたデフォルトのサブエージェント（Explore/Bash/Browser）
室谷代表取締役Cursor 2.4 でデフォルトで3つ組み込まれた。コードベース探索の Explore、シェルコマンド実行の Bash、ブラウザ操作の Browser。
テキトー教師.AI認定講師それぞれ、中間出力がノイジーになりやすい処理ですよね。サブエージェント化することで親コンテキストをクリーンに保つ。
室谷代表取締役特に Bash はコマンドのログが長くなりがち。あれを親のコンテキストで処理するとすぐ上限に達する。
サブに分離するのは自然な判断。
サブに分離するのは自然な判断。
テキトー教師.AI認定講師現場でよく聞くのは「勝手に動いてるのが怖い」という声ですが、慣れると手放せなくなります。
Cursor Subagentとスキル（Skill）の違いは？似た機能との住み分け
| 特徴 | Rules | Commands | Skills | Subagents |
|---|---|---|---|---|
| 本質 | 常時適用の行動指針 | ユーザーが意図的に呼び出すショートカット | Agent自身がタスクに応じて選ぶ手順書 | 子Agentに丸投げする実行ユニット |
| 起動方法 | 常時適用 | ユーザー呼び出し | Agentが自律的に使用 | 親Agentが委任判断 |
| コスト特性 | 常時適用で一定 | 呼び出し時コスト | 適用時コスト | 並列実行で使用量増加、コンテキスト節約 |
| 具体例 | コーディング規約 | 特定リファクタリング手順 | テスト実行フロー | コードベース全体調査 |
Subagent vs Skill：定義と自動起動の違い
室谷代表取締役まず定義から。Subagentは親Agentがタスクを委任する独立したAgentで、SkillはAgentが発見・適用する能力のバンドル。
この切り分けが最初の壁なんですよね。
この切り分けが最初の壁なんですよね。
テキトー教師.AI認定講師たしかに。初めて触る人は、両方とも.cursor配下に.mdファイルを置くってところで混乱します。
でも、Subagentは自分専用のコンテキストとモデルを持ち、Skillはあくまで親Agentの知識を拡張するもの。
でも、Subagentは自分専用のコンテキストとモデルを持ち、Skillはあくまで親Agentの知識を拡張するもの。
室谷代表取締役Subagentは並列実行されるのに対し、Skillは親Agentが逐次的に適用する。コスト面でも、Subagentはモデルを指定できるから、Exploreには高速で安いモデルを割り当てるといったチューニングが効く。
テキトー教師.AI認定講師自動起動の違いもポイント。Subagentは親Agentが「これは別のAgentに任せよう」と判断したときに起動される。
SkillはAgentが「このタスクにはこの手順が使える」とみなしたときに発動する。起動のトリガーが根本的に違うんですよ。
SkillはAgentが「このタスクにはこの手順が使える」とみなしたときに発動する。起動のトリガーが根本的に違うんですよ。
ルール・コマンドとの使い分け方
テキトー教師.AI認定講師Rules、Commands、Skills、Subagents……似た機能が多くて、現場でよく聞かれるのが「どれをいつ使うべきか」です。
室谷代表取締役ざっくり分けると、Rulesは常時適用の行動指針、Commandsはユーザーが意図的に呼び出すショートカット、SkillsはAgent自身がタスクに応じて選ぶ手順書、Subagentsは子Agentに丸投げする実行ユニット。
テキトー教師.AI認定講師具体例で言うと、コーディング規約はRules、特定のリファクタリング手順はCommands、テスト実行フローはSkills、コードベース全体の調査はSubagents、という具合に使い分けます。
室谷代表取締役コスト計算も重要。Subagentは並列で動く分、使用量が増える可能性がある。
でも、メインのコンテキストを節約できるので、長期的には効率的という判断もできる。
でも、メインのコンテキストを節約できるので、長期的には効率的という判断もできる。
コミュニティでよくある混乱の整理
テキトー教師.AI認定講師フォーラムでも「SubagentとSkillってどう違うの？」というスレッドがよく立ってます。特に、両方ともカスタム定義できる点が混乱を招いてますね。
室谷代表取締役本質は「Subagentは独立したAgentインスタンスを起動する」のに対し、「Skillは親Agentに知識を与えるだけ」という点。Subagent定義にモデル指定や読み取り専用モードがあるのは、それが理由。
テキトー教師.AI認定講師かつてのCommandsからSkillsへの移行も混乱の種です。Commandsはユーザーが直接呼び出すもの、SkillsはAgentが自律的に使うもの。
この違いを理解していないと、「CommandがSkillに移行されて動かなくなった」という事態に陥ります。
この違いを理解していないと、「CommandがSkillに移行されて動かなくなった」という事態に陥ります。
室谷代表取締役結局、Cursor側も試行錯誤中の部分はある。ただ、このTaxonomyを押さえておけば、自分たちのワークフローに最適な機能を選べるようになる。
現場の生産性にも直結する話ですよね。
現場の生産性にも直結する話ですよね。
Cursor Subagentの具体的な使い方：自動起動とカスタム設定
デフォルトサブエージェントの自動起動タイミング
室谷代表取締役デフォルトのサブエージェントは、エージェントがコード探索やシェルコマンド、ブラウザ操作が必要と判断したときに自動で起動するんですよね。
テキトー教師.AI認定講師たしかに。初めて使う人は「勝手に動いてる」って感じるかもしれません。
でも、これが意図しないタイミングで起動することはまずないですよ。
でも、これが意図しないタイミングで起動することはまずないですよ。
室谷代表取締役そうそう。例えばExploreは、コードベースの広い範囲を調べる必要がある時に、親エージェントが「これはサブに任せよう」と判断する。
コンテキストを節約できるのが大きい。
コンテキストを節約できるのが大きい。
テキトー教師.AI認定講師最初は「起動してるの？」って戸惑うかもですが、慣れると自然です。
カスタムサブエージェントの作成手順（.cursor/agents/ディレクトリ）
室谷代表取締役カスタムを作るときは、プロジェクトの .cursor/agents/ に Markdown ファイルを置くだけです。ドキュメントに詳しく書いてありますね。
テキトー教師.AI認定講師はい。ファイルには description と prompt、使うモデルを指定します。
コミュニティでは専用の検証用サブエージェントなんかを公開している人もいます。
コミュニティでは専用の検証用サブエージェントなんかを公開している人もいます。
室谷代表取締役例えばコストに敏感な人は、安いモデルを使った検索用サブエージェントを定義して、メインは高精度モデルに集中させる──みたいな使い方もありますね。
テキトー教師.AI認定講師あとは read-only モードにして「書き込み禁止」にするとか、用途に応じてツールアクセスを制限できます。細かい制御が効くんですよ。
フォアグラウンドモードとバックグラウンドモードの使い分け
室谷代表取締役フォアグラウンドはサブが終わるまでブロックされるので、結果がすぐ必要な逐次タスク向け。バックグラウンドは並列処理に使います。
テキトー教師.AI認定講師現場でよく聞くのは「バックグラウンドで探索をいくつも走らせて、結果をまとめてから次の処理に移る」というパターン。効率が全然違いますね。
室谷代表取締役経営目線で言うと、バックグラウンドを活用すると、待ち時間が減って開発者の時給換算のコストパフォーマンスが上がる。これ、ROI に直結しますよ。
テキトー教師.AI認定講師ただ、バックグラウンドで走らせるときは、結果をどう受け取るか設計しておかないと、途中で迷子になりがちです。
CLIやCloud Agentsでのサブエージェント活用
室谷代表取締役サブエージェントは CLI や Cloud Agents でも使えます。CLI なら cursor-agent コマンドでサブを呼び出せる。
テキトー教師.AI認定講師実際、CLI でサブを並列に動かして、結果をフォアグラウンドで待つ──みたいなワークフローが組めます。
室谷代表取締役Cloud Agents だと、サーバーサイドで処理を分散できるので、大規模なリファクタリングを夜間に仕込んだりするのに向いてますね。
テキトー教師.AI認定講師いずれにしても、公式ドキュメントに具体的な設定例が載っているので、まずはそれを参考に試すのが早いです。
Cursor Subagent導入で開発効率はどう変わる？現場の実感
並列実行によるタスク完了時間の短縮
高速モデルで複数探索を同時実行。従来数分の調査が数十秒に短縮。
複雑なタスク分解による認知負荷低減
中間出力をサブエージェント内に閉じ、メインコンテキストをクリーンに保ち、トークン消費も削減。
モデルコストとパフォーマンスのトレードオフ最適化
高速低コストモデルと高性能モデルを使い分け可能。コミュニティ公開のカスタム設定事例で最適ラインを発見。
並列実行によるタスク完了時間の短縮例
室谷代表取締役並列実行の効果は予想以上ですね。デフォルトのExploreサブエージェントはコードベース探索を高速モデルで何本も同時に走らせる設計になっている。
従来なら逐次処理で数分かかっていた調査が数十秒で帰ってくる。
従来なら逐次処理で数分かかっていた調査が数十秒で帰ってくる。
テキトー教師.AI認定講師確かに。実際に使ってみると「待ち時間」が劇的に減ります。
特に大規模リポジトリでのリファクタリング前調査とか、各モジュールの依存関係を同時に調べられるのは大きい。
特に大規模リポジトリでのリファクタリング前調査とか、各モジュールの依存関係を同時に調べられるのは大きい。
室谷代表取締役Cursorのフォーラムでも、カスタムサブエージェントを公開するユーザーが増えていて、例えばVerifierやJunior Coderといった役割ごとに分割した事例が共有されています。
テキトー教師.AI認定講師そうなんですよ。ああいったサンプル設定を参考にすれば、自分のワークフローに合わせた並列タスク分解をすぐ試せる。
複雑なタスクを分解する際の認知負荷低減効果
テキトー教師.AI認定講師複雑なタスクをサブエージェントに任せると、メインのコンテキストが非常にクリーンになります。中間出力はサブエージェント内に閉じて、最終結果だけが返ってくるので、人間が追う情報量が激減する。
室谷代表取締役Bashサブエージェントなんかはその典型で、コマンドのログ出力って結構ノイジーですからね。ああいうのを隔離できるのは認知負荷の軽減というより、むしろコスト削減に直結する。
トークン消費が減る。
トークン消費が減る。
テキトー教師.AI認定講師現場で「メインの会話がスッキリして考えやすくなった」という声をよく聞きます。特にPlanモードでの設計段階では、細かい実装検証をサブに任せられるのが効く。
モデルコストとパフォーマンスのトレードオフ
室谷代表取締役サブエージェントにはデフォルトで高速・低コストなモデル（Composerなど）が割り当てられている。Exploreサブエージェントがその典型で、トークン消費の大きい処理を安いモデルにオフロードする設計は、全体のコストを大きく下げる。
テキトー教師.AI認定講師ただしカスタムサブエージェントではモデルを明示的に指定できるので、精度が必要な検証には高性能モデルを、単純な走査には安いモデルを、と使い分けられます。
室谷代表取締役フォーラムではGemini 3 Flashを使った高速な検証用サブエージェントや、Claude Opusを使った高精度なデッドロック解消用エージェントなど、トレードオフを意識したカスタム設定が多数共有されています。
テキトー教師.AI認定講師そうしたコミュニティの知見を借りれば、自分のプロジェクトに最適なコストパフォーマンスのラインを見つけやすいですね。
Cursor Subagentを使う上での注意点とよくあるトラブル
コンテキストの引き継ぎ制限と対策
室谷代表取締役Subagentってコンテキストがクリーンな状態で起動するんですよね。親の会話履歴にはアクセスできない。
ここを理解しないと「さっき言ったのに」ってなる。
ここを理解しないと「さっき言ったのに」ってなる。
テキトー教師.AI認定講師そうなんですよ。初めて触る人は、親から必要な情報を渡し忘れて、サブエージェントがゼロから考え始めちゃう。
対策は、親エージェントのプロンプトにこれまでの経緯や要件を明示的に含めることです。
対策は、親エージェントのプロンプトにこれまでの経緯や要件を明示的に含めることです。
室谷代表取締役MYUUUの現場でも、最初は「なんでこのサブエージェント、前提条件を無視するの？」ってよく聞かれました。親が暗黙の期待をしちゃうんですね。
テキトー教師.AI認定講師そう、指示書に「前提として〇〇が決まっている」と書くだけで結果が安定します。この小さな意識が効くんです。
カスタムサブエージェントのプロンプト設計のコツ
室谷代表取締役カスタムサブエージェントはモデルも指定できる。検証用に高速で安いモデル、重要タスクに高性能モデルと使い分けるとコスト効率が上がります。
テキトー教師.AI認定講師最初にカスタムを作る人は、プロンプトに「コードレビューして」だけ書いてしまう。役割と出力形式、読み取り専用かどうかまで明示しないと、期待とずれることが多いです。
室谷代表取締役Task()のパラメータでreadonlyやmodelを指定できるのは便利ですよね。特にreadonlyはファイル変更を防げるので、検証用サブエージェントに最適。
テキトー教師.AI認定講師プロンプトは「あなたはサブエージェントです。親からの指示に従ってください。
」から始めて、具体的なタスクと成果物のフォーマットを書くのが鉄板です。
」から始めて、具体的なタスクと成果物のフォーマットを書くのが鉄板です。
MCPツールとの連携でハマりがちなポイント
室谷代表取締役MCPツールは親から継承されるはずなんですけど、サブエージェントはCursorの内部ツールを使おうとする傾向がある。フォーラムでも話題になってました。
テキトー教師.AI認定講師そう、せっかくMCPの検索ツールを設定しても、サブエージェントがディレクトリトラバースやgrepで済ませちゃう。readonlyモードにするとMCPツールの使用が制限されるので、そこが悩みどころですね。
室谷代表取締役確実にMCPを使わせたいなら、プロンプトで「MCPツールのみを使用すること」と明示する。Task()のパラメータでreadonlyをfalseにすればツール制限は解除される、という理解でいいのかな。
テキトー教師.AI認定講師現状ではプロンプトで徹底するしかないです。今後のアップデートで連携がスムーズになることを期待しつつ、現場では細かく指示を入れてます。
チームでSubagentを活用するためのベストプラクティス
サブエージェントを前提とした開発フローの設計
室谷代表取締役チームでSubagentを導入するとき、まずやるべきは「どの処理を並列化するか」の見極めですね。コードベース探索やテスト実行みたいな、独立して動かせる単位をSubagentに任せるのが基本です。
テキトー教師.AI認定講師そうですね。最初に戸惑うのが「どこまでをSubagentに任せればいいか」という線引きです。
実はCursorにはExploreやBashといった組み込みSubagentがいて、これらが自動で並列実行してくれるので、まずはそれに任せてみるのが早いです。
実はCursorにはExploreやBashといった組み込みSubagentがいて、これらが自動で並列実行してくれるので、まずはそれに任せてみるのが早いです。
室谷代表取締役コスト面でも有利ですよね。Exploreは高速なモデルを使ってるから、メインのコンテキストを圧迫せずに深い調査ができる。
チームで使うなら、この「安くて速いサブ」と「高精度なメイン」の使い分けをルール化しておくと無駄が減ります。
チームで使うなら、この「安くて速いサブ」と「高精度なメイン」の使い分けをルール化しておくと無駄が減ります。
テキトー教師.AI認定講師並列実行が効く場面として、複数のファイルにまたがるリファクタリングも挙げられます。Subagentに各部分を担当させれば、全体の待ち時間が劇的に減りますよ。
ルール・スキル・サブエージェントの整理整頓
室谷代表取締役チームで運用するなら、.cursorrulesやSkillsとSubagentの役割分担を明確にしないと混乱します。うちの現場でも「これはRulesでやるべきか、Subagentに任せるべきか」という議論がありました。
テキトー教師.AI認定講師実はよくある悩みで、Rulesは常時適用される宣言的なガイド、Skillsは動的に発動される手順書、Subagentは独立したコンテキストを持つエージェント、という整理がベターです。Subagentはモデル指定もできるので、タスクの重要度に応じてモデルを変えられます。
室谷代表取締役その辺り、GitHub上で公開されているSubagent設定例が参考になりますね。例えば検証用のVerifierや、安価なモデルで簡単な処理をさせるJunior Coderなど、チームのニーズに合わせて定義できます。
テキトー教師.AI認定講師注意点としては、Subagentが増えすぎると管理が煩雑になることです。チーム内で共通のSubagentセットを決めて、プロジェクトルートに配置する形がおすすめです。
CI/CDやコードレビューへの組み込みとガバナンス
室谷代表取締役SubagentはCLIでも使えるので、CI/CDパイプラインに組み込むのも有効です。例えばプルリクエスト時に自動でコードレビュー用Subagentを走らせて、問題点を報告させる。
時給換算すると開発者のレビュー時間を大幅に削減できます。
時給換算すると開発者のレビュー時間を大幅に削減できます。
テキトー教師.AI認定講師ただ、完全に自動化する前に、Subagentの判断が正しいかどうかを人間が確認する段階が必要です。最初はreadonlyモードで使って、提案だけもらう形から始めると安全です。
室谷代表取締役ガバナンスの観点では、Subagentが使うモデルやツールアクセスをチームで統一するルールを作るといいです。フォーラムでも、SubagentがMCPツールを適切に使わないケースが報告されてて、その辺はRulesで制御できます。
テキトー教師.AI認定講師最終的には、Subagentの実行ログを確認できる仕組みも欲しいところです。CursorのEnterpriseプランにはBlame機能もありますが、小規模チームなら手動でチェックするのでも十分でしょう。
よくある質問
Q1. Cursor Subagentは無料で使えますか？有料プランとの関係は？
室谷代表取締役SubagentそのものはCursor Proプランに含まれてるんですよ。無料版のBasicだと使えないので、Pro（月額20ドル）以上が必要ですね。
テキトー教師.AI認定講師そうなんです。ただProでも毎月500回の高速リクエスト制限があって、Subagentはその枠を消費します。
大量に使うならBusinessプランも検討したほうがいいかもしれません。
大量に使うならBusinessプランも検討したほうがいいかもしれません。
室谷代表取締役エージェントモードと同様、リクエスト数の上限は共有なので、使い方次第では足りなくなるケースも出てきますね。
Q2. SubagentとClaude Codeのエージェントモード、どちらを選ぶべき？
テキトー教師.AI認定講師よく聞かれる質問です。Claude Codeもエージェントモード持ってますが、CursorのSubagentはエディタに完全に統合されてる点が強みです。
室谷代表取締役そうですね。Claude Codeはターミナルベースで、並列実行は独自のワークフローが必要です。
一方SubagentはGUIで直感的に使えるので、導入ハードルが低い。
一方SubagentはGUIで直感的に使えるので、導入ハードルが低い。
テキトー教師.AI認定講師プロジェクト全体のリファクタならClaude Code、細かいタスクを並列で片付けたいならSubagent、という住み分けが現場では多いですね。
Q3. Subagentの実行速度は？トークン消費量が心配です。
室谷代表取締役速度はモデル依存ですが、Claude Sonnetを選べばそこそこ速いです。ただし並列で動かすとトータルのトークン消費は増えるので、コスト意識は必要です。
テキトー教師.AI認定講師現場でよく聞くのは「つい並列にしすぎてトークンが跳ね上がった」という話。1タスクあたりの出力を短くする工夫や、max_tokensの調整が効きます。
室谷代表取締役Proプランの月500回を超えると低速リクエストになるので、そこも注意ですね。ビジネス用途ならBusinessプランの無制限が安心です。
Q4. 複数のSubagentを同時に動かすときのリソース制限はある？
テキトー教師.AI認定講師同時実行数は公式には明示されてませんが、実際に5つ以上動かすと一部が待ち状態になることがあります。
室谷代表取締役エディタのバックグラウンド処理やネットワーク帯域も使うので、あまり過信しないほうがいいです。2〜3並列が現実的なラインですね。
テキトー教師.AI認定講師あと、タスク内容によっては同じファイルを触るとコンフリクトするので、ファイル単位の排他制御も意識したほうがいいです。
Q5. Subagentの今後のアップデート予定は？
室谷代表取締役Cursorは最近頻繁にアップデートしてますね。Subagentもまだ実験的機能なので、今後スキルとの統合や性能改善が入る可能性は高いです。
テキトー教師.AI認定講師ロードマップは公開されてないので確実なことは言えませんが、コミュニティの要望として「コンテキストの共有」「結果のマージ機能」あたりは期待されてます。
室谷代表取締役とにかく最新情報はCursorの公式ブログやChangelogを追うのが確実です。
まとめ
室谷代表取締役Cursor Subagent、並列実行で地味に効く機能ですよね。個人的には、テスト生成とリファクタリングの同時実行でかなり時間を削れてます。
テキトー教師.AI認定講師現場感覚で言うと、最初は1タスクずつ慣れてから並列に移行するのが失敗しないコツです。スキルとの使い分けも覚えておくと、さらに効率が上がります。
室谷代表取締役料金もProなら追加費用なしで使えるので、まずは試してみる価値は十分あります。エージェントモードと合わせて、自分のワークフローに合う形を見つけてください。
テキトー教師.AI認定講師そうですね。注意点さえ押さえれば、チーム開発でのボトルネック解消に役立つはずです。
ぜひ導入を検討してみてください。
ぜひ導入を検討してみてください。
