Cursorの使い方を初心者向けに徹底解説｜導入から基本操作まで
- CursorはVSCodeをベースにAIを組み込んだコードエディタで、無料プランから始められる。
- Cmd+K（編集）とCmd+L（チャット）の2つを覚えれば基本操作は足りる。
- 無料プランには高度なAI利用回数の上限があり、使い込むなら有料のProが必要になる。
- コードはAI処理のため外部サーバーに送られるため、機密情報の扱いには注意がいる。
- ダウンロードから日本語化、最初のコード入力までの所要時間は約30分・難易度は低め。
Cursorとは？AIコーディングエディタの基礎知識
Cursorとは、VSCodeをベースにAIを深く統合したコードエディタです。普段のコーディング画面の中で、AIに編集を頼んだり質問したりできます。
私はこのメディアのCMSをAI駆動で作っていますが、その大半をCursorで書いています。エディタを離れずにAIと往復できるのが、地味だけど効く。これが一番の価値だと感じています。
Cursorでできること
選択した行をAIに書き換えてもらう、コードベース全体に質問する、エラーを自動で直す。この3つが日常的に使う機能です。
特に効くのは「コード全体に質問できる」点。「この関数どこで呼ばれてる？」と聞くと、プロジェクト全体を見て答えてくれます。grepで探す手間がまるごと消えました。
VSCodeやGitHub Copilotとの違い
VSCodeは拡張機能としてAIを「足す」のに対し、CursorはAIを前提に作られた別アプリです。VSCodeの設定や拡張機能はそのまま引き継げます。
GitHub Copilotとの一番の違いは、Copilotが「補完」中心なのに対し、Cursorは「指示してまとめて書き換える」が得意なこと。正直、補完だけならCopilotでも足りますが、複数ファイルにまたがる作業はCursorの方が速いです。
| 項目 | Cursor | VSCode＋Copilot | 素のVSCode |
|---|---|---|---|
| ベース | VSCode互換 | VSCode | VSCode |
| AIの位置づけ | エディタに統合 | 拡張機能で追加 | なし |
| 得意なこと | 指示で書き換え・全体質問 | コード補完 | 手書き |
| 既存のVSCode設定 | 引き継ぎ可 | そのまま | - |
対応するAIモデルと使い分け
Cursorでは複数のAIモデルを切り替えて使えます。設定画面でモデルを選び、用途に応じて変えられます。
私の使い分けは単純で、長い文脈やリファクタリングはClaude系、軽い質問は速いモデル、という分け方です。迷ったらまず標準のモデルで試して、物足りなければ切り替える。それで十分回ります。
Cursorの料金プランと無料枠の違い
Cursorは無料プランで始められ、AIの利用回数を多く使う人だけ有料プランに移ればよい、という構成です。
具体的な金額や回数の上限はCursor側で改定されることがあるため、契約前に必ず公式の料金ページで最新の数字を確認してください。ここでは数字を断定せず、プランの考え方を整理します。
無料・有料・チーム向けの違い
おおまかには、個人で試す無料プラン、本格利用の有料プラン（Pro）、組織で使うチーム向けプラン（Business）の3段階です。
| プラン | 主な対象 | ざっくりの位置づけ |
|---|---|---|
| Free（無料） | まず試したい個人 | 基本機能とAI利用の上限つき |
| Pro（有料） | 日常的に使う個人 | 高度なAI利用の枠が広い |
| Business（チーム） | 組織・チーム | 管理機能や請求の一元化 |
課金が必要になるタイミング
無料のまま使い続けても、高度なAIモデルの利用回数が上限に達した時点で、有料を検討するタイミングが来ます。
正直に言うと、毎日コードを書く人なら無料枠はわりとすぐ足りなくなります。逆に、月に数回触る程度なら無料のままで困りません。自分の使用頻度で判断するのが現実的です。
自分のAPIキーで使う方法
OpenAIなどの自分のAPIキーを設定すれば、そのキー経由でAIを呼び出せます。
設定画面にキーを入力すると、Cursorの利用枠ではなく自分のAPI課金で動きます。すでにAPIを契約している人には選択肢ですが、初心者はまず標準のまま使う方が分かりやすいです。
Cursorの始め方（所要時間と難易度つき）
ダウンロードから日本語化、最初のコード入力まで、所要時間はおよそ30分・難易度は低めです。
前提として必要なのは、インターネット接続とWindowsまたはMacのパソコン、メールアドレス（サインイン用）だけ。プログラミングの予備知識はなくても進められます。
ダウンロードとインストール
手順は次の通りです。
- 公式サイト（cursor.com）にアクセスする。
- ダウンロードボタンを押し、自分のOS用のインストーラーを取得する。
- ダウンロードしたファイルを開いてインストールする。
- Cursorを起動する。
確認の目安：起動して、VSCodeに似た画面が表示されればここまで正解です。
初回セットアップとサインイン
起動後の最初の画面で、キーボードやテーマ、サインインを順に進めます。
- 初回画面でキーバインドやテーマを選ぶ（後から変更可なので適当でよい）。
- 「Sign In」からアカウントを作成またはログインする。
- ブラウザが開いたら認証を完了し、エディタに戻る。
確認の目安：左下や設定にアカウント名が表示されていれば、サインインは完了しています。
日本語表示に切り替える
日本語化は、日本語の言語パック拡張機能を入れるだけです。
- 左の拡張機能アイコンを開く。
- 「Japanese Language Pack」を検索してインストールする。
- 「Change Language and Restart」を押す（または再起動する）。
確認の目安：再起動後、メニューが日本語で表示されていれば成功です。VSCodeの拡張機能の仕組みをそのまま使えるので、ここはつまずきにくいはずです。
うまくいかないときの対処
よくある詰まりどころを先に挙げておきます。
- サインインのブラウザ認証後にエディタに戻らない→Cursorを一度終了して再起動する。
- 日本語化しても英語のまま→「Change Language and Restart」を押し忘れていないか確認する。
- AIが反応しない→ネット接続とサインイン状態（アカウント名表示）を確認する。
Cursorの基本操作をやってみよう
覚えるべきショートカットは、編集のCmd+K（WindowsはCtrl+K）とチャットのCmd+L（Ctrl+L）の2つだけです。
この2つさえ手になじめば、日々の作業の8割はカバーできます。残りの機能は必要になったときに足せばいい。最初から全部覚える必要はありません。
編集したい行にAIを使う
書き換えたい行を選んでCmd+K、やりたいことを日本語で書く。これで該当箇所をAIが直してくれます。
- 編集したいコードを範囲選択する。
- Cmd+K（Windowsは Ctrl+K）を押す。
- 「この関数に引数のチェックを追加して」のように指示を入力する。
- 提案された変更をプレビューで確認し、採用する。
確認の目安：選択した範囲だけが書き換わり、差分が表示されれば正しく動いています。
AIチャットで質問する
Cmd+Lでチャットを開き、コードについて自由に質問できます。
「このエラーの原因は？」「この処理を分かりやすく説明して」など、対話形式で進められます。選択中のコードはチャットに渡せるので、状況を一から説明する手間が省けます。
ファイルやコード全体を指定する
チャット内で「@」を打つと、特定のファイルやコードベース全体を指定して質問できます。
「@ファイル名」で対象を指定したり、コードベース全体に対して「ログイン処理はどこで実装されてる？」と聞いたりできる。大きめのプロジェクトほど、この機能の威力が出ます。
自動でエラーを直す機能
エラーが出ている箇所には、AIに自動修正を依頼するボタンが表示されます。
実行時エラーやLint（書式チェック）の警告に対して、ワンクリックで修正案を出してくれます。盲目的に採用せず、提案の差分を読んでから取り込むのが安全です。
実務での具体的な活用事例とワークフロー
実務でCursorが効くのは、既存プロジェクトの理解・リファクタリング・テストコード作成・複数ファイルの一括編集の場面です。
ここは私が日々やっていることなので、実体験ベースで書きます。
既存プロジェクトへの導入
既存のコードを開いて、まずコードベース全体に質問するのが導入の第一歩です。
私が引き継いだコードを触るとき、最初にやるのは「この処理の全体の流れを説明して」と聞くこと。ドキュメントが無いプロジェクトでも、構造をつかむ時間が大幅に縮みます。
リファクタリングとテストコード作成
既存コードを選んで「この関数を読みやすく分割して」「この関数のテストを書いて」と頼むのが定番の使い方です。
テストコードは特に相性がいい。既存の実装を見せて生成させると、自分で書くより速く、抜けの少ないケースを出してくれることが多いです。ただし生成されたテストが本当に意味のある検証になっているかは、必ず自分で読みます。
複数ファイルをまとめて編集する機能
Cursorには、複数ファイルにまたがる変更をまとめて指示できる機能（Composer／Agent系の機能）があります。
「この命名規則を全ファイルで統一して」のような横断的な変更が一度の指示で進みます。便利な反面、影響範囲が広いので、私はこの種の操作の前に必ずGitでコミットしておきます。やり直せる状態を作ってから走らせる。これは強く勧めます。
効果的な指示の書き方とルールファイルの設定
AIへの指示は「何を・どこを・どうしたいか」を具体的に書くほど、結果が安定します。
曖昧な指示は曖昧な結果を返す。これはAIコーディングの大原則です。
AIに伝わる指示のコツ
指示には、対象・目的・制約の3つを入れると精度が上がります。
- 対象を明確にする：「この関数」ではなく対象を選択しておく、または@で指定する。
- 目的を書く：「エラーを直して」だけでなく「nullのときに落ちないようにして」。
- 制約を添える：「既存のスタイルに合わせて」「外部ライブラリは増やさないで」。
私の体感では、制約を1行足すだけで的外れな提案がぐっと減ります。
プロジェクトごとのルール設定
プロジェクトのルートにルールファイル（.cursorrules）を置くと、AIに常に守らせたい方針を指定できます。
「コメントは日本語で」「このフレームワークの作法に従って」といった共通ルールを書いておくと、毎回指示し直す手間が消えます。チーム開発では、ここを揃えると出力のブレが減って効きます。
日本語環境での注意点
日本語で指示しても問題なく動きますが、専門用語は英語のまま書いた方が伝わることがあります。
関数名や変数名は英語で指定する方が誤解が起きにくい。日本語の指示文＋英語の固有名詞、という混ぜ方が私の定番です。日本語化はメニュー表示の話で、AIの理解力とは別物だと考えてください。
セキュリティとプライバシーで気をつけること
CursorはAI処理のためにコードを外部のAIサーバーへ送るため、機密情報の扱いには明確なルールが必要です。
ここは導入前に一番気にすべき点です。私も企業導入の相談を受けるとき、最初に確認します。
コードが外部に送られる範囲
AIに渡したコードや、@で指定したファイルの内容は、AI処理のために外部へ送信されます。
つまり、AIに見せた部分は外に出ると考えるのが安全です。Cursorにはコードを学習に使わせない設定（プライバシー寄りのモード）があるため、扱いが気になる場合は設定を必ず確認してください。最新の仕様は公式のプライバシー情報で確認するのが確実です。
機密情報の扱い方
APIキー・パスワード・個人情報を含むファイルは、AIに渡さないのが基本です。
- 認証情報や秘密鍵は環境変数に逃がし、コードに直書きしない。
- 個人情報を含むデータファイルは、AIへの指定対象から外す。
- 送ってよいコードと送ってはいけないコードを、自分の中で線引きしておく。
企業やチームで使うときの注意点
組織で使うなら、コードを学習に使わせない設定を全員で統一し、扱ってよい範囲のルールを先に決めておく必要があります。
私は導入支援で、まず「機密リポジトリでは使わない／使うならプライバシー設定必須」のような社内ルールを文書化することを勧めています。個人の判断任せにすると、必ずどこかで漏れます。Business向けプランの管理機能を使えば、設定を組織側で揃えやすくなります。
初心者がつまずきやすい点とよくある質問
初心者が最初に戸惑うのは「AIの提案をそのまま採用してよいのか」という判断の部分です。
操作自体は難しくありません。難しいのは、AIの出力を見極める目を育てることです。
最初に戸惑いやすいポイントと対策
- AIの提案を全部受け入れてしまう→必ず差分を読んでから採用する。
- Cmd+KとCmd+Lの使い分けが分からない→直接書き換えはK、相談はLと覚える。
- 無料枠の上限が分からず不安→使用頻度が高いなら早めにProを検討する。
- 日本語化したのにAIが英語で返す→指示文の最後に「日本語で答えて」と添える。
よくあるエラーと直し方
AIが反応しない・修正がうまく当たらない、というトラブルの多くは、接続かサインインか指定範囲のどれかが原因です。
- AIが応答しない→ネット接続とサインイン状態（アカウント名表示）を確認する。
- 修正が的外れ→対象を選択し直すか、@でファイルを明示的に指定する。
- 変更を取り消したい→Gitでコミットしておけば前の状態に戻せる。
よくある質問
まずは無料プランで入れて、Cmd+KとCmd+Lだけ触ってみてください。30分後には「これ無しでは戻れない」と思っているはずです。私はそうでした。
