Cursor Agent・Ask・Plan・Debugの違いと使い分け|4モード完全ガイド【2026年最新】

開発・エンジニア向け

Cursorを使い始めたが、いろいろな機能があって上手く使いこなせていないと感じる。

そう感じている人も多いと思います。

自分自身はAgentモードを取り入れてから劇的に作業効率が上がりました。

実はCursorにはAgent・Ask・Plan・Debugの4つのモードがあり、使い分けるだけで開発効率が大きく変わります。「全部Agentモードで使っている」という人は、かなり損をしている可能性があります。

この記事では、Cursorの4つのモードの使い分けとAgent機能の実践テクニックを、実務ですぐ使える形で解説します。

【結論】4モードの使い分けが最重要

モード 一言で 使う場面
Agent AIが自律的にコードを書く 新機能の実装、リファクタリング、テスト追加
Ask 質問・調査専用(コード変更なし) コードの理解、設計の相談、エラーの原因調査
Plan 実装計画を立てる 大きなタスクの事前設計、TODO作成
Debug エラー原因の特定 バグ修正、スタックトレース解析
鉄則:いきなりAgentで実装を始めない。まずAskで理解→Planで計画→Agentで実行、の順番が成功率を大きく上げます。

Agentモード:AIが自律的にコードを書く

AgentモードはCursorのデフォルトモードで、最も使われる機能です。自然言語で指示を出すと、AIがコードベースを自動で探索し、複数ファイルの編集やターミナルコマンドの実行まで自律的に進めます。

Agentモードでできること

  • 複数ファイルの同時編集(依存関係を考慮して順番に処理)
  • ターミナルコマンドの自動実行(npm install、テスト実行等)
  • エラーが出たら自動で修正を試みるループ処理
  • コードベース全体のインデックスを使った関連ファイルの自動検出

起動方法

Cmd+I(Mac)/ Ctrl+I(Windows)でComposerパネルを開き、上部のモード切り替えでAgentを選択。デフォルトでAgentになっているので、通常はそのまま使えます。

Agentモードの実践プロンプト例

📋 新機能の実装
ユーザー認証機能をJWTベースで実装してください。

条件:
- src/auth/ 配下に作成
- 既存のルーティングと整合性を取る
- エラーハンドリングを含める
- 完了後に pnpm typecheck を実行して型エラーがないことを確認

📋 リファクタリング
src/utils/helpers.ts を機能別に分割してください。

条件:
- 外部インターフェースは変えない
- インポートパスの更新も含める
- 既存テストがパスすることを確認

Agentモードで失敗しないコツ

  1. 「Done when」条件を明記する — 「テストが通ったら完了」「typecheckが0で終了したら完了」のように終了条件を入れると、AIが無駄なループに入りにくい
  2. 対象範囲を限定する — 「src/auth/ 配下のみ」「このファイルだけ」と指定。範囲が広すぎると意図しない変更が起きる
  3. チェックポイントを活用する — Agentが変更を加えるたびにチェックポイントが自動作成される。意図しない変更は簡単に巻き戻せる

大量のコードを一気に読み込ませようとするとクラッシュして止まるので、こまめに分けて読み込ませるのが無難かつ正確にコードを認識して書いてくれるのでおすすめです。

できれば画面のキャプチャなどを張り付けてから伝えると意図通りに修正してくれることが多いです。

Askモード:質問・調査に特化(コード変更なし)

Askモードはコードを一切変更しない読み取り専用モードです。「このコードは何をしている?」「この設計で問題はある?」といった質問に最適。

Askモードが効く場面

  • 既存コードの処理内容を理解したい
  • 設計方針の相談をしたい(実装はまだ)
  • エラーの原因を調査したい(修正はまだ)
  • 「この実装で進めて大丈夫?」の確認

プロンプト例

@codebase このプロジェクトの認証フローを説明してください。
どのファイルが関係していて、どこがエントリポイントですか?
重要:Agentモードで「この処理の意味を教えて」と聞くと、AIが説明ではなくコード修正を始めてしまうことがあります。質問だけしたい時は必ずAskモードに切り替えてください。

Planモード:実装前に計画を立てる

PlanモードはTODO付きの実装計画をMarkdownで生成するモードです。大きなタスクをいきなりAgentに投げるのではなく、まずPlanで計画を立ててからAgentで実行する、という流れが安全です。

プロンプト例

ダッシュボード画面にグラフ表示機能を追加したい。
実装計画をTODO形式で作成してください。

条件:
- 使用ライブラリ:Recharts
- データ取得:既存のAPIを利用
- ステップごとに影響するファイルも記載

計画を確認して問題なければ、そのままAgentモードに切り替えて「この計画に従って実装してください」と指示するとスムーズです。

Debugモード:エラー原因の特定に特化

Debugモードは、通常のAgentが「当てずっぽうで修正を試みる」のに対し、原因の切り分けを優先するアプローチを取ります。

Debugモードが効く場面

  • Agentで修正を繰り返しても直らないバグ
  • スタックトレースの原因特定
  • 「修正はしないで、原因だけ教えて」という場面

