◉CLAUDE LABEN
●CC 2.1.327 — Claude Code 2.1.327(11/18)で、MCP サーバーの設定を標準入力から渡せる claude mcp add-json が加わりました●MCP.JSON — 同じ版で、project スコープの mcp add・remove が .mcp.json の他のキーを消していた問題が直りました●SONNET 4.5 — Claude API での提供終了は 11/30、残り11日。コードと保存済みのモデル設定を一度に洗い出してください●GATEWAY — 1M 文脈のモデルをゲートウェイ越しに使うと、自動圧縮が遅すぎて1回の応答に数十秒かかる、という報告が出ています●NEON — 11/18 に Gemini 4 Neon が GA。Claude Code と併用するなら、MCP の設定をツールごとに分けておくと混乱しません●NEW — Linked billing の 402 と 403、どの財布が空かを見分ける●CC 2.1.327 — Claude Code 2.1.327(11/18)で、MCP サーバーの設定を標準入力から渡せる claude mcp add-json が加わりました●MCP.JSON — 同じ版で、project スコープの mcp add・remove が .mcp.json の他のキーを消していた問題が直りました●SONNET 4.5 — Claude API での提供終了は 11/30、残り11日。コードと保存済みのモデル設定を一度に洗い出してください●GATEWAY — 1M 文脈のモデルをゲートウェイ越しに使うと、自動圧縮が遅すぎて1回の応答に数十秒かかる、という報告が出ています●NEON — 11/18 に Gemini 4 Neon が GA。Claude Code と併用するなら、MCP の設定をツールごとに分けておくと混乱しません●NEW — Linked billing の 402 と 403、どの財布が空かを見分ける
記事一覧/Claude.ai
◉ Claude.ai/2026-11-19初級

Claude に settings.local.json を書き換えさせたら、ConfigChange フックで「効いたか」を記録しておきます

Claude Code は設定ファイルを監視して、権限ルールの変更をセッション中に読み直します。それでも承認画面が消えないときに、再起動を繰り返す前に見る場所と、ConfigChange フックで権限ルールの増減だけを記録するスクリプトをまとめます。

Claude Code290settings.local.json3ConfigChangeHooks5権限設定3

壁紙アプリの Android 版をビルドし直していた夕方、私は Claude に「./gradlew の実行を毎回聞かれないように、settings.local.json に足しておいてください」と頼みました。Claude はファイルを書き換え、追加した一行を見せてくれました。ところが、次の ./gradlew assembleDebug で、また承認画面が出たのです。

