11月19日、Nirmataが「How to use .cursorignore to keep secrets out of Cursor」と題した記事を公開した。AIコーディングツール「Cursor」を日常的に使っているエンジニアでも見落としがちなリスクがある。**.gitignoreに記載したファイルであっても、CursorのAIエージェントからは必ずしも保護されない**。Cursorは独自の無視リストを持っており、適切に設定しなければcredentials.jsonや*.pemといったファイルがエージェントにそのまま渡ってしまう。本記事はその仕組みと正しい設定手順を解説したものだ。
Agentが読めるファイルは、.gitignoreに書いてあっても必ずしも安全ではない。Cursorは独自の無視リストを持っており、設定しないとcredentials.jsonや*.pemといったファイルがエージェントにそのまま渡る。
.cursorignoreが守れるものと守れないもの
Cursorの公式ドキュメントによると、.cursorignoreでカバーされる範囲は以下の通りだ。
| 対象 | 保護されるか | 備考 |
|---|---|---|
| AgentおよびTabによるコードアクセス | ✅ | ドキュメントに明記 |
| @メンション経由のコードアクセス | ✅ | 同上 |
| Agentが使うターミナルツール | ❌ | ブロック不可 |
| Agentが使うMCPサーバーツール | ❌ | ブロック不可 |
ドキュメントのSecurityセクションにはこう書かれている:「CursorはIgnoreされたファイルをブロックするが、LLMの予測不能な挙動により完全な保護は保証されない」。ターミナルやMCPツール経由の読み取りは.cursorignoreでは防げないという点は特に重要だ。
基本的なセットアップ
リポジトリのルートに.cursorignoreというファイルを作成し、.gitignoreと同じ構文でパターンを記述する。まず押さえておくべき典型的なパターンは以下だ。
# Environment files
**/.env
**/.env.*
# Credentials
**/credentials.json
**/secrets.json
# Keys
**/*.key
**/*.pem
**/id_rsa
.env*はCursorのデフォルト無視リストに含まれているが、*.key・*.pem・credentials.jsonは含まれていない。デフォルトに任せきりにすると、これらのファイルはエージェントに露出したままになる。
注意点1:!による除外の取り消しが効かないケース
.gitignoreを使い慣れたエンジニアが陥りやすいのが、ネゲーション(!)の罠だ。元記事によると、.cursorignoreは.gitignoreと同じ構文を採用しているため、この挙動はCursor固有のバグではなくgitignoreの仕様に基づく共通の動作だ。親ディレクトリを*でまとめて除外した場合、その配下のファイルを!で戻すことができない。
# これは動かない
public/*
!public/index.html
!public/assets/style.css
正しくは、ネストされたディレクトリ自体を先に戻してから再度絞り込む。
# 正しい書き方
public/*
!public/index.html
!public/assets/
public/assets/*
!public/assets/style.css
除外されたディレクトリはパフォーマンス上の理由からトラバースされないため、その内部のパターンは無視される。.gitignoreを書き慣れていても同じ落とし穴にはまる点に注意が必要だ。
注意点2:テストにgit check-ignoreは使えない
.cursorignoreの動作確認にgit check-ignoreを使ってはいけない。Gitは.gitignoreしか読まないため、.cursorignoreでブロックしているファイルでも「見える」と報告してしまう。
正しいテスト手順はCursor上で直接行う:ダミーのシークレットファイルをリポジトリに置き、AgentにそのファイルをOpenするよう指示し、トランスクリプトでどのツールが使われたか確認する。本物の認証情報でテストしてはならない。
グローバル設定と階層的な無視ルール
プロジェクト横断で適用したいパターン(例:会社全体で使うAPIキーの命名規則)は、Cursor Settings → Indexing → Ignore Files にあるグローバル無視リストに追加できる。デフォルトは空。
さらにHierarchical Cursor Ignoreをオンにすると、親ディレクトリの.cursorignoreも検索対象になる。モノレポ構成などで有効な設定だ。
ただし、グローバルリストとプロジェクトの.cursorignoreが矛盾した場合の挙動はドキュメントに明記されていない。両方を設定する場合は必ず実際にテストすること。
Claude Codeとの比較
元記事ではClaude Codeのpermissions.denyとの比較も示されている。なお、Claude Code側の「既知の制限」欄は元記事においてもドキュメント未記載とされており、現時点では公式情報として確認できていない点に留意されたい。
{
"permissions": {
"deny": [
"Read(./.env)",
"Read(./.env.*)"
]
}
}
| 観点 | Cursor .cursorignore |
Claude Code permissions.deny |
|---|---|---|
| 設定場所 | プロジェクトルート+グローバル設定 | settings.json |
| パターン形式 | .gitignore構文 |
ツールルール(例:Read(./.env)) |
| 既知の制限 | ターミナル・MCPツールはブロック不可 | 元記事時点でドキュメントに記載なし |
両ツールを併用している場合、それぞれのフォーマットで個別にルールを書く必要がある。一方の設定がもう一方に引き継がれることはない。
.cursorignoreは「何もしなくても大丈夫」という思い込みを防ぐための最初の一手だ。ただし、これ単体で完全な保護にはならない。ターミナルやMCPツール経由のアクセスは.cursorignoreの管轄外であり、シークレット管理にはHashiCorp VaultやAWS Secrets Managerといったシークレットマネージャーの活用、あるいはdirenvなどの環境変数管理ツールとの組み合わせも検討に値する。.cursorignoreの設定はあくまで多層防御の一層として位置づけるのが現実的だ。
詳細はHow to use .cursorignore to keep secrets out of Cursorを参照していただきたい。