Background Agent(クラウドエージェント)

2026年3月に全ユーザーに開放されたBackground Agentは、クラウド上でタスクをバックグラウンド実行する機能です。

仕組み

  1. タスク内容とコンテキストを指示
  2. Agentがリポジトリをクローンしブランチを作成
  3. 自律的に作業し、完了時にPull Requestを作成
  4. Slack・メール・Web UIで完了通知を受け取る

自分が別の作業をしている間にAIがPRを作ってくれるので、並行作業の効率が大幅に上がります。

起動方法

チャットのクラウドアイコンをクリック、またはCmd+E(Mac)で起動。cursor.com/agents で複数のエージェントを管理できます。Slackから「@Cursor」をメンションして起動することも可能。

4モードの実践的な使い分けフロー

実務で最も効率が良いのは以下の順番で使い分けることです。

ステップ モード やること
1 Ask 既存コードの理解・仕様の確認・不明点の洗い出し
2 Plan 実装計画をTODO形式で作成・レビュー
3 Agent 計画に従って実装を実行
4 Debug テスト失敗時の原因特定
5 Agent 修正を実行・テスト再実行

いきなりAgentで実装を始めるのが一番の失敗原因です。Ask→Plan→Agentの順番を守るだけで、手戻りが大幅に減ります。

Agentの精度を上げる設定

① Cursor Rulesで品質を安定させる

Cursor Rulesを設定しておくと、Agentの出力品質が安定します。日本語回答・コーディング規約・テスト方針などをルール化しましょう。

Cursor Rulesテンプレート集|コピペで使える実践ルール15選

② @メンションでコンテキストを明示

メンション 効果
@codebase プロジェクト全体を参照
@files 特定のファイルを指定
@docs ライブラリのドキュメントを参照
@Past Chats 過去の会話を選択的に参照(会話が長くなった時に有効)

③ 会話が長くなったら新しいチャットを開始

多くのターンを重ねるとAgentのコンテキストにノイズが蓄積し、精度が下がります。効果が落ちてきたと感じたら、@Past Chatsで過去の作業を参照しつつ新しい会話を始めるのがベスト。

よくある失敗と対処法

「Agentが意図しないファイルを編集する」

対処:対象ファイルを明示する。.cursorignoreで触らせたくないファイルを除外する。

「修正を繰り返してもエラーが直らない」

対処:Agentを止めてDebugモードに切り替える。原因を特定してからAgentに戻る。

「コードの品質が安定しない」

対処:Cursor Rulesを設定する。テンプレートはこちら → Cursor Rulesテンプレート集

「レスポンスが遅い・重い」

対処:モデルを軽いものに切り替える、.cursorignoreで不要ファイルを除外。詳しくは → Claude Codeが重いときの対処法

実体験

★ 実体験①:Ask→Plan→Agentの順番を守った効果

例)いきなりAgentで実装してた時は手戻りが多かったが、Askで仕様確認→Planで計画→Agentで実行の順にしたら成功率が上がった。

★ 実体験②:Background Agentを使った感想

例)別タスクをやっている間にPRが作られるのは便利。ただしレビューは必須。

よくある質問

Q. Cursor Agentとは何ですか?

A. AIがコードベースを自律的に探索し、複数ファイルの編集やターミナルコマンドの実行を自動で行う機能です。

Q. Agent・Ask・Plan・Debugの違いは?

A. Agentは実行、Askは質問、Planは計画、Debugはバグ調査。場面に応じて切り替えるのがコツ。

Q. 無料プランでも使えますか?

A. 使えますが月50回のチャット制限あり。本格利用ならProプラン(月$20)を推奨。

Q. Background Agentとは?

A. クラウド上でバックグラウンドにタスクを実行し、完了時にPRを作成してくれる機能。2026年3月に全ユーザー開放。

■ プログラミングを本格的に学びたい方へ

Cursor Agentを使いこなすには、コードの基礎理解があるほど効果が上がります。Winスクールなら、Python・JavaScript・AIプログラミングなど300以上の講座から選べて、プロ講師の個人レッスンで指導。給付金対象講座なら最大70%還元

無料カウンセリングに申し込む →

※ オンラインでも参加OK。無理な勧誘はありません

■ おすすめ書籍

▶ ChatGPT最強の仕事術

AIへの指示設計の基本が学べます。Cursor Agentへのプロンプト設計にもそのまま応用できます。

Amazonで見る

まとめ:Ask→Plan→Agent→Debugの順番で使う

Cursor Agent機能を使いこなすポイントは3つです。

  1. いきなりAgentで始めない。Ask→Plan→Agentの順番が鉄則
  2. 対象範囲と終了条件を明記する。「このディレクトリだけ」「テストが通ったら完了」
  3. 会話が長くなったら新しいチャットへ。@Past Chatsで引き継ぎ

この3つを守るだけで、Cursor Agentは実務でかなり強力な開発パートナーになります。

Cursorをダウンロード(公式サイト)