Cursorは、コードを書く・読む・直すといった作業をAIと一緒に進められる「AIコードエディタ」です。ただ、機能が多く、最初はどこから触ればよいか迷いがちです。この記事では、インストールと初期設定、Tab補完、チャット、Agentの基本操作、そのまま試せるプロンプト例、つまずきやすい点の対処、Rulesなどの上級テクニックまでを順番に解説します。読み終えるころには、自分のプロジェクトでCursorを使い始められる状態になります。
前提条件：必要な環境・アカウント・料金
まず、Cursorを使い始める前に用意しておくものを整理します。
| 項目 | 内容 |
|---|---|
| 対応OS | Windows / macOS / Linux（対応バージョンは公式のダウンロードページで確認） |
| アカウント | Cursorのアカウント（メールアドレスやGoogleアカウントなどで作成） |
| ネットワーク | AI機能はクラウド上のモデルを利用するため、インターネット接続が必要 |
| 開発環境 | 作業したい言語のランタイム（Node.js、Pythonなど）は別途自分で用意する |
| 料金 | 無料プランあり。有料プラン（Pro、Teamsなど）は利用量の上限や使えるモデルが異なる |
※VS Codeとは: Microsoftが公開している人気のコードエディタです。CursorはVS Codeをベースに作られているため、画面構成や拡張機能の考え方がよく似ています。VS Codeを使った経験があれば、すぐに慣れられます。
料金プランの内容や利用上限は、改定されることがあります。契約前に必ずCursor公式の料金ページで最新情報を確認してください。プランの考え方や機能の全体像は、Cursorとは？AIコードエディタの機能・料金・始め方を解説の記事でも整理しています。
なお、プログラミング経験がまったくない場合でも使い始めることはできます。ただし、AIが出したコードが正しいかを判断するには、最低限の読解力が必要です。「AIに任せきり」にせず、変更内容を確認しながら進める前提で読み進めてください。
基本的な使い方：セットアップから最初の操作まで
ここでは、インストールからAIに最初の指示を出すまでを、手順に沿って説明します。
ステップ1：インストールと初回設定
- Cursor公式のダウンロードページを開き、自分のOSに合ったインストーラーを入手します。
- インストーラーを実行し、画面の案内に従ってインストールします。
- Cursorを起動すると、初回セットアップの画面が表示されます。画面の案内に従って進めます。
- 画面の指示に従い、アカウントを作成してログインします。ブラウザが開き、認証後にCursorへ戻る流れが一般的です。
- 初回セットアップでは、VS Codeの設定や拡張機能を取り込む選択肢が表示されることがあります。VS Codeユーザーは取り込むと、これまでの環境を引き継げます。
※拡張機能とは: エディタに機能を追加する小さなプログラムです。言語サポート、フォーマッタ、Git連携などがあり、Cursorでも利用できます。ただし一部の拡張機能は、VS Codeと同じ配布元から入手できない場合があります。使いたい拡張機能は、事前に動作を確認しておくと安心です。
ステップ2：プロジェクトのフォルダを開く
Cursorは、フォルダ単位で作業します。AIはこのフォルダ内のファイルを手がかりに回答するためです。
- メニューの「File」から「Open Folder」を選びます（macOSでは日本語環境でも英語表記のことがあります）。
- 作業するプロジェクトのフォルダを選択します。まだ何もなければ、空のフォルダを新規作成して開いても問題ありません。
- 左側のエクスプローラーにファイルが一覧表示されれば成功です。
ステップ3：Tab補完を試す
Cursorの最も手軽なAI機能が、Tabキーで受け入れる「Tab補完」です。
- 適当なファイル（例：
sample.py）を作成します。 - 関数名やコメントを書き始めます。たとえば「# 2つの数を足す関数」とコメントを書き、改行します。
- 薄い文字で続きのコードが提案されます。
- 提案を受け入れるなら Tab キー、不要なら Esc キーを押します。
※Tab補完とは: 入力中のコードの続きをAIが予測して提示する機能です。従来の単語補完と違い、複数行にわたる提案や、直前の編集の流れを踏まえた提案が出ることがあります。
ステップ4：AIパネル（チャット／Agent）に指示を出す
Tab補完の次に覚えたいのが、サイドのAIパネルです。自然な日本語で指示を出せます。
- ショートカット（Windows/Linuxは Ctrl+L、macOSは Cmd+L が一般的）でAIパネルを開きます。見つからない場合は、画面上のAIアイコンから開けます。
- 入力欄の近くにあるモード切り替えで、使いたいモードを選びます。
- 入力欄に指示を書き、送信します。
- 回答がコードの変更を伴う場合は、変更箇所が差分（diff）で表示されます。
- 内容を確認し、問題なければ承認（Accept）、不要なら破棄（Reject）します。
※差分（diff）とは: 変更前と変更後の違いを並べて見せる表示です。追加された行は緑、削除された行は赤で示されるのが一般的です。AIの変更は必ずここで確認する習慣をつけましょう。
※モード名や画面構成は、バージョンアップで変わることがあります。この記事の画面説明は一例です。実際の表示は、公式のCursorドキュメントと見比べてください。
ステップ5：保存してGitで記録する
AIが加えた変更を確認したら、ファイルを保存し、動作を確かめます。その後、Gitでコミットしておくと、あとから元に戻しやすくなります。AIに大きな変更を頼む前には、いまの状態をコミットしておくことを強くおすすめします。
※Gitとは: ソースコードの変更履歴を記録・管理する仕組みです。コミットは「ある時点の状態を保存すること」を指します。
主要機能の使い分け
Cursorには、似た用途の機能がいくつかあります。目的別に使い分けると効率が上がります。
| 機能 | 向いている場面 | 起動のしかた（一例） |
|---|---|---|
| Tab補完 | 書きながらの短い補完、定型コードの入力 | 入力中に自動表示、Tabで受け入れ |
| インライン編集 | 選択した範囲だけを指示で書き換える | コードを選択して Ctrl+K / Cmd+K |
| チャット（Askなど） | 質問、コードの解説、設計の相談 | AIパネルで質問系のモードを選ぶ |
| Agent | 複数ファイルにまたがる実装、修正、調査 | AIパネルでAgentモードを選ぶ |
ショートカットはバージョンや設定によって異なる場合があります。確認するときは、コマンドパレット（Ctrl+Shift+P / Cmd+Shift+P）で「Keyboard Shortcuts」を検索して開き、一覧を見るのが確実です。
※Agentとは: ユーザーの指示を受けて、ファイルの読み取り、コードの編集、ターミナルでのコマンド実行などを、AI自身が段取りを考えながら進める機能です。ユーザーが細かく指示しなくても、複数の作業をまとめてこなせます。一方で、実行内容の確認は人間の責任になります。
インライン編集の使い方
インライン編集は、「この関数だけ直したい」という場面で便利です。
- 書き換えたいコードの範囲をマウスで選択します。
- Ctrl+K（macOSはCmd+K）を押します。
- 小さな入力欄が出るので、指示を書きます。例：「この関数に型ヒントを付け、docstringを追加して」
- 提示された差分を確認し、承認します。
@でコンテキストを指定する
AIパネルで @ を入力すると、参照させたいファイルや情報を指定するメニューが表示されます。
※コンテキストとは: AIが回答を作るときに参照する情報のことです。開いているファイル、指定したファイル、ドキュメントなどが含まれます。適切なコンテキストを渡すほど、回答の精度は上がります。
代表的なものは次のとおりです。メニュー項目は、バージョンにより増減することがあります。
| 指定 | 用途 |
|---|---|
| @Files | 特定のファイルを参照させる |
| @Folders | フォルダ全体を参照させる |
| @Code | コードの一部（関数など）を参照させる |
| @Docs | ドキュメントを参照させる |
| @Web | Web検索の結果を参照させる |
| @Git | Gitの履歴や差分を参照させる |
実践的な活用例
以下は、Cursorの使い方を理解するための「例」です。プロンプトは自分のプロジェクトに合わせて書き換えてください。結果はプロジェクトやモデルにより変わります。
活用例1：既存プロジェクトの構造を理解する
引き継いだコードや、オープンソースのリポジトリを読むときに有効です。変更を伴わない質問系のモード（Askなど）を使うと、誤って書き換える心配がありません。
手順は次のとおりです。
- 対象のフォルダをCursorで開きます。
- AIパネルを開き、質問系のモードを選びます。
- 次のようなプロンプトを送ります。
このプロジェクト全体の構成を、初心者にもわかるように説明してください。
- 主要なディレクトリの役割
- エントリーポイント（最初に実行されるファイル）
- 使われている主なライブラリ
- 処理の大まかな流れ
最後に、最初に読むべきファイルを3つ挙げてください。気になった箇所は、@Files でファイルを指定して追加質問します。
@src/api/user.ts の fetchUser 関数は、どんな入力を受け取り、
どこでエラー処理をしていますか？ 処理の流れを順番に説明してください。ポイントは、質問を「範囲を絞って具体的に」することです。「全部説明して」よりも、「この関数の入出力を教えて」のほうが、役立つ回答を得やすくなります。
活用例2：Agentで新機能を実装する
小さなWebアプリ（ToDoアプリなど）に機能を追加するシナリオです。
- 作業前にGitでコミットしておきます。
- AIパネルでAgentモードを選びます。
- 目的・条件・完了の基準を、具体的に書いて送ります。
ToDoアプリに「タグで絞り込む」機能を追加してください。
# 要件
- 各ToDoに複数のタグを付けられる
- 画面上部のタグ一覧をクリックすると、そのタグのToDoだけ表示する
- もう一度クリックすると絞り込みを解除する
# 制約
- 既存のコーディングスタイルに合わせる
- 新しいライブラリは追加しない
- 変更するファイルの一覧を最初に提示する
# 完了条件
- 既存のテストが通る
- 新機能のテストを追加する- Agentが作業計画や変更を提示します。コマンド実行の許可を求められた場合は、内容を読んでから許可します。
- 差分を1ファイルずつ確認し、承認または破棄します。
- アプリを実際に動かして挙動を確かめます。
指示が大きすぎると、意図しない変更が増えがちです。「データ構造の変更」「画面の変更」「テストの追加」のように、段階に分けて依頼すると安定します。
活用例3：エラーメッセージからバグを修正する
エラーが出たときは、エラー内容と状況をセットで渡すのがコツです。
- ターミナルに出たエラーメッセージをコピーします。
- AIパネルに貼り付け、状況を添えて送ります。
次のエラーが出ました。原因を調べて、修正案を提示してください。
まず原因の仮説を説明し、そのあとで修正してください。
# 実行したこと
npm run build を実行
# エラーメッセージ
（ここにエラー全文を貼る）
# 関連しそうなファイル
@src/components/Header.tsx- 原因の説明を読み、納得できるかを確認します。
- 修正の差分を確認し、再度ビルドや実行を行って解消されたかをチェックします。
- 解消しない場合は、新しいエラーを同じ形式で渡して繰り返します。
「原因の仮説を先に説明させる」ことで、AIが的外れな修正を始めたときに気づきやすくなります。同じ手順で、テストの失敗も調べられます。
よくあるつまずきポイントと対処法
初心者がつまずきやすい点を、表にまとめます。
| つまずき | 主な原因 | 対処法 |
|---|---|---|
| AIが的外れな回答をする | コンテキスト不足、指示が曖昧 | @でファイルを指定し、目的・条件・制約を書く |
| 意図しないファイルまで変更された | 指示の範囲が広すぎる | 変更するファイルを限定する。事前にコミットして差分を確認する |
| 古い書き方や存在しない関数を使う | モデルの知識が最新でない | @Docsや@Webで最新の資料を参照させる |
| 回答が長い会話の途中で乱れる | 会話が長くなり、情報が散らかる | 新しいチャットを開始し、必要な情報だけを渡し直す |
| 利用上限に達した | プランの利用枠を使い切った | 利用状況を確認し、必要ならプラン変更を検討する |
| 拡張機能が動かない | 配布元や互換性の違い | 拡張機能の対応状況を確認し、代替を探す |
| 補完が出ない | 設定の無効化、ネットワークの問題 | 設定でTab補完が有効か確認し、接続状況を見直す |
AIの出力をそのまま信じない
生成AIは、もっともらしいが誤ったコードを出すことがあります。次の習慣をつけると、事故を減らせます。
- 差分は必ず読んでから承認する
- 動かして確認する。テストがあれば実行する
- 理解できないコードは、「このコードを1行ずつ説明して」と質問してから採用する
- 認証、決済、データ削除など影響の大きい部分は、特に慎重にレビューする
機密情報の扱いに注意する
AI機能を使うと、コードの一部が外部のサーバーに送信されます。APIキー、パスワード、個人情報などを含むファイルの扱いには注意が必要です。
- 秘密情報は
.envなどに分離し、コードに直接書かない - AIに読ませたくないファイルは、除外設定（
.cursorignoreなど）の利用を検討する - データの取り扱い（プライバシー関連の設定）は、公式ドキュメントで内容を確認する
- 会社・組織で使う場合は、社内のセキュリティルールを必ず確認する
除外設定の書き方や挙動の詳細は変わる可能性があるため、公式ドキュメントの最新の記載を参照してください。
利用量とコストの考え方
Agentで大きな作業を頼むと、AIへのリクエスト量が増えます。プランごとの上限や課金の仕組みは変更されることがあるため、設定画面で利用状況を確認し、料金ページの最新の説明と照らし合わせる習慣をつけましょう。
上級者向けのテクニック
基本に慣れたら、次のテクニックで精度と効率をさらに高められます。
Rulesでプロジェクトのルールを固定する
毎回同じ前提をプロンプトに書くのは手間です。Rulesを使うと、プロジェクトの方針をAIに継続的に伝えられます。
※Rulesとは: AIに常に守らせたい指針（コーディング規約、使用技術、禁止事項など）を、ファイルとして保存しておく仕組みです。一般に、プロジェクト内の .cursor/rules ディレクトリなどに置く形式が使われます。設定場所や書式は更新されることがあるため、最新の手順は公式ドキュメントで確認してください。
ルールの内容は、たとえば次のような短い箇条書きから始めるとよいでしょう。
# プロジェクトのルール（例）
- 言語はTypeScript（strictモード）を使う
- コメントと説明は日本語で書く
- 新しい外部ライブラリは、事前に相談してから追加する
- 関数には必ずテストを書く
- 既存のディレクトリ構成と命名規則に従うルールは長すぎると効果が薄れます。「AIが間違えやすい点」「プロジェクト固有の約束事」に絞って、短く保つのがコツです。間違いが繰り返されたら、そのたびにルールへ追記して育てていきます。
計画を立ててから実装させる
大きな機能は、いきなり実装させず、まず計画を作らせると失敗が減ります。Cursorには計画を立てるためのモード（Planなど）が用意されている場合があります。モードがない場合も、次のように依頼すれば同じ効果が得られます。
まだコードは変更しないでください。
次の機能を実装するための手順を、ファイル単位で計画してください。
不明点があれば、実装前に質問してください。
機能：ユーザー設定画面にダークモードの切り替えを追加する計画を人間がレビューし、「3番は不要」「テストを先に書く」などの修正を入れてから、実装を依頼します。
MCPで外部ツールとつなぐ
※MCP（Model Context Protocol）とは: AIアプリと外部のツールやデータ（データベース、タスク管理、ドキュメントなど）をつなぐための共通ルールです。対応するサーバーを設定すると、AIが外部の情報を参照したり、外部のツールを操作したりできるようになります。
設定方法は、公式ドキュメントのMCPの項目に従ってください。接続先に権限を与えるため、信頼できるサーバーだけを使い、渡す権限は必要最小限にします。
画面を見ながらUIを調整するDesign Mode
当サイトの記事によると、2026年6月5日に、ブラウザ上でUIを操作して変更を指示できる「Design Mode」が登場し、その後も改善が続いています。フロントエンド開発で、見た目の微調整を素早く行いたい場面に向いた機能です。利用方法や対応状況は、アップデートのたびに変わる可能性があるため、公式の更新履歴（Changelog）で最新の情報を確認してください。
クラウドやセルフホストでAgentを動かす
Cursorでは、自分のPCの外でAgentを動かす方向の機能も追加されています。当サイトでは次の記事で解説しています。
- 大規模な開発をAgentに任せる流れについては、【Cursor】Projects機能リリース！AIエージェントによる自律開発の全貌で紹介しています。
- 自社のインフラでAgentを実行したい場合は、【Cursor】セルフホスト環境対応！AIエージェントの実行を自社インフラへが参考になります。
これらは、利用できるプランや提供状況が変わる可能性があります。導入前に、公式の最新情報を確認してください。
日々の使い方を磨く小さなコツ
- 1つのチャットでは、1つの目的に絞る
- うまくいった指示の型（要件・制約・完了条件）を、テンプレートとして保存しておく
- 大きな変更の前には、必ずコミットする
- 「なぜその実装にしたのか」を質問し、学習にも活用する
- 更新が頻繁なツールなので、機能が変わったときは公式の更新履歴を定期的に確認する
まとめ
- Cursorは、VS Codeをベースにしたエディタです。公式サイトからインストールし、アカウントを作成すれば、すぐに使い始められます。
- 基本は、Tab補完、インライン編集、チャット、Agentの4つです。目的に応じて使い分け、
@で必要なコンテキストを渡すと精度が上がります。 - プロンプトには「目的・要件・制約・完了条件」を書き、大きな作業は段階に分けます。作業前のコミットと、差分のレビューは必ず行いましょう。
- つまずいたら、コンテキストの追加、新しいチャットでのやり直し、最新ドキュメントの参照を試します。機密情報の扱いにも注意してください。
- 慣れてきたら、Rules、計画の作成、MCPなどで精度と効率を高められます。料金や機能は変わるため、公式ドキュメントや料金ページで最新情報を確認してください。
Cursorそのものの特徴をもう少し詳しく知りたい方は、Cursor AIとは？機能・料金・始め方を初心者向けに解説もあわせてご覧ください。
よくある質問
Cursorは無料で使えますか？
無料プランが用意されており、基本機能を試せます。ただし、AI機能の利用量やモデルには上限があり、有料プラン（ProやTeamsなど）では枠が広がります。内容は変更されることがあるため、契約前に公式の料金ページで最新情報を確認してください。
VS Codeの拡張機能や設定はそのまま使えますか？
CursorはVS Codeをベースにしており、初回セットアップで設定や拡張機能を取り込める場合があります。ただし、すべての拡張機能が同じように動くとは限りません。重要な拡張機能は、事前に動作を確認しておくと安心です。
プログラミング初心者でもCursorを使えますか？
日本語で指示を出せるため、初心者でも使い始められます。ただし、AIのコードが常に正しいとは限りません。差分を確認し、動作テストを行う習慣をつけ、不明な点は「この部分を説明して」と質問しながら進めるのがおすすめです。
AgentとチャットのAskモードは何が違いますか？
Askのような質問系のモードは、コードの解説や相談に使い、基本的にファイルを書き換えません。Agentは、ファイルの編集やコマンド実行まで自律的に進めます。調査はAsk、実装や修正はAgentというように使い分けると安全です。
会社のコードをCursorで扱っても安全ですか？
AI機能の利用時にはコードの一部が外部へ送信されます。取り扱いの方針やプライバシー関連の設定は、公式ドキュメントで確認してください。業務で使う場合は、社内のセキュリティ規定に従い、必要に応じて管理者や情報システム部門に相談しましょう。