真っ先に疑ったのは「書き換えたファイルを、Claude Code が読み直していないのではないか」ということでした。GitHub には、まさにその症状を報告した Issue(#41259、2026年3月)があります。私はそれを読んで納得し、セッションを二度、三度と立ち上げ直しました。

結果は芳しくありませんでした。何度立ち上げ直しても、承認画面は消えなかったのです。

原因がまったく別の場所にあると気づいたのは、三度目の再起動のあとでした。

最初にお伝えしたいのは、いまは読み直される前提だということです

公式の Settings ドキュメントには「When edits take effect」という節があり、Claude Code は設定ファイルを監視して、変更されたら読み直すと書かれています。対象には permissions と hooks が含まれ、ユーザー・プロジェクト・ローカル・管理者設定のどれもが読み直しの範囲です。

先ほどの Issue はすでに閉じられています。少なくとも現行のドキュメントでは、Claude が settings.local.json を書き換えた時点で、新しい allow はそのセッションに届く設計なのです。

例外として、セッション開始時に一度だけ読むキーがあります。ドキュメントが挙げているのは次のとおりです。

  • model は /model で切り替えます。
  • effortLevel と modelSettings は /effort で変えます。
  • permissions.blockReadsOutsideWorkingDirectories を途中で外しても、ファイル系ツールの制限は残ります。外すには、すべての設定ファイルから消して再起動します。

権限ルールの追加は、この例外に入っていません。つまり「再起動すれば直る」と考えて立ち上げ直すのは、多くの場合、遠回りなのです。

再起動の前に見る4つの場所

私の場合、原因はプロジェクトの .claude/settings.json に置いてあった一行の ask でした。チームで共有しているわけではなく、半年ほど前に自分で書いて、すっかり忘れていたものです。

公式の権限ドキュメントでは、deny がどの層にあっても allow より先に評価されます。さらに Settings ドキュメントのトラブルシューティングには、ローカルファイルの allow が、プロジェクトや管理者設定の ask より上には来ないと書かれています。私の allow は、最初から勝てない位置にあったわけです。

同じように承認画面が消えないとき、私はいま、次の順で見ています。

  1. /status の Setting sources の行: 書き換えたファイルが、そのセッションで読まれているかを確かめます。settings.local.json は、サブディレクトリで起動しても git リポジトリのルートから読まれます(Windows やリポジトリの外など、例外があります)。
  2. ほかのファイルの ask と deny: ユーザー設定とプロジェクト設定に、同じツールを指す ask や deny がないかを見ます。
  3. ファイルが壊れていないか: JSON の書き損じはファイルごと、ルールの書き損じはその項目だけが読み飛ばされます。11月17日の 2.1.327 から、/status に「無視された権限設定」の一覧が出るようになりました。詳しい理由は claude doctor で確かめます。
  4. 信頼待ちになっていないか: settings.local.json が git で追跡されているか、.claude がシンボリックリンクの場合、Claude Code はリポジトリから来た設定として扱い、フォルダを信頼するまで allow を保留します。

それぞれの層を1つずつ読む方法は、allow を足したのに承認画面が消えないときの6段の読み方で詳しく扱いました。ここでは、その手前の「書き換えが本当に起きて、読み直されたのか」を記録として残す方法に絞ります。

Claude に .claude を書かせるときの前提

もう一つ、知っておくと迷わずに済む性質があります。.claude フォルダは「保護されたパス」で、Claude が書き込むときの扱いはモードごとに決まっています。

モード.claude への書き込み
default・acceptEdits毎回たずねられる
auto分類器が判断する
dontAsk拒否される
bypassPermissions許可される

ドキュメントには、Edit(.claude/**) のような allow を書いても、この扱いは変わらないとあります。承認画面では「このセッションのあいだ、このプロジェクトの .claude フォルダの編集を許可する」という選択肢が出ることがあります。

dontAsk で動かしている無人の処理に「設定に足しておいて」と頼んでも、書き込みそのものが拒否されます。Claude が「追加しました」と返していても、ファイルが変わっていないことがあるのです——私が記録を残すようにした理由の一つは、ここにあります。

ConfigChange フックで、権限ルールの増減だけを記録する

Claude Code には、セッション中に設定ファイルが変わったときに動く ConfigChange フックがあります。matcher には user_settings・project_settings・local_settings・policy_settings・skills があり、フックには source と file_path が渡されます。

このフックは変更を止めることもできます。ただし、止めたときには本人にも Claude にも何も表示されず、デバッグログに一行残るだけだと書かれています。「記録のつもりで書いたフックが、うっかり変更を止めていた」という事故は、いちばん見つけにくいかたちになるでしょう。

そこで私は、書き換えは Claude に、記録はフックに、効いたかの確認は私がという分担にしました。フックには記録だけをさせ、どんな失敗でも終了コード 0 で抜けるようにしています。

次のスクリプトは、変わったファイルの allow・ask・deny を前回のスナップショットと比べ、増えたルールと消えたルールを ~/.claude/config-audit/changes.jsonl に一行ずつ書き足します。allow が増えたときは、ほかの設定ファイルにある同じツール名の ask と deny も並べます。

#!/usr/bin/env python3
"""ConfigChange フックから呼ばれ、権限ルールの増減だけを記録する。
変更を止めることはしない(どんな失敗でも exit 0)。"""
import hashlib
import json
import sys
import time
from pathlib import Path
 
LOG_DIR = Path.home() / ".claude" / "config-audit"
KEYS = ("allow", "ask", "deny")
 
 
def load_rules(path):
    """permissions の3リストを返す。読めないときは (None, 理由)。"""
    try:
        data = json.loads(Path(path).read_text(encoding="utf-8"))
    except FileNotFoundError:
        return None, "missing"
    except json.JSONDecodeError as e:
        return None, f"invalid JSON (line {e.lineno})"
    perms = data.get("permissions") or {}
    return {k: sorted(set(perms.get(k) or [])) for k in KEYS}, None
 
 
def tool_of(rule):
    """'Bash(npm run *)' -> 'Bash'"""
    return rule.split("(", 1)[0]
 
 
def competing_rules(cwd, changed_path, tools):
    """ほかの設定ファイルにある ask / deny のうち、同じツール名のものを拾う。"""
    others = [Path.home() / ".claude" / "settings.json",
              Path(cwd) / ".claude" / "settings.json",
              Path(cwd) / ".claude" / "settings.local.json"]
    hits = []
    for p in others:
        if str(p) == str(changed_path) or not p.exists():
            continue
        rules, err = load_rules(p)
        if err:
            continue
        for k in ("ask", "deny"):
            hits += [f"{k} {r}  <- {p}" for r in rules[k] if tool_of(r) in tools]
    return hits
 
 
def main():
    event = json.load(sys.stdin)
    source = event.get("source", "?")
    path = event.get("file_path")
    if not path or source == "skills":
        return
    LOG_DIR.mkdir(parents=True, exist_ok=True)
    snap = LOG_DIR / f"snapshot-{hashlib.sha1(path.encode()).hexdigest()[:12]}.json"
    prev = json.loads(snap.read_text()) if snap.exists() else {k: [] for k in KEYS}
    rules, err = load_rules(path)
    entry = {"at": time.strftime("%Y-%m-%dT%H:%M:%S"), "source": source, "file": path}
    if err:
        entry["error"] = err  # 壊れたファイルは記録だけ残し、スナップショットは更新しない
    else:
        for k in KEYS:
            added = [r for r in rules[k] if r not in prev.get(k, [])]
            removed = [r for r in prev.get(k, []) if r not in rules[k]]
            if added:
                entry[k + "+"] = added
            if removed:
                entry[k + "-"] = removed
        new_tools = {tool_of(r) for r in entry.get("allow+", [])}
        if new_tools:
            entry["competing"] = competing_rules(event.get("cwd", "."), path, new_tools)
        snap.write_text(json.dumps(rules, ensure_ascii=False))
    with open(LOG_DIR / "changes.jsonl", "a", encoding="utf-8") as f:
        f.write(json.dumps(entry, ensure_ascii=False) + "\n")
 
 
if __name__ == "__main__":
    try:
        main()
    except Exception as e:  # フックの失敗で作業を止めない
        print(f"config_audit: {e}", file=sys.stderr)
    sys.exit(0)

競合の判定を「同じツール名」までにとどめているのは、意図してのことです。Bash(./gradlew *) と Bash(./gradlew assembleDebug) のどちらが勝つかを、スクリプトの側で推測したくありませんでした。候補を並べるところまでを機械に任せ、当たっているかどうかは自分の目で決めます。少し慎重すぎるかもしれません。それでも、判定を間違えたスクリプトを信じて遠回りするよりはよいと感じています。

保存先は ~/.claude/hooks/config_audit.py にしました。フックの登録は、Claude に書き換えさせることの少ないユーザー設定 ~/.claude/settings.json に置いています。

{
  "hooks": {
    "ConfigChange": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$HOME/.claude/hooks/config_audit.py\""
          }
        ]
      }
    ]
  }
}

matcher を省いているので、すべての設定ファイルの変更で動きます。skills の変更はスクリプト側で読み飛ばしています。args を付けないシェル形式なので、$HOME はシェルが展開します。

手元で動かした結果

Claude Code を起動する前に、フックに渡される JSON を手で流し込んで確かめました。プロジェクト設定に ask: Bash(./gradlew *) を置き、ローカル設定の allow を一行ずつ増やしてから、最後にわざと末尾のカンマを残しています。

echo '{"hook_event_name":"ConfigChange","source":"local_settings","cwd":"'"$PWD"'","file_path":"'"$PWD"'/.claude/settings.local.json"}' \
  | python3 ~/.claude/hooks/config_audit.py; echo "exit=$?"

3回とも exit=0 で終わり、changes.jsonl には次の3行が残りました(パスは短くしています)。

{"source": "local_settings", "allow+": ["Bash(npm test)"], "competing": ["ask Bash(./gradlew *)  <- proj/.claude/settings.json"]}
{"source": "local_settings", "allow+": ["Bash(./gradlew assembleDebug)"], "competing": ["ask Bash(./gradlew *)  <- proj/.claude/settings.json"]}
{"source": "local_settings", "error": "invalid JSON (line 1)"}

1行目は初回なので、既存のルールがすべて「増えた」側に出ます。npm test の行にも gradlew の ask が並んでいるのは、ツール名だけで拾っているためです。2行目こそが、私が三度の再起動で見落としていた一行でした。

記録に残らない変更もあります

ドキュメントによると、承認画面で「Yes, and don't ask again」を選んだときや、/permissions・/model で保存したときは、保存したそのセッションでは ConfigChange フックが動きません。同じファイルを読んでいる別のセッションでは動きます。

claude.ai のコンソールから届く管理者設定や、macOS の管理プロファイルによる更新でも動きません。この記録は「Claude かエディタがファイルを直接書き換えたとき」の記録だと割り切って使っています。

もう一つ、スクリプトは cwd の .claude を見ています。サブディレクトリで起動していると、git ルートにある settings.local.json を競合の候補から取りこぼすことがあります。気になる方は、git rev-parse --show-toplevel の結果を使うように書き換えていただければと思います。

記録を見たあとに確かめること

changes.jsonl に行が増えていれば、少なくともファイルの書き換えは起きています。そのうえで承認画面が消えないなら、competing の欄と /status を見比べます。

  • competing に ask や deny が並んでいたら、そのルールが同じ呼び出しに当たるかを確かめます。
  • 何も並ばず、/status に無視された権限設定が出ていたら、書式の誤りを疑います。
  • 行そのものが増えていなければ、書き込みが拒否されたか、別のファイルを書き換えています。

設定の書き損じが黙って読み飛ばされる仕組みは、settings.json のキー名を間違えても何も言われない件でも触れました。claude doctor の警告の読み方は、警告が4つ並んだ日の仕分けが参考になると思います。

いまの私の線引き

個人開発では、設定を書き換えるのも、それを使うのも自分一人です。だからこそ「さっき足したはず」という記憶に頼りがちで、私自身、三度の再起動でようやくそれに気づきました。

いまは、Claude に権限を足してもらったら、まず changes.jsonl の末尾を一行だけ見ます。増えたルールの隣に competing が並んでいないか——それを確かめてから、作業に戻るようにしています。

まずは ~/.claude/settings.json にこのフックを登録し、次に Claude が設定を書き換えたときの一行を読んでみていただければ幸いです。再起動する前に読む一行が、私にはいちばん効きました。

シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

◉ Claude.ai2026-11-17
定期実行の「新着はある?」を毎回 AI に聞かせていた — 1日の回数と1回の量を掛けてから組み直す
Claude に組ませた定期実行で週の使用枠が早く尽きるとき、原因は「確認だけの回」まで AI が丸ごと動いていることが多いです。1日の回数×1回の量の見積もり、AI を起こす前の条件確認、失敗が続いたら止めるブレーキを、動くスクリプトつきで書き残します。
◉ Claude.ai2026-11-15
「Browser extension is not connected」が消えないとき、拡張を入れ直す前に確かめた4つの層
Claude in Chrome が Cowork や Claude Code から「Browser extension is not connected」と返されるとき、Chrome・プロフィール・Desktop の設定・ブリッジのどこで止まっているかを順に切り分ける手順と、macOS 用の確認スクリプトをまとめました。
◉ Claude.ai2026-08-29
Claude Desktop のセッションが30日で消えていた問題が直ったあとで、記録の取り方を見直しました
Claude Desktop と Cowork のセッションが30日で消えていた不具合が v2.1.248 で修正されました。自分の環境を確かめる手順と、新しい設定の効く範囲、そしてセッションに頼らず結果を1行ずつ残す小さな仕組みまでをまとめます。