.cursorignoreでCursorのtoken消費を抑える方法

Cursor で作業していると、依頼のたびに動作が重くなったり、token（トークン、AI とのやり取りで消費される処理単位）の消費が思った以上に早いと感じることがあります。原因の一つは、Cursor がプロジェクト内の不要なファイルまで読み込んでしまっていることです。.cursorignore を設定すると、この巨大コンテキスト化を防げます。

今日の結論

• node_modules や .next、dist などの生成物を読ませないことで、token 消費を抑えられます
• 無料版・Pro 版どちらでも「読ませない範囲」を設計しておくことが重要です
• 大きな JSON データを意図せず読み込ませていないかも、合わせて確認する価値があります
• 設定後は実際の依頼で動作確認し、必要に応じて追記します

Cursorが重くなる原因は「読み込み範囲」

Cursor はプロジェクト全体を参照しながら回答を作るため、明示的に除外しない限り node_modules や .next、dist のようなビルド生成物・依存パッケージのフォルダも読み込み対象になりえます。これらはファイル数・サイズが大きく、本来は依頼内容に関係のない情報です。結果として、無関係なファイルを読んだ分だけ token 消費が増え、応答が重くなる可能性があります。

.cursorignoreとは

.cursorignore は、Git の .gitignore と同じ書き方で、Cursor に読ませたくないファイル・フォルダを指定する設定ファイルです。プロジェクトルートに置くことで、指定したパスを Cursor の読み込み対象から外せます（執筆時点での挙動です。詳細な仕様は公式ドキュメントで確認することをおすすめします）。

作り方の手順

1. プロジェクトルートに .cursorignore を作成する
2. node_modules、.next、dist、サイズの大きい JSON ファイルなどを追加する
3. Cursor に何か依頼し、意図しないファイルを読んでいないか確認する
4. 読み込まれている不要なファイルが見つかったら、ignore に追記する

node_modules
.next
dist
*.log

適用後の確認とチーム共有

設定したら、実際に Cursor へ依頼を出して挙動を確認します。回答の根拠や参照ファイルの表示があれば、そこに不要なフォルダが含まれていないかをチェックすると分かりやすいです。

チームで Cursor を使う場合は、.cursorignore をリポジトリに含め、なぜそのパスを除外したのかを1行コメントなどで残しておくと、後から見た人が判断に迷いません。

データの置き場所も合わせて見直す

.cursorignore の設定と合わせて検討したいのが、大きな JSON などのデータファイルをどこに置くかです。公開用のフォルダに大きなデータを直接置いてしまうと、Cursor の読み込み対象になりやすいだけでなく、リポジトリ自体も重くなります。読み込ませる必要がないデータは、別リポジトリや非公開のディレクトリに分けておくと、コンテキストの管理がしやすくなります。

チェックリスト

まとめ・次に読む

.cursorignore は小さな設定ですが、token 消費や応答速度に直結する部分です。まずは node_modules などの生成物を除外するところから始めてみてください。

• Hub: Cursor初心者トラブル解決シリーズ
• 関連: token消費が重くなりやすい依頼の傾向

本記事は執筆時点（2026年6月20日）の情報に基づいています。Cursor の仕様や挙動は変更される可能性があるため、最新の制限や動作については公式ドキュメントでご確認ください。