AIエディタCursorガイド

【概要】CursorはAI機能を統合した開発環境である。CursorはVS Codeを基盤としており、操作体系も基本的にVS Codeに準拠する。本ガイドでは、Windows向けのインストール手順、AIによるコード支援機能やチャット機能、VS Code標準のキー操作およびEmacs風キー操作（拡張機能による再現）について解説する。

【本ガイドの前提と注意】

【目次】

  1. Windows向けCursorインストールガイド
  2. Cursorの主な機能
  3. Cursorのテキスト編集操作（Emacs風キー操作）
  4. Cursorのテキスト編集操作（VS Code標準キー操作）

【サイト内のPython関連主要ページ】

【外部リソース】

1. Windows向けCursorインストールガイド

CursorはWindows向けにインストーラ（.exe）形式で配布されている。公式サイトからダウンロードして実行するだけで導入でき、追加の依存パッケージや環境設定は不要である。以下の手順でWindowsにCursorをセットアップする。

手順の概要

  1. Cursorの公式インストーラをダウンロード

    Cursorの公式サイト（https://cursor.com/download）からWindows版インストーラ（.exe）をダウンロードする。

  2. インストーラを実行

    ダウンロードしたインストーラ（.exe）を実行し、画面の指示に従ってインストールする。インストール先やスタートメニューへの登録は既定のままでよい。

  3. Cursorを起動して確認

    インストール完了後、スタートメニューまたはデスクトップのアイコンからCursorを起動する。問題なく起動すれば、基本的なセットアップは完了である。

  4. サインインと初期設定

    初回起動時にサインインを行い、使用するキーマップ（VS Code風またはEmacs風）やAIモデルを選択する。これで利用を開始できる。

補足：アップデート（更新）について

Windows版Cursorは、新しいバージョンが公開されると自動的に更新の通知が表示され、アプリ内から更新できる。手動でファイルを入れ替える必要はない。

2. Cursorの主な機能

Cursorは以下の機能を備えている。なお、本節のショートカットはバージョンにより変わり得るため、正確な割り当ては Cursor 内の「キーボードショートカット」（Ctrl+Shift+P →「Keyboard Shortcuts」）で確認できる。

1. AIによるコード支援機能

コード補完、バグ検出、リファクタリング提案（外部から見た動作を変えずに、コードの構造を読みやすく・保守しやすく改善すること）などをリアルタイムで提供する。これらの機能により、コーディング効率が向上し、バグの早期発見が可能になる。

2. 自然言語によるコード生成（インラインAI編集）

自然言語での指示からコードを生成する機能を備えている。日本語や英語で「ファイルを読み込む関数を作成して」のように指示すると、対応するコードが生成される。

コード上でCtrl+Kを押すとインラインAI編集の入力欄が開き、指示を入力すると該当箇所にコードが生成・編集される。

3. コンテキスト理解

プロジェクト全体のコンテキストを理解し、一貫性のあるコード提案を行う。プロジェクトとは複数のファイルからなるソフトウェア開発の単位であり、コンテキストとは文脈や背景情報を指す。この機能により、既存コードのスタイルや命名規則に沿った提案が得られる。

チャットでは @ を入力することで、特定のファイルやシンボル、コードベース全体などを文脈（コンテキスト）として指定できる。また、コードを選択してCtrl+Shift+Lを押すと、選択範囲をチャットのコンテキストとして追加できる。

4. チャットベースのAIアシスタント

エディタ内でAIとの対話ができる。コードの意味を質問したり、エラーの解決方法を尋ねたりできる。

5. エージェント機能（Agent）

複数ファイルにまたがる編集や、複雑なタスクの自動実行を依頼できる。チャットでの一問一答にとどまらず、目的を伝えるとAIが必要なファイルを横断して編集や生成を進める。Ctrl+Iでエージェント（Agent／Composer）のパネルを開く。AIの動作モード（Agent／Ask／Planなど）は、パネル内のモード選択メニューから切り替えられる。

6. 自動コードドキュメンテーション

関数やクラスに対して、その動作を説明するドキュメントコメントを生成できる。対象を選択してCtrl+K（インラインAI編集）で「この関数のドキュメントコメントを生成して」と指示するか、チャット（Ctrl+L）で同様に依頼する。

7. 複数のエディタスタイル対応

CursorはVS Code標準の操作を採用している。Emacs風の操作に慣れている場合は、VS Code用の拡張機能（例: Awesome Emacs Keymap）を導入することで、Emacs風のキー操作を部分的に再現できる（標準機能ではない）。

キー割り当ての変更は、Ctrl+, から設定を開き「キーボードショートカット」で行える。

8. Gitとの統合

Gitバージョン管理との統合機能を提供する。コミット、プッシュ、差分確認などの操作をエディタ内で行える。サイドバーのソース管理（Git）アイコン、またはCtrl+Shift+Gでアクセスする。

