2026年7月29日

Cursorエージェントモード完全ガイド:機能・使い方・トラブル解決

エージェントモードとは?Cursorができること

公式画面

Cursorエージェントモードの主要機能
自律的な検索・編集・実行
コードベース全体を検索・編集・ターミナル実行・エラー修正まで自動。diff表示で変更確認可能。
複数ファイルにまたがる変更
リファクタリングや依存追加など、関連ファイルを自動検出し修正。npm installやエラー修正ループを自動実行。
サブエージェント委譲と画像生成
役割別サブエージェントを並列起動。自作サブエージェントを.cursor/agents/で定義。画像生成でUIモックアップ作成も可能。

コードの自律的な検索・編集・実行

室谷室谷代表取締役
エージェントモード、Cursor の頭脳みたいなもので。コードベース全体を自分で検索して、編集して、ターミナル叩いてエラー直すところまで全部やってくれるんですよね。
テキトー教師テキトー教師.AI認定講師
たしかに。初めて触ると「え、勝手にファイル読みに行って直すの?」って驚きますね。

プロンプト1つで「ログインフォーム作って」って言えば必要なファイルを探して、変更を加えてくれる。
室谷室谷代表取締役
MYUUU の現場でも「テスト書いて」って投げるだけで、関連ファイルを grep して勝手にテストファイル作って実行まで持ってく。時給換算したら、この自律性だけで結構なコスト削減になるんですよ。
テキトー教師テキトー教師.AI認定講師
最初に「これ、信用していいの?」って聞かれますけど、diff 表示で変更内容が逐一出てくるので安心です。Stop ボタンで途中停止もできるし。

複数ファイルにまたがる変更とターミナル操作

室谷室谷代表取締役
複数ファイルにまたがるリファクタリングとか、エージェントモードじゃないとやってられないですよね。手動で開くファイルを指定しなくても、関連箇所を全部見つけて修正してくれる。
テキトー教師テキトー教師.AI認定講師
それにターミナル操作も自動でやってくれるのが強いです。例えば「依存パッケージ追加して」って言うと、package.json 編集した後 npm install まで走らせる。
室谷室谷代表取締役
エラーが出たら、その出力を読んで自分で修正に入る。ループの中で完結するので、人間が「あ、これエラーだから直して」って指示しなくていい。

ROI で見ると、この自動修正ループが一番効く。
テキトー教師テキトー教師.AI認定講師
現場感覚で言うと、最初は「ターミナル実行まで任せていいの?」って怖がる人もいますけど、YOLO モードでなければ実行前に確認できるので安心です。

サブエージェントへのタスク委譲と画像生成

室谷室谷代表取締役
さらに、エージェントがサブエージェントを起動できるんですよ。調査用、シェル操作用、ブラウザ操作用とか、役割を分けて並列で動かせる。
テキトー教師テキトー教師.AI認定講師
自作のサブエージェントも作れて、.cursor/agents/ にマークダウンで定義するだけ。複雑なタスクを分割して任せられるので、大きな機能追加とかで威力を発揮します。
室谷室谷代表取締役
画像生成もできる。UI モックアップやアーキテクチャ図をテキストから作ってくれる。

デザインカンプをコードに落とすフローがかなりスムーズになりましたね。
テキトー教師テキトー教師.AI認定講師
作業中に次の指示をキューに入れられるのも便利で、エージェントが動いてる間に次のタスクを考えて投入できる。並行作業が捗ります。

エージェントモードの起動と切り替え方法

エージェントモードの起動と切り替え
  1. 1
    Ctrl+I で起動
    Windows/Mac共通。Agentパネルを開き、コード編集やターミナル実行が可能
  2. 2
    Shift+Tab でモード切り替え
    Agent, Ask, Plan, Debugを順に切り替え。質問だけならAskにしておくと安全
  3. 3
    モードセレクターからマウス選択
    Agentパネル内のドロップダウンから選択。初心者や切り替え忘れの保険に

起動ショートカット(Ctrl+I)と基本的な使い方

