モデル切り替えの記録と歯止めを、フック2本で作る

claude-haiku-4-5-20251001
claude-sonnet-5

#!/usr/bin/env bash
# .claude/hooks/model-switch-guard.sh
# PreModelSwitch: 判断だけを行います。重い処理はここに書きません。
set -uo pipefail
 
INPUT=$(cat)
ALLOW_FILE="${CLAUDE_PROJECT_DIR:-$PWD}/.claude/model-allowlist.txt"
 
# 無人実行（source=sdk）以外は素通りさせます。
# 対話中の切り替えは人が意図して行ったものです。
[[ "$INPUT" == *'"source":"sdk"'* || "$INPUT" == *'"source": "sdk"'* ]] || exit 0
 
# to_model を取り出します。パラメータ展開だけで済ませ、外部プロセスを起こしません。
TO="${INPUT#*\"to_model\":}"
TO="${TO#*\"}"
TO="${TO%%\"*}"
 
# 一覧が無い環境では止めません（設定漏れで作業を止めないため）。
[ -f "$ALLOW_FILE" ] || exit 0
grep -qxF "$TO" "$ALLOW_FILE" && exit 0
 
echo "無人実行で許可されていないモデルへの切り替えです: ${TO}" >&2
echo "許可一覧: ${ALLOW_FILE}" >&2
exit 2

$ echo '{"to_model":"claude-opus-5","source":"sdk"}' | ./model-switch-guard.sh
無人実行で許可されていないモデルへの切り替えです: claude-opus-5
許可一覧: /tmp/hooktest/.claude/model-allowlist.txt
exit=2
 
$ echo '{"to_model":"claude-sonnet-5","source":"sdk"}' | ./model-switch-guard.sh
exit=0
 
$ echo '{"to_model":"claude-opus-5","source":"picker"}' | ./model-switch-guard.sh
exit=0

#!/usr/bin/env bash
# .claude/hooks/model-switch-log.sh
# PostModelSwitch: 記録だけを行います。
set -uo pipefail
 
LOG_DIR="${CLAUDE_PROJECT_DIR:-$PWD}/.claude/logs"
mkdir -p "$LOG_DIR"
export LOG="${LOG_DIR}/model-switch-$(TZ=Asia/Tokyo date +%Y-%m).jsonl"
 
python3 -c '
import json, sys, os, datetime
 
d = json.load(sys.stdin)
row = {
  "at": datetime.datetime.now(datetime.timezone.utc).isoformat(timespec="seconds"),
  "session": d.get("session_id"),
  "from": d.get("from_model"),
  "to": d.get("to_model"),
  "requested": d.get("requested_model"),
  "source": d.get("source"),
  "context_tokens": d.get("context_tokens"),
  "cache_warm": d.get("prompt_cache_warm"),
  "cache_ttl": d.get("cache_ttl"),
  "cache_write_usd": d.get("estimated_cache_write_usd"),
  "pricing": d.get("pricing"),
}
with open(os.environ["LOG"], "a", encoding="utf-8") as f:
    f.write(json.dumps(row, ensure_ascii=False) + "\n")
' 2>>"${LOG_DIR}/model-switch-error.log"
 
# 記録に失敗しても、この時点では切り替えは終わっています。
# 終了コードで騒がず、エラーはログに落とすだけにします。
exit 0

{"at": "2026-09-02T03:08:32+00:00", "session": "s1", "from": "claude-haiku-4-5-20251001", "to": "claude-sonnet-5", "requested": "claude-sonnet-5", "source": "sdk", "context_tokens": 48210, "cache_warm": true, "cache_ttl": "5m", "cache_write_usd": 0.9042, "pricing": "catalog"}

{
  "hooks": {
    "PreModelSwitch": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/model-switch-guard.sh",
            "timeout": 5
          }
        ]
      }
    ],
    "PostModelSwitch": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/model-switch-log.sh",
            "timeout": 15
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env python3
"""記録した切り替えを、経路と往復で集計します。"""
import json, sys, collections
 
rows = []
for path in sys.argv[1:]:
    with open(path, encoding="utf-8") as f:
        rows += [json.loads(l) for l in f if l.strip()]
 
by_source = collections.Counter()
cost_by_source = collections.defaultdict(float)
pairs = collections.Counter()
 
for r in rows:
    s = r.get("source") or "unknown"
    by_source[s] += 1
    cost_by_source[s] += r.get("cache_write_usd") or 0.0
    pairs[(r.get("from"), r.get("to"))] += 1
 
total = sum(cost_by_source.values())
print(f"切り替え {len(rows)} 回 / 推定キャッシュ書き込み合計 ${total:.4f}")
for s, n in by_source.most_common():
    print(f"  source={s:<8} {n:>3}回  ${cost_by_source[s]:.4f}")
 
# A→B と B→A が両方ある組は、設計を疑う対象です。
seen = set()
for (a, b), n in pairs.items():
    if (b, a) in pairs and (b, a) not in seen:
        seen.add((a, b))
        print(f"  往復: {a} <-> {b}  {n}+{pairs[(b,a)]}回")

切り替え 3 回 / 推定キャッシュ書き込み合計 $1.2981
  source=sdk        2回  $1.1473
  source=command    1回  $0.1508
  往復: claude-haiku-4-5-20251001 <-> claude-sonnet-5  2+1回