Cursorを使い始める前に：インストール、アカウントとプラン、VS Codeからの移行、最初に決めること、Rulesと AGENTS.md を、公式ドキュメントで確かめる

この記事は公式ドキュメントを2026年10月22日に読んでまとめたもので、実際に使って確かめた記録ではありません。運営者はCursorを入れていますが、使い心地はこの記事には書いていません。コマンド、メニュー名、設定名、価格は公式の表記を写しただけで、動作確認はしていません。公式の文章は要約の形で取得したため、引用は少数にとどめ、ほとんどは言い換えています。

先に結論

• まず決めること。 ①どこで使うか（エディタ、ターミナルのCLI、ブラウザなどから動かすCloud Agents）、②どのアカウントとプランで入るか、③どのフォルダで、どんな小さな作業から始めるか、の3つです。
• 入れ方。 エディタ版は cursor.com/downloads からOS用のものを入れ、サインインしてフォルダを開きます。CLIは、公式の1行コマンドで入ります。
• VS Codeを使っていた人。 Cursor Settings の「VS Code Import」を使うと、拡張機能・テーマ・設定・キーバインドを取り込めると書かれています。取り込めないものが何かは、読んだ範囲では見つかりませんでした。
• 覚え書き。 毎回言い直していることは、プロジェクトの Rules か AGENTS.md に書きます。ただし、公式は、AIへの指示だけを唯一のセキュリティ対策にしないよう注意しています（Team Rules の説明にある記載）。

前提：用語をそろえる

エディタ版のインストール

公式のQuickstartとダウンロードページ、ヘルプの手順をまとめます（確認日10月22日）。

Quickstartは、aptとyumのパッケージを勧めています。デスクトップのアイコン、自動更新、CLIツールが付くから、という理由です。メモリやディスクなどのハードウェア要件は、読んだ範囲では見つかりませんでした。

ヘルプの「インストール」ページの流れは、次のとおりです。ダウンロードしたファイルを開く、Macならアプリケーションフォルダへ移す、Windowsならインストーラーの案内に従う、起動する、初回に Cursor アカウントでサインインする、File > Open Folder でプロジェクトのフォルダを開く、です。ダウンロードページの最新版表示は 3.24 でした。版番号は変わります。

CLIのインストールとログイン

公式のCLIのページに載っているコマンドです。

• macOS、Linux、Windows（WSL）: curl https://cursor.com/install -fsS | bash
• Windows（PowerShellで直接）: irm 'https://cursor.com/install?win32=true' | iex
• 入ったか確認: agent --version。見つからないときは、~/.local/bin をPATH（コマンドを探す場所の一覧）に入れる手順が公式に書かれています。
• 起動: agent。更新: 既定で自動更新。手動なら agent update。

ログインは、agent login でブラウザが開き、Cursorアカウントでサインインします。ブラウザを開かずURLだけ出したいときは NO_OPEN_BROWSER=1 agent login です。agent logout で認証情報を消し、agent status で状態を見ます。自動化やCI向けには、ダッシュボードの API Keys で作ったキーを、環境変数 CURSOR_API_KEY で渡す方法があり、公式はこの環境変数を推奨としています。コマンドライン引数の --api-key もあります。

僕らの注意です。「ネットの文字列をそのままシェルに渡して実行する」形のコマンドなので、実行前に中身を読む習慣をつけたいところです。これは公式の文言ではなく、僕らの見立てです。

アカウントとプラン（公式の表示のまま）

ヘルプには、Cursorアカウントが必要で、サインアップは cursor.com で無料と書かれています。サインインの方法（メール、外部アカウントなど）は、読んだ範囲では見つかりませんでした。登録ページ自体は、取得が許可されず読めていません。

料金は、公式の「Models & Pricing」と、ヘルプの「Pricing and plans」に載っていました。2つのページで同じ表でした。ヘルプのページは、この体系を「The X Subscription」と呼んでいます。