室谷室谷代表取締役
エージェントモードの起動はCtrl+I一発です。MacもWindowsも同じ。

MYUUUの現場だと、これでコードベース全体を読んでファイル編集まで任せられるわけです。
テキトー教師テキトー教師.AI認定講師
たしかに。最初に戸惑うのが「普通のチャットと何が違うの?」という点ですよね。

Ctrl+Iで開くAgentパネルは、コードを探して編集し、ターミナルコマンドまで実行してくれる。
室谷室谷代表取締役
時給換算すると、自分でファイルを探す手間が月に数時間分削減できる。経営目線ではその時間を別のタスクに充てられるのが大きい。

Shift+Tabでモードを切り替える

室谷室谷代表取締役
で、モード切り替えはShift+Tabで一周できます。Agent、Ask、Plan、Debugの4モード。

タスクに応じて最適なモードを選ぶだけで、動作がガラッと変わる。
テキトー教師テキトー教師.AI認定講師
現場でよく聞くのが「うっかりAgentのまま質問だけしたら勝手にファイルを編集された」という失敗。Shift+TabでAskに切り替えてから質問するクセをつけると安全です。
室谷室谷代表取締役
編集が必要なときだけAgentを使い、情報収集だけならAskにすると無駄な編集が減る。コスト削減に直接効いてくる。

モードセレクターからマウスで選択

室谷室谷代表取締役
マウスで選ぶならパネル内のドロップダウンから。慣れるまではこっちのほうが間違いがない。
テキトー教師テキトー教師.AI認定講師
そうですね。初めて触る人は「どこで切り替えるんだろう」と迷うんですが、Agentパネルの入力欄すぐ上にモードセレクターがあります。

クリックで選択できます。
室谷室谷代表取締役
キーボード操作が速いのはもちろんだが、切り替えを忘れたときの保険としてマウス操作も知っておくといい。現場では両方覚えさせてます。

Agent、Ask、Plan、Debugの使い分け

Agent、Ask、Plan、Debugの使い分け
Agent
全部入りでどんな作業にも最適。ファイル編集、ターミナル操作など何でもできる。
Ask
読み取り専用。コードを調べるだけ。変更を加えず、副作用ゼロ。
Plan
複雑な機能の設計計画を作成。Markdownで保存でき、ナレッジとして再利用可能。
Debug
実行時エラーの原因調査に特化。エラーログから調査し、修正は別モードで。

Agentモード:ほとんどの作業に最適

室谷室谷代表取締役
Agentモード、一言で言うと全部入りですよね。機能追加、リファクタ、バグ修正、何でもやらせられる。

エージェントが自分でコードベースを探索して、ファイルを編集し、ターミナルまで叩く。MYUUUでも、新機能の実装はほとんどこれで済ませてます。
テキトー教師テキトー教師.AI認定講師
そうですね。現場でよく聞かれるのは「結局どのモードを普段使えばいいんですか」という質問で、答えは大抵「Agentでいいよ」です。

ほとんどのタスクはこれで事足りる。
室谷室谷代表取締役
コスト面も悪くないんですよ。時給換算すると、自分で書くより安いケースも多い。

特に繰り返しの多い作業は相性がいい。
テキトー教師テキトー教師.AI認定講師
ただ、逆に言うとAgentはやることが多すぎて、読み取りだけでいい時にいきなりファイルを触られると困ることもありますよね。そういう時はAskモードがハマる。

Askモード:コードを読み解くだけで変更しない

テキトー教師テキトー教師.AI認定講師
Askモードは読み取り専用。コードベースを調べて「この関数は何をしてる?」とか「この部分の設計意図は?」と聞くのに最適です。

まったく変更を加えないので、ただ理解したいだけの時に安心です。
室谷室谷代表取締役
これは結構重要で、Agentに聞くとついでに修正までしようとするんですよね。Askなら確実に副作用ゼロ。

