メインコンテンツまでスキップ
thumbnail

Claude Codeの「もう聞かないで」で、パスワードが設定ファイルに残る――settings.local.json の落とし穴

箕浦
箕浦
ディアシステム(株)開発二部

こんにちは。ディアシステム開発二部の箕浦です。
毎日、Qiita・Zenn・Xから技術トレンドを集めて、その中から1つテーマを選んで掘り下げています。今日のテーマは 「Claude Codeの『今後は聞かない』承認が、秘密情報を設定ファイルに残してしまう問題」 です。

なぜ今日このテーマなのか​

今日のXでは、トレンドの「本日のニュース」に「Claude Codeが日本で人気急上昇、アプリ作成は便利だがセキュリティリスクも指摘」という趣旨の話題が上がっていました。技術系キーワードで検索すると、「Claude Codeの設定ファイルからパスワードなどが流出」という投稿が上位に並び、引用や拡散も多く見られました。

Qiita・Zennにも関連する動きがありました。Qiitaでは「Claude Codeのコミット前フックでTruffleHogを実行し、シークレット入りのコミットを止める」という記事が出ており、ZennでもClaude Codeの実装のクセやAIが書いたコードを本番品質に保つ仕組みに関する記事が並んでいます。「エージェントに任せる範囲が広がるほど、秘密情報の扱いが問題になる」という空気があります。

そこで元の話を調べると、セキュリティ企業Apiiroが公開GitHub上のファイルを調べた研究が出どころのようでした。社内でもClaude Codeを使う場面が増えているので、仕組みと、今日から確認できることを整理します。

1. 何が起きているのか​

Claude Codeは、シェルコマンドを実行する前にユーザーへ許可を求めます。その選択肢の1つが「Yes, and don't ask again」(はい、今後は聞かない)です。これを選ぶと、そのコマンドを許可するルールが .claude/settings.local.json に allow として保存され、次からは確認なしで実行されます。

ここまでは便利な機能です。問題は、保存されるのがコマンドの文字列そのものだという点です。たとえば psql postgres://user:password@host/db -c "select 1" のように、パスワードを含むコマンドを承認すると、報道によればパスワードごと平文でファイルに残ります。ファイルの側には「これは秘密です」という印もありません。

Apiiroの調査について、報道が伝える数字は次のとおりです。

  • 公開GitHub上の .claude/settings.local.json を 104,185件(約10.4万件、103,617リポジトリ)調べた
  • そのうち 1,122件の現行ファイルに、もっともらしい認証情報が含まれていた(重複を除いて1,379件の秘密)
  • 履歴や関連ファイルまで含めると、1,994リポジトリで2,539件
  • 種類は、データベースのパスワード、Supabaseのキー、SSHのログイン情報、AWSのキー、秘密鍵など。影響を受けた組織は63、うち1社は漏れたキーが有効だったと確認した

読むときに注意したい点もあります。

  • 「1,122件」と「2,539件」は数える単位が違う(現行ファイルだけか、履歴などを含むか)ため、単純に比べられません。報道記事自身も、この2つの関係を詳しく説明していません。
  • Apiiroは、見つけた認証情報が実際に使えるかどうかは検証していないとされています。「実在しそうな認証情報」であって、全部が有効だったわけではありません。
  • 対象は公開リポジトリだけです。非公開リポジトリの状況は分かりません。
  • Anthropic側の対応についても、確認できた記事には書かれていませんでした。

とはいえ、公式ドキュメントと突き合わせると、仕組みとしては筋が通っています。

2. 公式ドキュメントで確認できること​

Claude Codeの設定のドキュメントには、次のように書かれています。

  • .claude/settings.local.json は「あなた個人・そのプロジェクトだけ」の設定ファイルで、「Yes, and don't ask again」を選ぶと、承認がこのファイルに allow ルールとして保存される。
  • このファイルは、Claude Codeが作るときにユーザー全体(グローバル)のgit除外設定に自動で追加される。手作業で作ったファイルは、自分で .gitignore に入れる必要がある。
  • 権限ルールの評価順は deny → ask → allow で、最初に一致したものが採用される。
  • 権限の確認表では、Bashコマンドの「今後は聞かない」は「リポジトリごと・コマンドごとにずっと」有効と説明されている。

ここで大事なのは、ドキュメントの言う「gitに入らない」が、自分のPCのグローバル設定に依存していることです。報道で指摘されていた、この保護が効かない場面を整理します。

  1. 別のPCやCI、チームメンバーの環境:除外設定は各自のグローバル設定にあるので、共有されない。
  2. すでに追跡されているファイル:除外設定は、過去にコミット済みのファイルを追跡対象から外さない。
  3. 後からgit管理を始めたフォルダなど、除外設定が働く前の状態でコミットした場合。

つまり、「普通に使っていれば漏れない」ように作られてはいますが、その前提が崩れる場面が現実にはある、というのが今回の話の骨格です。悪意のある攻撃やプロンプトインジェクションではなく、ふつうの操作の積み重ねで起きる点も特徴です(この見方も報道の整理によるものです)。

3. なぜ従来のスキャナでは見落とされやすいのか​

報道によると、同じ調査でGitleaksは564件、TruffleHogは643件のファイルを検出した一方、どちらも検出できなかったものが215件あったとされています。

理由として挙げられているのは、PGPASSWORD=...、sshpass -p ...、mysql -p... のように、コマンドの引数に書かれたパスワードには、AKIA... や sk-... のような「見ればキーとわかる接頭辞」がないことです。スキャナは、形式が決まっているキー(AWSのアクセスキーなど)は得意ですが、ただの文字列のパスワードは見分けにくい、ということです。

