settings.json

claudeMdExcludes

型string[]記述場所どの設定ファイルでも可

読み込みから除外する CLAUDE.md ファイルの glob パターンを指定します。

記述例

{
  "claudeMdExcludes": ["**/vendor/**/CLAUDE.md"]
}

使い方・用途

  • 大規模なモノレポにおいて、他チームが作成した無関係な CLAUDE.md の指示を Claude が読み込んで混乱するのを防ぎます。
  • プロジェクト固有のルールを優先させ、不要なファイルによるトークンの消費や指示の衝突を回避したい場合に活用します。
英語原文(公式ドキュメントより)

Glob patterns for CLAUDE.md files to exclude from loading. Useful in monorepos to skip irrelevant instructions from other teams. Patterns match against absolute file paths. Arrays merge across settings layers. Managed policy CLAUDE.md files cannot be excluded. See https://code.claude.com/docs/en/memory#exclude-specific-claude-md-files

関連ドキュメント

関連する変更履歴

v2.1.239(1件)

Fixed
Memory
プロジェクトの claudeMdExcludes のパス判定において、シンボリックリンクされた .claude/rules ディレクトリがパターンにマッチせず、無視設定がすり抜けて不要なルールファイルが読み込まれてしまう不具合を修正しました。
英語原文を表示
Fixed claudeMdExcludes not excluding a symlinked .claude/rules file when the pattern names the rules directory or the symlink rather than its target

変更前

複数のプロジェクトで共通のルールをシンボリックリンクして .claude/rules に配置している場合、claudeMdExcludes に除外対象として .claude/rules/ やシンボリックリンク名を指定しても、リンク先の絶対パスで判定されてマッチせず、除外が無視されてしまっていました。

変更後

シンボリックリンク自体のパスおよび論理パスについても適切に除外スキャンの段階で評価され、claudeMdExcludes に設定した通りのパターンでシンボリックリンク先の CLAUDE.md やルールが確実にロード対象から除外されます。

ユーザーへの恩恵

共通ルールをシンボリックリンクで管理している大規模プロジェクトで、不要なルールがメモリにロードされてコンテキストを圧迫するのを防げます。

関連ドキュメント