Cursor Agentは、AIエディタCursorに搭載された自律コーディング機能です。指示を出すと、コードベースの検索・ファイル編集・ターミナルコマンドの実行までをエージェントが自律的に進めます。起動はサイドパネル（Cmd+I）から。読み取り専用のAskモードで調査し、Plan Modeで計画を立て、Agentモードで実装させるのが公式推奨の使い方です。無料のHobbyプランでも制限付きで試せて、本格利用はPro（月20ドル）からになります。
- できること：ファイル検索・読み込み・編集、シェルコマンド実行、Web検索、ブラウザ操作までエージェントが自律実行
- 基本の使い分け：調査はAsk（読み取り専用）、設計はPlan Mode（Shift+Tab）、実装はAgent
- 本格活用の鍵：.cursor/rulesによるプロジェクトルール定義と、Cloud Agentによる並列実行
「Cursorを入れてはみたけど、Agentモードって結局どこまで任せていいんだろう…？」
先日、あるWebアプリの改修プロジェクトで検証したときのことです。タブ補完だけ使っていたメンバーがAgentモードに切り替えたところ、最初は「勝手にファイルを書き換えられるのが怖い」と及び腰でした。ところが、Plan Modeで計画をレビューしてから実行する流れを覚えた途端、リファクタリングやテスト追加のような定型作業をどんどんエージェントに投げるようになりました。
この経験から気づいたのは、Cursor Agentは「機能を知っているか」よりも「どの作業をどのモードに割り当てるかの型を持っているか」で成果が大きく変わる、ということです。
この記事では、Cursor Agentの使い方を、公式ドキュメントで確認できる最新仕様（2026年7月時点）にもとづいて解説します。基本操作からモードの使い分け、.cursor/rulesの設定例、Cloud Agentでの並列実行、料金プランまで、今日から実践できる形で紹介していきます。
Cursor Agentとは何か：3つのモードの違いから理解する
Cursor Agentを理解する近道は、Cursorのチャットに用意されたモードの違いを押さえることです。公式ドキュメントでは、大きく次の3つが案内されています。
| モード | 役割 | ファイル変更 | 向いている作業 |
|---|---|---|---|
| Agent | コード生成と実装を自律実行 | あり | 機能実装、リファクタ、バグ修正、テスト追加 |
| Ask | コードベースを検索して回答（読み取り専用） | なし | コード理解、影響範囲調査、設計の壁打ち |
| Plan Mode | 実装前にリサーチして計画書を生成 | 計画のみ | 複数ファイルにまたがる変更、大きめの機能開発 |
ポイントは、Askモードが完全に読み取り専用だという点です。コードベースを検索し、質問に答え、コードを説明してくれますが、ファイルには一切書き込みません。「まずAskで調べて、Agentで実装する」という流れが公式にも推奨されており、いきなりAgentに丸投げするより結果が安定します。
Plan Modeは、Agentがコードベースをリサーチし、必要なら確認の質問を返したうえで、レビュー可能な実装計画を生成するモードです。生成された計画はMarkdownファイルとして開かれ、不要なステップを削ったり、エージェントが見落とした文脈を追記したりと、実行前に直接編集できます。切り替えはShift+Tab、またはモードピッカーのドロップダウンから行えます。
Agentが使えるツール一覧
Agentモードのエージェントは、公式ドキュメントによると次のようなツールを組み合わせてタスクを進めます。
| ツール | 内容 |
|---|---|
| ファイル検索 | ファイル名検索とキーワード・パターン検索でコードベースを探索 |
| ファイル読み込み | ソースコードの読み込み（画像ファイルにも対応） |
| ファイル編集 | 編集内容を提案し、差分として適用 |
| シェルコマンド実行 | ターミナルでのコマンド実行（ビルド、テスト、依存関係インストール等） |
| Web検索 | 最新のドキュメントや情報をWebから取得 |
| ブラウザ操作 | スクリーンショット取得、ページ操作、ビジュアル検証 |
つまり「コードを書く」だけでなく、「調べて、書いて、実行して、確認する」までの一連のループをエディタ内で完結できるのがCursor Agentの本質です。この点で、単なるコード補完とは根本的に別物と考えたほうがよいでしょう。
また、Agentには自動チェックポイント機能があり、重要な変更の前にスナップショットが作成されます。エージェントの変更が気に入らなければロールバックできるので、「勝手に壊されるのが怖い」という心理的ハードルはかなり下がります。
セットアップと基本の使い方：最初の1タスクを流す
Cursor Agentを使い始める手順はシンプルです。順に見ていきましょう。
Step 1：Agentパネルを開く
Cursorをインストールしてプロジェクトを開いたら、Cmd+I（Windows/LinuxではCtrl+I）でサイドパネルのAgentを起動します。モードピッカーでAgentが選択されていることを確認してください。
Step 2：具体的なタスクを指示する
最初の指示文は、対象・条件・完了条件がわかる形にするのがコツです。次のようなプロンプトから試してみましょう。
Agentへの実装依頼プロンプトの例です。
# 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。
src/api/users.ts のユーザー一覧取得APIに、
ページネーション（page, per_page クエリパラメータ）を追加してください。
条件:
- per_page のデフォルトは20、上限は100
- 既存のレスポンス形式は変えず、meta フィールドに total / page / per_page を追加
- 対応するテストを tests/api/users.test.ts に追加
- 最後に既存のテストスイートを実行して、全件パスすることを確認
不足している情報があれば、最初に質問してから作業を開始してください。
ポイントは次の3つです。
- ファイルパスを明示する：探索の初動が速くなり、誤ったファイルへの変更を防げます
- エッジケースと上限値を先に指定する：エージェントの裁量に任せる範囲を狭めるほど精度が上がります
- 「テスト実行まで」を完了条件に含める：Agentはシェルコマンドを実行できるので、検証までワンセットで任せられます
Step 3：差分をレビューして受け入れる
Agentの作業中は、生成される差分をリアルタイムで確認できます。完了後はレビュー機能で行単位のチェックを行い、問題なければ受け入れます。納得できない変更はチェックポイントからロールバックすればやり直せます。公式のベストプラクティスでも「生成中に差分を眺めてレビューする」「完了後にReview機能で行単位に確認する」という二段構えが推奨されています。
Plan Modeで精度を上げる：大きめのタスクの任せ方
単一ファイルの修正ならAgentに直接指示すれば十分ですが、複数ファイルにまたがる変更ではPlan Modeを経由したほうが手戻りが減ります。Cursor公式ブログ「Best practices for coding with agents」（2026年1月9日公開）でも、経験豊富な開発者ほど先に計画を立てるとして、Plan Modeファーストの進め方が推奨されています。
Plan Modeへの依頼プロンプトの例です。
# 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。
認証まわりをセッションベースからJWTベースに移行したい。
まず以下を調査して、実装計画を作成してください:
- 現在の認証フローがどのファイルにまたがっているか
- 影響を受けるミドルウェアとテスト
- 段階的に移行する場合のステップ分割案
計画には各ステップの対象ファイルと検証方法を含めてください。
数字と固有名詞は、根拠(参照したファイルパス)を添えてください。
生成された計画はMarkdownとして開かれるので、実行前に自分の手で編集できます。検証では、この「計画を人間がレビューしてから実行」という一手間を挟むだけで、大規模変更のやり直し回数が体感で大きく減りました。エージェントの出力をそのまま信じるのではなく、計画段階でズレを潰すのが効率的です。
.cursor/rulesで「毎回同じ指示」をなくす
Agentを日常的に使い始めると、「テストはVitestで書いて」「コミットメッセージは日本語で」のような同じ指示を毎回書いている自分に気づきます。これを解消するのがルール機能です。
公式ベストプラクティスによると、Cursorのカスタマイズは2系統に整理されています。
- Rules（.cursor/rules/）：すべての会話に適用される静的なコンテキスト。ビルドコマンド、コードスタイル、ワークフローの約束事を記述
- Skills：必要なときにオンデマンドで読み込まれる動的な機能。スラッシュコマンド（/）で起動するカスタムコマンドや自動化フックを定義
プロジェクトルールのファイル例です。.cursor/rules/ ディレクトリに配置します。
# 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。
# .cursor/rules/ に配置するプロジェクトルールの例
## プロジェクト共通ルール
- パッケージマネージャは pnpm を使う（npm / yarn は使わない）
- テストは `pnpm test` で実行し、変更後は必ず実行する
- 新規コンポーネントは src/components/ 配下に1ファイル1コンポーネントで作成
- エラーハンドリングは握りつぶさず、必ずログ出力かthrowを行う
- 環境変数はハードコードせず .env.example に項目を追記する
注意したいのは、公式ガイド自身が「最初はシンプルに始めて、エージェントが同じ間違いを繰り返すことに気づいたときだけルールを足す」と明言している点です。最初から数十行のルールを書き込むより、運用しながら育てるほうが結果的にノイズの少ないルールセットになります。
コンテキスト管理のコツ
公式ベストプラクティスからは、コンテキストの扱いについても重要な指針が読み取れます。
- ファイルは手動でタグ付けしすぎない：エージェント自身に検索ツールでコンテキストを見つけさせるほうがよい
- タスクを切り替えたら新しい会話を始める：長い会話はノイズが蓄積して精度が落ちる
- 過去の作業は@Past Chatsで選択的に参照する：全部を引き継ぐのではなく必要な文脈だけを渡す
Cloud Agentで並列自律コーディング
ローカルのAgentに慣れたら、次の段階がCloud Agentです。クラウド上の隔離されたVM（完全な開発環境つき）でエージェントが動作し、コードの作成・テスト・検証を自律的に進めます。複数エージェントの並列実行にも対応しており、「レビュー待ちの間に別タスクを走らせる」という使い方ができます。
公式ドキュメントによると、起動チャネルは次のとおり多岐にわたります。
| 起動方法 | 内容 |
|---|---|
| Cursor Web | cursor.com/agents からブラウザで起動 |
| Cursor Desktop | エディタ内のドロップダウンで「Cloud」を選択 |
| Cursor iOS | ネイティブアプリから起動（AndroidはPWA推奨） |
| Slack | @cursor メンションで起動 |
| GitHub / Bitbucket | PRやIssue上の @cursor コメントで起動 |
| Linear | @cursor コマンドで起動 |
| API | プログラムから直接呼び出し |
実行環境は、エージェント主導のセットアップ、保存済みスナップショット、.cursor/environment.json でのDockerfile指定という3つの方法で構成できます。公式ドキュメントも「環境設定がCloud Agentの効果を左右する最重要要素」としているので、本格運用するならこの設定を最初に整えましょう。environment.jsonの具体的なスキーマは公式ドキュメントの最新版を参照してください。
料金面では、Cloud Agentの利用は選択したモデルのAPI料金ベースで課金され、初回利用時に支出上限の設定が求められます。使いすぎの心配を上限設定でコントロールできる設計です。
実力を最大化する運用パターン3選
公式ベストプラクティスで推奨されているパターンのうち、検証で特に効果を感じた3つを紹介します。
パターン1：テスト駆動でAgentを回す
先にテストを書き（またはAgentに書かせてレビューし）、そのテストをパスする実装をAgentに任せる進め方です。Agentはシェルコマンドでテストを実行できるため、「実装→テスト実行→失敗箇所を修正」のループを自律的に回してくれます。完了条件がテストという客観的な形で定義されるので、エージェントの暴走が起きにくく、出力の品質も判定しやすくなります。
パターン2：難しい問題は複数モデルで並列に解かせる
公式ガイドでは、難易度の高い問題に対して複数のモデルを同時に走らせて結果を比較するアプローチが紹介されています。同じプロンプトでもモデルごとに解き方の癖が違うため、1つのモデルの出力に固執するより、並列に走らせて良いほうを採用するほうが早いケースがあります。Cloud Agentの並列実行と組み合わせると、待ち時間もほぼ発生しません。
パターン3：コードベースの学習相手として使う
新しいプロジェクトにジョインしたとき、同僚に聞くようにAskモードで探索的な質問を投げるのも公式推奨の使い方です。「この決済処理のエントリポイントはどこ？」「なぜこのモジュールはこういう設計になっている？」のような質問に、実際のコードを検索したうえで答えてくれます。読み取り専用なので、理解が浅い段階でコードを壊す心配がないのも利点です。
なお、指示の送信には2種類の操作があり、Enterでキューに積んで待機、Cmd+Enterで即時送信という使い分けができます。作業中のエージェントに次のタスクを予約しておけるので、細かいですが並行作業の効率に効いてくる仕様です。
料金プラン：Agentはどのプランでどこまで使えるか
Cursorの料金は公式サイトによると次のとおりです（2026年7月12日参照）。
| プラン | 料金 | 主な内容 |
|---|---|---|
| Hobby | 無料 | クレジットカード不要。Agentリクエストとタブ補完に制限あり |
| Pro | 月20ドル | Agentの制限拡張、フロンティアモデルへのアクセス、MCP・スキル・フック対応、Cloud Agent |
| Pro+ | 月60ドル | Proより多い利用枠を求めるユーザー向け上位プラン |
| Ultra | 月200ドル | パワーユーザー向けの最上位個人プラン |
| Teams | 月40ドル/ユーザー | チーム課金・管理、Bugbotによる自動コードレビュー、使用分析、SSO対応 |
| Enterprise | 要問い合わせ | プール利用枠、SCIM、リポジトリ・モデル・MCPのアクセス制御等 |
まず試すだけならHobbyで十分ですが、Agentを日常業務の中心に据えるなら実質的にPro以上が前提と考えてください。なお、AI系ツールの料金と利用枠は変更が頻繁なので、契約前に必ず公式のpricingページで最新条件を確認しましょう。
【要注意】よくある失敗パターンと回避策
失敗1：最初から巨大なタスクを丸投げする
❌「この管理画面を全部作り直して」
⭕ Plan Modeで計画を作成→レビュー→ステップごとにAgentで実装
なぜこれが重要か：エージェントは自律的に動けるがゆえに、曖昧で巨大な指示だと想定外の方向へ突き進みます。計画のレビューを挟めば、走り出す前に軌道修正できます。
失敗2：調査タスクにAgentモードを使う
❌「この認証処理どうなってる？」をAgentモードで聞く（不要な編集が入るリスク）
⭕ 読み取り専用のAskモードで調査し、方針が固まってからAgentに切り替える
なぜこれが重要か：Askはファイルに一切書き込まないため、コード理解や影響調査を安全に行えます。「調査はAsk、実装はAgent」の使い分けが公式推奨のワークフローです。
失敗3：長い会話を引きずったまま別タスクを始める
❌ 1つの会話でバグ修正→機能追加→リファクタと続ける
⭕ タスクが変わったら新しい会話を開始し、必要な文脈だけ@Past Chatsで参照
なぜこれが重要か：長い会話にはノイズが蓄積し、エージェントの精度が目に見えて落ちます。会話は使い捨て、永続化したい知識は.cursor/rulesへ、が正しい役割分担です。
失敗4：エージェントの変更をレビューせずに受け入れる
❌ テストが通ったからそのままマージ
⭕ 生成中の差分確認+完了後のReview機能+PRでのBugbot自動レビューの三段構え
なぜこれが重要か：エージェントの出力にはハルシネーションのリスクが常にあります。テストの成否だけでは設計上の問題は検出できません。人間のレビューを省略しない前提で「どこまで任せるか」を設計しましょう。
よくある質問
Q. Cursor Agentは無料で使えますか？
A. 無料のHobbyプランでも制限付きでAgentを試せます。ただしAgentリクエスト数に制限があるため、日常的に使うならPro（月20ドル）以上が現実的です。最新の制限内容は公式のpricingページで確認してください。
Q. AgentモードとGitHub Copilotのエージェント機能はどう違いますか？
A. どちらも自律的にコードを編集・実行するエージェント機能ですが、CursorはエディタそのものがAIファーストで設計されており、Plan Mode・チェックポイント・Cloud Agentのような周辺機能が統合されている点が特徴です。詳しい比較はGitHub Copilot Agentモードの解説記事とAIコーディングエージェントIDE 6種比較を参照してください。
Q. エージェントが勝手に危険なコマンドを実行しませんか？
A. Agentのシェルコマンド実行は設定で制御でき、重要な変更の前には自動チェックポイントが作成されるためロールバック可能です。それでも、本番環境の認証情報を扱うディレクトリでの実行は避け、まずテスト環境・使い捨てブランチで運用を始めることを推奨します。
まとめ：今日から始める3つのアクション
- 今日やること：手元のプロジェクトでCmd+IからAgentを起動し、「テストを1本追加して実行まで」の小さなタスクを1つ流してみる
- 今週中：Askで調査→Plan Modeで計画→Agentで実装のワークフローを1つの実タスクで通し、.cursor/rules/ にプロジェクトルールを3〜5行だけ書く
- 今月中：Cloud Agentの実行環境を整備し、レビュー待ち時間に並列でタスクを走らせる運用を試す。チーム導入ならTeamsプランのBugbot自動レビューまで含めて効果測定を開始する
あわせて読みたい：
- Cursor Composerの解説 — Cursor内製モデルの特徴と使いどころ
- Claude Code・Cursor・Windsurf比較 — MCP対応を軸にした主要AIコーディングツールの比較
参考・出典
- Agent Overview – Cursor Docs — Cursor公式（参照日: 2026-07-12）
- Modes – Cursor Docs — Cursor公式（参照日: 2026-07-12）
- Plan Mode – Cursor Docs — Cursor公式（参照日: 2026-07-12）
- Cloud Agents – Cursor Docs — Cursor公式（参照日: 2026-07-12）
- Pricing – Cursor — Cursor公式（参照日: 2026-07-12）
- Best practices for coding with agents – Cursor Blog — Cursor公式ブログ、2026-01-09公開（参照日: 2026-07-12）
この記事を読んで導入イメージが固まってきた方へ
UravationではAIエージェント導入の研修・コンサルを行っています。
