設定が効かないときは、まず「読まれたか」を見る

CLAUDE.md に書いた決まりを Claude が守らないとき、書き方を直す前に確かめることがあります。そのファイルが、いまのセッションに読み込まれているかどうかです。

公式ドキュメントは、設定が効かない原因をおおむね3つに分けています。ファイルが読み込まれていない、思っていたのと別の場所から読み込まれている、別のファイルに上書きされている。この記事は、その最初の「読み込まれていない」を見分ける手順です。上書きを疑うのは、読まれたと分かってからです。

/context で、読み込まれた中身を見る

最初に使うのは `/context` です。いまのコンテキストに載っているものを、システムプロンプト、ツール、MCP のツール、自作のサブエージェント（読み込み元つき）、メモリファイル、skill、会話、の区分で表示します。CLAUDE.md や rules、skill の説明がそもそも入っているかを、ここで確かめます。

なお `/context` の skill の欄には、`/skills` の一覧に出ない同梱の skill も含まれます。

一覧に無いとき、あるとき

メモリファイルが一覧に無いなら、置き場所を疑います。サブディレクトリの CLAUDE.md が開始時には読み込まれないことは、7月の記事で書きました。いまは、そのディレクトリのファイルに Read・Write・Edit のどれかを使った後で読み込まれます（v2.1.288 より前は Read のときだけ）。

一覧にあるのに守られないなら、読み込みではなく書き方の問題です。docs は、解釈が複数ありうる曖昧な指示、ファイル同士の食い違い、長くなりすぎたファイルで、守られる度合いが下がると書いています。

/status と claude doctor で、設定ファイルを見る

設定ファイル（`settings.json` など）は `/status` で見ます。Status タブの `Setting sources` の行に、その回に読み込まれた設定ファイルが並び、組織の管理設定が効いているかも分かります。どのキーがどのファイルから来たかまでは出ません。

壊れた設定ファイルを探すときは、ターミナルで `claude doctor` を実行します。セッションを始めずに、読み取りだけの診断を出します。セッション内の `/doctor` は別物で、修正案を出し、確認を取ってから直します。

それでも分からなければ、全部外して比べる

`claude --safe-mode` で始めると、CLAUDE.md、skill、プラグイン、フック、MCP サーバー、自作のコマンドと agent を全部外したセッションになります。認証やモデルの選択、組み込みのツール、権限はふだんどおり動きます。これで症状が消えたなら、外したもののどれかが原因です。組織の管理設定のフックや設定のポリシーは、safe mode でも効き続けます。

safe mode でも消えないときは、設定を何も読まないセッションと比べます。`CLAUDE_CONFIG_DIR` を空のディレクトリに向け、`.claude` フォルダも `.mcp.json` も CLAUDE.md も無い場所から起動します。

```

cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude

```

初回はテーマ選択などの初期設定の画面が出ます。出れば、空の設定ディレクトリが効いています。ログインもやり直しになります。ここで症状が消えれば原因は自分の `~/.claude` かプロジェクトの `.claude` にあるので、ファイルを1つずつ戻して特定します。

まとめると、一覧に無ければ置き場所、一覧にあれば書き方、それでも分からなければ safe mode と空の設定で比べる、の順です。設定が効かないときは、書き方を直す前に、まず読まれたかどうかを確かめます。

※ 仕様の記述は Claude Code 公式ドキュメント「Debug your configuration」「Settings files and precedence」（2026-10-04 確認）によります。版ごとの挙動は変わることがあるため、最新は公式ドキュメントでご確認ください。
#ClaudeCode #AI #開発環境 #個人開発 #エンジニア