Cursorの使い方完全ガイド｜料金・日本語対応・Agent・MCP・Automationsまで解説【2026年版】

01Cursorでできることと、導入前の選び方

Cursorは、コードを読む・書く・直す作業にAIを組み込んだ開発環境です。補完だけでなく、Agentが関連ファイルを探して編集し、コマンドを使う作業にも対応します。ただし、AIの回答が正しいことや、変更が目的どおりであることは保証されません。

Chat・Tab・Agentは、任せる範囲が違う

根拠：Agent Security／Using Agent in CLI／Cursor Keyboard Shortcuts

向いている人と、今の環境を残してよい人

既存のHTML/CSSやプログラムを読みながら直したい人、変更内容を比較できる人に向いています。WordPressなら、まず本番サイトから切り離したコピーで試すと、変更範囲を把握しやすくなります。コード作業の予定がない場合や、変更の良し悪しを確認できない場合は、無理に導入する必要はありません。

「AIに直してもらえるか」だけでなく、「自分で変更を確かめ、元に戻せるか」を導入の判断基準にしてください。短時間で使える、必ず効率が上がるといった所要時間・効果の保証はできません。

VS Code・Copilot・Claude Code・Codexとの比較

「Copilotは補完だけ」「Claude Codeは単発のCLIだけ」「Cursorは並列Agentを扱えない」と分けると、現在の機能を正しく比べられません。機能が重なるため、普段の作業場所と管理方法から選びます。

根拠：VS Code: Understand AI agents／Claude Code overview／OpenAI: Codex

Cursorにも複数Agentを管理するAgents Windowとworktreeの機能があります。Cursor 3のAgents Windowは2026年4月2日公開の機能として公式に説明されており、単一ファイル編集だけの製品ではありません。

根拠：Agents Window

この比較は公式に案内された利用形態の整理です。同一コードでの速度・精度の比較実験ではありません。

02始め方と、日本語で小さな修正を進める手順

インストールとVS Codeからの移行

1. Cursor公式ダウンロードから、自分のOSに合う版を取得します。
2. ログイン後、契約とプライバシー設定を確認します。会社のコードを開く前に、社内の利用条件も確認してください。
3. VS Codeを使っている場合は、設定やキーバインドを控えてから移行します。インポート項目の有無・位置はバージョンで確認し、拡張機能やフォーマッターは個別に動作を確かめます。すべてがそのまま移るとは限りません。
4. 秘密情報を含まない練習用フォルダを開きます。Gitや別のバックアップで変更前の状態を残します。
5. まずコードの説明を求め、対象を1ファイルに絞って修正を試します。VS Codeを先に削除する必要はありません。

根拠：Installation and startup

日本語の指示は、対象・目的・制約・確認方法を分ける

説明は日本語、ファイル名や関数名は元の表記のままにすると、依頼先が分かりやすくなります。日本語で依頼することと、設定画面の全項目が日本語化されることは別です。料金や権限の英語が分からないときは、機密情報を除いて意味を確認し、画面上の設定値も自分で照合します。

文字で書く代わりに声で相談したい場合は、Cursor音声チャットの使い方｜開始条件と出ないときの確認で、開始条件とボタンが出ないときの確認をまとめています。

対象：styles/main.css のスマートフォン表示
目的：画面幅375pxでカードが横にはみ出す原因を調べる
制約：文言、クラス名、PC表示、他のファイルは変更しない
まず行うこと：原因候補と最小限の修正方針を説明する。まだ編集しない
実装に進む条件：方針を確認した後、対象ファイルだけを変更する
完了時：変更点、実施した確認、未確認事項を分けて報告する

Agentの編集は「承認してから保存」とは限らない

注意通常のワークスペースファイルは、Agentが承認前に変更し、ディスクへ即時保存できます。差分レビューは、未適用の案の確認とは限りません。自動再読み込みがあると、確認前に変更後のコードが実行される場合もあります。

先に計画を見たいときはPlanモード、調べるだけならAskなど目的に合うモードを使います。Planでは実装前に計画を確認・編集できますが、計画自体の正しさまで保証するものではありません。通常Agentに「まだ変更しない」と書くことだけを、強制的な権限制限の代わりにしないでください。

根拠：Agent Security／Plan Mode

1. 作業前に変更前の状態を保存し、本番データや不要な認証情報を切り離します。
2. 計画と対象範囲を確認してから実装に進みます。
3. 変更済みファイルのdiff（変更前後の差）を見て、不要な削除や別ファイルへの変更を確認します。
4. テストや表示確認を行い、問題があれば自分の未保存作業を巻き込まない方法で戻します。
5. 公開・デプロイは、レビューと動作確認が済んでから別に判断します。

ターミナルは標準設定では実行確認がありますが、Run Modesなどの設定で挙動が変わります。自動承認や許可リストを、完全な安全境界とは扱わないでください。

