🚫
.claudeignore — 不要なファイル読み込みをブロック
Claude Codeトークン浪費防止＋機密ファイル保護
Claude Codeは作業中にプロジェクトファイルを読む。しかしnode_modules/、ビルド成果物、大容量データファイル、機密情報ファイルまで読むとコンテキストウィンドウが不要なトークンで浪費される。
プロジェクトルートに.claudeignoreファイルを作ると、指定パターンのファイルをClaudeが読まなくなる。文法は.gitignoreと完全に同じ。
なぜ必要か？
- トークン節約 — 大容量ファイル（ログ、データセット、バイナリ）を読むとコンテキストウィンドウがすぐ埋まる
- セキュリティ —
.env、credentials、シークレットキーファイルをClaudeが読めないようブロック - 精度向上 — 不要なファイルを除外するとClaudeが関連ファイルに集中できる
- 速度改善 — ファイル検索範囲が狭まりGlob/Grep等が高速化
.gitignoreとの関係
.gitignoreに既に含まれるファイルはClaudeもデフォルトで無視する。.claudeignoreはGitには追跡されているがClaudeに見せたくないファイルに使用。例えば大容量fixtureファイルや生成コードはGitにはあるがClaudeが読む必要はない。
.claudeignore推奨テンプレート
# === 大容量/不要 ===
node_modules/
vendor/bundle/
tmp/
log/
coverage/
.git/
# === ビルド成果物 ===
public/assets/
dist/
build/
*.min.js
*.min.css
# === データ/バイナリ ===
*.sql
*.sqlite3
*.csv
*.xlsx
storage/
# === 機密情報 ===
.env*
config/master.key
# === 生成コード ===
db/schema.rb
yarn.lock
Gemfile.lock
# === メディア ===
*.mp4
*.mp3
*.png
*.jpg
*.pdf使い方
1
プロジェクトルートに.claudeignoreファイルを作成
2
.gitignoreと同じ文法で無視パターンを記述
3
大容量ファイル、ビルド成果物、機密ファイル、不要データを追加
4
.claudeignore自体はGitにコミットしてチームと共有可能
タグ
#claudeignore
#ignore
#token
#security
#optimization
#performance
Source
Anthropic Docs