9. AIモデルの選択

Cursorでは複数のAIモデル（Claude、GPTなど）が利用できる。基本的な使用にあたって追加設定は不要である。チャットやComposerの入力欄にあるモデル名のドロップダウンから、利用するモデルを選択・切り替えできる。なお、AIの動作モード（Agent／Ask／Planなど）は、パネル内のモード選択メニューから切り替える。

料金プランは変更が大きく、近年は利用量（クレジット）ベースの体系へ移行している。無料プラン（Hobby）には使用量の制限があり、有料プラン（個人向けのPro／Pro+／Ultra、チーム向けのTeams、組織向けのEnterpriseなど）が用意されている。具体的なプラン名・金額・課金単位は変動するため、必ず公式サイト（https://cursor.com/pricing）で最新情報を確認すること。 また、自分のAPIキー（OpenAI等）を設定して利用する方法（BYOK）も用意されている。

3. Cursorのテキスト編集操作（Emacs風キー操作）

注記: 本節のEmacs風キー操作は、Cursorに標準で備わっているものではなく、VS Code用拡張機能（例: Awesome Emacs Keymap）を導入した場合に利用できる操作である。拡張機能やそのバージョンによって挙動・割り当ては異なる場合がある。記法として、C-はControlキーを押しながら、M-はAltキー（またはMetaキー）を押しながらの操作を意味する。

1. 基本的なカーソル操作とテキスト編集

カーソル移動

テキスト削除

貼り付け（ヤンク）

マーク設定

元に戻す

2. ファイル操作

3. 検索・置換

4. バッファ管理

複数のバッファを同時に管理できる。バッファを切り替えることで、複数のファイルを編集できる。

5. ウィンドウ操作

画面を分割して複数のバッファを同時に表示できる。

6. リージョン指定とマーク設定

テキストの一部を選択するために「リージョン」という概念を使用する。指定したい領域の一方の端に目印（マーク）をつけ、もう一方の端にカーソルを移動すると、その間がリージョンとなる。カーソルを目印の位置に移動してC-SPCを入力するとマークが設定され、ミニバッファ（画面下部の情報表示領域）に「Mark set」と表示される。リージョンはマーク位置から現在のカーソル位置までの範囲になる。

7. テキスト削除（deleteとkill）

Emacs風操作にはdeleteとkillの2種類がある。deleteは文字を消去するのみであるが、killは切り取りの機能を持ち、取り除いたテキストはkill-ringに保存される。kill-ringのテキストは後から取り出せるが、deleteで消去したテキストはアンドゥ以外では復元できない。

8. 複写

リージョンを削除せずにkill-ringへ格納するにはM-wを使用する（kill-ring-save）。

9. 貼り付け

kill-ringからテキストを取り出すにはヤンク（yank）コマンドC-yを使用する。さらに古いテキストを取り出すには、C-yの直後にM-yを入力する（yank-pop）。M-yを入力するたびに、取り出されるテキストがkill-ringの履歴を遡って入れ替わる。

10. 取り消し

C-/を入力すると、直前の操作を取り消す（アンドゥ）。アンドゥは繰り返し実行できる。

4. Cursorのテキスト編集操作（VS Code標準キー操作）

VS Code標準のキー操作は、一般的なWindows/Linuxアプリケーションと同様の操作体系である。これがCursorの既定の操作体系である。

1. 基本的なカーソル操作とテキスト編集

カーソル移動

テキスト削除

コピー・貼り付け

選択範囲

元に戻すとやり直し

2. ファイル操作

3. 検索・置換

4. エディタ（タブ）管理

複数のファイルをタブで管理し、切り替えて編集できる。

5. ウィンドウ（エディタ）分割

画面を分割して複数のファイルを同時に表示できる。

6. 選択範囲の指定

  1. Shift+矢印キーで選択範囲を広げることができる。
  2. Ctrl+Aで全テキストを選択する。
  3. Alt+ドラッグで矩形選択（長方形の領域を選択する機能）ができる。
  4. 単語上でダブルクリックするとその単語全体が選択される。

7. テキスト削除（削除と切り取り）

削除は文字を消去するのみであるが、切り取りはクリップボードにテキストを保存する。

8. 複写

選択範囲をクリップボードに保存するにはCtrl+Cを使用する。マウスドラッグで選択した範囲を右クリックし、コンテキストメニューからコピーすることもできる。

9. 貼り付け

クリップボードのテキストを貼り付けるにはCtrl+Vを使用する。右クリックしてコンテキストメニューから貼り付けを選択することもできる。

10. 取り消し

Ctrl+Zを入力すると、直前の操作を取り消す（アンドゥ）。Ctrl+Yでやり直し（リドゥ）ができる。アンドゥは繰り返し実行できる。