コードレビューの事前調査とかで使ってます。
テキトー教師テキトー教師.AI認定講師
最初に戸惑うのが「変更してほしいのにAskにしてしまった」パターン。でも慣れれば、調べる時はAsk、作る時はAgent、と頭を切り替えられるようになります。
室谷室谷代表取締役
切り替えはShift+Tabで一瞬ですからね。慣れの問題。

Planモード:複雑な機能は計画を立ててから実装

室谷室谷代表取締役
Planモードは、いわば設計書を先に書かせるモード。複数ファイルにまたがる複雑な機能や、複数のアプローチがある場合に有効です。

エージェントがコードベースを調べて、実装計画をMarkdownで書いてくれる。それをレビューしてから実行に移せる。
テキトー教師テキトー教師.AI認定講師
これ、仕組みがいいのは計画を保存できる点です。.cursor/plans/に保存しておくと、後で同じ機能に再挑戦する時に再利用できる。

チームのナレッジにもなる。
室谷室谷代表取締役
海外のスタートアップだと、このPlanモードを設計ドキュメント代わりにしてるチームも多いですね。Pull Requestの説明文に計画を貼る、みたいな使い方。
テキトー教師テキトー教師.AI認定講師
ただし、簡単な変更にはオーバーキルです。目安としては「一手で終わるタスクには使わない」が現場の感覚ですね。

Debugモード:実行時エラーの調査に特化

テキトー教師テキトー教師.AI認定講師
Debugモードはその名の通り、厄介なバグを追うのに特化しています。特に再現しづらい実行時エラーに対して、ランタイムの証拠をもとに調査を進めてくれます。
室谷室谷代表取締役
Agentでもバグは直せますが、Debugモードは「原因特定」に集中する点が違いますね。うちのチームだと、エラーログをペタッと貼って「これの原因を調べて」と投げるのに使ってる。

結果的に修正までやってもらうこともあるけど、最初は調査だけ。
テキトー教師テキトー教師.AI認定講師
そうそう。Agentだと「原因調べて直して」がワンセットになりがちで、思わぬ変更が入るリスクがある。

Debugはあくまで調査主体。修正は別のモードでやるのが安全です。
室谷室谷代表取締役
ちなみに、各モードでルール(Rules)は共通で適用されます。切り替えてもプロジェクトの設定は引き継がれるので安心。

トラブルシューティング:よくある問題と対処法

トラブルシューティング:よくある問題と対処法
  1. 1
    Auto Debugが表示されない
    Shift+TabでDebugモードを選択。古いバージョンならアップデートを確認。
  2. 2
    エラー修正をエージェントに任せる
    エラーメッセージをコピーしてAgentモードで送信。ファイル指定で精度向上。Debugモードはランタイムエラー向け。
  3. 3
    キャッシュクリア
    設定画面からクリア可能。環境により手順が異なるため公式ドキュメントを確認。再起動でも直ることが多い。

Auto Debugが表示されない場合の確認ポイント

テキトー教師テキトー教師.AI認定講師
Auto Debugって、Agentパネルのモード切替で選べるんですけど、表示されないって相談をよく聞きます。
室谷室谷代表取締役
モードピッカーがそもそも出てないケースが多いですね。Shift+Tabで切り替えられるので、まずそれでDebugモードを選んでみてください。
テキトー教師テキトー教師.AI認定講師
あと、古いバージョンだとUIが違う可能性もあるので、Cursor自体のアップデートも確認した方がいいですよ。

エラー修正をエージェントに任せる方法

室谷室谷代表取締役
エラーが出たら、そのメッセージをコピーしてエージェントに投げるのが効率的です。Agentモードなら自動でコードを修正し、ターミナルでテストまでやってくれます。
テキトー教師テキトー教師.AI認定講師
最初は「このエラー直して」だけでも動きますが、どのファイルで起きてるかまで伝えると精度が上がります。@でファイルを指定するのも手です。
室谷室谷代表取締役
そうですね。Debugモードは特にランタイムエラー向けなので、再現が難しいバグにはそちらを使うと良いです。