年額は、Plus が $80、Premium が $300、Super が $1,000、Ultra が $2,000 と書かれています。税は含まれません。日本円の表示は、読んだ範囲では見つかりませんでした。上の金額は2026年10月22日に公式ページで読んだもので、変わることがあります。購入前に必ず公式の最新の表示を見てください。

プランごとの違いとして、公式に書かれていた点です。

• Free。 AgentとChatが限られた量で使えます。
• Plus。 Cursor自社のモデルが、固定の設定（Fastはオフ、effortはmedium）で使えます。Auto、Cloud Agents、Automations、Bugbot、Origin、サードパーティのモデル、自分のAPIキーは含まれない、と書かれています。
• Premium以上。 Cloud Agents、Automations、Bugbot、サードパーティのモデルが加わります。サードパーティのモデルは、APIの定価で、前払いのクレジットから払われます。
• Teams。 席の種類は Premium、Super、Ultra で、Plus はチームでは使えません。中央での請求、利用分析、Privacy Mode の強制、SAML/OIDC のSSOなどが加わります。

使用量の考え方。 有料プランには、Cursorのモデル用に「週ごとのプール」が1つ付き、エディタのAgent、CLI、Cloud Agentsなどで共有される、と公式は書いています。プールが尽きたときは、更新を待つ、前払いクレジット（トップアップ）を使う、プランを上げる、の選択肢が書かれています。月ごとの追加利用の上限を決める設定もあります。

切り替えの注意（ヘルプの記載）。 古い契約者がこの新しい体系に切り替えると、いまのCursorの契約は日割りの返金つきで解約され、この変更は元に戻せない、と書かれています。古いプランは新規の人には提供されず、既存の契約者には続きます。古いプランの名前と価格は、Hobby（無料）、Pro（$20/月）、Pro+（$60/月）、Ultra（$200/月）、Teams Standard（$40/人/月）、Teams Premium（$120/人/月）で、インド向けの Start は ₹649/月（税込）と表示されていました。無料トライアルについては、読んだページには書かれていませんでした。

VS Codeから移る

ヘルプとdocsの「VS Code Migration」を読みました。

1回のクリックで取り込む。 Cursor Settings を開き（Mac は Cmd+Shift+J、Windows/Linux は Ctrl+Shift+J）、General > Account の VS Code Import で Import を押します。拡張機能、テーマ、設定、キーバインドが取り込まれる、と書かれています。何が取り込まれないのか、設定がぶつかったときにどうなるのかは、読んだ範囲では見つかりませんでした。

手動でプロファイルを移す。 もっと細かく決めたい人、別のパソコンへ移す人向けです。VS Code側で、コマンドパレットから「Preferences: Open Profiles (UI)」を開き、プロファイルの3点メニューから「Export Profile」でファイルかGitHub Gistへ書き出します。Cursor側でも同じ「Preferences: Open Profiles (UI)」を開き、「New Profile」の横のメニューから「Import Profile」を選び、Gist のURLかファイルを指定して「Import」を押し、できたプロファイルを有効にします。

違うところ。 - 拡張機能は Open VSX から入ります。ヘルプは、すべてのVS Code拡張機能が載っているわけではなく、まったく同じに動かないものもある、と書いています。 - 既定のキーボードショートカットはVS Codeと同じです。 - Cursor のアクティビティバー（左端のアイコン列）は、既定で横向きです。縦にしたいときは、設定 workbench.activityBar.orientation を vertical にして、Cursorを再起動します。 - Cursor は VS Code を定期的に取り込んだ形ですが、安定性のために、少し古いVS Codeの版で動くことが多い、と書かれています。 - CursorとVS Codeは別のアプリで、同じプロジェクトを両方で開いて使えます。

最初に決めること：どこで、どのフォルダで、何から

1. どこで使うか。 エディタ版、CLI、Cloud Agentsの3つが、公式のダウンロードページに並んでいます。迷ったら、エディタ版が出発点です。Cloud Agentsは、クラウドの機械でエージェントを動かす形で、2本目の記事で扱うように、承認の仕組みがエディタ版とは違います。

