3行でいうと

  • Agent は Mac が Cmd+I、Windows と Linux が Ctrl+I で開き、文章で頼むと、検索、ファイルの編集、コマンドの実行まで進めます。変更は差分で見られ、気に入らなければ戻せます（チェックポイント）。
  • 大きめの作業は、Shift+Tab で Plan Mode に切り替えると、先に計画を作り、承認を待ちます。原因のわからない不具合は、Debug Mode が「仮説、ログの追加、再現、分析、修正、後片づけ」の順で進めると公式が書いています。
  • Tab は、入力中に薄い文字で続きを出し、Tab キーで受け入れ、Esc で断ります。選択した範囲を Cmd/Ctrl+K で Agent に渡す使い方もあります（旧来の「インライン編集」は、この流れに置き換わったと公式が書いています）。
  • 文脈は @ で渡します（ファイル、フォルダ、ターミナル、過去のチャット、Git の差分、ブラウザ）。決まりごとは Rules（.cursor/rules や AGENTS.md）に書いておけます。
  • 最初の1時間は、「説明を頼む、小さな変更を頼む、差分を見る、戻す、Plan、Rules」の順に進める組み方を、この記事の例として載せます。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はCursorを入れていますが、使い心地はこの記事には書いていません。手順は、公式の手順を順に並べたものです。文中の指示文（プロンプト）と練習用のファイルは、すべて「この記事の例」で、動作は確かめていません。画面の表記は公式ページの表記を写しているので、手元の画面と照らして読んでください。

先に結論

前提：用語をそろえる

たとえ話：新人の同僚に仕事を頼む

Agent への頼み方は、新人の同僚に仕事を頼むのに似ています。まず「このフォルダの全体を説明して」と読ませ、次に小さな仕事を頼み、出来上がりをいっしょに見て、気に入らなければ「元に戻して」と言う。決まりごと（Rules）は、先に渡しておく社内のメモです。これは僕らのたとえで、公式の表現ではありません。公式は Cloud Agents の資料で、エージェントを「a smart, but low-context human developer」（賢いが、文脈の少ない開発者）のように扱うとよい、と書いています。

画面の見取り図

06で出てくる場所を、先に並べます（名前は公式ページの表記）。

場所 何があるか
Agent のパネル（サイドペイン） Cmd/Ctrl+I で開く。入力欄、モードの選択メニュー、モデルの選択メニュー、コンテキストの円（入力欄の横）がある
チャット入力欄の上 モデルの選択メニュー（Cmd+/、Windows と Linux は Ctrl+/ で順に切り替え）
画面の右下 Tab の状態の表示（一時停止、全体オフ、拡張子ごとのオフを選べる）
左のサイドバーの「Customize」 Rules、Skills、MCP、プラグインなどを探して管理する場所
Source Control タブ 変更の確認。Agent Review をここから動かせる
設定 Cmd/Ctrl+Shift+J で Cursor Settings。モデルは「Models」、Tab は「Tab」

練習用の例題を用意する

以降の場面で使う、小さなフォルダをこの記事の例として決めておきます。名前も中身も、この記事で組んだものです。

  1. 新しいフォルダ cursor-practice を作り、Cursor で開く（File > Open Folder。05の手順8）。
  2. その中に greet.py というファイルを作り、次の内容を貼る（この記事の例。わざと、直したくなる所を残しています）。
def greet(name):
    return "Hello, " + name

def main():
    names = ["Aki", "Ben", "Chika"]
    for n in names:
        print(greet(n))

main()
  1. もう1つ、test_greet.py を作る（この記事の例）。
from greet import greet

def test_greet():
    assert greet("Aki") == "Hello, Aki"

テストを走らせるには、pytest が要ります。入っていない場合は、Agent に頼むか、自分でターミナルから入れます（パッケージを入れるコマンドの実行は、Agent に頼むと承認の確認が出ます。場面2で扱います）。

