Cursor AgentがAuto-runで止まった——3ステップの復旧手順

"Cursor Agentが途中で一時停止したとき、何を確認してどう再開するか。初心者でも迷わない3ステップの復旧手順と、再発を減らすセッション設計を解説します。"

Cursorのエージェントモードでタスクを走らせていたら、途中で応答がなくなった——そんな経験はないでしょうか。

ぐるぐるローディングのまま動かない、何度プロンプトを送っても反応しない。焦って画面を閉じると、途中までの作業が消えてしまうかもしれないと不安になります。

原因のほとんどはセッションの肥大化か内部エラーです。手順を固定しておくと、再発時に落ち着いて対処できます。

この記事の結論

Agent一時停止の主因はセッション肥大化・内部エラー

まず画面リロード→改善しなければ新規チャット+context再投入→タスク分割の順で対処する

長いタスクは最初から小さく区切るのが再発防止の基本

一時停止が起きる主な原因

Cursor Agentが止まりやすい状況はおおむね次の2つです。

セッションが長くなりすぎた
1つのチャットで多くのファイル編集・ターミナル実行を重ねると、Agentが参照する情報量（コンテキスト）が増えすぎて処理が詰まります。

内部エラー・接続のタイムアウト
ネットワークの一時的な不安定やCursor側のサーバーエラーが原因で、応答が止まるケースもあります。

まずアプリ全体をリロードします。

リロード後にAgentが再開する、またはエラーメッセージが表示されるケースがあります。エラー内容が分かれば対処しやすくなります。

リロードで解決した場合はここで完了です。

リロードしても改善しない場合は、そのチャットを使い続けるのをいったん止めます。

再投入するcontextの例:

# 再開メモ
- 作業対象ファイル: src/components/Header.tsx
- ここまでやったこと: ナビゲーションのレスポンシブ対応（完了）
- 次にやること: フッターの同様の修正
- 制約: Tailwind のみ使用、既存クラスを消さない

前のチャットに積み上げた情報をそのまま引き継ぐ機能は、執筆時点では公式には提供されていません。必要な情報を自分でまとめて貼り直すのが確実です。

ステップ1・2を繰り返すようであれば、タスクの粒度が大きすぎる可能性があります。

1つの指示でAgentに任せる範囲を小さくします。

分割前（止まりやすい）	分割後（止まりにくい）
「ヘッダーとフッターとサイドバーをレスポンシブ対応して」	「ヘッダーだけレスポンシブ対応して」→確認→「次はフッター」
「全ページのmetaタグを修正して」	「トップページのmetaタグを修正して」→確認→「次は記事ページ」

1タスク＝1ファイル〜数ファイル程度を目安にすると安定します。

確認項目	タイミング
`Cmd/Ctrl + R` でリロード済みか	止まったらまず
新規チャットでcontext再投入したか	リロード後も改善しない場合
タスクを1ファイル単位に分割したか	繰り返し停止する場合
`.cursorrules` や `AGENTS.md` など前提条件は冒頭に貼り直したか	新規チャット作成時

Cursorの無料版でできることとできないことの全体像は、以下のHub記事にまとめています。

関連Tips

本記事はCursor 2026年5月時点の動作をもとにしています。UI・機能名はアップデートで変わる場合があるため、最新情報はCursor公式ドキュメントをあわせてご確認ください。