Cursorで起きるトラブルを14件集めて、直し方を1か所にまとめました。設定で直るものと、ツール側の制約で直らないものを分けています。直らないものを探して時間を溶かさないためです。
直すまでにやることは、平均で3つ。多くは3つ以内で止まります。
まず、どれに当たるか
| 段 | 意味 | Cursorでの件数 |
|---|---|---|
| 設定で直る | 設定か指示文の書き方だけで止まる | 2件 |
| 使い方で直る | 設定ではなく、渡し方や手順で止まる | 8件 |
| ツール側の制約 | 設定を探しても止まらない。別のAIを見る | 1件 |
| 規約・権利の話 | ツールを替えても解決しない。確かめる先の話 | 3件 |
3段目に当たったら、設定を探すのをやめてください。そのAIにその機能が無いか、仕様で決まっています。探すほど時間が減ります。
設定で直る(2件)
| 症状 | 起きる理由 | 最初にやること |
|---|---|---|
| 日本語のコメントが文字化けする | ファイルの文字コードが合っていません。 | UTF-8で保存し直す |
| 提案が出てこない・止まる | 接続、契約の状態、対応していない言語のいずれかです。 | 接続と契約の状態を確かめる |
使い方で直る(8件)
| 症状 | 起きる理由 | 最初にやること |
|---|---|---|
| 生成されたコードが動かない | 使っているライブラリの版が違うか、前提の環境が異なります。 | エラー文をそのまま貼って直させる |
| 既存のコードを壊される | 文脈を読み違えて、関係ない部分まで書き換えることがあります。 | 変更前にコミットしておく |
| 長いファイルの後半を無視する | 一度に読める長さに上限があります。 | ファイルを分割して渡す |
| 同じ修正を何度も繰り返す | 直した内容が伝わっていないか、前の指示に戻っています。 | 現在のコードを貼り直す |
| APIキーをコードに書かれてしまう | 動く形を優先して、鍵を直接書いた例が出ます。 | 環境変数に移す |
| テストを書かずに完成と言う | 指示に含まれていないと、確認の工程を省きます。 | テストまで含めて依頼する |
| 料金が急に増える | 従量課金のツールでは、長いやり取りや大きなファイルで消費が増えます。 | 使用量の画面を定期的に見る |
| バージョン管理と噛み合わない | AIがまとめて変更すると、差分が大きくなって追えなくなります。 | 変更を小さく区切って依頼する |
ツール側の制約(1件)
| 症状 | 起きる理由 | 最初にやること |
|---|---|---|
| 存在しない関数やライブラリを使う | それらしい名前を作ってしまうことがあります。仕様です。 | 公式の資料で名前を確かめる |
規約・権利の話(3件)
| 症状 | 起きる理由 | 最初にやること |
|---|---|---|
| 社内のコードを外部に送ってよいか分からない | コードがどこへ送られ、学習に使われるかはツールと設定で変わります。 | 学習利用をオフにする設定を確かめる |
| ライセンスの分からないコードが混ざる | 学習データに由来する断片が出ることがあります。 | 似たコードの検出機能を有効にする |
| 生成物の権利が誰のものか分からない | 扱いはツールの規約で決まり、受託案件では発注側との取り決めも要ります。 | 利用規約を確かめる |
CursorはどんなAIか
| 項目 | 内容 |
|---|---|
| 提供元 | Anysphere |
| 月額 | 0〜3,000円 |
| 無料で試せるか | 無料枠あり |
| 日本語 | 日本語○ |
| 向く場面 | 無料枠で一度動かし、続けるか決めたい場合 |
AIを使う前提で設計されたエディタ。すでに書かれたコードの修正に向く。無料枠だと補完の回数に上限があります。
料金は提供元が公表している価格です。プランによって、止まる症状そのものが変わることがあります(生成の上限、使えるモデル、同時の本数)。
Cursorでとくに多い5件を、手順まで
1. 生成されたコードが動かない
なぜ起きるか:使っているライブラリの版が違うか、前提の環境が異なります。
直し方(3つ)
- エラー文をそのまま貼って直させる
- 使っている版を先に伝える
- 動く最小の形から積み上げる
次からの避け方:環境と版を最初に伝えると、手戻りが大きく減ります。
それでも止まらないとき:Claude Codeで回避できることがあります(有料のみ)。
2. 存在しない関数やライブラリを使う
なぜ起きるか:それらしい名前を作ってしまうことがあります。仕様です。
直し方(3つ)
- 公式の資料で名前を確かめる
- 実行して確かめてから使う
- 「実在するものだけ使って」と指示しても防ぎきれません
次からの避け方:動かして確かめるまで信じないことです。
それでも止まらないとき:Claude Codeで回避できることがあります(有料のみ)。
3. 既存のコードを壊される
なぜ起きるか:文脈を読み違えて、関係ない部分まで書き換えることがあります。
直し方(3つ)
- 変更前にコミットしておく
- 変更範囲を明示して指示する
- 差分を必ず目で確かめる
次からの避け方:作業の前に必ず記録を取ってください。戻せる状態を保つことです。
それでも止まらないとき:Clineで回避できることがあります(無料枠あり)。
4. 長いファイルの後半を無視する
なぜ起きるか:一度に読める長さに上限があります。
直し方(3つ)
- ファイルを分割して渡す
- 関係する部分だけを抜き出す
- ファイルを直接読めるツールを使う
次からの避け方:1ファイルが長くなりすぎないよう分けておくと、AIも扱えます。
それでも止まらないとき:Claude Codeで回避できることがあります(有料のみ)。
5. 同じ修正を何度も繰り返す
なぜ起きるか:直した内容が伝わっていないか、前の指示に戻っています。
直し方(3つ)
- 現在のコードを貼り直す
- 何を直したかを明示する
- 会話を新しく始める
次からの避け方:やり取りが長くなったら、状態を貼り直してください。
それでも止まらないとき:Claude Codeで回避できることがあります(有料のみ)。
直らないときに、ほかのAIへ移る目安
Cursorで止まる症状には、別のAIなら回避できるものがあります。このサイトで代わりに挙げているのは次のとおりです。
| 代わりに使えるもの | この症状のとき |
|---|---|
| Claude Code | 生成されたコードが動かない/存在しない関数やライブラリを使う |
| Cline | 既存のコードを壊される/社内のコードを外部に送ってよいか分からない |
| Cursor | 日本語のコメントが文字化けする/提案が出てこない・止まる |
| GitHub Copilot | 料金が急に増える |
乗り換える前に、いま出ている症状が2段目までかを見てください。使い方で直るものを、AIを替えて解決しようとすると、同じことが次でも起きます。
問い合わせる前にそろえるもの
| 控えるもの | 例 |
|---|---|
| いつから | 日付と時刻 |
| 何をしたら | 押した順番・貼った内容 |
| どう出たか | 画面の文字をそのまま。写真でもよい |
| 使っているもの | OS・アプリかブラウザか・プラン |
| 試したこと | 新しい会話で試した/別の端末で試した など |
「動きません」だけでは調べようがありません。この5つがあると1往復で終わります。
先に試す3つ(症状を問わず)
- 新しい会話で、短い指示だけで試す。前のやり取りを引きずっていることが多い
- ブラウザとアプリを入れ替える。どちらかで動けば、動かないほうの問題
- 拡張機能を切る。広告ブロックやVPNが通信を止めていることがある
このページの決めごと
症状は109件を調べ、そのうちCursorで起きるものを14件選んでいます。口コミの点数・満足度・おすすめ順位は載せていません。集めていないためです。並べ方は「設定で直るもの」から順で、優劣ではありません。仕様は変わるので、直らないときは提供元の最新の記載を見てください。