Claude Code の --add-dir で追加したディレクトリの CLAUDE.md が読まれないときの設定

共通の設定やドキュメントを別リポジトリに置き、claude --add-dir ../shared-config で参照させている構成はよくあります。ところが、その shared-config/CLAUDE.md に書いた指示が効かない、という相談が多い機能です。

結論として、--add-dir で追加したディレクトリの CLAUDE.md は 既定では読み込まれません。環境変数 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD を設定したときだけ読み込まれます。

--add-dir は設定を検出しない

--add-dir(セッション内なら /add-dir)は、起動ディレクトリの外にある場所を追加の作業ディレクトリとして扱い、Claude がそこにあるファイルを読み書きできるようにするオプションです。公式ドキュメントは、追加ディレクトリからは「ほとんどの .claude/ 設定が検出されない」と明記しています。CLAUDE.md もこの対象で、既定では読み込まれません。

同じことを settings.json に書くのが permissions.additionalDirectories です。こちらも役割は同じで、ファイルアクセスの付与であり、CLAUDE.md の読み込みではありません。

{
  "permissions": {
    "additionalDirectories": ["../shared-config/"]
  }
}

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD で読み込ませる

追加ディレクトリのメモリファイルも読み込ませたい場合は、環境変数を設定して起動します。

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

このとき読み込まれるのは、追加ディレクトリ直下の次のファイルです。

ファイル	読み込み
CLAUDE.md	読み込まれる
.claude/CLAUDE.md	読み込まれる
.claude/rules/*.md	読み込まれる
CLAUDE.local.md	読み込まれる(--setting-sources で local を除外していると読み込まれない)

環境変数ページの説明では、この変数は「Claude Code が CLAUDE.md を探す追加ディレクトリのコロン区切りリスト(Windows は ; 区切り)」とされています。一方でメモリのページの例は =1 を付けて --add-dir と組み合わせています。どちらの形でも動くかは公式ドキュメントでは確認できなかったため、まずは公式例どおり =1 と --add-dir の組み合わせで試し、効かなければディレクトリのパスを値に指定してください。

毎回付けずに済ませる

環境変数を毎回シェルで指定するのが面倒なら、settings.json の env キーに書きます。env に書いた値はすべてのセッションとそのサブプロセスに適用され、シェルで同名の変数が設定されていても settings 側が優先されます。

{
  "env": {
    "CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD": "1"
  },
  "permissions": {
    "additionalDirectories": ["../shared-config/"]
  }
}

これで claude と打つだけで、../shared-config/ へのアクセスと、その CLAUDE.md の読み込みが両方有効になります。

読み込まれたかどうかは、セッション内で /context を実行して Memory files に追加ディレクトリの CLAUDE.md が並ぶことで確認できます。逆に、共有したい指示が短いなら、環境変数を使わず自分の CLAUDE.md から @ インポート記法 で取り込む方が単純です。CLAUDE.md の階層の全体像は親記事の CLAUDE.md の書き方 を参照してください。

まとめ

• --add-dir と permissions.additionalDirectories はファイルアクセスを付けるだけで、そこにある CLAUDE.md は既定では読まない
• 読ませるには CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD を設定する。CLAUDE.md、.claude/CLAUDE.md、.claude/rules/*.md、CLAUDE.local.md が対象
• 毎回付けたくなければ settings.json の env に書く
• 内容を管理していないディレクトリで有効にしない
• 確認は /context の Memory files