Cursorの使い方と、AIに書かせたコードを確かめる進め方

Cursorの使い方は、入力の途中で続きを提案する「Tab」、選んだ部分だけを書き換える「インライン編集」、まとまった作業を任せる「エージェント」の3つを使い分けるところから始まります。ここまでは多くの解説で語られていますが、実際の仕事で差が出るのはその先です。AIが書いたコードを、どの順番で、何を見て確かめるか。ここを決めずに使うと、速く書けた分だけ、後で直す時間が増えます。

この記事では、Cursorの公式ドキュメントと料金ページ（2026年10月時点の記載）をもとに、インストールから日々の使い方、そしてAIに書かせたコードを確かめる進め方までを順に整理します。エディタの外側のファイルとターミナルの整理まで含めて作業場所を整えたい人に向けて、Mac用のファイル管理アプリAtriensにも後半で触れます。

Cursorとはどんな道具か

Cursorは、AIが組み込まれたコードエディタです。コードエディタとは、プログラムを書くための専用のソフトのことです。見た目や操作は、広く使われているエディタのVS Codeに近く、VS Codeを使ったことがある人なら違和感なく移れます。

公式ドキュメントでは、Cursorのエージェントを「複雑なコーディングの作業を自分で進め、ターミナルのコマンドを動かし、コードを編集するアシスタント」と説明しています。エージェントは、指示（システムの指示とルール）、道具（ファイルの編集、コードの検索、ターミナルの実行など）、モデル（作業に使うAI）の3つで成り立っていると書かれています。

データ分析の仕事をしていると、PythonやSQLのちょっとした処理を書く場面が毎日のようにあります。集計のスクリプトを1本書く、グラフの見た目を整える、エラーの原因を探す。こうした細かい作業が、Cursorを使うと会話の中で片づくようになりました。ただ、使い始めのころにありがちなのが、AIが出した集計の式をそのまま信じてしまい、数字の合わないレポートを作りかける失敗です。速く書けることと、正しく書けることは別物です。この記事の後半で「確かめる進め方」に多くの字数を割いているのは、そのためです。

Cursorが要る人、表計算ソフトで十分な人

データ分析の相談を受けていると、「Cursorを入れるべきか」という質問をよく受けます。判断の目安は、同じ処理を何度繰り返すかです。

月に1回だけ、数百行のデータを集計するなら、表計算ソフトで十分です。関数とピボットテーブルで済む作業に、わざわざプログラムを書く必要はありません。

一方で、毎週のように同じ形のデータが届く、数万行を超えるデータを扱う、複数のファイルを結合してから集計する、といった作業なら、プログラムにしておく価値があります。一度スクリプトにしてしまえば、次からはデータを差し替えて動かすだけです。Cursorは、そのスクリプトを書く手間を大きく減らしてくれる道具です。

プログラムを書いたことがない人でも、まずはエージェントに「このCSVを集計するPythonのスクリプトを作って、何をしているか1行ずつ説明して」と頼むところから始められます。説明を読みながら動かすうちに、少しずつ中身が分かるようになります。

料金と、無料で使える範囲

Cursorには無料のプランがあり、クレジットカードを登録せずに試せます。公式の料金ページ（2026年10月時点）の内容を整理すると、次のとおりです。金額は公式の表記のまま米ドルで載せています。

プラン	1か月あたりの料金（月払い）	主な内容
Hobby	無料	制限付きのエージェントの利用、クレジットカード不要
Pro	20米ドル	エージェントの利用上限の拡大、フロンティアモデル、MCP・スキル・フック、クラウドエージェント
Pro+・Ultra	公式の料金ページで確認	Proより利用上限が大きい
Teams	1人あたり40米ドル	チームの請求と管理、チーム全体のプライバシーモード、SSOなど

料金ページのよくある質問には、すべての価格は適用される税金を含まないと書かれています。日本から申し込む場合は、表示の金額に税金が加わる前提で考えておきましょう。同じページでは、日常的にエージェントを使う人にはPro+、エージェントを使い込む人にはUltraを勧めています。

まずは無料のHobbyで、手元の小さなプロジェクトを開いて試し、毎日使うようになってからProに切り替える、という順番が無駄のない始め方です。最新の金額と含まれる内容は、公式の料金ページで確かめてください。

