title: "Claude Codeの承認ルールから秘密を掃除する手順|settings.local.jsonを棚卸しして、pre-commitで止める"
tags:
- ClaudeCode
- セキュリティ
- Git
- シークレット管理
- Python
private: false
はじめに
Claude Codeで「Yes, and don't ask again」を選ぶと、承認したコマンドが .claude/settings.local.json にallowルールとして保存されます※1。コマンドにパスワードを直書きしていると、その値もファイルに残ります。
Apiiroの報告では、GitHub上の同ファイル104,185件のうち1,122件に秘密が含まれていました※2。経緯と数字の読み方は、同じ日にZennへ書いた記事にまとめています。この記事では、手を動かす部分だけを扱います。
やることは次の4つです。
- 手元のリポジトリを棚卸しする
- 秘密入りのルールを見つけて、書き換え案を出す
- pre-commitでコミットを止める
- すでに漏れていた場合の手順を確認する
検証環境は Python 3.13、git、Linux(bash)です。実施日は2026-11-09です。サンプルの値はすべてダミーで、実在の認証情報ではありません。
1. 先に確認:ファイルはどこにあるか
公式ドキュメントによると、保存先は次のとおりです※1※3。
| ファイル | 用途 | gitの扱い |
|---|---|---|
~/.claude/settings.json |
ユーザー全体の設定 | リポジトリ外 |
.claude/settings.json |
チーム共有の設定 | コミットする前提 |
.claude/settings.local.json |
個人用の設定。承認の保存先 | Claude Codeが初回書き込み時にグローバルgit excludesへ追加する |
gitリポジトリ内で作業を始めた場合、ルールはリポジトリのルートのファイルに保存されます。ワークツリーでは、メインのチェックアウトのルートが使われます※3。
まず、自分の環境で、実際に何が入っているかを見ます。
# 自分のリポジトリ直下で
git rev-parse --show-toplevel
ls -la .claude/ 2>/dev/null
git check-ignore -v .claude/settings.local.json # 無視されているか
git ls-files .claude # すでに追跡されているか
git ls-files に settings.local.json が出たら、すでにコミットされています。グローバルのgit excludesは、追跡済みのファイルには効きません※2。
2. 棚卸しスクリプト
permissions.allow の各ルールを読み、秘密らしい文字列を探します。2種類の検出器を使います。
- 検出器A:既知のキー形式(AWS、GitHub、npm、Slack)
- 検出器B:コマンドの文脈(
PGPASSWORD=、sshpass -p、mysql -pXXX、Bearer、URL内のuser:pass@)
Apiiroの報告では、検出を逃した例の多くが、人が決めたパスワードをコマンドに書いたものでした※2。Bはその対策です。
2.1 コード
Python 3.13の標準ライブラリだけで動きます。
#!/usr/bin/env python3
"""settings.local.json の permissions.allow から「コマンド文字列に埋まった秘密」を探す簡易スキャナ。
Python 3.13 / 標準ライブラリのみ。サンプルはすべてダミー値。
検出器A: 既知のキー形式(gitleaks/TruffleHog系の発想の簡易版)
検出器B: コマンド引数の文脈(PGPASSWORD=, sshpass -p, mysql -pXXX, Bearer, URL内パスワード)
"""
import json, re, sys
KEY_FORMATS = { # 検出器A
"aws_access_key": re.compile(r"\bAKIA[0-9A-Z]{16}\b"),
"github_token": re.compile(r"\bgh[pousr]_[A-Za-z0-9]{36}\b"),
"npm_token": re.compile(r"\bnpm_[A-Za-z0-9]{36}\b"),
"slack_token": re.compile(r"\bxox[baprs]-[A-Za-z0-9-]{10,}\b"),
}
CONTEXT = { # 検出器B
"env_password": re.compile(r"\b[A-Z_]*(?:PASSWORD|PASSWD|TOKEN|SECRET|API_?KEY)=(?!\$)\S+"),
"sshpass": re.compile(r"\bsshpass\s+-p\s*\S+"),
"mysql_p": re.compile(r"\bmysql\b[^|;&]*\s-p(?!\s)\S+"),
"bearer_header": re.compile(r"Authorization:\s*Bearer\s+[A-Za-z0-9._~+/=-]{8,}", re.I),
"url_userinfo": re.compile(r"\b[a-z][a-z0-9+.-]*://[^/\s:@]+:[^/\s@]+@"),
}
def rules(path):
d = json.load(open(path, encoding="utf-8"))
return d.get("permissions", {}).get("allow", [])
def scan(rule):
hits = {"A": [k for k, r in KEY_FORMATS.items() if r.search(rule)],
"B": [k for k, r in CONTEXT.items() if r.search(rule)]}
return hits
def suggest(rule):
"""秘密を含む rule は、先頭コマンドだけの前置パターンに置き換える案を出す。"""
m = re.match(r"Bash\((.*)\)$", rule)
if not m: return None
cmd = m.group(1)
cmd = re.sub(r"^(?:[A-Z_]+=\S+\s+)+", "", cmd) # 先頭の VAR=value を除く
head = cmd.split()[0] if cmd.split() else cmd
return f"Bash({head} *) ※広すぎないか要確認。秘密は $ENV 参照にする"
if __name__ == "__main__":
allow = rules(sys.argv[1])
a_only = b_only = both = none = 0
for r in allow:
h = scan(r)
a, b = bool(h["A"]), bool(h["B"])
tag = "A+B" if a and b else "A" if a else "B" if b else "-"
a_only += a and not b; b_only += b and not a; both += a and b; none += not (a or b)
print(f"[{tag:3}] {r}")
if a or b: print(f" -> {suggest(r)}")
n = len(allow); flagged_A = a_only + both; flagged_AB = n - none
print(f"\nrules={n} A(キー形式)で検出={flagged_A} A+Bで検出={flagged_AB} どちらも検出なし={none}")
sys.exit(1 if flagged_AB else 0) # pre-commit用:検出ありなら失敗
2.2 ダミーデータで動かす
次のダミーファイルを作ります。
{
"permissions": {
"allow": [
"Bash(npm test *)",
"Bash(git status)",
"Bash(AWS_ACCESS_KEY_ID=AKIAABCDEFGHIJKLMNOP aws s3 ls)",
"Bash(GITHUB_TOKEN=ghp_0123456789abcdefghijklmnopqrstuvwxyz gh api user)",
"Bash(PGPASSWORD=dummy-Pa55w0rd psql -h db.example.com -U admin -c 'select 1')",
"Bash(sshpass -p 'dummy-ssh-pass' ssh root@203.0.113.10 uptime)",
"Bash(mysql -h db.example.com -u root -pdummyMysqlPass -e 'show databases')",
"Bash(curl -H 'Authorization: Bearer dummyTokenValue1234567890' https://api.example.com/v1/me)",
"Bash(psql postgres://app:dummyPgPass@db.example.com:5432/prod)",
"Bash(DATABASE_URL=$DATABASE_URL npm run migrate)",
"Bash(npm run lint *)",
"WebFetch(domain:docs.example.com)"
]
}
}
実行します。
python3 -I scan_rules.py sample_settings.local.json
実際の出力は次のとおりでした。
[- ] Bash(npm test *)
[- ] Bash(git status)
[A ] Bash(AWS_ACCESS_KEY_ID=AKIAABCDEFGHIJKLMNOP aws s3 ls)
-> Bash(aws *) ※広すぎないか要確認。秘密は $ENV 参照にする
[A+B] Bash(GITHUB_TOKEN=ghp_0123456789abcdefghijklmnopqrstuvwxyz gh api user)
-> Bash(gh *) ※広すぎないか要確認。秘密は $ENV 参照にする
[B ] Bash(PGPASSWORD=dummy-Pa55w0rd psql -h db.example.com -U admin -c 'select 1')
-> Bash(psql *) ※広すぎないか要確認。秘密は $ENV 参照にする
[B ] Bash(sshpass -p 'dummy-ssh-pass' ssh root@203.0.113.10 uptime)
-> Bash(sshpass *) ※広すぎないか要確認。秘密は $ENV 参照にする
[B ] Bash(mysql -h db.example.com -u root -pdummyMysqlPass -e 'show databases')
-> Bash(mysql *) ※広すぎないか要確認。秘密は $ENV 参照にする
[B ] Bash(curl -H 'Authorization: Bearer dummyTokenValue1234567890' https://api.example.com/v1/me)
-> Bash(curl *) ※広すぎないか要確認。秘密は $ENV 参照にする
[B ] Bash(psql postgres://app:dummyPgPass@db.example.com:5432/prod)
-> Bash(psql *) ※広すぎないか要確認。秘密は $ENV 参照にする
[- ] Bash(DATABASE_URL=$DATABASE_URL npm run migrate)
[- ] Bash(npm run lint *)
[- ] WebFetch(domain:docs.example.com)
rules=12 A(キー形式)で検出=2 A+Bで検出=7 どちらも検出なし=5
- 秘密入りの7件は、すべて検出されました。
- 安全な5件(
npm test *、git status、DATABASE_URL=$DATABASE_URL …、npm run lint *、WebFetch)は、誤検出されませんでした。 - キー形式だけ(A)では、7件中2件しか拾えません。残りは、Bが加わって初めて見つかります。
-I は、Pythonの隔離モードです。カレントディレクトリの意図しないモジュールを読み込まないために付けます。
2.3 書き換え案の読み方
出力の -> の行は、先頭コマンドだけの前置パターンです。たとえば Bash(psql *) が提案されます。
ただし、この提案は機械的な出力です。Bash(psql *) は、あらゆる psql 呼び出しを許可します。広すぎる場合があります。公式ドキュメントは、* を置く位置が許可範囲を決めると説明しています。Bash(git *) は、すべてのgitコマンドを許可します※1。
書き換えの順序は、次のようにするのが安全です。
- 値は環境変数に出す(
export PGPASSWORD=...を別の経路で設定)。 - ルールは
Bash(psql *)よりも狭い形にする。たとえば接続先を限定する。 - 秘密そのものは、シークレットマネージャから読む。
3. pre-commitフックで止める
棚卸しは手動なので、コミットの入口にも置きます。ステージされた .claude/settings*.json を調べ、検出があればコミットを止めます。
#!/bin/sh
# .git/hooks/pre-commit : ステージ済みの .claude/settings*.json に秘密入りallowルールがあれば止める
SCAN="${SCAN_RULES:-$HOME/tools/scan_rules.py}"
for f in $(git diff --cached --name-only --diff-filter=ACM | grep -E '(^|/)\.claude/settings(\.local)?\.json$'); do
git show ":$f" > /tmp/_staged_settings.json
if ! python3 -I "$SCAN" /tmp/_staged_settings.json >/tmp/_scan.out 2>&1; then
echo "[pre-commit] $f に秘密らしい文字列を含む allow ルールがあります:"; grep -E '^\[(A|B|A\+B) *\]' /tmp/_scan.out; exit 1
fi
done
exit 0
3.1 置き方
mkdir -p ~/tools && cp scan_rules.py ~/tools/
cp pre-commit .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
チーム全体で使うなら、フックをリポジトリで管理できる core.hooksPath や、pre-commitフレームワークに載せるのが現実的です。
3.2 動作確認
一時的なgitリポジトリで試しました。
- ダミーの秘密入りファイルをステージし、
git commitを実行しました。結果は、7件の該当ルールが表示されてコミットが止まりました。 - 秘密入りのルールを取り除いたファイルをステージし、
git commitを実行しました。結果は、コミットできました。
[pre-commit] .claude/settings.local.json に秘密らしい文字列を含む allow ルールがあります:
[A ] Bash(AWS_ACCESS_KEY_ID=AKIAABCDEFGHIJKLMNOP aws s3 ls)
[A+B] Bash(GITHUB_TOKEN=ghp_0123456789abcdefghijklmnopqrstuvwxyz gh api user)
[B ] Bash(PGPASSWORD=dummy-Pa55w0rd psql -h db.example.com -U admin -c 'select 1')
...(以下省略)
3.3 うまくいかない点
- 正規表現は、筆者が思いつく範囲のパターンです。独自形式のトークンは拾えません。
- フックはローカルのコミットだけを止めます。
--no-verifyで回避できます。サーバ側の検査(CI、push protection)と併用してください。 - 履歴にすでに入っているものは、このフックでは見つかりません。
4. すでに入っていた場合の手順
報道が紹介するApiiroの推奨は、次の順序です※2。
4.1 秘密をローテーションする(最初)
ファイルから秘密が見つかったら、先にその秘密を無効にして、新しい値に替えます。ファイルを消しても、履歴・fork・別のcloneに残るためです。
Apiiroの数字では、現在のファイルには無い秘密が、履歴の中に734件ありました。fork 211件にも同じ秘密が残っていました※2。
4.2 追跡を外す
git rm --cached .claude/settings.local.json
echo '.claude/settings.local.json' >> .gitignore
git add .gitignore
git commit -m "stop tracking Claude Code local settings"
git rm --cached は、作業ツリーのファイルは消さず、追跡だけを外します。履歴は変わりません。
4.3 履歴の確認
履歴に入っているかは、次で確認できます。
git log --all --oneline -- .claude/settings.local.json
git log --all -p -- .claude/settings.local.json | grep -E 'PASSWORD|sshpass|Bearer|AKIA|ghp_' | head
出力が出たら、その時点の秘密は漏えいしたものとして扱います。履歴の書き換えは、チームの合意と全cloneへの影響の確認が必要です。まず、ローテーションを優先します。
4.4 手元のファイルも掃除する
コミットしていなくても、秘密入りのルールは手元に残っています。ファイルを開き、秘密が入った行を削除します。または、棚卸しスクリプトで検出されたルールを置き換えます。
5. 予防:新しく秘密を入れないために
| 対策 | 内容 |
|---|---|
| 変数参照にする | コマンドに $DB_URL と書き、値は環境変数に置く。ルールには変数名だけが残る |
| パターンで承認する |
Bash(npm run *) のように、サブコマンドの後に * を置く※1 |
.env はdenyに入れる |
Read(./.env)、Read(./secrets/**) をdenyにする※1 |
.gitignore に入れる |
組織のテンプレートに .claude/settings.local.json を入れる |
| 検査を入れる | pre-commit・CIの秘密検査に、コマンド文脈のルールを加える |
Read のdenyルールは、Claudeにファイルを読ませないための機能です。コマンドに直書きされた秘密には効きません。目的が別です。
6. 筆者がまだ確認できていないこと
- Claude Codeを対話操作で動かして、承認ダイアログからルールが保存される場面は、再現していません。
- 公式ドキュメントの例では、承認ダイアログが
npm test *のようなパターンを提案しています※1。コマンド全文のルールがどの操作で作られるのかは、手元で確かめる価値があります。 - Apiiroの原文は、取得時にエラーとなり確認できませんでした。数字は報道(※2)が引用した値です。
- スキャナの正規表現は、ダミーデータでの確認だけです。実データでの誤検出率は不明です。
まとめ
- 承認ルールは
.claude/settings.local.jsonに保存され、コマンドの文字列がそのまま残ることがあります。 - 棚卸しスクリプトとpre-commitで、コミットの前に止められます。キー形式だけでなく、コマンドの文脈も見るのがポイントです。
- すでに入っていた場合は、ローテーション、追跡の解除、履歴の確認、手元の掃除の順に進めます。
※本記事の記載内容は筆者個人の見解であり、所属する会社や組織の立場や方針とは一切関係ありません。
筆者情報
【Tomcat-zhou】|AI/AX/AIセキュリティ専門家
AI戦略洞察、AI駆動開発の方法論設計と現場で回る仕組みづくりをしています。
noteで戦略洞察 / Zenn・Qiitaで技術・方法論を書いています。
AIセキュリティ・AIコンサル・AIエージェント開発・AI活用・AI駆動開発教育、AI人材育成サービスを一体で提供。
X: @ZY20240528
LinkedIn: Tomcat-zhou
Facebook: zhou yi
note: Tomcat-zhou
Zenn: Tomcat-zhou
参考資料
- Configure permissions(Claude Code公式ドキュメント)
- Claude Code's "Don't Ask Again" File Exposes Passwords and Keys in 1,122 Public Copies on GitHub(The Hacker News、2026-11-07)
- Settings files and precedence(Claude Code公式ドキュメント)
- Claude Code's "Don't ask again" button left passwords and API keys in 1,122 public GitHub files, researchers say(MadRobot、2026-11-07)
Apiiroの原文は、取得時にエラーとなり内容を確認できませんでした。リンクは付けていません。
タグ
ClaudeCode セキュリティ Git シークレット管理 Python pre-commit AIエージェント
