Cursor CLI 3つのモード：Agent / Plan / Ask

3つのモード、一言で区別：誰があなたのコードを変更でき、誰は話すだけか。これを理解すれば、モードの選択に迷わなくなります。

一言で比較

3人の同僚をイメージしてください：Agent は「渡してくれれば直接やります」という人、Plan は「先に提案書を書いてレビューしてもらいます」という人、Ask は「答えるだけでファイルは触りません」という人――正しい人を選べば手間が半分になります。

Agent モード（デフォルト）

用途：AI に直接コードを編集・機能追加・リファクタリングさせたい。結果が欲しい、議論は不要。

cursor agent "ログインを JWT に変更して"

• ファイルを読み込み、編集し、コマンドを実行する場合もある
• 各ステップを承認・拒否できます — あなたがコントロールできます

Plan モード

用途：どう進めるか不明、または AI に一気に変更されるのが心配？先に計画を確認してから進めましょう。

cursor agent --plan "API 層全体をリファクタ"

• AI がいくつか質問をして、アプローチを提案します
• 承認後のみ実行されます — 驚きはありません

いつ使う：大きな変更、または「コミットする前に全体を把握しておきたい」場合。

Ask モード（読み取り専用）

用途：「このコードは何をしているの？」「もっといい書き方はある？」を聞きたいだけで、絶対にファイルを変更してほしくないとき。

cursor ask "src/auth.ts のロジックは何をしていますか？"

• 読み取り・分析・回答のみ — 書き込みは一切しない
• CI や「確認はしたいが変更はしたくない」環境に最適

会話中にモードを切り替える

すでに cursor agent の会話に入っている？スラッシュコマンドで瞬時に切り替え：

• /plan → Plan モードへ（先に計画）
• /ask → Ask モードへ（読み取り専用）

終了して再起動する必要はありません — スムーズに切り替えられます。

まとめ

• Agent：実行する、ファイルを変更する — 結果が欲しいときはこれ
• Plan：先に計画、承認後に実行 — 安全を重視するときはこれ
• Ask：質問のみ、読み取り専用 — 変更なしで答えが欲しいときはこれ

次へ：04-non-interactive — スクリプトや CI 用の非インタラクティブモード