インストールとサインイン

公式のクイックスタートに沿って、使い始めるまでを説明します。

対応している環境

公式ドキュメントによると、MacはmacOS 12（Monterey）以降で、Apple SiliconとIntelの両方に対応しています。WindowsはWindows 10以降です。Linuxは、DebianやUbuntu、RHELやFedora向けのパッケージと、持ち運びできるAppImage形式が用意されていて、自動更新やコマンドの道具が付くパッケージ形式が推奨されています。

インストールの流れ

公式サイトからインストーラーをダウンロードして、Macなら.dmg、Windowsなら.exeを開いてインストールします。アプリを開いてサインインし、作業したいフォルダを選べば準備は完了です。

VS Codeに近い作りなので、VS Codeを使っていた人は、エディタとしての基本の操作で迷うことは少ないはずです。

最初にやること

公式のクイックスタートが勧めている最初の一歩は、エージェントにコードの全体を説明させることです。Macでは Cmd+I でエージェントの画面を開き、「このコードベースを説明して。最初に読むべき入り口と主なモジュールを教えて」のように頼みます。Cursorがリポジトリを検索し、関係するファイルを読んで、全体の構成をまとめてくれます。知らないコードに入るときの、いちばん速い道です。

Tab・インライン編集・エージェントの使い分け

Cursorには、AIの助けを借りる入り口が大きく3つあります。どれを使うかで、手間と確かめやすさが変わります。

機能	呼び出し方（Mac）	向いている作業
Tab	入力するだけ。提案を受けるときはTab	1行から数行の続きを書く
インライン編集	範囲を選んで Cmd+K	選んだ部分だけを書き換える
エージェント	Cmd+I	複数のファイルにまたがる作業、調べものを含む作業

Windowsでは、CmdをCtrlに読み替えてください。

Tab：入力の続きを提案する

Tabは、Cursorの自動補完の機能です。最近の編集、周りのコード、エラーの情報をもとに、灰色の文字で続きを提案します。受け入れるならTab、断るならEscか、そのまま入力を続けます。Macでは Cmd+→、Windowsでは Ctrl+→ で、1語ずつ受け入れることもできます。

公式のヘルプによると、Tabは複数の行をまとめて書き換えたり、足りないimport文を補ったりできます。提案を受け入れた後にもう一度Tabを押すと、次に編集しそうな場所へ移動します。ほかのファイルにも直しが必要な場合は、そのファイルへの移動も提案されます。

Tabは、マークダウンやJSONのように、補完が邪魔になるファイルでだけ止めることもできます。画面右下のTabの表示から、一時停止や、ファイルの種類ごとのオフを選べます。

インライン編集：選んだ部分だけを直す

インライン編集は、チャットの画面を開かずに、その場でコードを書き換える機能です。直したい範囲を選び、Macなら Cmd+K を押して、「この関数を非同期にして」のように指示します。Returnを押すと、選んだ部分が書き換わります。

質問だけしたいときは、Cmd+K の後にMacなら Opt+Return で質問のモードに切り替えます。変更が1つのファイルの中で収まらないと分かったら、範囲を選んだまま Cmd+L を押すと、選んだコードを渡した状態でエージェントが開きます。

エージェント：まとまった作業を任せる

エージェントは、ファイルの検索、読み込み、編集、ターミナルのコマンドの実行、Webの検索などを組み合わせて、まとまった作業を自分で進めます。公式ドキュメントによると、1つの作業の中で道具を使う回数に上限はありません。

作業の途中で次の指示を入力すると、今の作業が終わった後に順番に処理される「キュー」に入ります。今すぐ方向を変えたいときは、Cmd+Enter でキューを飛ばして送れます。本筋と関係のない疑問は、チャットの入力欄に /side と打って、本来の会話を邪魔しない「サイドチャット」で聞けます。

大きな変更はプランモードから

複数のファイルにまたがる機能の追加や、進め方がいくつも考えられる作業では、いきなりコードを書かせずに、プランモードを使います。エージェントの入力欄で Shift+Tab を押すと切り替わります。