ブランチやworktreeは変更の整理に役立ちますが、認証情報・ネットワーク・実行権限まで隔離する仕組みではありません。確認できないコードやコマンドは実行を止め、必要な環境を分けます。

コードの回答は、もっともらしくても検証する

たとえば「エラー時の戻り値をnullから空オブジェクトへ変えれば解決」と言われても、呼び出し元が必要とするプロパティや型を確認しなければ問題を隠すだけになることがあります。Reactの依存配列も、警告を消す目的だけで依存値を削除せず、状態更新と参照の関係を調べます。こうした例は、AIの説明を採用する前に確認する観点です。

03MCP・Automations・Rules・CLIへ広げる

MCPは、接続先と権限を選んで追加する

MCPはAIと外部ツール・データをつなぐ仕組みです。GitHubのIssueや設計資料を参照するなど、必要な用途があるときに追加します。Customizeから管理する方法や、mcp.jsonを使う方法があります。プロジェクト用とユーザー全体用の設定範囲を混同せず、接続先が提供する公式手順を使ってください。

1. 提供元、送信されるデータ、必要な権限を確認します。
2. 最初は読み取り専用・テスト用の対象に絞ります。
3. 接続の認証と、実際のツール実行を分けて確認します。
4. 不要な接続を残さず、使わなくなった権限を見直します。

標準ではMCP接続後の各ツール呼び出しにも確認がありますが、許可リストで事前承認できるため、現在の設定を確かめます。「接続済みだから安全」とは判断できません。ローカルのMCPサーバーを使う場合も、その結果がAIへのリクエストに含まれる可能性があります。「ローカルで動く」と「外部へデータを送らない」は別です。

根拠：Model Context Protocol／Agent Security

Automationsは、通知だけでなくCloud Agentを動かす

Automationsは、スケジュールやGitHub・Slackなどのイベントを起点にCloud Agentを動かします。週次の変更要約やIssue調査など、確認しやすい作業から検討します。利用可能なプランは料金欄も確認してください。

1. Agents Windowや公式のAutomations画面で、実行する目的を決めます。
2. トリガー、対象リポジトリ、指示、利用ツール、通知先を確認します。
3. 初回は少ない頻度で試し、実行履歴と費用を確認します。
4. 不要になったものは停止し、外部への投稿や本番変更を許可するか別に判断します。

「変更しない」と指示するだけで読み取り専用になるとは限りません。書き込み権限を持たない接続や実行環境も組み合わせます。費用はCloud Agent利用に基づき、実行主体の設定でも請求先が変わります。予定時刻から遅れて起動する場合もあるため、厳密な時刻保証が必要な用途では条件を確認します。

根拠：Automations

Rules・AGENTS.md・Skills・Hooksを使い分ける

根拠：Rules／Agent Skills／Hooks

これらを整えても、指示への追従や品質が保証されるわけではありません。「指示コストがゼロになる」ではなく、繰り返しの説明を減らすための仕組みです。まず1つの用途だけ整理し、適用状態と結果を確認してください。

CLIはエディタ起動用のcursorと、Agent用のagentを区別する

現行公式ドキュメントのAgent CLIはagentを使います。エディタを起動するcursorと同じものとして、cursor --headlessなどへ置き換えないでください。旧記事や旧版のcursor-agent表記を見た場合も、使っているバージョンのヘルプと照合します。

インストール方法はmacOS・Linux・WindowsのWSLと、WindowsネイティブのPowerShellで異なります。公式ページのコマンドは、取得したスクリプトをそのまま実行する方式です。入手元・スクリプトの内容・職場のルールを確認してから実行してください。ここでは導入コマンドの一括実行は案内せず、OS別の公式インストール手順を入口にします。

根拠：CLI Installation／CLI Parameters

agent --version
agent login
agent status
agent --mode=ask "このプロジェクトの構成を日本語で説明してください。ファイルは変更しないでください。"

command not foundが出た場合は、インストール完了とPATHを確認します。公式のbash・zsh向け手順では~/.local/binが案内されています。OSとシェルが異なる手順をそのまま混ぜず、既存の設定を控えてから修正してください。

上の例は、バージョン確認、ブラウザ認証、認証状態確認、Askモードでの調査です。使うプロジェクトのフォルダで起動し、出力や承認要求を読んで進めます。この記事ではコマンドを実行しておらず、表示例を実測ログとして載せていません。

根拠：CLI Authentication／Using Agent in CLI

非対話実行はagent -p、出力指定は--output-format textや--output-format jsonです。ただし-pは読み取り専用の意味ではなく、書き込みやシェルのツールを利用できます。最初からCIに入れず、権限、利用料金、入力に含まれる秘密情報、失敗時の停止条件を確認します。APIキーは記事やリポジトリに貼らず、CIの適切な秘密情報管理を使ってください。

根拠：CLI Parameters

04料金とAutoの使用量は、新規契約と旧契約を分ける