場面1：コードの全体像を説明してもらう（Agent、読むだけ）

目的： AIに、ファイルの構成と役割を読ませる。まだ何も書き換えない。

  1. Agent を開く。Mac は Cmd+I、Windows と Linux は Ctrl+I。
  2. 入力欄に次を入力して、Enter を押す（この記事の例）。
このフォルダのファイルを読んで、何をするプログラムか、主な関数と、読む順番を、短く教えてください。ファイルは書き換えないでください。
  1. 何が返ってくるか。 公式のクイックスタートは、Cursor がリポジトリを検索し、関連するファイルを読み、プロジェクトの要約を返す、と書いています。この例題なら、greet と main の説明と、test_greet.py の役割が返ってくるはずです（返答の中身は、この記事では確かめていません）。
  2. 「書き換えないでください」と書くのは、この記事の用心です。公式のCLIのページにも、計画だけを頼むときは「do not write any code」のように意図を書くとよい、という趣旨の案内があります。

公式のクイックスタートの例。 同じページは、コードベースの説明を頼む例のほか、「安全な小さな改善を3つ、トレードオフつきで挙げて、選ぶのを待つ」ように頼む例も挙げています。大きなフォルダで説明を頼むときの、聞き方の参考になります。

場面2：小さな変更を頼み、差分を見て、確かめる（Agent の基本の一周）

  1. Agent の入力欄に、次を入力する（この記事の例）。
greet.py の greet 関数に、名前が空のときは "Hello, stranger" を返す処理を足してください。test_greet.py に、そのテストも足してください。
  1. 何が起きるか。 公式は、Agent の編集は作業しながら適用され、差分の表示で確認でき、不要な変更は拒否できる、と書いています（公式のインライン編集のページ）。
  2. 差分を見る。変更された行が、前後で並んで表示されます。意図どおりか、余計な変更がないかを、1か所ずつ見ます。
  3. 確かめる。 公式のクイックスタートは、プロジェクトに既にある確認（テスト、型チェック、リント、ローカルのビルドなど）を、Cursor に頼んで走らせるよう案内しています。この例なら、次のように頼みます（この記事の例）。
pytest を実行して、結果を教えてください。
  1. コマンドの承認。 Agent が、ターミナルのコマンドを走らせようとすると、設定の「Run Modes」（05の6-6）に従って、承認を求められることがあります。画面に出たコマンドの文言を読んでから、許可するか断るかを決めます。
  2. 気に入らないとき。 次の方法があります（公式の Agent のページと、インライン編集のページ）。
  3. 途中なら、「Stop」ボタンで止める（Stop ボタンの記述は、インライン編集のページにあります。Agent のページには見つかりませんでした）。
  4. 過去の依頼の「Restore Checkpoint」ボタンか、メッセージの上にマウスを置いたときに出る「+」ボタンで、その時点のファイルに戻す。
  5. 戻すのはファイルだけで、チャットのメッセージは消えません。チェックポイントは手元に保存され、Git とは別です。

気をつける点。 チェックポイントは Git の代わりではありません。本物の作業では、Git でコミットしてから Agent に頼む、という使い方もできます（この記事の見立て。公式が勧めている、という意味ではありません）。

場面3：読むだけの質問をする（Ask）

Ask は、コードを書き換えず、読んで答えるだけのモードです。公式で Ask の動きが書かれているのは CLI のページで、/ask か --mode=ask で、ファイルを編集せずにコードを調べる、とあります。次のコマンドの引数の文は、この記事の例です。

agent --mode=ask "このフォルダの構成を説明して"

エディタ側では、読んだドキュメントに Ask の説明は見つかりませんでした。Plan Mode のページは、Agent の「mode picker dropdown」か Shift+Tab でモードを切り替える、と書いています。選択メニューに Ask があるかは、手元の画面で確かめてください。