2. どのフォルダで始めるか。 Quickstartは、アプリを開いてサインインし、フォルダを選んで、小さな作業から始めるよう書いています。エージェントは、そのフォルダ（ワークスペース）の中のファイルを、承認なしで編集できる、とセキュリティのページに書かれています。つまりフォルダ選びは、作業の範囲を決めることでもあります。大事なものが入ったフォルダの直下で、いきなり始めない、というのが僕らの見立てです。

3. 最初の作業。 Quickstartの流れは次のとおりです。

1. Agent を開いて（Cmd I または Ctrl I）、コードベースの説明を頼む。公式の例文は、入口になるファイルや主要なモジュールを教えて、というもの。
2. 小さく安全な改善を3つ、利点と欠点つきで挙げてもらい、選んで頼む。コピーの修正や小さなUIの直しなど、リスクの低い作業を勧めています。
3. 差分（diff）の画面で変更を確認し、テスト、型チェック、リント、ビルドなど、プロジェクトの既存の確認コマンドを走らせてもらう。
4. 複数のファイルにまたがる変更や、調べものが多い作業では、エージェントの入力欄で Shift+Tab を押して Plan Mode にする。コードを調べ、質問をし、計画を作り、承認を待ってから作る、と書かれています。

4. 戻せるようにしておく。 Agentは、大きな変更の前に、変更するファイルのスナップショット（チェックポイント）を作り、チャットの履歴から戻せます。ただしチェックポイントはローカルに保存され、Gitとは別物です。セキュリティのページは、ファイルの変更はすぐディスクに書かれるので、元に戻すにはバージョン管理を使うよう書いています。始める前にGitで状態を残しておくのが安心、というのは僕らの見立てです。

5. Privacy Modeを確認する。 初回のセットアップの流れに、Privacy Modeを選ぶ画面があるかどうかは、読んだページには書かれていませんでした。設定の場所は Cursor Settings > General です。仕事のコードを扱うなら、先に2本目の記事を読んでください。

RulesとAGENTS.md：毎回の説明を省く仕組み

公式のRulesのページによると、指示の置き場所は4種類です。

Project Rulesの書き方。 拡張子は .mdc で、先頭にメタデータ（frontmatter）を書きます。拡張子が .md だけのファイルはメタデータがないので無視される、と公式に書かれています。項目は description、globs、alwaysApply の3つで、ルールの種類のドロップダウンを切り替えると、これらが変わります。適用のしかたは4通りです。

• Always Apply（alwaysApply: true）: 毎回のチャットに入る。
• ファイルの種類で自動的に付く（alwaysApply: false と globs）: 一致するファイルが文脈にあるとき。globs は src/**/*.tsx のようなパターンで、カンマ区切りで複数指定できる。
• Apply Intelligently（description だけ）: Agentが説明を読んで、入れるか決める。説明が必須。
• Apply Manually: チャットで @my-rule のように名指ししたときだけ。

ファイルの参照。 ルールの中で @service-template.ts のようにファイルを書いても、中身がそのまま入るわけではなく、Agentが必要なときに道具で読みに行く、と書かれています。いつも文脈に入れたいことは、ルール本体に書きます。

AGENTS.md。 メタデータも設定もない、ただのMarkdownを、プロジェクトのルートに置きます。サブフォルダにも置け、そのフォルダ以下のファイルを扱うときに適用されます。親フォルダの指示と合わさり、細かい側が優先されます。CLIについては、.cursor/rules に加えて、プロジェクトのルートの AGENTS.md と CLAUDE.md も読んで適用する、と書かれています。

Team Rules。 管理者がダッシュボードで作ります。「Enforce this rule」を付けると必須になり、利用者が Customize で無効にできなくなります。優先順位は、Team Rules、Project Rules、User Rules の順で、すべて合わされ、ぶつかる場合は前の側が勝ちます。公式は、ルールを強制しても、AIへの指示は唯一のセキュリティ対策にしないように、と注意しています。