公式ドキュメントによると、プランモードでは、エージェントがまず要件について質問し、コードを調べ、実装の計画を作り、人が承認するまで待ちます。計画はチャットやマークダウンのファイルで直せ、納得したら実行に移します。計画は標準ではホームフォルダに保存され、「Save to workspace」を押すとプロジェクトの中に移せます。

公式ドキュメントには、エージェントが望みと違うものを作ったときは、追加の指示で直そうとするより、変更を戻して計画を具体的にし直してから、もう一度実行するほうが速く、きれいな結果になることが多いとも書かれています。集計の処理を作らせるときも、最初の計画で「どの列を、どの単位で、どう丸めるか」を決めておくと、後から数字の食い違いを追いかける時間を大きく減らせます。

ルールとAGENTS.mdで、プロジェクトの決まりを伝える

AIのモデルは、会話をまたいで記憶を持ちません。毎回同じ説明を繰り返さないために使うのが「ルール」です。公式ドキュメントでは、4種類のルールが説明されています。

種類	保存する場所	効く範囲
Project Rules	プロジェクトの .cursor/rules	そのプロジェクト（Gitで共有できる）
User Rules	Cursorの設定	自分のすべての環境
Team Rules	管理画面	チーム全体（TeamsとEnterprise）
AGENTS.md	プロジェクトの直下やサブフォルダ	そのフォルダ以下

Project Rulesは、拡張子が .mdc のファイルで書きます。公式ドキュメントによると、.cursor/rules に普通の .md ファイルを保存しても、ルールとしては読まれません。設定の項目なしでシンプルに書きたいなら、AGENTS.mdを使うよう案内されています。

ネット上の古い記事では、プロジェクトの直下に .cursorrules というファイルを作る方法が紹介されていることがあります。新しく設定するなら、公式ドキュメントに載っている .cursor/rules かAGENTS.mdを使うのが確実です。

ルールには、いつ読み込まれるかの種類があります。常に読み込む、関係がありそうなときにエージェントが判断して読み込む、特定のファイルを扱うときだけ読み込む、チャットで名前を指定したときだけ読み込む、の4つです。データ分析のプロジェクトなら、「日付は日本時間で扱う」「金額は整数で持ち、表示のときだけ丸める」のような決まりを常に読み込むルールにしておくと、集計の食い違いを最初から防げます。

AIに書かせたコードを確かめる進め方

ここからが、この記事の本題です。Cursorの公式のクイックスタートも、変更を加えた後は差分を見て、プロジェクトで使っているチェックを動かすよう勧めています。実務で回している確かめ方を、5つの段階に分けて説明します。

段階1 差分を自分の目で読む

エージェントが作業を終えたら、まず差分を読みます。差分とは、変更前と変更後で何が変わったかを並べたものです。Cursorでは、エージェントの変更が差分の画面に表示されます。

読むときは、「頼んだ範囲の外が変わっていないか」を最初に見ます。関係のないファイルの書き換えや、消してほしくない処理の削除が紛れていないかを確かめます。次に、変更の中身が意図と合っているかを見ます。全部を理解できなくても、「なぜこの行が変わったのか」を説明できない箇所が残るなら、その場でエージェントに理由を聞きます。

段階2 プロジェクトのチェックを動かす

差分に納得したら、テスト、型のチェック、文法のチェック（リンター）、手元でのビルドなど、プロジェクトですでに使っているチェックを動かします。公式のクイックスタートにも、エージェントにこれらを実行させるよう書かれています。

データの処理なら、テストに加えて、結果の数字の検算を入れます。合計の件数が元のデータと一致するか、平均や合計が手計算と大きくずれていないか、欠けている値の扱いが意図どおりか。テストが通っても、集計の条件が1つ違えば数字は静かに間違います。小さなサンプルで、答えが分かっている計算を流してみるのが確実です。

段階3 Agent Reviewでもう一度見てもらう

自分の目とテストに加えて、AIにレビューをさせる方法もあります。Cursorには「Agent Review」という、手元の変更を専用にレビューする機能があります。