場面4：大きめの変更は先に計画を作る（Plan Mode）

  1. Agent の入力欄で、Shift+Tab を押す。押すたびにモードが順に変わります。または、モードの選択メニューで「Plan」を選ぶ。
  2. 次を入力する（この記事の例）。
greet.py を、名前の一覧をコマンドラインの引数から受け取るように作り替えたいです。進め方の計画を作ってください。まだコードは書かないでください。
  1. 何が起きるか（公式のPlanning のページ）。 Agent が、要件について質問をし、コードベースを調べ、計画を作ります。計画は、チャットか、マークダウンのファイルとして、編集できます。
  2. 計画を読み、手直しを頼みます。納得したら、計画を実行（ビルド）します。公式は、実行のボタンの名前を書いていません。画面の表示を見てください。
  3. 計画の保存。 計画は標準では、ホームディレクトリに保存されます。「Save to workspace」を押すと、ワークスペースの中に移り、あとで見返したり、チームで共有したりできます。保存先のフォルダ名は、ページに書かれていません。
  4. やり直したいとき。 公式は、結果が意図と違ったら、変更を戻し、計画をもっと具体的にして実行し直すほうが、途中で追加の指示を重ねるより早くきれいなことが多い、と書いています。

いつ使うか。 公式は、方法がいくつもある機能、多くのファイルにまたがる変更、要件があいまいなもの、先に確認したい設計の判断に向く、と書いています。すぐ済む変更は Agent で直接頼めばよい、とも。

場面5：Tab 補完を使う

Tab は、入力中に、最近の編集、周りのコード、リンターのエラーをもとに、続きを出す機能です。

  1. greet.py を開き、main 関数の下に、次のように途中まで打つ（この記事の例）。
def farewell(name):
  1. 何が見えるか。 薄い文字で、続きの候補が出ます。複数行にわたる提案や、足りない import の追加も、Tab は行える、と公式が書いています。
  2. 操作は次のとおりです。
操作 キー
候補をすべて受け入れる Tab
単語ごとに受け入れる Cmd+右矢印（Mac）、Ctrl+右矢印（Windows と Linux）
断る Esc、またはそのまま打ち続ける
次の編集位置へ飛ぶ 受け入れた直後にもう一度 Tab
  1. ほかのファイルへの提案。 ある変更のために別のファイルの直しが要るとき、Tab は別のファイルの編集も提案でき、その場合、エディタの下に小さな窓が出る、と公式は書いています。
  2. 止めたいとき。 画面右下の「Tab」の表示を押し、一時停止（Snooze）、全体でオフ、拡張子ごとのオフを選びます。設定は「Cursor Settings」>「Tab」。受け入れのキーを変えるときは、キーボードショートカットの設定で「Accept Cursor Tab Suggestions」を探します。
  3. Rules との関係。 公式の Rules のページは、Rules は Tab には影響しない、と書いています。

場面6：選んだ部分だけ頼む（Cmd/Ctrl+K と Cmd/Ctrl+L）

公式の「インライン編集」のページには、Cmd+K はかつてインライン編集を開いていたが、今はこの流れに置き換わった、という旨が書かれています。今の動きは次のとおりです。

  1. greet.py で、greet 関数の行を、マウスかキーボードで選ぶ。
  2. Mac は Cmd+K、Windows と Linux は Ctrl+K を押す。
  3. 何が起きるか。 Agent が開き、選んだ行が入力欄に参照として入ります。そこに指示を足して送ります（この記事の例）。
この関数に、型ヒントと、1行の説明文（docstring）を付けてください。
  1. Cmd/Ctrl+L でも、選んだコードを Agent に送れる、と書かれています。
  2. 結果は、場面2と同じく差分で確認し、不要なら拒否します。

確認できていない点。 公式のそのページは、旧来のインライン編集の「受け入れ、拒否」の細かい操作、追加の指示、「ちょっとした質問」の動きを書いていません。これらは、手元の画面で確かめてください。