キャッシュクリアの手順

テキトー教師テキトー教師.AI認定講師
たまに動作がおかしくなったら、キャッシュクリアが有効な場合があります。Cursorの設定画面から可能です。
室谷室谷代表取締役
具体的な手順は環境によって違うので、公式のフォーラムやドキュメントを確認した方が確実ですね。再起動だけでも直ることは多いです。

プライバシー設定とモデル変更

プライバシーモードの設定方法

室谷室谷代表取締役
プライバシー周り、実は地味に気にする人多いんですよね。MYUUUの現場でも、最初に「コード送信したくない」って相談が来ます。
テキトー教師テキトー教師.AI認定講師
たしかに。設定画面のどこかにあるんですが、最初は見つけにくい。

Cursorもちゃんと用意してて、プライベートモードにすれば学習に使われないようにできます。
室谷室谷代表取締役
海外の契約だと企業コンプライアンスで必須条件になるケースもある。この辺をコマンドラインからも切り替えられると助かるんですけどね。

モデルの変更手順と制限

テキトー教師テキトー教師.AI認定講師
モデル変更は、エージェントパネルの左下にあるドロップダウンで簡単にできます。クリック一つでGrokとかComposerとか選べる。
室谷室谷代表取締役
そのままだとAutoモードになってて、Cursor Routerが勝手に振り分ける。でも「このタスクは絶対このモデルで」って時は固定した方が確実。
テキトー教師テキトー教師.AI認定講師
制限としては、プランによって使えるモデルが違う点。ProだとGrok 4.5まで使えるけど、無料だと限られる。

公式の料金ページを確認した方がいいです。
室谷室谷代表取締役
そこはROIで考えた方がいい。月額20ドルで使えるモデルが増えるなら、時給換算したら安いものですよ。

モデル設定をコマンドで切り替える

室谷室谷代表取締役
CLI派には朗報で、Cursor CLIに/modelsってスラッシュコマンドが用意されてます。ターミナルからモデル一覧を見てスイッチできる。
テキトー教師テキトー教師.AI認定講師
これ、地味に便利ですよね。いちいち設定画面開かなくて済む。

エージェントモードでもAskでも、コマンド一発で切り替えられる。
室谷室谷代表取締役
僕もよく使う。/modelsで今のモデル確認して、/models grok-4.5みたいに指定するだけ。

頻繁に切り替えるなら覚えておいて損はないです。
テキトー教師テキトー教師.AI認定講師
最初は「コマンド覚えるの面倒」と思われがちですが、一度使うともう戻れなくなりますよ。

エージェントモードを最大限活用するコツ

プロンプト設計の基本:具体的に、シンプルに

室谷室谷代表取締役
エージェントモードに投げるプロンプトは、具体的なほど結果がブレません。シリコンバレーのスタートアップでは「Add a login form」より「Emailとパスワードのフィールド、エラー処理、送信ボタン」と粒度を指定するのが主流です。
テキトー教師テキトー教師.AI認定講師
たしかに。僕も最初に「よくわからないけど直して」と投げて、予想と違うものが返ってきた経験があります。

必要な操作だけシンプルに書くのがコツですね。
室谷室谷代表取締役
あと、複数ファイルを跨ぐタスクは、最初にPlanモードで設計を確認してから実行するといいです。ソースにも「Plan Modeで詳細な実装計画を作れる」とあります。
テキトー教師テキトー教師.AI認定講師
そうそう。僕は最初に箇条書きで要件を並べるクセをつけました。

エージェントが迷わなくなるんですよ。

ルール設定で品質とセキュリティを担保

室谷室谷代表取締役
エージェントモードにルールを設定できるの、知ってますか?プロジェクトルールやユーザールールで振る舞いを制御できます。
テキトー教師テキトー教師.AI認定講師
はい。例えば「ファイル編集前にテストを実行する」とか「秘密鍵をコミットしない」とか、ルールに書いておくと自動で守ってくれます。
室谷室谷代表取締役
うちの現場では、コスト管理の観点から「一度に生成するコード量を制限する」ルールを入れてます。使いすぎ防止に効くんですよね。
テキトー教師テキトー教師.AI認定講師
そういうルールはAskモードでも効くので、一貫した品質保証ができます。最初にちょっと設定するだけで、後が楽になりますよ。