書き方のコツ（公式の記載）。 1つのルールは500行未満にし、大きいものは小さく分けます。具体的に書き、例や参照ファイルをつけます。ファイルは写さず参照して、古くならないようにします。スタイルガイドを丸ごと貼る、エージェントがすでに知っているコマンドを書く、めったにない例外を書く、は勧められていません。ルールは、同じ間違いをエージェントが繰り返すときに足し、gitに入れます。

ほかの注意。 User Rules は、インライン編集（Cmd/Ctrl+K）には適用されません。Rules は Cursor Tab など、ほかのAI機能には影響しません。リポジトリのルールの取り込みは自動ではなく、プラグインにして、マーケットプレイス経由で公開する必要があるとされ、.cursor-plugin/marketplace.json が要るとも書かれています。.cursorrules という古い形式については、読んだページに記載がありませんでした。

誤解されやすい点と、今日からできること

誤解されやすい点

• 「ルールに書けば必ず守られる」わけではない。 公式は、ルールを強制する場合でも、AIへの指示だけをセキュリティ対策にしないよう書いています。「必ず止めたい」ことは、2本目の記事で扱う承認や許可の設定の役目です。
• 「プランに入れば全部使える」わけではない。 Plus には Cloud Agents、Auto、サードパーティのモデルが含まれません（公式の表示）。
• 「Cursorは別のエディタ」だけではない。 VS Codeの設定を取り込めますが、拡張機能の入手元が違います。

今日からできること、避けたいこと

• できること。 ①エディタ版を入れ、サインインして、練習用の小さなフォルダを開く。②Agentに「このコードベースを説明して」と頼む。③差分を見て、小さな変更を1つ頼む。④VS Codeを使っていたなら、VS Code Importを試す。⑤同じ説明を2回したら、AGENTS.md か .cursor/rules に書く。
• 避けたいこと。 ①仕事の大事なコードで、Privacy Modeの状態を確かめないまま始める。②パスワードやAPIキーをルールのファイルに書く（gitで共有されうるため。これは僕らの見立てです）。③料金を、公式ではない場所で確かめる（公式の最新の表示が基準です）。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。運営者はCursorを入れていますが、使い心地はこの記事には書いていません。コマンド、メニュー名、設定名、価格は、公式の記載を写したもので、動作確認はしていません。
• 取得したのは、ページの要約です。バージョン番号（ダウンロードページの3.24など）や価格は変わりやすい点です。
• 公式のdocsとヘルプで、入手ページの表記が cursor.com/downloads と cursor.com/download の2通りありました。実際のページは公式のダウンロードページで確かめてください。
• CLIの Capabilities のページ（cursor.com/docs/cli/using）は、ログインを扱っていませんでした。認証は別のページ（Authentication）に書かれていました。
• サインアップのページ、初回起動時の画面の流れ、サインイン方法の一覧、Cursor Tab（入力の補完）の説明は、読めていません。
• 価格や契約の判断は、公式の最新の表示と規約で確かめてください。この記事は法律や投資の助言ではありません。

出典

• Welcome（Cursor Docs、Cursor、10月22日確認）
• Quickstart（Cursor Docs、Cursor、10月22日確認）
• Downloads（Cursor、10月22日確認）
• Install（Cursor Help、Cursor、10月22日確認）
• CLI Installation（Cursor Docs、Cursor、10月22日確認）
• CLI Overview（Cursor Docs、Cursor、10月22日確認）
• CLI Authentication（Cursor Docs、Cursor、10月22日確認）
• Headless / CI（Cursor Docs、Cursor、10月22日確認）
• Models & Pricing（Cursor Docs、Cursor、10月22日確認）
• Pricing and plans（Cursor Help、Cursor、10月22日確認）
• Migrate from VS Code（Cursor Help、Cursor、10月22日確認）
• VS Code Migration（Cursor Docs、Cursor、10月22日確認）
• Rules（Cursor Docs、Cursor、10月22日確認）
• Customize overview（Cursor Docs、Cursor、10月22日確認）
• CLI Capabilities（Cursor Docs、Cursor、10月22日確認）
• Agent security（Cursor Docs、Cursor、10月22日確認）
• Agent Overview（Cursor Docs、Cursor、10月22日確認）