公式ドキュメントによると、始め方は3つあります。設定でオンにしてコミットのたびに自動で走らせる方法、エージェントの入力欄に /agent-review と打つ方法、ソース管理のタブから、手元のすべての変更をメインのブランチと比べてレビューする方法です。レビューの深さは、速くて費用の少ない「Quick」と、時間と費用はかかるが丁寧な「Deep」から選べます。ちょっとした修正ならQuick、複雑な処理やセキュリティに関わる変更ならDeep、と使い分けます。

段階4 チェックポイントで戻れるようにしておく

エージェントは、大きな変更の前に「チェックポイント」を自動で作ります。チェックポイントとは、その時点のファイルの状態を控えておく仕組みです。方向がずれたら、チャットの流れの中のチェックポイントを選んで、その時点のファイルに戻せます。

ただし、チェックポイントはGitの代わりにはなりません。公式ドキュメントには、はっきりこう書かれています。

Checkpoints are stored locally and separate from Git. Only use them for undoing Agent changes; use Git for permanent version control. 出典: cursor.com

「チェックポイントは手元に保存され、Gitとは別のもの。エージェントの変更を取り消すためだけに使い、長く残す履歴の管理にはGitを使う」という意味です。また、チェックポイントで戻されるのはファイルだけで、会話の内容は削除されません。

段階5 区切りごとにGitでコミットする

最後に、確かめ終えた区切りでGitにコミットします。コミットとは、その時点の状態を履歴として保存することです。作業の前に一度コミットしておき、確かめ終えたらまたコミットする。これを繰り返しておけば、どの段階からでも戻れます。

この5段階は、面倒に見えるかもしれません。でも実際には、1回の作業の範囲を小さくしておけば、1回あたりの確認は数分で終わります。大きな変更を一気に任せ、最後にまとめて確かめようとするほうが、結局は時間がかかります。

データ分析の作業で使うときの例

ここまでの使い方を、データ分析の作業に当てはめた例で整理します。毎月の売上のCSVを読み込み、商品の分類ごとに集計してグラフにするスクリプトを作る場面を考えます。

最初に、エージェントをプランモードにして、「月次の売上のCSVを読み込み、分類ごとの売上の合計と前月比を出すスクリプトを作りたい。列の名前はこれ、金額は税込、日付は日本時間」と伝えます。エージェントから「返品の行はどう扱うか」「分類が空の行はどうするか」といった質問が来たら、ここで決めておきます。ここを曖昧にしたまま進めると、後で数字が合わない原因になります。

計画に納得したら実行させ、差分を読みます。読み込みの部分で文字コードや区切り文字が正しく指定されているか、集計の条件が計画どおりかを確かめます。

次に検算です。元のCSVの行数と、集計の対象になった行数が一致するか。分類ごとの合計を足し合わせると、全体の合計と一致するか。前月比が極端な値になっている分類はないか。こうした確認は、表計算ソフトで手で計算した小さなサンプルと突き合わせるのが確実です。

グラフの見た目を整えるような小さな直しは、インライン編集で該当の部分だけを選んで頼みます。凡例の位置や色の調整のように、範囲がはっきりしている作業は、エージェントに頼むより速く終わります。

最後に、Agent ReviewをQuickで走らせ、問題がなければコミットします。翌月からは同じスクリプトを使い回せるので、最初に丁寧に確かめた分だけ、毎月の作業が楽になります。

ターミナルから使うCursor CLI

Cursorには、エディタのほかに、ターミナルからエージェントを使える「Cursor CLI」もあります。公式ドキュメントによると、macOS、Linux、WSLでは1行のコマンドでインストールでき、Windowsのネイティブ環境向けにはPowerShell用のコマンドが用意されています。インストール後は agent と打つと対話の画面が始まります。

CLIでも、エディタと同じようにエージェント、プラン、そして変更を加えずに読むだけの「Ask」の3つのモードを切り替えられます。-p を付けると、対話の画面を開かずに1回だけ結果を出す使い方ができ、スクリプトや自動処理の中で使えます。

データ分析の仕事では、サーバーに入ってバッチ処理の様子を確かめることがあります。エディタを開けない環境でも、CLIなら同じエージェントに手伝ってもらえるので、覚えておくと役立ちます。

エージェントに任せる範囲を決める

エージェントがコマンドを実行するとき、どこまで人の承認なしで動かすかは、「Run Modes」という設定で決めます。デスクトップ版では、設定の「Agents」の中の「Approvals & Execution」にあります。