経営視点:開発工数削減とROIの考え方

室谷室谷代表取締役
エージェントモードの真価は、時間単価で測るより「タスクの完了速度」で見るべきです。複数ファイルを同時編集してテストまで通すので、手動の3〜5倍は速い感覚。
テキトー教師テキトー教師.AI認定講師
現場でよく聞くのは「バグ修正が格段に楽になった」という声です。ターミナルコマンドも自分で打つので、デバッグサイクルが短縮されます。
室谷室谷代表取締役
ROIで言うと、エラーの早期発見と自動修正で、QA工程の負荷が減るのが大きい。特にスタートアップはリソースが限られてますからね。
テキトー教師テキトー教師.AI認定講師
まさに。ルール設定とプロンプト設計を最初に整えれば、あとはエージェントに任せて別の仕事に集中できます。

そこが導入する最大のメリットでしょう。

よくある質問

Q1. Cursorエージェントモードは無料で使えますか?

テキトー教師テキトー教師.AI認定講師
無料プランでもエージェントモードは試せます。ただし、リクエスト数に制限がありますよ。
室谷室谷代表取締役
Pro プランだと月額 $20 でかなり快適に使える。知り合いのスタートアップは無料で始めて、足りなくなったらアップグレードしてますね。

Q2. エージェントモードは Windows と Mac で体験が変わりますか?

室谷室谷代表取締役
基本的に同じです。ただし、ターミナル操作の一部でパス周りが違うくらい。
テキトー教師テキトー教師.AI認定講師
現場でよく聞かれるんですが、Mac の方がシェル連携がスムーズに感じる人は多いみたいです。ただ Windows でも WSL を使えば問題ないですね。

Q3. 複数ファイルを一度に編集できますか?

テキトー教師テキトー教師.AI認定講師
できます。エージェントモードはコンテキスト内のファイルを自動で把握して、必要な変更を一括で適用してくれます。
室谷室谷代表取締役
実際、リファクタリングで 5 ファイル跨ぐ修正を一度で任せられる。手動で開く手間が減るのが地味に効くんですよね。

Q4. VS Code の拡張機能と比べてどうですか?

室谷室谷代表取締役
拡張機能はあくまで部分支援ですが、Cursor はエディタ自体が AI 前提で設計されてます。差は大きいです。
テキトー教師テキトー教師.AI認定講師
特にエージェントモードは自分でコードを書かずに指示だけで進められるので、初心者には敷居が低い。VS Code の Copilot より自由度が高い印象です。

Q5. エージェントモードの会話履歴は残りますか?

テキトー教師テキトー教師.AI認定講師
チャット履歴として保存されます。後から見返せるので、同じ質問を繰り返さなくて済みますよ。
室谷室谷代表取締役
チームで共有するときは履歴をエクスポートできると良いんですが、そこは今後のアップデートに期待。

まとめ

テキトー教師テキトー教師.AI認定講師
エージェントモードは Cursor の核となる機能です。モードの切り替えやプライバシー設定を押さえれば、初心者でもすぐに活用できますね。
室谷室谷代表取締役
「とりあえず Agent で動かしてみる」が正解。その後に Ask で質問、Plan で設計、Debug で修正と使い分けると効率が跳ね上がる。
テキトー教師テキトー教師.AI認定講師
まずは無料プランで感触を掴んで、慣れたら Pro プランに移行するのがおすすめです。チームなら Max プランも検討価値あり。
室谷室谷代表取締役
現場ではもうエージェントモードなしの開発を考えられない。早めに試して、自分のワークフローに取り入れてみてください。

関連記事

新着記事

関連記事

.AI TIMES一覧に戻る