場面7：文脈を渡す（@、画像、コンテキストの円）

公式の「Prompting」のページに書かれた、文脈の渡し方です。

  1. 入力欄に @ を打つと、候補が出ます。
  2. 使えるもの：
  3. ファイルとフォルダ。例は @auth.ts、@src/components/。フォルダを選んだあとに / を打つと、中へ進めます。
  4. @Terminals：ターミナルの出力。エラーの文言を渡すときに便利です（この記事の見立て）。
  5. @Chats：前の会話。
  6. @Commit (Diff of Working State)：まだコミットしていない変更。@Branch (Diff with Main)：ブランチ全体の差分。
  7. @Browser：内蔵ブラウザの内容。
  8. 公式の助言：どのファイルが関係するか分かっているときに、@ を使う。分からなければ付けなくてよい。Agent が自分の検索で関連するファイルを探す。
  9. 画像。 入力欄にドラッグして入れるか、Cmd/Ctrl+V で貼り付けます（スクリーンショットも可）。デザインの見本、見た目の不具合、エラーや、スタックトレースの画面に使える、とあります。
  10. 音声。 マイクのアイコンを押して話します。ファイル名や関数名を含めて話し、送る前に文字起こしを確かめるよう案内されています。
  11. コンテキストの円。 入力欄の横の円が、使っている枠の量を示し、押すと内訳（システムのプロンプト、道具、Rules、Skills、MCP、サブエージェント、要約した会話、会話）が見えます。

この記事の例として、場面2のあとに、次のように頼めます。

@greet.py の main 関数を、名前を引数で受け取る形にしてください。

場面8：Rules を書いて、決まりを覚えさせる

Rules は、Agent に毎回伝えたい決まりを、ファイルに書いておく仕組みです。公式の「Rules」のページを順に並べます。

作り方は2つ。

ファイルの決まり。

4つの効き方。

種類 alwaysApply description globs 効き方
Always Apply true 不要 不要 すべてのチャットに入る
Apply to Specific Files false 不要 あり 該当ファイルが文脈に入ると自動で付く
Apply Intelligently false あり なし Agent が関係ありと判断すると取り込む
Apply Manually false なし なし @ルール名 と書いたときだけ入る

この記事の例（練習用のルール）。 .cursor/rules/python-style.mdc というファイルを作り、次を書きます。書式は公式の例に合わせて、この記事で組みました。動作は確かめていません。

---
globs: "**/*.py"
alwaysApply: false
---
- 関数には型ヒントを付ける
- 関数の先頭に、1行の説明文（docstring）を書く
- テストは pytest の形式で、test_ で始まるファイルに書く

globs の書き方は、公式のページに *.ts、**/*.ts、src/**/*.tsx などの例があります。引用符の付け方など、この例が実際に効くかは確かめていません。効かないときは、Customize の Rules に出る状態を見てください。

AGENTS.md という選択肢。 プロジェクトの一番上に AGENTS.md という、フロントマターのないマークダウンを置く方法もあります。サブフォルダの AGENTS.md は、そのフォルダの作業のときに自動で効き、親のものと合わさり、より具体的なものが優先されます（公式の説明）。

効かないとき。 公式の FAQ は、種類を確かめる（Apply Intelligently には description が、Apply to Specific Files には合う形のパターンが要る）、と書いています。

公式のコツ。 ルールは500行以内にして、大きいものは分ける。具体例か、参照するファイルを示す。あいまいな指示は避ける。同じ間違いを繰り返すときに足す。標準的なコードの書き方（スタイル）は、リンターに任せる。チームで使うなら、git に入れる。ファイルを参照するときは @service-template.ts のように書き、中身はプロンプトに自動では入らない（Agent が必要なときに読む）ので、いつも文脈に必要なことは、ルールの本文に書く、とあります。

場面9：コードベースを検索させる

公式の「Codebase search」のページに書かれていることです。