モード	承認なしで実行されるもの	向いている場面
Auto-review	許可リストのものはすぐ実行。ほかはできるだけ隔離された環境で動かし、それ以外は分類器が確かめる	確認の回数を減らしつつ、危ない操作は点検したい
Allowlist	許可リストに入れた操作だけ	決まった操作だけを任せたい
Run Everything	すべて	危険を承知で、確認をなくしたい

公式ドキュメントは、多くの人にとって安全で使いやすいのはAuto-reviewだとしています。ただし、分類器（操作を点検する小さなAI）は間違えることがあり、「セキュリティの境界ではない」と明記されています。お客様から預かったデータや、本番の環境につながる作業では、確認をなくすモードは選ばないのが基本です。

特定の操作だけは必ず人が確かめたい、という場合は、permissions.json に普通の言葉で書いておけます。たとえば「データベースを書き換えるコマンドは必ず承認を求める」のように伝えると、エージェントがファイルを編集してくれます。

仕事で使う前に確かめておきたいこと

Cursorを仕事で使うときは、作業のやり方だけでなく、データの扱いも確かめておく必要があります。

まず、依頼主のコードやデータをAIに渡してよいかです。契約や依頼主の社内規程で、外部のAIの利用に決まりがあることがあります。迷ったら、使う前に依頼主に確かめましょう。料金ページには、Teamsプランの内容として「チーム全体のプライバシーモード」が挙げられています。学習への利用やデータの保存の扱いは、公式の説明で確かめてから使い始めるのが安全です。

次に、パスワードやAPIキーのような秘密の情報です。設定ファイルに書かれた秘密の情報が、エージェントの読み込むファイルに含まれていないかを確かめます。エージェントに渡す必要のないファイルは、最初から作業の範囲の外に保存しておきます。

最後に、成果物の責任です。AIが書いたコードでも、納品する以上は自分の成果物です。どの部分をAIに書かせたかにかかわらず、説明できない処理を納品しないことが、信頼を守るいちばんの近道です。

使いはじめにつまずきやすい5つの点

Cursorを使い始めた人がつまずきやすい点を、公式ドキュメントの記載と照らして5つにまとめました。

1つ目は、Tabの提案を確かめずに受け入れ続けることです。灰色の提案は便利ですが、変数の名前や条件を少しずつ外していることがあります。受け入れる前に一瞬だけ中身を見る習慣が、後の手戻りを減らします。

2つ目は、エージェントに大きすぎる作業を渡すことです。範囲が広いほど差分が膨らみ、確かめきれなくなります。大きな作業はプランモードで計画を作り、段階に分けて実行します。

3つ目は、古い記事のルールの書き方を写すことです。.cursorrules や、.cursor/rules に保存した .md ファイルは、期待どおりに読まれないことがあります。

4つ目は、チェックポイントだけを頼りにすることです。チェックポイントは手元の一時的な控えで、Gitの履歴とは別物です。区切りごとにコミットします。

5つ目は、会話を長く続けすぎることです。1つの会話でいくつもの無関係な作業を続けると、前の作業の文脈まで抱えたまま進むので、作業が変わったら新しい会話を始めます。

エディタの外側の作業場所も整える

Cursorでコードを書く時間が長くなると、エディタの外側での作業も増えていきます。ターミナルでコマンドを動かし、Finderで生成されたファイルやデータを探し、CSVの中身を確かめる。エージェントをターミナルで動かすようになると、どの窓で何が動いているのかを見失いやすくなります。

ファイルを並べる場所とターミナルを同じ画面にまとめておくと、エディタとの行き来が減ります。その候補の1つが、Mac用のファイル管理アプリのAtriensです。公式サイトによると、フォルダの一覧とターミナルが同じ画面にあり、フォルダを切り替えるとターミナルも一緒に切り替わるので、移動のコマンドを打つ必要がありません。実際の保存場所とは別に、案件ごとにフォルダをサイドバーにまとめて並べられます。変更のあるファイルを一覧で見て差分も確かめられるGitの表示もあり、エディタを開く前に「どこが変わったか」をざっと見るのに使えます。

