壁紙アプリの 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 は、最初から勝てない位置にあったわけです。
同じように承認画面が消えないとき、私はいま、次の順で見ています。
/statusの Setting sources の行: 書き換えたファイルが、そのセッションで読まれているかを確かめます。settings.local.jsonは、サブディレクトリで起動しても git リポジトリのルートから読まれます(Windows やリポジトリの外など、例外があります)。- ほかのファイルの ask と deny: ユーザー設定とプロジェクト設定に、同じツールを指す
askやdenyがないかを見ます。 - ファイルが壊れていないか: JSON の書き損じはファイルごと、ルールの書き損じはその項目だけが読み飛ばされます。11月17日の 2.1.327 から、
/statusに「無視された権限設定」の一覧が出るようになりました。詳しい理由はclaude doctorで確かめます。 - 信頼待ちになっていないか:
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 が設定を書き換えたときの一行を読んでみていただければ幸いです。再起動する前に読む一行が、私にはいちばん効きました。