Claude CodeでCLAUDE.mdの変更はいつ反映される?再起動の要否を7種類のファイルで実測
途中で書き換えたCLAUDE.mdはいつから効くのか。Claude Code v2.1.328の対話モードでは次の発言から反映され、再起動は不要でした。スキルは呼び直すまで、出力スタイルは再起動まで古いままでした。

この記事の結論
- Claude Code v2.1.328の対話モードでは、セッションの途中で書き換えたCLAUDE.md・CLAUDE.local.md・.claude/rules/・@importの読み込み先は、次の発言から反映されました(各3回中3回)。再起動は不要です(Claude Desktop・IDE拡張は未測定)。
- 反映の仕組みは、ファイルがディスク上で変わったことを知らせる差分の通知で、Claude Codeが次の発言に付けます。228行のCLAUDE.mdで1行を変更・追加・削除しても、3回中3回とも次の発言から新しいルールになりました。
- スキルはClaudeが呼び直したときだけ新しい中身になりました。同じ会話で呼び直さなかった9回はすべて古いままで、/compactの後も古い本文が戻りました。/スキル名で直接呼ぶと3回中3回、新しい中身になりました。
- 出力スタイルのファイルを編集した場合は、/clearや/compactでも3回中0回で、終了して再開するか新しいセッションを始めるまで反映されませんでした。公式ドキュメントも再起動が必要としています。
- claude -pにstream-json形式で続けて指示を送り、1つのプロセスを動かし続ける使い方では、CLAUDE.mdの変更は次の発言では反映されず(3回中0回)、/compact・/clear・再開で反映されました。hooks(settings.json)はどちらの使い方でもすぐに反映されました。
こんにちは、Claude Code研究所 技術ブログ担当です。CLAUDE.mdにルールを書き足したけれど、これって今のセッションに効いているの? 再起動したほうがいい?…と迷ったこと、ありませんか。再起動が必要だ、/clearでは読み直されない、という説明も見かけます。そこで今回は途中で書き換えたルールがいつから効くのかを、CLAUDE.md・スキル・hooks・出力スタイルなど7種類のファイル×6つのタイミングで確かめました(v2.1.328、計337回)。
目次
CLAUDE.mdを途中で書き換えたら、いつから効く?
ターミナルの対話モードなら、次の発言から効きます。再起動は要りません(Claude Desktop・IDE拡張は未測定)。v2.1.328で試すと、途中で書き換えたCLAUDE.md・CLAUDE.local.md・.claude/rules/・@importの読み込み先は、6つのタイミングすべてで3回中3回とも新しいルールになりました。例外はスキルと出力スタイルで、こちらは書き換えても古い中身のまま動くことがありました。
試し方はシンプルです。CLAUDE.mdに「回答の最後の行には、必ず『担当:佐藤』とだけ書く」と書いて、社内向けの案内文を頼みます。1回目の回答の後で、ファイルを外から「担当:鈴木」に書き換えます。その後の回答の最後の行が佐藤なら古いまま、鈴木なら反映です。
ルールの置き場所の違いはCLAUDE.mdとSkillsの違いで詳しく解説しています。
7種類のファイルは、いつ反映された?
CLAUDE.mdの仲間4種類とhooksは、どのタイミングでもすぐ反映されました。スキルは/clearか新しいセッションで確実に、出力スタイルは終了して再開するか新しいセッションでしか変わりませんでした。
| 書き換えたファイル | 次の発言 | /compact | 自動compact | /clear | 終了→再開 | 新しいセッション |
|---|---|---|---|---|---|---|
| CLAUDE.md | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 |
| CLAUDE.local.md | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 |
| .claude/rules/(pathsなし) | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 |
| @importの読み込み先 | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 |
| hooks(.claude/settings.json) | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 | 3/3 |
| スキル(SKILL.md) | 2/3 | 0/3 | 0/3 | 3/3 | 1/3 | 3/3 |
| 出力スタイル(.claude/output-styles/) | 0/3 | 0/3 | 0/3 | 0/3 | 3/3 | 3/3 |
※新しいルールで回答した回数。Claude Code v2.1.328、macOSのターミナルの対話モード、Sonnet 5.5、各3回。自動compactは発動点を下げて起こした。CLAUDE.mdの仲間4種類は、自動compactより先に次の発言で変更が伝わるので、この列はcompact単独の効果ではない
正直、CLAUDE.mdは「起動時に1回読むだけ」だと思っていたので、次の発言から3回とも鈴木になったのには驚きました…! 3行のファイルで1語を変えただけでは甘いかもしれないので、実物に近い228行のCLAUDE.mdでも試しています。1行を書き換える・1行を足す・1行を消す、どれも3回中3回、次の発言から新しいルールで回答しました。消したルールに従い続けることもありませんでした。
逆に、出力スタイルは/clearをしても0/3です。/clearは会話を空にするだけで、スタイルのファイルは起動時に読んだものを使い続けるようです、、、。公式ドキュメントにも、スタイルのファイルは起動時に読むので、編集したら再起動が必要だと書かれています。
なぜ次の発言から効くのか
Claude Codeが、書き換わったCLAUDE.mdの差分を次の発言に添えてClaudeに渡しているからです。セッションの記録を見ると、書き換えた直後の発言に、CLAUDE.mdのパスと「changed on disk since you last read it」という一文を含む通知と、変更後の行が付いていました。通知には、意図した変更とみなして今の状態を正とするように、という添え書きもあります。
起動時に読んだ古いルールも会話の先頭に残ったままですが、Claudeは新しい差分のほうに従いました。この通知はツールを全部外したセッションでも付いたので、Claudeが自分でファイルを読み直したわけではありません。11月10日公開のv2.1.321でも、同じように次の発言から反映されました(2回)。今回の版で始まった動きではないようです。
/compactの後については、プロジェクト直下のCLAUDE.mdはディスクから読み直すと公式ドキュメントに書かれています。compactの仕組みそのものはClaude Code compactの解説記事にまとめています。
スキルの変更が効かないときは?
スキルは、Claudeがスキルを呼び直したときだけ新しい中身になります。同じ会話の中だと、Claudeは一度読み込んだスキルを呼び直さないことが多く、そのときは古い中身のまま動きました。
| 書き換えた後の状況 | 新しい中身で回答 |
|---|---|
| 同じ会話で、Claudeがスキルを呼び直した | 3/3 |
| 同じ会話で、Claudeがスキルを呼び直さなかった | 0/9 |
| /clear・新しいセッションの後(どれも呼び直した) | 6/6 |
| 入力欄で /annai と打って直接呼んだ | 3/3 |
| 「annaiスキルを読み直してから」と頼んだ | 3/3 |
※annai は検証用に作った案内文スキル。v2.1.328、対話モード、Sonnet 5.5。上の3行は前の表のスキルの行(18回)を、Claudeがスキルを呼び直したかどうかで分け直したもの
公式ドキュメントには、スキルのフォルダは監視されていて、編集はセッション中に拾われるとあります。ファイルの変更そのものは伝わっていても、Claudeが呼び直さなければ古い本文が会話に残ったまま、ということですね。
意外だったのは/compactです。0/3でした。compactの後は「呼んだスキルの本文」を会話に戻す仕組みがあり、戻ってくるのは最初に読んだ古い本文でした。スキルを直したら、/スキル名で呼ぶのがいちばん手軽で確実です。
claude -pで続けて送る使い方では結果が違う
claude -pにstream-json形式で続けて指示を送り、1つのプロセスを動かし続ける使い方では、CLAUDE.mdの変更は次の発言に反映されませんでした。同じ42条件を、この使い方で3回ずつ試した結果です。
| 書き換えたファイル | 対話モード:次の発言 | claude -p:次の発言 | claude -p:/compact・/clear・再開 |
|---|---|---|---|
| CLAUDE.md | 3/3 | 0/3 | 各3/3 |
| CLAUDE.local.md・rules・@import | 各3/3 | 各0/3 | 各3/3 |
| hooks(settings.json) | 3/3 | 3/3 | 各3/3 |
| 出力スタイル | 0/3 | 0/3 | 再開のみ3/3 |
※claude -p --input-format stream-json で1つのプロセスに続けて送った。v2.1.328、Sonnet 5.5、各3回。v2.1.327でも同じ結果(各1回)
対話モードで3/3だったものが、-pでは0/3に逆転しました…! 書き換えから15秒待った回も、Readツールを使えるようにした3回も古いルールのままで、差分の通知そのものが付いていませんでした。ふつうに claude -p "…" と1回ずつ呼ぶ使い方なら、毎回起動し直すので最新のCLAUDE.mdが読まれます。困るのは、スクリプトから1つのプロセスを長く動かし続ける場合です。SDKも同じ仕組みの可能性がありますが、今回は試していません。
なお、Claudeに頼んでCLAUDE.mdの署名を鈴木に直させた場合と、外で書き換えた後にCLAUDE.mdを読み直してから書くよう頼んだ場合は、-pでも3回中3回とも新しいルールになりました。
書き換えた後の確実な反映方法
変えたファイルの種類で、やることが決まります。
- CLAUDE.md・CLAUDE.local.md・rules・@import先:対話モードならそのまま次の発言でOKです。claude -pで1つのプロセスを動かし続けている場合は、/compact・/clear・再開のどれかを挟むか、「CLAUDE.mdを読み直して」と頼みます
- スキル(SKILL.md):入力欄で /スキル名 と打って直接呼びます。/compactでは古い本文が戻るので、直しても効かないときは /clear か新しいセッションにします
- 出力スタイルのファイル:いったん終了して、claude --continue で再開します。会話は続けたまま、新しいスタイルが読み込まれます
- hooks・権限(settings.json):何もしなくて大丈夫です。公式ドキュメントによると、Claude Codeは設定ファイルを監視して読み直します。hooksは今回の実測でも次の発言から新しい内容で動きました
読み込まれたかどうかを自分の目で確かめたいときは、/context allでCLAUDE.mdの一覧を、/skillsでスキルを、/hooksでhooksを見られます。設定が効かない原因の探し方はhooks・スキルが動かない原因の検証記事で紹介しています。
検証の方法と限界
Claude Code v2.1.328(macOS)で、ルールを1つだけ書いたフォルダを7種類用意しました。1回目の依頼の後でファイルを外から書き換え、6つのタイミングのあとに同じ種類の依頼をして、回答の最後の行で判定しています。
- 対話モード:擬似端末でターミナルの画面を動かし、158回測りました(v2.1.321の4回を含む)。セッションの記録からClaudeの回答と差分の通知を取り出しています
- claude -p:stream-jsonの入力で1つのプロセスに続けて送り、179回測りました。APIに送ったリクエストの中身も保存し、新旧のルールがどこに入っているかを確かめています
- 条件をそろえるため:プロジェクト以外の設定ファイル・MCPサーバー・自動メモリは読み込まず、ツールは条件に必要なものだけにしました。ログインはUltraプランのアカウントで、対話モードはauto modeで起動しています
限界もあります。
- モデルはSonnet 5.5だけ、各3回です(v2.1.321とv2.1.327の確認は1〜2回)
- Claude Desktop・VS Codeなどの拡張機能、Agent SDK、ユーザー単位の ~/.claude/CLAUDE.md は試していません
- ルールは署名1行の単純なものです。長く複雑なルールの書き換えで、新旧が混ざらないかまでは見ていません
- 自動compactは発動点を下げて起こしました。対話モードの自動compactの列は、差分の通知が先に届くCLAUDE.mdの仲間ではcompact単独の効果ではありません
- v2.1.328で直った「自動compactが以前のシステムプロンプトを使い回す」不具合は、今回の条件(途中での/output-styleの切り替えを含む)では、v2.1.327との違いとして見えませんでした
まとめ
ターミナルの対話モードでは、途中で書き換えたCLAUDE.mdは次の発言から効き、再起動は要りませんでした。効かないことがあるのはスキル(呼び直すまで)と出力スタイル(再起動まで)、それにclaude -pで動かし続ける1つのプロセスです。
この記事のまとめ
- 対話モードでは、CLAUDE.md・CLAUDE.local.md・rules・@import先の変更は次の発言から反映(各3回中3回)
- 仕組みは、次の発言に付く差分の通知(ファイルがディスク上で変わったことを知らせる)。228行のファイルで変更・追加・削除しても3/3
- スキルはClaudeが呼び直したときだけ新しい中身。直したら /スキル名 で呼ぶのが確実(3/3)。/compactでは古い本文が戻る(0/3)
- 出力スタイルのファイルの編集は、/clearでも0/3。終了して再開すれば3/3
- claude -pにstream-json形式で続けて送ると、CLAUDE.mdの変更は次の発言で0/3。/compact・/clear・再開で反映。hooksはどこでもすぐ反映
記事で紹介した設定を、自社の業務に合わせて組み上げる。
CLAUDE.mdによるプロジェクト規約の設定から、業務に合わせたオリジナルskillsの作成まで、一社ごとにヒアリングした業務を題材に対面で進めます。受講者限定のオリジナルskillsとプロンプトテンプレート集もお渡しします。
- 一社ごとに業務をヒアリングして設計
- 実際の業務データでハンズオン
- スパルタ以上は全額返金保証
- 受講法人数100社超
オンライン30分・無料。フォームは入力1分で、2営業日以内にご連絡します。
よくある質問
CLAUDE.mdを書き換えたら、Claude Codeを再起動する必要はありますか?
ターミナルの対話モードなら不要です。当研究所の実測(v2.1.321とv2.1.328)では、セッションの途中で書き換えたCLAUDE.mdは次の発言から反映されました。Claude Codeが、ファイルが変わったことを知らせる通知と変更箇所を次の発言に付けて、Claudeに伝えます。ただし、claude -pにstream-json形式で続けて指示を送る使い方では次の発言に反映されず、/compactや/clear、再開で反映されました。Claude Desktop・IDE拡張は試していません。
CLAUDE.mdの変更が反映されないのはなぜですか?
よくある原因は3つです。1つ目はファイルの場所で、サブフォルダに置いたCLAUDE.mdは起動時には読まれず、Claudeがそのフォルダのファイルを開いたときに読み込まれます。2つ目はclaude -pにstream-json形式で続けて指示を送る使い方で、途中の変更は/compact・/clear・再開まで反映されませんでした(SDKは未測定)。3つ目は、変えたのが実はスキルや出力スタイルの場合です。スキルはClaudeが呼び直すまで、出力スタイルは再起動まで古い中身のままでした。/context allで読み込まれたCLAUDE.mdの一覧を確かめられます。
/clearでCLAUDE.mdは読み直されますか?
読み直されます。当研究所の実測(v2.1.328)では、/clearの後の発言で、書き換えたCLAUDE.md・CLAUDE.local.md・rules・@importの読み込み先がすべて新しい内容になりました(対話モード・claude -pとも各3回中3回)。ただし出力スタイルのファイルの編集は、/clearでは反映されませんでした。
スキル(SKILL.md)を編集したのに、前の内容のまま動くのはなぜですか?
Claudeが同じ会話の中でスキルを呼び直さず、一度読み込んだ古い本文を使い続けるためです。当研究所の実測では、同じ会話で呼び直さなかった9回はすべて古い内容のままでした。/compactは呼んだスキルの本文を残す仕組みのため、古い本文が戻ります。入力欄で /スキル名 と打って直接呼ぶか、「スキルを読み直してから」と頼むと、3回中3回とも新しい内容になりました。
hooksや権限の設定を変えたときも再起動が必要ですか?
多くの場合は不要です。公式ドキュメントによると、Claude Codeはsettings.jsonを監視していて、permissionsやhooksの変更を実行中のセッションに反映します。当研究所の実測でも、.claude/settings.jsonのhookを書き換えると、対話モード・claude -pとも次の発言から新しい内容で動きました。モデルや一部の設定は起動時にしか読まれないので、/modelなどのコマンドで切り替えます。
参考資料・出典
- GitHubClaude Code v2.1.328
自動compactが以前のシステムプロンプトを使い回していた不具合の修正(/compactと同じく作り直す)など。検証に使ったバージョン
- 公式ドキュメントStore instructions and memories(Instructions seem lost after /compact)
プロジェクト直下のCLAUDE.mdは/compactの後にディスクから読み直されること、/context allで読み込まれたCLAUDE.mdを確かめる方法(確認日)
- 公式ドキュメントExplore the context window(What survives compaction)
compactの後、CLAUDE.mdとpathsの無いrulesはディスクから再注入、呼んだスキルの本文は上限つきで再注入されること(確認日)
- 公式ドキュメントExtend Claude with skills(Live change detection)
スキルのディレクトリを監視し、SKILL.mdの追加・編集・削除を実行中のセッションで拾うこと(確認日)
- 公式ドキュメントClaude Code settings(When edits take effect)
settingsファイルを監視して再読み込みし、permissions・hooksの変更は再起動なしで反映されること。modelなど起動時にしか読まない設定(確認日)
- 公式ドキュメントOutput styles
スタイルのファイルは起動時に読むため、途中で作成・編集したら再起動が必要なこと。/output-styleでの切り替えは次のメッセージから効くこと(確認日)
Claude Codeを実務で活用したい方へ
一社ごとにカスタマイズする対面のClaude Code研修は「スパルタClaude Code塾」。経営者・士業・エンジニア・マーケター・営業職まで、業務をヒアリングしてカリキュラムを設計します。まずは30分の無料相談で、自動化プランと費用対効果をご確認ください。


