Cursorは、プログラムを書く画面にAIの質問・補完・編集機能を組み込んだ開発ツールです。
その中のCursor Agentは、指示を受けて関連ファイルを探し、コードを直し、必要なコマンドやテストまで進める役割を持ちます。
初めて触るなら、変更しない質問はAsk、小さな修正はAgentなどで依頼し、最後に差分と実際の動作を確かめる流れから始めると、AIに任せた範囲を見失いにくくなります。
「日本語で頼めば完成する」と考えるより、何を作りたいかを伝え、できたものを自分でも確かめる相手として使うのが出発点です。
ここでは主にWindows・macOS・LinuxのCursorエディタを扱います。
ブラウザーから使うCloud AgentsやCLIとは操作や実行場所が異なるため、最初はエディタ内の一つの練習に絞って進めます。
CursorとCursor Agentは、道具全体と作業役の関係
コードのすぐ隣で、意味を聞き、変更を頼める
コードエディタは、HTMLやCSS、JavaScript、Pythonなどのファイルを読み書きする作業画面です。
Cursorでは、開いているコードをAIの説明と見比べながら、意味を聞いたり、変更を依頼したりできます。
別のチャットへコードを貼り直す手間を減らし、説明がどのファイルのどの処理を指すかを追いやすくする点が利点です。
ただし、同じフォルダーを開いているからといって、AIが目的や全ファイルを正しく理解しているとは限りません。
たとえば「検索を付けて」だけでは、どの画面で、何のデータを、どう絞り込むかが決まりません。
商品名で商品一覧を絞るのか、説明文も検索するのかを伝えることで、作業内容と確認する結果が具体的になります。
Agentは、AIに検索・編集・実行の道具を組み合わせた仕組み
生成AIは、文章やコードなどを生成する技術です。
Agentはモデルだけでなく、行動を導く指示と、ファイル検索・編集・コマンド実行などの道具を組み合わせて、作業を進めます。
Cursorの公式説明でも、この三つが構成要素として示されています。
商品一覧への検索追加なら、画面とデータのファイルを探す、入力欄を作る、絞り込む処理を変える、テストする、といった一連の作業を依頼できます。
リファクタリングは、外から見た動作を保ちながらコードの構造を整理する作業で、これも依頼できる用途です。
ほかにも、エラー調査、複数ファイルの整合、READMEやコメント、テストのたたき台づくりに使えます。
どの場合も、道具を使って進められることと、出力が正しいことは別です。
AIが作ったテストの期待値が間違っている場合や、必要な環境がなく実行できない場合もあります。
完了報告を読むだけでなく、自分が求めた動作と照らし合わせるところまでが、一つの作業になります。
説明を聞くのか、変更を任せるのかで機能を分ける
チャットのような欄が見えていても、質問だけの状態とは限りません。
説明を聞きたいときにファイルを変えたくなければ、送信前にモード選択を見て、Askになっていることを確かめます。
| 機能・モード | 向く作業 | 使うときに見ること |
|---|---|---|
| Tab補完 | 入力中のコードや次の編集の候補を受け取る | 候補を読んで採用するか決める |
| Ask | コードの意味・構成を変更せずに調べる | 説明されたファイルや処理が実在するか |
| インライン編集 | 選んだコードの部分修正を頼む | 選択範囲と、そこを呼ぶ処理への影響 |
| Agent | 機能追加や不具合修正を進める | 変更ファイル・コマンド・検証結果 |
| Plan | 実装の前に方針を検討する | 目的・変更範囲・手順が依頼に合うか |
| Debug | 実行時の情報から不具合を調べる | 再現操作と、原因を裏付ける情報 |
Askは読み取りを目的とするモードです。
最初に「この画面はどこで作られていますか」と聞き、説明されたファイルを開いて見比べる使い方ができます。
一方、Agentは編集や実行を伴うため、使う前に変更前へ戻れる状態を用意します。
モードはAgentパネルの選択メニューなどから切り替えられますが、表示やキー設定が手元で異なる場合は、その画面の案内を優先してください。
Planは、変更が広い場合に、先に調査した方針を読んで直してから実装へ進むための機能です。
「この画面だけを直す予定なのに、認証やデータの作りまで変える計画になっていないか」と、作業前に話を合わせる場面に向きます。
Debugは実行時の情報が必要な問題の調査に使いますが、何をしたら問題が起きるのかを伝える必要はなくなりません。
Tab補完とインライン編集は、その場の候補を読む
Tab補完では、入力位置の先に灰色の候補が表示されます。
採用するときはTab、不要ならEscを押すか入力を続けます。
一行の続きを埋めるだけでなく、複数行や関連ファイルの変更も提案されるため、補完した箇所がどこかを見てください。
選んだ関数の変数名を読みやすくするなど、範囲を絞った依頼にはインライン編集も使えます。
Windows・Linuxの標準操作では対象コードを選び、Ctrl＋Kで指示を入力する方法です。
「動作を変えず、この変数名を役割が分かる名前へ変えてください」のように頼み、変更後は使っている側のコードも確かめます。
名前だけ変えて呼び出す側が古いままなら、読みやすくするつもりの修正がエラーにつながるためです。
最初に、練習用の場所と送ってよい情報を用意する
Cursorは公式ダウンロードからOSに合うものを入れ、起動してアカウントでサインインします。
Windowsはインストーラー、macOSはアプリの配置、Linuxは配布形式に応じた導入が必要です。
すでに入っている場合は入れ直さず、起動して練習用フォルダーを開くところから進められます。
初回は、本番データや会社の秘密を含まない専用フォルダーを使ってください。
既存の学習用プロジェクトを使うなら複製し、Gitを使える場合は変更前をコミットしておくと、後で差分を追えます。
Gitに慣れていなければ、まずフォルダー全体の控えを別の場所に置き、元のファイルを直接使わず練習する方法があります。
Privacy Modeと、外部へ送る情報は別に考える
CursorのAI機能は、指示文やコードの文脈をモデル提供者へ送って処理します。
Privacy ModeはコードをCursorやモデル提供者の学習に使わないための設定で、オンにしても処理がすべてPC内だけで済む意味ではありません。
仕事のコードを開く前には、会社の利用ルール、契約、外部へ送ってよい範囲を確かめる必要があります。
公式ヘルプの設定先は「Cursor Settings → General → Privacy Mode」です。
表示がオンであることを確かめたうえで、APIキー、パスワード、秘密鍵、顧客情報などを指示や参照ファイルへ含めないようにします。
設定を一つ有効にしただけで、会社の禁止事項まで解除されるわけではありません。
一つのHTMLで、説明から編集・表示確認まで試す
手元に練習用コードがなければ、次のような小さなHTMLから始められます。
HTMLはページの見出しや文章などを表すファイルです。
この例は、表示する文字を一か所変え、ファイルとブラウザーの違いを見比べるためのものです。
1．フォルダーを開き、練習用ファイルを保存する
任意の場所に練習専用フォルダーを作り、Cursorの「File → Open Folder」で開きます。
Fileメニューの新規ファイルの操作でファイルを作り、次の内容を入力します。
保存先を練習フォルダー、名前を「index.html」として保存してください。
Windows・LinuxならCtrl＋S、macOSならCommand＋Sが標準の保存操作です。
別の名前でも作れますが、ここでは指示するファイル名をそろえます。
<!doctype html>
<html lang="ja">
<head>
<meta charset="utf-8">
<meta name="viewport"
content="width=device-width,
initial-scale=1">
<title>練習ページ</title>
</head>
<body>
<h1>はじめてのページ</h1>
<p>今日はCursorの練習をします。</p>
</body>
</html>OSのファイル管理画面（Windowsのエクスプローラー、macOSのFinderなど）で練習フォルダーを開きます。
index.htmlを開いてブラウザーが起動しなければ、ファイルの「プログラムから開く」などから普段使うブラウザーを指定します。
「はじめてのページ」と文章が見えたら、変更前の表示を確かめられています。
文字列がそのままコードとして表示される場合は、ファイル名の末尾が「.html.txt」などになっていないかを見てください。
ここで変更前の表示を確認しておくと、後の結果を比べられます。
2．Askで、どこを変えると何が変わるか聞く
Agentパネルを開き、Askを選びます。
Windows・Linuxの標準操作ではCtrl＋Iでパネルを開けますが、設定が異なる場合はメニューやキー設定から開いてください。
質問には、対象ファイルと知りたい内容を入れます。
index.htmlの内容を、初めてHTMLを読む人向けに説明してください。ページの見出しと本文が、どの行に対応するか教えてください。ファイルは変更しないでください。
返答が出たら、h1の中の文字と、ブラウザーの大きな見出しを見比べます。
pの中の文章が、下に表示した一文に対応することも確かめてください。
知らない用語が出たときは、「このh1は何ですか」と、見ている箇所を指定して聞き直せます。
3．Agentで、一か所だけ編集を依頼する
次にAgentを選び、変えてよい場所と残す場所を伝えます。
モードを切り替えたときに以前の説明がそのまま共有されるとは考えず、対象ファイル名も書いてください。
index.htmlのh1の表示を「はじめてのページ」から「私の練習ページ」へ変更してください。本文の文章と、それ以外の構造は変えないでください。変更した箇所と、確認できたこと・確認できていないことを教えてください。
Agentの編集は、すべてが承認待ちになるわけではありません。
公式のセキュリティ説明では、通常の作業フォルダーのファイルは、設定ファイルなどの例外を除いて、承認なしで変更・保存されるとされています。
コマンドは標準では承認を求めますが、実行設定によって扱いが変わるため、変更前の控えを先に作る理由もここにあります。
4．差分を読み、ブラウザーでも結果を見る
差分とは、変更前後で追加・削除・置換された部分です。
今回なら、h1の文字だけが変わり、pの文章や他の構造は残っているかを見ます。
別ファイルまで変更されていたら、その目的を説明してもらい、依頼に必要かを判断してください。
ファイルを保存した状態でブラウザーを再読み込みし、「私の練習ページ」へ変わったかを確かめます。
変わらなければ、開いているファイルが同じフォルダーのindex.htmlか、保存済みかを見てから、もう一度読み込み直します。
AIの返答が「完了」でも、表示が変わっていなければ、この練習の確認は終わっていません。
問題がなければ変更後も保存し、何を直して何を見たかを短く残します。
Gitを使っている場合は、差分を確認してコミットすれば、その時点を後から参照できます。
この小さな練習で、依頼・変更・確認の三つが別の工程であることをつかめます。
実際の開発では、目的と確認条件をもう少し具体化する
画面の不具合なら、どの操作で何が起きるかと、どうなれば直ったといえるかを伝えます。
「スマホ表示を直して」だけでは、文字を小さくすればよいのか、カードの並びを変えるのかが分かりません。
たとえば、次のように対象と条件をそろえる方法があります。
商品一覧のカードが、画面幅320pxで横にはみ出します。対象は一覧表示と対応するCSSです。320px幅で横スクロールが出ず、PC幅でもカードが崩れない状態にしてください。データ処理や他の画面は変えないでください。修正ファイルと確認方法、未確認の条件を報告してください。
これは指示の記入例なので、実際の画面・ファイル・幅へ置き換えます。
変更が広いと分かったらPlanで先に計画を読み、不要な変更を外してから進められます。
見た目だけでなく入力やエラー時の動作も関係する修正では、再現操作を試し、プロジェクトで用意されたテストも実行して、関連する部分が変わっていないかを確かめてください。
意図と違う動きになったら、止めて範囲を確かめる
別のファイルを直す・説明が合わない場合
Agentが作業中ならStopで止め、開いているフォルダーと、対象にしたファイルを確かめます。
違うプロジェクトを見ていた、似た名前の別画面を直していた、といったずれがあれば、エラー文だけを足しても話がかみ合いません。
対象を伝え直し、起きた操作、期待した結果、実際の結果をそろえて聞き直してください。
エラー文を渡すときは、必要な箇所を残しつつ、パスワードや個人情報を伏せます。
テストが実行できなかった場合は、何が足りないと表示されたかを読み、必要な実行環境や起動手順をプロジェクトのREADMEなどで調べます。
分からないコマンドをそのまま許可するのではなく、何を変える操作かを説明してもらうと、進めてよい範囲を確かめられます。
モードやTab候補が見つからない場合
エディタ内のAgentパネルを見ているかを先に確かめます。
Cloud AgentsやCLIなど別の画面では、同じ手順や選択肢が出るとは限りません。
Tab候補が出ない場合は、右下のTab表示や「Cursor Settings → Tab」で、一時停止・全体の無効化・ファイル形式ごとの無効化を見ます。
利用上限や接続エラーが表示されていれば、その表示に対応する課金・使用量画面や公式の障害情報へ進みます。
編集を戻すときは、戻ったファイルも確かめる
公式ヘルプには、以前のメッセージの「Restore Checkpoint」から、その時点以降のAgentの変更を戻す方法があります。
対象にした位置を確かめて復元し、該当ファイルを開き、戻したい内容になったかを見てください。
会話のメッセージ自体は残るため、会話が見えることと、ファイルの内容が戻ったことを混同しないようにします。
チェックポイントは、Gitの履歴やデータのバックアップと同じものではありません。
コマンドで外部サービスやデータベースを更新していた場合、ファイルを戻しただけでその変更まで取り消せるとは限りません。
元の状態が分からないまま復元を繰り返さず、作業前の控えと差分を見て、必要ならプロジェクトの管理者へ相談してください。
ChatGPT・Codex・GitHub Copilotとは、使う作業場所で比べる
AIにコードを書かせる機能だけを見ると、複数のツールが重なります。
比較するときは、今のコードをどこで扱いたいか、その環境で差分を読み、動かして確かめやすいかが判断材料です。
| ツール | 作業場所を選ぶときの観点 |
|---|---|
| Cursor | 専用エディタで質問・補完・編集・Agentをまとめて使いたいか |
| ChatGPT・Codex | チャットでの学習や相談と、コードを扱う作業環境のどちらが必要か |
| GitHub Copilot | 対応する今のIDEを使い続けたいか、その環境で必要な機能を使えるか |
「ChatGPTはコードを直接扱えない」「Copilotは入力補完だけ」とは一括りにできません。
OpenAIのCodexにはコードの作業と変更結果を確認する環境があり、GitHub CopilotのAgentモードも複数ファイルの編集やコマンド実行を扱います。
どのツールでも、使える画面や機能は契約、設定、管理者の制限などに左右されます。
すでに開発環境があるなら、拡張機能や起動手順との相性を見ます。
まだ何も使っていなければ、説明が理解でき、変更を追いかけられるかを小さな練習で比べると、選ぶ理由が見えてきます。
ここでは同じ条件で速度や正答率を測って順位を付けていません。
無料・有料は、現行プランと自分の契約を分けて見る
2026年10月23日に確認した公式料金ページでは、新規向けに次の米ドル建て月額が表示されています。
無料で使える範囲にも使用量の制限があり、有料にすればすべてのモデルを無制限で使えるわけではありません。
| 新規向けの表示プラン | 月額表示・米ドル |
|---|---|
| Free | 0ドル |
| Plus | 8ドル |
| Premium | 30ドル |
| Super | 100ドル |
| Ultra | 200ドル |
公式ヘルプでは、新規向けをThe X Subscriptionのプランとして案内し、それ以前のCursor契約をlegacyプランとして分けています。
既存のPro月額20ドル、Pro+月額60ドルなどを使っている人は、自分の契約が続く条件をダッシュボードで確かめてください。
新規向けの表と旧契約の料金を混ぜると、申込画面に出ないプランを探すことになります。
金額だけでなく、使いたいモデル、Agentの利用枠、上限に達した後の扱いを見ます。
現行案内ではPlusで使えるモデルに制限があり、第三者モデルの利用分は表示月額に含まれず別に購入する条件も示されています。
税・年払い・追加使用を含めた支払額は、公式ページと自分の申込画面で確認してください。
まず無料枠で説明と小さな変更を試し、不足しているものが使用量なのか、必要な機能なのかを分けると、有料化の理由も判断しやすくなります。
最初の一歩は、変更を説明できる一つの練習から
Cursor Agentは、ファイルを探して編集・実行まで進められる開発支援の仕組みです。
最初はAskで意味をつかみ、対象を絞って編集を頼み、差分と表示を確かめるだけでも、任せ方を学べます。
一つの変更を説明できるようになったら、関連するファイルやテストへ範囲を広げていきます。
仕事で使う際も、情報を送ってよいか、変更前へ戻れるか、結果をどう確かめるかを先に決めておくと、AIの出力を自分の作業につなげやすくなります。
参考資料
- Cursor：Agentの仕組み
- Cursor：Agent・Ask・Plan・Debugと復元
- Cursor：Plan Mode
- Cursor：Tab補完
- Cursor：インライン編集
- Cursor：インストール
- Cursor：Agent Security
- Cursor：Privacy Modeとデータの扱い
- Cursor：料金ページ
- Cursor：現行・既存契約プランの説明
- OpenAI：Codex Cloud
- GitHub：IDEのCopilot Agentモード
機能・操作・料金・データの公式案内の確認日：2026年10月23日。
