Cursor Agent モード完全ガイド：3 ステップで始める自動化プログラミング（2026 年最新）

2026-06-08 更新：Cursor 公式ドキュメントで再確認——Agent は ⌘/Ctrl + I で開き、Shift + Tab で Agent / Ask / Plan / Debug を切り替えます。旧「Yolo モード」は現在「Auto-run」に改名（Agent 設定内、自然言語で自動実行を許可するコマンドを指定可）。モデル一覧も現行の Claude / GPT / Gemini と Auto モードに更新しました。

先日、バグ修正中に Cursor Chat で AI と 10 回以上やり取りしました。「こう直せばいい」と言われ、コピーして貼り付け、実行——エラー。また聞いて、またコピペ……このループ。

そのあとプロジェクトを走らせたら依存関係不足のエラー。AI は「npm install xxx を実行して」と言うのに、またターミナルへ切り替えて手入力。AI が何を入れるか分かっているなら、なぜ自分で入れないのか——そう思いました。

Cursor の Agent モードを知ってから、すべてが変わりました。Agent は「提案」だけでなく、直接作業します。ファイル作成、コマンド実行、バグ修正。初めて使ったときは本当に驚きました——AI プログラミングがここまで自動化できるとは。

この記事では、3 ステップで Agent を始め、5 つの実践例で使い方を押さえます。読み終える頃、これまで繰り返していた開発作業を AI に任せられるようになっているはずです。

Agent モードとは？

わかりやすい例え

Cursor の各モードをチームメンバーに例えると：

• Chat モードはアドバイザー。質問すれば助言はくれますが、実行は自分
• Agent モードはアシスタント。タスクを渡せば、ファイル作成・コマンド実行・エラー修正まで代行

Cursor 公式が Agent を「最も自動運転に近いモード」と呼ぶのも、自分で手を動かしてくれるからです。

Agent モードは 2024 年 11 月 24 日、Cursor 0.43 で登場しました。2026 年 1 月現在、多くの開発者の主力ツールになっています。

Agent vs Chat：何が違うのか？

比較表を見れば一目瞭然です。

具体例：

Chat モード：

• あなた：「ログインコンポーネントを作って」
• AI：「コードは以下のとおり…（長文）」
• あなた：（新規ファイルにコピペ）

Agent モード：

• あなた：「ログインコンポーネントを作って」
• AI：（Login.tsx を自動作成、import 追加、不足依存があれば install）
• あなた：（何もせずそのまま使える）

差は歴然です。

Agent の 4 つの核心能力

使い込んで感じた「超能力」は次の 4 つです。

1. コードベースの自動検索

• セマンティック検索で関連コードを素早く発見
• 「src/utils/auth.ts を見て」と言わなくても自分で探す

2. 複数ファイルの同時作成・修正

• 機能追加でコンポーネント・ルート・API を一度に変更
• スタイルを揃え、import を自動補完

3. ターミナルコマンドの自動実行

• 依存インストール：npm install
• サーバー起動：npm run dev
• テスト：npm test
• Yolo モードなら確認なしで実行

4. エラーの自動読み取りと修正

• ターミナル出力を読み、原因を分析（依存不足？コード？設定？）
• 自動修正し、ダメなら再試行

3 ステップで Agent モードを始める

方法 1：ショートカット（最速）

いちばんよく使う方法。1 秒で起動：

• Agent パネルを開く：Mac は ⌘ + I、Windows/Linux は Ctrl + I
• モード切替：Shift + Tab で Agent / Ask / Plan / Debug を循環

押すだけで Agent パネルが開きます。（旧バージョンは ⌘/Ctrl + . でも開きましたが、新版は ⌘/Ctrl + I に統一。）

KiloClaw - 企業向けマネージド OpenClaw、AI エージェントのオーケストレーションとスマートルーティングを加速

今すぐ始める →広告

方法 2：UI 切り替え（初心者向け）

初めてなら UI の方が分かりやすいです：

1. Cursor を開き、右側 Composer パネルを開く（⌘/Ctrl + I でも可）
2. パネル上部のモード切替を確認
3. 「Agent」 を選択
4. 入力欄のプレースホルダが “Tell me what to build…” のような表示に変わる

これで Agent 起動完了です。

起動できたか確認する

次のサインをチェック：

• ✅ 「Agent mode」などの表示がある
• ✅ 入力欄の文言が「コードについて聞いて」ではなく「何を作るか教えて」系
• ✅ ツールバーに Yolo モードスイッチなどが増えている

