1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Codeの承認ルールから秘密を掃除する手順|settings.local.jsonを棚卸しして、pre-commitで止める

1
Last updated at Posted at 2026-11-09

title: "Claude Codeの承認ルールから秘密を掃除する手順|settings.local.jsonを棚卸しして、pre-commitで止める"
tags:
  - ClaudeCode
  - セキュリティ
  - Git
  - シークレット管理
  - Python
private: false

da_cover.png

はじめに

Claude Codeで「Yes, and don't ask again」を選ぶと、承認したコマンドが .claude/settings.local.json にallowルールとして保存されます※1。コマンドにパスワードを直書きしていると、その値もファイルに残ります。

Apiiroの報告では、GitHub上の同ファイル104,185件のうち1,122件に秘密が含まれていました※2。経緯と数字の読み方は、同じ日にZennへ書いた記事にまとめています。この記事では、手を動かす部分だけを扱います。

やることは次の4つです。

  1. 手元のリポジトリを棚卸しする
  2. 秘密入りのルールを見つけて、書き換え案を出す
  3. pre-commitでコミットを止める
  4. すでに漏れていた場合の手順を確認する

検証環境は 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。

書き換えの順序は、次のようにするのが安全です。

  1. 値は環境変数に出す(export PGPASSWORD=... を別の経路で設定)。
  2. ルールは Bash(psql *) よりも狭い形にする。たとえば接続先を限定する。
  3. 秘密そのものは、シークレットマネージャから読む。

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リポジトリで試しました。

  1. ダミーの秘密入りファイルをステージし、git commit を実行しました。結果は、7件の該当ルールが表示されてコミットが止まりました。
  2. 秘密入りのルールを取り除いたファイルをステージし、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

参考資料

  1. Configure permissions(Claude Code公式ドキュメント)
  2. 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)
  3. Settings files and precedence(Claude Code公式ドキュメント)
  4. 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エージェント

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?