この点は、OWASPのSecrets Management Cheat Sheetが述べる「検出ツールは複数使い、種類を広く見る」「秘密をコードや設定に埋め込まない」という考え方とも合います。「スキャナが通ったから安全」とは言えない、というのが今回の教訓の1つです。

4. 防ぐ手立てを、4つの層で考える​

対策は、1つに頼らず層で考えるのが現実的です。

層1:そもそもコマンドに秘密を書かない
最も効く対策です。PGPASSWORD=xxx psql ... と書く代わりに、起動前にシェル側で環境変数を設定したり、ツールが読む認証情報ファイルを使ったりします。ただし、ある解説は、KEY=value をコマンドの前に付けるだけではコマンド全体が記録されるので意味がないと注意しています。Claude Code側の許可ルールでは、先頭の変数代入のうち安全と分かっているものだけが無視される、とドキュメントにありますが、パスワードの変数はその対象ではありません。

層2:秘密が入ったコマンドを、永続承認しない
確認画面で、コマンドに秘密が見えたら「今回だけ許可」を選びます。「今後は聞かない」を押す前に、画面に出ているコマンドに秘密が含まれていないかを一呼吸おいて見る習慣です。ドキュメントによれば、複合コマンド(&& でつないだもの)は、確認が必要な部分ごとにルールが保存されます。長いコマンドほど、何が保存されるのかが見えにくくなります。

層3:ファイルをgitに入れない・履歴に残さない
プロジェクトの .gitignore に .claude/settings.local.json を明示的に入れます(個人のグローバル設定に頼らない)。すでに追跡されているなら、追跡から外します。コミット前の検査は、Qiitaで紹介されていたような PreToolUseフック+TruffleHog でエージェント経由のコミットを止められます。ただし、その記事自身が書いているとおり、フックは --no-verify や設定変更で回避でき、人が手でするコミットには効かないので、CIでの検査も併用する前提です。

層4:許可の設計そのものを見直す
deny に Read(./.env) のような機密ファイルを入れる設定は、公式にも例があります。ただしドキュメントは、Read/Editのdenyは「Pythonなどのスクリプトが自分でファイルを開く場合」までは止められないと述べ、OSレベルで止めたいならサンドボックスを使うとしています。Bashの許可ルールも、コマンドの書き方を変えれば一致しない場合があるため、「セキュリティの境界ではない」と明記されています。ルールは「便利さのための仕組み」であり、「秘密を守る壁」ではない、という理解が大切です。

5. 万一、すでに漏れていたら​

順序が大事です。ファイルを消す前に、まず鍵を無効にします。

  1. 該当するパスワード・トークン・キーを失効させ、新しいものに差し替える(ローテーション)。OWASPも、漏れた秘密は失効→再発行→コードやログからの除去の順で、素早く対応するよう述べています。
  2. そのうえで、ファイルを追跡から外し、.gitignore に追加する。
  3. 履歴に残っていないか確認する。最新のコミットから消しても、過去のコミットには残り続けます。
  4. フォークやクローンが他にあれば、そちらにも残っている前提で考える(報道では、フォークによって74リポジトリ分の認証情報が211の追加コピーに複製されていたとされています)。

6. 現場で使えるチェックリスト​

社内の開発リポジトリで、今日から確認できる項目です。

現状の確認(5分でできます)

  • リポジトリ内で次のコマンドを実行し、.claude/settings.local.json がgitに追跡されていないか確認する。

    git ls-files --error-unmatch .claude/settings.local.json

    パスが表示されたら追跡されています(表示されず「did not match」と出れば追跡されていません)。

  • 履歴に入ったことがないかも確認する。

    git log --all --oneline -- .claude/settings.local.json
  • 保存されている許可ルールを見て、パスワードやトークンらしき文字列がないか目で確認する(jq が使えない環境では、エディタで開くだけで構いません)。

    jq -r '.permissions.allow[]?' .claude/settings.local.json

運用の見直し

  1. プロジェクトの .gitignore に .claude/settings.local.json を入れる(個人のグローバル設定に任せない)。
  2. 確認画面で、コマンドに秘密が見えたら「今後は聞かない」を選ばない。
  3. DBやSSHの接続情報は、コマンドに書かず、環境変数・認証情報ファイル・シークレット管理の仕組みから渡す。
  4. 秘密の検出は、コミット前(フック)とCIの両方に置く。パスワード形式を拾えるルールを追加できるか、使っているスキャナの設定も確認する。
  5. 保存された許可ルールを、ときどき棚卸しする(広すぎる許可や、不要になった許可を消す)。
  6. 確実に守りたいファイル・ネットワークは、サンドボックスなどのOSレベルの制限を併用する。
  7. 漏れた疑いがあれば、消す前にローテーションする。

まとめ​

  • 「Yes, and don't ask again」は、承認したコマンドの文字列を .claude/settings.local.json に残す。コマンドに秘密が含まれていれば、秘密も残る。
  • 公開GitHub上の約10.4万件を調べたApiiroの調査(報道ベースで、原文は未確認)では、現行ファイル1,122件から認証情報が見つかったとされる。ただし、有効性の検証や非公開リポジトリは対象外。
  • gitに入らない保護は、個人のグローバル設定に頼るもので、追跡済みのファイルや別環境には効かない。
  • 防ぐ基本は、「コマンドに秘密を書かない」「秘密入りを永続承認しない」「ファイルをプロジェクトの .gitignore で明示的に除外する」の3つ。漏れたら、ファイルを消す前に鍵を差し替える。
  • 権限ルールやスキャナは便利な安全網ですが、それだけで秘密を守る壁にはならない。

明日もトレンドを追いかけます。

未経験から始める
システムエンジニア

一生モノのITスキルを身につけよう

あなたの経験とスキルを
ディアシステムで発揮してください!