見当たらなければ、上の手順をもう一度。

設定のおすすめ（任意だが効く）

Agent 起動後、ついでに以下も：

1. Auto-run（旧 Yolo モード）をオン

• 場所：Agent の設定（新版 Cursor は「Yolo」を「Auto-run」に改名）
• 効果：ターミナルコマンドを毎回確認せず自動実行。どのコマンドを自動実行してよいか（テスト・ビルド・lint など）を自然言語で指定できる
• 注意：自動承認されるのはターミナルコマンドのみ。ファイル変更は引き続き diff で確認

正直、本番以外ではだいたい Auto-run オンです。

2. Windows ユーザー：Git Bash に切り替え

• 理由：Agent は Linux 風コマンドを出すため、CMD では動かないことがある
• 手順：設定 → ターミナル → デフォルトプロファイル → Git Bash

3. AI モデルの選択

• 日常の既定：Auto（タスクに応じて Cursor が自動選択）
• 複数ファイル/リファクタ：Claude Sonnet 4.6 または Claude Opus 4.8
• 推論・計画：GPT-5.5
• 巨大コードベース：Gemini 3.1 Pro（最大コンテキスト）

利用可能なモデルは Cursor の更新で変わります。チャットパネル上部のモデル選択が最新の基準です。

5 つの実践例：Agent で何ができるか

口だけでは伝わりません。5 つの実例で見ていきましょう。

例 1：Todo List をゼロから作る（入門）

シナリオ：React Todo List を素早く作りたいが、プロジェクト設定からやりたくない。

従来：

1. npx create-react-app my-todo
2. TypeScript インストール
3. tsconfig 設定
4. コンポーネントフォルダ作成
5. TodoList.tsx、TodoItem.tsx を書く……
6. （30 分以上）

Agent：

Agent を開き、一言：

React + TypeScript の Todo List プロジェクトを作って

コーヒーを淹れに行って戻る頃には：

• ✅ フォルダ構成の作成
• ✅ package.json 生成
• ✅ App.tsx、TodoList.tsx、TodoItem.tsx 作成
• ✅ npm install 実行
• ✅ 基本スタイルまで追加されることも

3〜5 分。最後にコードを確認するだけ。

ヒント：途中エラーでも Agent は再試行します。成功率はかなり高いです。

例 2：依存関係の自動インストール（高頻度）

シナリオ：GitHub から clone し npm start したら：

Error: Cannot find module 'axios'

従来：

1. axios 不足に気づく
2. npm install axios
3. 再起動で react-router-dom 不足……
4. また install……

Agent：

エラーをそのまま渡す：

プロジェクト実行でこのエラー。直して：
Error: Cannot find module 'axios'

Agent の動き：

1. axios 不足を特定
2. npm install axios を実行
3. 他の不足依存もチェック
4. 残エラーがあれば続けて修正

データ：コミュニティ報告では依存問題の自動修正成功率は約 70%。2 回以上失敗したらログ追加で成功率アップ。

例 3：バグの自動修正（核心）

シナリオ：コードを書いたが実行時エラー。原因が分からない。

function calculateTotal(items) {
  return items.reduce((sum, item) => sum + item.price, 0)
}

calculateTotal(null) // エラー

従来：

1. Cannot read property 'reduce' of null
2. ドキュメント・Stack Overflow
3. null チェックが必要と気づく
4. 手動修正

Agent：

コードを選択して：

実行時にエラー。修正して

Agent の流れ：

🔥 需要のない製品に3ヶ月も無駄にするな！少額の予算で Adsterra を使い、SaaS の訴求を今すぐ検証 ➡️

今すぐ検証 →広告

1. エラーログを読む
2. items が null の可能性を特定
3. 自動修正：

function calculateTotal(items) {
  if (!items) return 0
  return items.reduce((sum, item) => sum + item.price, 0)
}

4. 修正を検証

上級テクニック：

2 回直してもダメなら：

まず重要箇所に console.log を入れて、問題を特定して

ログ追加で成功率 70%+。いちばんよく使うシーンです。

例 4：複数ファイル機能開発（上級）

シナリオ：既存プロジェクトにユーザーログインを追加。

必要なもの：

• Login.tsx
• routes.ts のルート追加
• api.ts の API 呼び出し
• グローバル状態の変更かも

従来：

• Chat は 1 ファイルずつ
• 自分でファイル作成・コピペ
• 参照関係も手動管理

Agent：

ユーザーログイン機能を追加して。コンポーネント、ルート、API 呼び出しを含めて

