Cursor Agent モードの使い方 (2026年版)
Cursorの自律型コーディングエージェントを使いこなし、生産性を最大化する
Hyperealで構築を始めよう
Kling、Flux、Sora、Veoなどに単一のAPIでアクセス。無料クレジットで開始、数百万規模まで拡張可能。
クレジットカード不要 • 10万人以上の開発者 • エンタープライズ対応
Cursor Agent Mode の使い方 (2026年版)
Cursor は最も人気のある AI 搭載コードエディタの一つとなりました。その中でも Agent Mode は、従来のオートコンプリート型の AI コーディングツールとは一線を画す機能です。Agent Mode は単に次の行を提案するだけでなく、コードベース全体にわたって、マルチステップのコーディングタスクを自律的に計画、実行、反復することができます。このガイドでは、2026年において Agent Mode を効果的に使いこなすために必要なすべてを解説します。
Cursor Agent Mode とは?
Agent Mode は、以下のことが可能な Cursor の自律型コーディングアシスタントです。
- コードベース全体を読み取り、理解する
- 複数のディレクトリにわたるファイルの作成、編集、削除
- ターミナルコマンドの実行(ユーザーの承認が必要)
- ドキュメントや解決策を求めてウェブを検索
- テストとエラー修正を繰り返すことで、自身の出力を改善
- 外部連携のための MCP (Model Context Protocol) ツールの使用
Cursor の標準的な「Ask」モードや「Edit」モードとは異なり、Agent Mode は単一のプロンプトに応答するだけではありません。ジュニアデベロッパーがチケットを処理するように、一連のアクションを計画し、ステップバイステップで実行します。
Agent Mode のセットアップ
前提条件
- Cursor IDE がインストールされていること(バージョン 0.48 以降を推奨)
- Agent を無制限に使用するための有効な Cursor サブスクリプション(Pro または Business)
- Cursor でプロジェクトが開かれていること
ステップ 1: チャットパネルを開く
Cmd+L (macOS) または Ctrl+L (Windows/Linux) を押して、エディタの右側にある Cursor チャットパネルを開きます。
ステップ 2: Agent Mode を選択する
チャットパネルの上部にモード選択ドロップダウンがあります。そこをクリックし、オプションから Agent を選択します。
| モード | 説明 |
|---|---|
| Agent | ファイル編集、ターミナルコマンド、ツール使用を伴う自律的なマルチステップ実行 |
| Ask | 変更を加えずに、コードベースに関する対話形式の Q&A を行う |
| Edit | 差分表示(diff)に特化した、インラインでのコード編集 |
ステップ 3: モデルを選択する
Agent Mode は複数のモデルで動作します。モデルドロップダウンからお好みのモデルを選択してください。
| モデル | 最適な用途 |
|---|---|
| Claude Sonnet 4 | コーディングにおけるスピードと能力のバランスが最も優れたモデル |
| Claude Opus 4 | 複雑なアーキテクチャ設計や大規模なリファクタリング |
| GPT-4o | 汎用的なコーディングとドキュメント作成 |
| Gemini 2.5 Pro | 大規模なコードベースを扱う巨大なコンテキスト・タスク |
ステップ 4: プロンプトを書く
チャット入力欄にタスクの説明を入力します。達成したい内容を具体的に記述してください。
JWTトークンを使用したユーザー認証用の新しい REST API エンドポイントを作成してください。
以下を含める必要があります:
- email と password による POST /api/auth/login
- email、password、name による POST /api/auth/register
- 現在のユーザーを返す GET /api/auth/me
- ルート保護のためのミドルウェア
User モデルには既存の Prisma スキーマを使用し、
既存のルートファイルのパターンに従ってください。
ステップ 5: アクションの確認と承認
Agent Mode はプランを提示し、実行を開始します。ファイルが変更されるたびに差分(diff)が表示されます。ターミナルコマンドについては、実行前にそのコマンドが表示されます。以下の操作が可能です:
- チェックマークボタンで個別の変更を Accept (承認) する
- X ボタンで変更を Reject (却下) する
- Accept All ですべての保留中の変更を一括承認する
- チャットに追加の指示を入力して フィードバックを提供する
Agent Mode のベストプラクティス
1. @-メンションでコンテキストを提供する
Cursor の @ シンボルを使用して、特定のファイル、フォルダ、ドキュメント、またはウェブページを参照します。
@src/routes/users.ts @src/middleware/auth.ts
これらのファイルのパターンに従って、JWT と API キーの両方の認証方法を
サポートするように認証ミドルウェアをリファクタリングしてください。
利用可能な @ 参照には以下が含まれます:
| 参照 | 用途 |
|---|---|
@filename |
特定のファイルを参照 |
@foldername |
ディレクトリ全体を参照 |
@codebase |
関連するコンテキストを求めてコードベース全体を検索 |
@web |
ドキュメントを求めてウェブを検索 |
@docs |
インデックス化されたドキュメントを参照 |
@git |
Git の履歴や差分を参照 |
2. プロジェクトのコンテキストに .cursorrules を使用する
プロジェクトのルートに .cursorrules ファイルを作成して、Agent Mode にプロジェクト固有の永続的なコンテキストを与えます。
# プロジェクト: E-commerce API
## 技術スタック
- Node.js (TypeScript)
- ルーティング: Express.js
- ORM: Prisma (PostgreSQL)
- テスト: Jest
- バリデーション: Zod
## 規約
- 生の Promise ではなく、必ず async/await を使用すること
- すべてのルートハンドラーは try/catch を含み、適切なエラーレスポンスを返すこと
- リクエストのバリデーションには Zod スキーマを使用すること
- RESTful な命名規則に従うこと
- すべての新しいサービス関数に対してユニットテストを書くこと
## ファイル構造
- src/routes/ - ルートハンドラー
- src/services/ - ビジネスロジック
- src/middleware/ - Express ミドルウェア
- src/utils/ - 共有ユーティリティ
- src/types/ - TypeScript 型定義
- tests/ - src 構造を反映したテストファイル
3. 大きなタスクを分割する
Agent Mode に「機能全体を構築して」と頼むのではなく、論理的なチャンクに作業を分割してください。
# 良い例: フォーカスされた段階的なタスク
"User と Product へのリレーションを持つ Order モデルの Prisma スキーマを追加して"
"createOrder、getOrderById、listUserOrders 関数を持つ order サービスを作成して"
"user ルートと同じパターンに従って、order 用の REST エンドポイントを追加して"
"order サービスの関数に対して Jest テストを書いて"
# あまり効果的でない例: 曖昧で巨大なリクエスト
"注文管理システムを丸ごと構築して"
4. エージェントにターミナルコマンドを実行させる
Agent Mode は、自身の作業を検証するためにテスト、リンター、ビルドコマンドを実行できます。エージェントがコマンドの実行を提案したときは許可してください。これにより、エージェントが自らエラーを修正できるフィードバックループが生まれます。
Agent: 変更が正しく動作することを確認するためにテストを実行します。
> npm run test -- --testPathPattern=order
# テストが失敗した場合、エージェントは自動的にエラー出力を読み取り、
# 問題の修正を試みます。
5. チェックポイントを使用してロールバックする
Cursor は、Agent Mode が変更を加える前に自動的にチェックポイントを作成します。エージェントが誤った方向に進んでしまった場合は:
- チャットパネルのチェックポイントにある Restore ボタンをクリックします。
- より具体的な指示を提供します。
- 適切なガイダンスを与えた状態で、エージェントに再試行させます。
高度な Agent Mode 機能
YOLO モード
エージェントの判断を信頼できる上級ユーザーのために、Settings > Features > Agent で YOLO モードを有効にできます。これにより、指定したパターンに一致するターミナルコマンドが自動承認されます。
{
"allowedCommands": [
"npm run test",
"npm run lint",
"npx tsc --noEmit",
"npx prisma generate"
]
}
警告: YOLO モードは、安全、読み取り専用、または簡単に取り消し可能なコマンドに対してのみ有効にしてください。本番データやインフラを変更する可能性のあるコマンドを自動承認しないでください。
MCP ツールの統合
Agent Mode は MCP (Model Context Protocol) サーバーをサポートしており、外部ツールとの対話が可能です。
// .cursor/mcp.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "your-token"
}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "postgresql://localhost:5432/mydb"
}
}
}
}
MCP ツールを使用すると、Agent Mode は以下のことが可能になります:
- GitHub の Issue やプルリクエストの作成
- データベーススキーマへの直接クエリ
- UI 実装のための Figma デザインとの連携
- デバッグのための Sentry エラーへのアクセス
複数ファイルのリファクタリング
Agent Mode は、多くのファイルにまたがるリファクタリングタスクに長けています。
コードベース全体で "user" サービスレイヤーの名前を "account" に変更してください。
すべてのインポート、ルート参照、テストファイル、型定義を更新してください。
名前変更後もすべてのテストがパスすることを確認してください。
エージェントは体系的にすべての参照箇所を見つけて更新し、TypeScript コンパイラを実行して更新漏れを特定し、何も壊れていないことを検証するためにテストを実行します。
Agent Mode のキーボードショートカット
| ショートカット | アクション |
|---|---|
Cmd+L / Ctrl+L |
チャットパネルを開く |
Cmd+Shift+L / Ctrl+Shift+L |
選択したコードをコンテキストとしてチャットを開く |
Cmd+Enter |
すべての保留中の変更を承認する |
Cmd+Backspace |
すべての保留中の変更を却下する |
Cmd+. |
実行中のエージェントを停止する |
Tab |
エージェントからのインライン提案を承認する |
よくある落とし穴と解決策
| 問題 | 解決策 |
|---|---|
| エージェントが不要な変更を加えすぎる | プロンプトをより具体的にする。@-メンションを使用してタスクの範囲を絞り込む |
| エージェントがループに陥る | Cmd+. で停止し、より明確な指示を与えるか、タスクを分割する |
| エージェントがプロジェクトの規約を理解しない | プロジェクトのパターンと標準を記述した .cursorrules ファイルを追加する |
| 変更によって既存の機能が壊れる | 変更後にテストを実行するようエージェントに指示する。チェックポイントを使用してロールバックする |
| エージェントがファイルパスや API を捏造(ハルシネーション)する | 推測ではなく実際のファイルを検索させるため、@codebase を使用する |
料金と使用制限
| プラン | Agent Mode へのアクセス | 月間制限 |
|---|---|---|
| Free | 制限あり (50 slow requests) | 厳しい制限 |
| Pro ($20/月) | フルアクセス | 500 fast + 無制限の slow requests |
| Business ($40/月) | 管理機能付きフルアクセス | 500 fast + 無制限の slow requests |
結論
Cursor Agent Mode は、開発者が AI コーディングアシスタントと対話する方法を根底から変えます。提案を一つずつコピー&ペーストする代わりに、タスク全体を委任して結果を確認することができます。成功の鍵は、明確なプロンプトを書き、.cursorrules や @-メンションを通じて適切なコンテキストを提供し、大きなタスクを管理可能な単位に分割することです。
デモビデオ、マーケティングコンテンツ、製品ウォークスルーの作成など、AI 生成メディアも扱う開発者の場合、Hypereal AI は AI ビデオ生成、トーキングアバター、画像作成のための手頃な API を提供しており、Cursor で構築している AI 駆動の開発ワークフローと非常に相性が良いでしょう。