Mac単体で使う機能は期限なく無料で、アカウント登録も要りません。外出先のiPhoneやiPadから自宅のMacのターミナルを見て打てる機能を使う場合だけ、月額780円、年額6,800円、または買い切り14,800円（いずれも税込）の有料プランになります。AIの利用料はAtriensでは取らず、手元のモデルか自分のAPIキーを使う形です。動作環境はmacOS 14以降、Apple Silicon搭載のMacです。

公式サイト自身が「コードを書くならCursor」と書いているとおり、Atriensはエディタを持ちません。コードはCursorで書き、ファイルとターミナルの整理はAtriensに任せる、と役割を分けると、AIの道具が増えても作業の流れが散らかりにくくなります。

Atriensは、@SOHOを運営する株式会社ライフスケープが開発・提供しています。

AIに書かせたコードを確かめる力は、仕事の単価に表れる

最後に、Cursorのような道具を使えることが、仕事にどうつながるかを考えます。

AIのコーディング道具が広がって、コードを書く速さそのものは、以前ほど差になりにくくなりました。代わりに差が出ているのが、確かめる力です。依頼する側から見ると、AIを使ったかどうかより、納品されたものが正しく動き、数字が合っていて、後から直しやすいかどうかが大事です。この記事で紹介した5つの段階を自分の手順として持っている人は、その点で信頼されやすくなります。

在宅ワークの求人でも、アプリの開発そのものに加えて、AIの道具を社内に導入する手伝いや、業務の自動化の相談に乗る仕事が見られるようになりました。開発の仕事の内容や求められる経験は、アプリケーション開発のお仕事で紹介しています。AIを業務に取り入れる手伝いをする仕事は、AIコンサル・業務活用支援のお仕事で仕事の種類と始め方を整理しています。データの分析や研究に近い仕事の相場を知りたい人は、研究者の年収・単価相場が参考になります。

20年にわたって在宅ワークの市場を見てきた運営者の立場から言えば、長く仕事が続く人は、速さより「この人に任せると確認の手間が要らない」と思われる人です。AIで浮いた時間を、テストや検算の丁寧さに回せる人は、継続の依頼につながりやすくなります。

運営者として見てきた実感では、仲介の手数料が乗らない直接の取引だと、同じ予算で依頼する側はより多く頼め、受ける側は手取りが厚くなります。手数料0%で直接やり取りできる場なら、確認に時間をかける丁寧な仕事も、手取りを削らずに続けやすくなります。開発の仕事でどんな経験が求められているかは、アプリケーション開発のお仕事で確かめてみてください。

よくある質問

Q. Cursorは無料で使えますか？

使えます。公式の料金ページでは、無料のHobbyプランが案内されていて、クレジットカードを登録せずに試せます。ただし、エージェントの利用には制限があります。毎日使うようになったら、1か月あたり20米ドルのProなど有料のプランを検討します。表示の金額には税金が含まれていないので、申し込む前に公式の料金ページで確かめてください。

Q. CursorのTabとエージェントはどう使い分ければよいですか？

入力の続きを1行から数行書いてほしいときはTab、選んだ範囲だけを書き換えたいときはインライン編集（Macは Cmd+K）、複数のファイルにまたがる作業や調べものを含む作業はエージェント（Macは Cmd+I）が向いています。大きな変更は、エージェントをプランモードにして、計画を確かめてから実行すると手戻りが減ります。

Q. Cursorのエージェントが書いたコードを元に戻せますか？

戻せます。エージェントは大きな変更の前にチェックポイントを自動で作り、チャットの流れの中から選んでその時点のファイルに戻せます。ただし、公式ドキュメントはチェックポイントをエージェントの変更の取り消し用とし、長く残す履歴の管理にはGitを使うよう案内しています。作業の区切りごとにGitでコミットしておくのが安全です。

Q. .cursorrulesはまだ使えますか？

新しく設定するなら、公式ドキュメントに載っている .cursor/rules（拡張子は .mdc）か、AGENTS.md を使うのが確実です。.cursor/rules に普通の .md ファイルを保存してもルールとしては読まれないと公式に書かれています。設定の項目なしで簡単に書きたい場合は、プロジェクトの直下にAGENTS.mdを作る方法が案内されています。