Agent の流れ：

1. プロジェクトを検索し、ルート設定・API ファイルを特定
2. 複数ファイルを同時修正：
   • Login.tsx 作成
   • routes.ts にログインルート追加
   • api.ts に login メソッド追加
   • import を自動追加
3. 既存スタイル（関数コンポーネントなど）に合わせる

Agent と Chat の最大の差：ファイルを跨ぎ、プロジェクト全体を理解して動くこと。

ダークモード追加を任せたら 7 ファイルを一発で正しく直され、1 時間以上節約しました。

例 5：Playwright 自動テスト（高度）

シナリオ：E2E テストを追加したいが、手書きは避けたい。

Agent + MCP：

Playwright MCP（Model Context Protocol、Cursor の拡張）を設定すると：

あなた：ユーザーログインに E2E テストを追加して

Agent：
1. Playwright テストケース生成
2. 自動実行
3. 失敗を検出（例：ログインボタンのセレクタ誤り）
4. コード修正
5. 再実行
6. 通るまで繰り返し

「要件 → テスト → 修正」が完全自動化。

最近知った機能ですが衝撃的。テスト作成を AI に任せられる時代です。

Agent のコツと注意点

長く使ってきたベストプラクティスと失敗談です。

Agent をうまく使う 4 つのコツ

1. 指示は具体的に

❌ 悪い例：

このコードを最適化して

✅ 良い例：

この関数の時間計算量を O(n²) から O(n) に下げて。ハッシュ表で最適化して

Agent は心を読めません。具体性が正義。

2. 十分なコンテキスト

初回は背景を伝える：

React + TypeScript + Tailwind CSS で ESLint/Prettier を使うプロジェクトです。
ユーザー設定ページを追加してください。

規約に沿ったコードになりやすくなります。

3. Yolo モードを賢く使う

新規プロジェクトや新機能追加なら Yolo オンで全自動。

コアロジック変更なら Yolo オフで操作ごとに確認。

4. チェックポイントを活用

Vultr - 高性能NVMeクラウドサーバー、世界32拠点、Dockerワンクリック展開対応

価格を見る →広告

修正前にチェックポイント（Git ステージに近い）が作られます。間違えたら：

• Ctrl+Z で undo
• 「さっきの修正は問題。前のバージョンに戻して」と伝える

試行錯誤を恐れないで。

避けたい落とし穴

❌ 一度に巨大タスク

• 「プロジェクト全体をリファクタ」は Agent も混乱
• 「まず Auth モジュールから」と分割

❌ Agent 実行中にファイルを行ったり来たり

• 思考が途切れる
• 完了を待ってから確認

❌ 重要プロジェクトをいきなり Agent に

• 先に git commit
• ブランチで修正 → テスト → マージ

✅ 小さなプロジェクトで練習

• Todo List、電卓など

✅ undo と再試行

• 間違えても Ctrl+Z。何度か試せば慣れる

最後に

この記事を書きながら、初めて Agent に触れてからの変化を振り返りました。

以前はコーディング時間の半分がロジック、半分が反復作業——ファイル作成、コピペ、依存 install、設定変更、小バグ修正……

今は Agent に反復作業を任せ、「何を作るか」を考えることに集中しています。

Agent を使い始めてから、もう元には戻れません。

今すぐ試す

ここまで読んだなら、Cursor を開いて：

1. ⌘ + .（または Ctrl + .）で Agent 起動
2. 「このバグを修正して」から始める
3. または「シンプルな Todo List を作って」

徐々に 30〜50% の時間短縮を実感するはず。

間違えても Ctrl+Z。まず一歩を。

関連記事（当ブログ）

• Cursor コードベースインデックス完全ガイド
• Cursor ネットワーク問題の完全対処
• Cursor 無料枠の使い方ガイド

さらに学ぶ（任意）

公式：

• Cursor Agent 概覧
• Agent モード詳細
• Cursor 機能

チュートリアル：

• Cursor Agent 初心者ガイド
• Agent モードの使い方

中国語コミュニティ：

• Cursor 効率化：Agent モード + 7 技巧
• 72 時間 Cursor Agents 研究
• Cursor 実践 1 万字

動画（中国語）：

• Cursor 0.43 Agent 機能解説

締め

Agent で何をしたいですか？ バグ自動修正、高速プロジェクト構築、それとも別のこと？

コメントでアイデアや面白い体験を教えてください。みんなが Agent で何をしているか、とても気になります。

Happy Coding! 🚀