はじめに
Claude Code の VS Code 拡張を使っていて、プロジェクトの CLAUDE.md に書いたルールを急に守ってくれなくなりました。
CLAUDE.md の中身も置き場所も変えていません。ところが拡張機能が更新されたころから、書いておいたワークフローを無視して勝手な方法で作業を進めるようになりました。
調べると、原因は CLAUDE.md の書き方ではありませんでした。拡張機能 v2.1.323 で入った「フォルダの信頼(trust)」の確認によって、CLAUDE.md がそもそも読み込まれていなかったのです。
結論
- VS Code 拡張 v2.1.323 から、フォルダを「未信頼」と判断すると、プロジェクトの CLAUDE.md・settings・MCP を読み込まずに起動するようになった。
- CHANGELOG と確認ダイアログには「settings と MCP が使われない」としか書かれておらず、CLAUDE.md も外れることは明記されていない。
- 拡張が信頼を判断するのは、ウィンドウを開いたときだけ。私の環境では「Developer: Reload Window」で判断し直させると直った。新しいチャットを始めるだけでは直らなかった。
この記事では、次の3つを順に書きます。
- 原因の切り分け方(セッションログの調べ方)
- 原因の仕組み
- 対処法
環境
- macOS
- Claude Code VS Code 拡張 v2.1.327(v2.1.322 までは問題なし)
- 作業フォルダ直下に
CLAUDE.mdを置いている
症状
- CLAUDE.md に書いた手順に従わない。
- 本人(Claude)に聞くと、「受け取っている指示に CLAUDE.md の内容は入っていない」と答える。
- ユーザーレベルのスキルや auto memory(
MEMORY.md)は、これまでどおり効いている。
切り分け①:セッションログで「いつから読まれていないか」を調べる
Claude Code は、セッションの記録を ~/.claude/projects/<フォルダ名を変換したもの>/*.jsonl に保存しています。CLAUDE.md が自動で読み込まれたセッションには、Contents of <パス>/CLAUDE.md (project instructions, checked into the codebase) という文字列が残ります。
そこで、セッションごとに「この文字列があるか」と「Claude Code のバージョン」を並べてみました。
cd ~/.claude/projects/<対象フォルダ>
for f in $(ls -t *.jsonl | head -15); do
loaded=$(grep -c 'CLAUDE.md (project instructions, checked into' "$f")
ver=$(grep -m1 -o '"version":"[^"]*"' "$f")
ep=$(grep -m1 -o '"entrypoint":"[^"]*"' "$f")
echo "$f loaded=$loaded $ver $ep"
done
会話の中でこの文字列そのものを引用したセッションも数えられてしまうので、その点だけ注意してください。
結果は、バージョンできれいに分かれました。
| バージョン | CLAUDE.md の自動読み込み |
|---|---|
| v2.1.319 / v2.1.322 | 全セッションで読み込まれていた |
| v2.1.325 / v2.1.327 | 1回も読み込まれていない |
切り分け②:CLI では読まれるか
拡張機能には CLI 本体が同梱されています。同じバージョンの CLI を同じフォルダで実行し、CLAUDE.md が読み込まれるかを確かめました。
# 拡張に同梱されている CLI(パスは環境に合わせて変更)
CLAUDE=~/.vscode/extensions/anthropic.claude-code-2.1.327-darwin-arm64/resources/native-binary/claude
cd <対象フォルダ>
$CLAUDE -p "ツールは使わずに答えて。コンテキストにこのフォルダの CLAUDE.md の内容はある?あれば最初の見出しを1行で。なければ「なし」" --tools ""
結果は「含まれています」でした。CLI では読み込まれ、VS Code 拡張でだけ読み込まれていないことになります。
原因:拡張がフォルダを「未信頼」と判断すると、プロジェクトの設定を読み込まない
VS Code の拡張ログ(コマンドパレットで「Claude Code: Show Logs」)に、次の行が出ていました。
[info] Starting a process in /path/to/project without the folder's setting sources: Claude Code has no trust record for it
[warning] The folder's setting sources stay unused in /path/to/project: Claude Code was not given trust for it
CHANGELOG の v2.1.323 には、次の記載があります。
[VSCode] Added a Claude Code trust prompt before the first session in a folder you haven't trusted; declining leaves the folder's settings and MCP servers unused
拡張機能のコード(v2.1.327 の extension.js)を見ると、仕組みは次のとおりでした。圧縮されたコードから関係する部分だけを抜き出して、整形しています。変数名は版ごとに変わります。
var n9e=["user","project","local"], r9e=["user"], zJ={CLAUDE_CODE_IGNORE_PERSISTED_TRUST:"1"};
// ...
settingSources: [...C.kind==="trusted" ? n9e : r9e]
- 信頼済みのフォルダ:
settingSources: ["user", "project", "local"]で起動する。 - 未信頼のフォルダ:
settingSources: ["user"]だけで起動し、環境変数CLAUDE_CODE_IGNORE_PERSISTED_TRUST=1を付ける。
Agent SDK のドキュメントによると、プロジェクトの CLAUDE.md(<cwd>/CLAUDE.md または <cwd>/.claude/CLAUDE.md)が読み込まれるのは、settingSources に "project" が含まれる場合だけです。一方で auto memory は settingSources の対象外です。症状とぴったり一致します。
気づきにくい理由
CHANGELOG にも信頼ダイアログにも、「settings と MCP servers が使われない」としか書かれていません。CLAUDE.md も読み込まれなくなるとは、どこにも明記されていません。そのため「CLAUDE.md が効かない」という症状から、この原因にたどり着きにくくなっています。
自分の環境で確かめる方法
- 拡張ログに
without the folder's setting sourcesが出ていないか確認する。 - Claude Code のチャットで Bash を使わせ、
echo $CLAUDE_CODE_IGNORE_PERSISTED_TRUSTの結果を見る。1なら未信頼で起動しています。
対処法
1. フォルダを信頼する(本来の対処)
- VS Code で
Cmd + Shift + P→「Developer: Reload Window」を実行します。 - 新しいチャットを始めます。「Trust this folder in Claude Code?」というダイアログが出たら「Trust folder」を押します。
- ダイアログで回答した場合は、ウィンドウを閉じる前に同じウィンドウでチャットを始めます。信頼の回答は、次にチャットのプロセスが起動したときに保存されるためです(issue #109831)。
ターミナルで claude を対話モードで起動し、信頼を承認する方法もあります(issue #108012)。
新しいチャットを始めるだけでは直りません
拡張ログを見るかぎり、拡張が信頼を判断するのはウィンドウを開いたときの1回だけです。未信頼と判断されたウィンドウでは、チャットを何度作り直しても未信頼のまま起動しました。判断し直させるには、ウィンドウのリロードが必要です。
私の環境では、リロードだけで直りました。ダイアログは出ませんでした。確認した内容は次のとおりです。
- チャットで
echo $CLAUDE_CODE_IGNORE_PERSISTED_TRUSTを実行させると、何も表示されない(未信頼のときは1)。 - ツールを使わせずに「CLAUDE.md の最初の見出しは?」と聞くと、正しく答える。
- 拡張ログに
without the folder's setting sourcesが出なくなった。
ダイアログが出なかったのは、リロードの時点で ~/.claude.json にこのフォルダの信頼の記録(hasTrustDialogAccepted: true)がすでにあったためだと考えています。実際、この記録が付いたあとも、リロードする前のウィンドウでは未信頼のまま起動していました。記録がいつ付いたのかは特定できていません。
2. 信頼済みなのに直らない場合:SessionStart フックで読み込ませる
~/.claude.json で hasTrustDialogAccepted: true になっているのに、「信頼を確認できない」と判断される報告もあります(issue #110741。2.1.323 以降の通常の VS Code でも起きるというコメントあり)。
その場合の回避策として、セッションの開始時に CLAUDE.md の中身を渡すフックを作りました。未信頼の間はプロジェクトの .claude/settings.json も読み込まれないので、フックは**ユーザー設定(~/.claude/settings.json)**に置きます。
~/.claude/hooks/load-project-claudemd.sh:
#!/bin/bash
# 拡張が未信頼で起動したときだけ動く(信頼済みなら通常どおり読み込まれるので何もしない)
[ "$CLAUDE_CODE_IGNORE_PERSISTED_TRUST" = "1" ] || exit 0
input=$(cat)
cwd=$(printf '%s' "$input" | jq -r '.cwd // empty')
[ -n "$cwd" ] || cwd="$PWD"
for f in "$cwd/CLAUDE.md" "$cwd/.claude/CLAUDE.md"; do
if [ -f "$f" ]; then
jq -n --arg path "$f" --rawfile body "$f" '{
hookSpecificOutput: {
hookEventName: "SessionStart",
additionalContext: ("Contents of " + $path + " (project instructions, loaded by SessionStart hook). Follow these instructions:\n\n" + $body)
}
}'
exit 0
fi
done
exit 0
~/.claude/settings.json(既存の設定に追加):
{
"hooks": {
"SessionStart": [
{
"hooks": [
{ "type": "command", "command": "~/.claude/hooks/load-project-claudemd.sh", "timeout": 10 }
]
}
]
}
}
フックの注意点
-
additionalContextが1万文字を超えると、中身はファイルに書き出されます。Claude に渡るのは、先頭2,000文字のプレビューとファイルのパスだけです。長い CLAUDE.md には向きません。 - このフックで補えるのは CLAUDE.md だけです。プロジェクトの settings や MCP サーバーは読み込まれないままなので、根本的には1の対処が必要です。
-
chmod +xを忘れずに。
フックを入れたあと、リロードする前の未信頼のウィンドウで新しいセッションを始めたところ、フックが動きました。セッションの記録には、フックが渡した CLAUDE.md の中身が残っていて、本来の読み込みは0件でした。リロードして信頼済みになったあとは、フックは何もしていません。
単体では、次の3パターンをテストしています。
-
CLAUDE_CODE_IGNORE_PERSISTED_TRUST=1のとき:CLAUDE.md の中身が出力される - 変数がないとき:何も出力しない
- CLAUDE.md がないフォルダ:何も出力しない
まとめ
- VS Code 拡張 v2.1.323 から、未信頼のフォルダでは
settingSources: ["user"]で起動するようになった。そのためプロジェクトの CLAUDE.md も読み込まれない。 - CHANGELOG とダイアログには「settings と MCP が使われない」としか書かれておらず、CLAUDE.md への影響は明記されていない。
- 信頼の判断はウィンドウを開いたときに行われる。直すには、新しいチャットではなくウィンドウのリロードが必要だった。
- 「CLAUDE.md が効かない」と思ったら、書き方を直す前に、まず本当に読み込まれているかをセッションログと拡張ログで確かめるとよい。
参考
- CHANGELOG:https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md (2.1.323 / 2.1.325)
- Agent SDK のドキュメント(Claude Code の機能と settingSources):https://code.claude.com/docs/en/agent-sdk/claude-code-features
- 権限のドキュメント(フォルダの信頼):https://code.claude.com/docs/en/permissions
- フックのドキュメント:https://code.claude.com/docs/en/hooks
- issue #110741、#109831、#108012(anthropics/claude-code)