Cursorのコードベースインデックス｜進まないときの確認手順

Cursorにファイルを探させても、狙った箇所がなかなか出てこない。そんな違和感を覚えたことはないでしょうか。原因を探ろうとインデックスの完了を待っても、進捗がどこまで進んでいるのか分かりづらく、依頼を重ねるだけになりがちです。

本記事は「インデックスが進まない」と「完了しているのに見当違いな返答が来る」の両方から読める入口として書いています。焦点は対象範囲の決め方と、効いていないときの切り分けの2点だけ。Settings画面全体の見直しや.cursorignoreの書き方そのものは扱いません。それぞれ専用の記事があるので、気になった方はそちらもチェックしてみてください。

インデックスの内部処理（埋め込みの方式や保存場所、再計算のタイミングなど）は、公式に細部まで公開されているわけではありません。この記事では公式ドキュメントと画面上で確認できる範囲にとどめ、非公開の仕様については後半で改めて触れます。

今日の結論

• まず「今の作業に必要な範囲」を決めてから、インデックスを見直す
• 効いていないと感じたら、依頼を増やす前にSettingsで進捗（完了／途中／停止）を確認する
• 完了しているのに見当違いなら対象が広すぎるか除外漏れ、進まないなら対象の大きさやignoreの食い違いを疑う
• 除外の具体的な書き方は.cursorignoreの記事に譲る。本記事は対象の決め方と切り分けまで

インデックス対象の決め方｜入れる／外す

インデックスは、Cursorがコードベースをあらかじめ読み込んでおき、依頼のたびにファイルを探し直す手間を減らすための仕組みです。具体的な処理方式（埋め込みの方式や保存場所など）は公開情報が限られているため、本記事では取り扱わない。

範囲は広げすぎず、目安は次の表を参考にしてください。

「全部インデックスすれば精度が上がる」わけではありません。範囲が広いほど無関係なファイルもヒットしやすくなり、かえって的外れな返答につながる。除外の具体的な書き方は、.cursorignore（インデックス対象を除外するための設定ファイル）の記事にまとめているので、この記事では対象の考え方までにとどめます。

進んでいるか確認する手順｜Settingsの見方

進捗を見る前に、依頼を増やして様子を見るのはやめましょう。まずはSettings画面でインデックスの状態を確認します。

1. Cursorの設定画面から、インデックスに関する項目を開く。あわせて公式ドキュメントのCodebase Indexing該当ページも一度確認しておくと、表示の意味を取り違えにくくなります（ページのURLや表示名は変更されることがあるため、公式サイト内の検索を使ってください）
2. 進捗が「完了」「途中」「停止」のどれに見えるか確認し、その日付をメモしておく
3. 対象フォルダが、前の見出しで決めた範囲とずれていないか見る
4. 短い依頼で「このファイルを知っているか」を試し、効きの感触を取る。正確に答える保証はないため、あくまで目安として使う

筆者が実装時に確認した範囲では、Settings画面の項目名や表示のされ方はバージョンによって変わることがある。本文では特定のボタン名を断定せず、実際の画面を優先して読み進めてください。料金プランによる制限の有無も執筆時点では未確認のため、気になる場合は公式ドキュメントで確認しましょう。

効いていないときの切り分け｜進まない／見当違い

進捗そのものが動かないケースと、完了しているのに答えがずれるケースは、疑う順番が違います。

切り分けの起点は、進捗が動いているかどうかの一点です。

1. 進捗が動いているか、完了しているかをまず区別する
2. 動いていないなら対象の大きさとネットワークを疑い、完了しているなら除外設定を疑う
3. それでも解決しない場合は、対象を一度絞り込んでから改めて試す

インデックスが再計算されるタイミングなど細かい内部処理は公開されていない範囲があり、本記事では未検証としています。設定画面のプライバシーや自動実行に関する項目、モデルの切り替えは本記事の範囲外です。

.cursorignoreとの連携｜除外の書き方は別記事

対象の決め方と診断がひと通り終わったら、実際に除外する範囲を書き込むのは.cursorignore側の役割です。

• 対象の大枠を決める → Settingsのインデックス設定（設定画面の入口記事も参照）
• パターンで細かく外す → .cursorignore（書き方はこちらの記事にまとめています）
• 詰まりの診断 → 本記事のここまでの内容

.cursorignoreの具体的な書き方やサンプルはこの記事では扱いません。除外のパターンを増やしたい場合は、上記のリンク先を参照してください。

まとめと次に読む

まとめると、インデックスと向き合うときの流れはシンプルです。対象の範囲を決め、Settingsで進捗を見て、動かない・見当違いのどちらかで切り分ける。この3つを順番に進めるだけで、依頼を増やす前に原因の見当がつけやすくなります。

次に読むなら、以下がおすすめです。

• 設定画面全体を見直したい → Cursor Settingsの確認手順
• 除外ファイルの書き方を知りたい → .cursorignoreとtokenの記事
• 拡張を足しすぎて重いときは 拡張機能の選び方
• RulesとAGENTS.mdの置き場所に迷ったら 3ファイルの比較
• Cursorをこれから使い始める、読む順番を確認したい → Cursor無料版シリーズのHub記事

---

本記事の内容は執筆時点（2026-08-22）の情報に基づきます。Cursorの仕様・UI名・インデックスの挙動は変更される可能性があります。内部の実装（保存方式や再計算の詳細）は、公式に公開されていない範囲では未検証です。重要な判断はCursor公式ドキュメントで確認してください。