公式料金は変更されています。新規向けのThe X Subscriptionと、継続中の旧Cursorプランを混ぜないでください。以下は公式ページを確認した時点の米ドル月払い表示で、税は別です。地域、購入経路、契約画面の表示も確認してください。

有料プランのCursorモデル枠はGrokと共有され、週次で更新されます。Premium以上で使うClaude・GPT・Geminiなどの第三者モデルは含まれず、プリペイド残高から別に請求されます。Teams・Enterpriseは席単位や組織条件があるため、個人用の表をそのまま予算に使わないでください。

根拠：Models & Pricing

旧Pro・Pro+・Ultraが表示されている場合

旧Proは月$20、Pro+は$60、Ultraは$200で、既存契約向けの扱いです。月次のCursor ModelsとOther Modelsの2つの枠があります。第三者モデルを選んだ場合や、Autoが第三者モデルへ振り分けた場合はOther Modelsを消費します。Autoは無制限・クレジット消費なし、と一律には言えません。

旧契約から新体系への移行は任意ですが、公式は恒久的な切り替えとして説明しています。モデル枠と追加課金方式が変わるので、月額だけで比較しないでください。過去の「新規は一律2週間のPro体験」といった案内も、現在の申込画面で確認できる場合だけ判断材料にします。

根拠：Legacy Cursor plans

課金前・使用量が急に減ったときの確認リスト

• 契約名と請求アカウントは、新体系か旧体系か。
• リセット日は週次か月次か。請求日と利用枠の更新日を取り違えていないか。
• 選んだモデルやAutoの振り分け先は、どの枠・残高を使うか。
• Cloud AgentやAutomationなど、画面を閉じた後の利用がないか。
• 追加利用、支出上限、自動チャージの設定はどうなっているか。
• 年払い、解約、返金、切り替え条件を申込前に確認したか。

最上位でも予算管理は必要です。まず自分の代表的な作業を小さく試し、使用履歴を見てからプランを選びます。特定プランがブログ運営には必ず過剰、Auto中心なら必ず十分、といった一律の判断は避けてください。

05データ保護と、つまずいたときの戻せる対処

Privacy Modeにも条件と例外がある

Privacy Modeを有効にすると、CursorはCustomer Dataを学習に使わず、モデル提供者とゼロデータ保持（ZDR）の契約を維持すると説明しています。ただし、不正利用検知に反応したデータの調査目的での保存や、非ZDRモデルに関する例外があります。「どこにも送信・保存されない」設定ではありません。

独自のAPIキーを使ってもリクエストはCursorのバックエンドを通ります。また、一時的な暗号化キャッシュの説明もあります。機密コードを扱う前に、会社の規程、接続先、モデル、保存条件を確認し、秘密鍵や顧客データなどを不要に渡さないでください。

根拠：Data Use & Privacy Overview

.cursorignoreは参照対象を制御する助けになりますが、AgentのターミナルやMCPツールによるアクセスまで遮断するものではありません。除外ファイルを書いただけで秘密情報を隔離できたとは判断せず、実行環境や接続権限も分けます。

根拠：Ignore file

設定フォルダ削除や保護機能の無効化から始めない

注意設定フォルダ全体の削除や、ウイルス対策の一括除外を初手にしないでください。履歴・設定を失ったり、保護範囲を狭めたりします。キャッシュだけを消す操作と、ユーザーデータの初期化は別です。

1. 作業を保存し、エラー文、OS、Cursorのバージョン、発生時刻を記録します。
2. 公式ステータスとアカウント・利用枠を確認します。再ログインで改善するかは症状を見て判断します。
3. 完全終了して再起動し、公式の更新手順を確認します。設定変更は1つずつ行います。
4. 拡張機能やネットワークなど、関係する条件を切り分けます。会社のVPNや保護設定を独断で解除しないでください。
5. 再インストールや初期化が必要なら、対象データ、バックアップ、復旧方法を確認してから公式手順を使います。

根拠：Installation and startup

セキュリティソフトが原因と思われる場合も、検知ログや対象ファイルを管理者と確認します。除外が必要と判断された場合だけ、対象と期間を限定し、確認後の設定を見直します。「ほとんどはセキュリティソフト」「ほとんどは指示のズレ」のように原因を決めつけないことが大切です。

症状ごとに確認する場所

OSとバージョン：
Cursorのバージョン：
発生日時とタイムゾーン：
機能・契約プラン：
再現手順：
エラー文（認証情報・個人情報は除く）：
試したことと結果：
残しておきたい設定・履歴：

ログやスクリーンショットを送る前に、メールアドレス、APIキー、プロジェクト内の機密情報が映っていないか確認してください。

CursorでOpenAIのモデルを使っている場合は、11月12日に予定されている変更と、使い続けるための方法をCursorのOpenAIモデルは11月12日終了？継続する3つの方法で確認できます。

06よくある質問