greet という関数が使われている場所を、すべて探して、ファイル名と行を一覧にしてください。

場面10：原因がわからない不具合を追う（Debug Mode）

モードの選択メニューか Shift+Tab で、Debug Mode に切り替えます（公式のページ）。公式の手順は6段階です。

  1. 探索と仮説。 関係するファイルを調べ、原因の候補を複数出す。
  2. 計測の追加。 ログの出力を足す。ログは、Cursor の拡張が持つ手元のデバッグ用サーバーに送られる。
  3. 再現。 不具合を起こす手順が示されるので、そのとおりに操作する。
  4. ログの分析。 集まったログから、実行時の証拠で原因を探す。
  5. 的を絞った修正。 多くは数行の修正。
  6. 確認と後片づけ。 再現の手順をもう一度試して、直ったか確かめる。確認できたら、足した計測のコードをすべて消す。

この記事の例として、greet.py の main で、名前の一覧に数字を混ぜると、"Hello, " + name が失敗します。その失敗を題材に、Debug Mode で頼んでみる、という使い方が考えられます（この記事の例。動作は確かめていません）。

場面11：実行中の Agent に追加で頼む（キュー、割り込み、サイドチャット）

公式の Agent のページの表です。

やりたいこと 操作
動いている間に、次のメッセージを予約する Enter。ドラッグで順番を入れ替えられる
すぐに送る Cmd+Enter、Ctrl+Enter。直近のユーザーのメッセージに追加される
いまの作業の向きを変える 「Send now」を押す、または Enter を2回。次の道具の呼び出しの時点で届く
今のターンが終わってから送る Tab

場面12：ターミナルから使う（CLI の基本）

05の手順7で入れた CLI は、エディタと同じ設定（Rules、MCP）を使います。公式の「CLI」のページの手順です。

  1. 練習用のフォルダで、ターミナルを開く。
  2. 次のように起動する。
agent
agent "greet.py にテストを足して"
  1. 対話の中では、提案された変更を見て、コマンドの実行は y で許可、n で断ります。
  2. モードは、Shift+Tab で Agent、Plan、Ask の順に切り替えます。スラッシュコマンドは /plan、/ask、/resume、/summarize（別名 /compress）。
  3. Ctrl+R で変更の確認の画面が開き、i で追加の指示、左右の矢印でファイルの切り替え。
  4. 前の会話は、agent ls（一覧から選ぶ）、agent resume、agent --continue で続けられます。
  5. 非対話の実行。 -p を付けると、結果を表示して終わります。ファイルの書き換えは、標準では提案のみで、--force を付けると直接書き換わります（公式のヘッドレスのページ）。
agent -p "このコードは何をする？"
agent -p --force "greet.py に型ヒントを付けて"

公式の CLI の Capabilities のページは、「Cursor has full write access in non-interactive mode」と書いています（注意書きの形ではなく、一文の記述です）。--force を付ける前に、対象のフォルダを確かめてください。

最初の1時間の進め方（この記事の例）

次の順は、この記事で組んだ進め方の例です。公式が決めた順番ではありません。

時間の目安 やること 参照する場面
0〜10分 練習用のフォルダを作り、2つのファイルを置く。Agent を開き、説明を頼む 例題の用意、場面1
10〜25分 小さな変更を頼み、差分を見て、テストを走らせる。1回、チェックポイントで戻してみる 場面2
25〜35分 Tab で farewell 関数を書いてみる。Esc で断る操作も試す 場面5
35〜45分 選んだ関数に Cmd/Ctrl+K で指示する。@ でファイルを指す 場面6、7
45〜55分 Plan Mode で、引数を受け取る形への作り替えの計画を作らせる 場面4
55〜60分 python-style.mdc を作り、Customize の Rules に出るか確かめる。プライバシーモードの状態を、もう一度見る 場面8、05の6-2

気をつけること

出典