ホーム›読みもの›Claude Codeの秘密保護と8リポジトリの走査

Claude Codeに秘密を読ませない設定と、自分の8リポジトリで鍵を探した結果(実測)

2026年11月11日 / フジケン

自作の秘密検査にダミーの鍵12種を通した結果の棒グラフ。接頭辞が決まっている7種は7種とも検知、形を変えた5種は5種とも見逃し
図1:自作の秘密検査にダミーの鍵12種を通した結果(2026年11月11日の実測)

僕は、個人で運営しているサイトやツールの多くを、AI(Claude Code)に任せて作っています。AIにファイルを触らせるなら、秘密の鍵が入ったファイルを読ませない・公開しない仕組みが要ります。そこで、公式ドキュメントの内容を確かめ、自分のリポジトリを走査して、結果を書きます(2026年11月11日)。

先に結論です。Claude Codeには、秘密のファイルへの読み取りを拒否する設定(permissions の deny ルール)があり、拒否は許可より先に評価されます。ただし、効く範囲には限りがあります。僕の8つのリポジトリ(追跡ファイル490件)を走査したら、鍵らしい文字列は0件でした。一方で、自作の検査にダミーの鍵12種を通すと、7種は見つけて、5種は見逃しました。「0件」は安全の証明ではありません。

1. よくある解説と、足りなかったもの

「Claude Code .env 読ませない」で検索して、上位のサーバーワークスの解説を開きました(2026年11月11日)。CLAUDE.mdに「読まないで」と書くだけでは、自然言語のお願いにすぎず足りないこと、permissions の deny ルールで Read(.env)・Read(.env.*)・Bash(cat .env*) を拒否する方法、さらに細かく制御する hooks の使い方を、手順つきで説明しています。ファイルの名前や命令の文字列しか見ないなど、限界も書かれていました。

この解説は、設定の書き方はよく分かります。一方で、書いた設定が実際にどこまで効くかや、自分のリポジトリに鍵が入っていないかを数字で確かめた結果は載っていません。この記事では、そこを書きます。

2. 公式ドキュメントが言っていること

公式の「Configure permissions」のページを読みました(2026年11月11日に取得)。秘密の保護に関わる部分を、表1にまとめます。

表1:公式ドキュメントの要点(https://code.claude.com/docs/en/permissions、2026年11月11日取得)
項目書かれていること注意点
評価の順番deny、ask、allow の順に見て、最初に一致したものが結果になる広い拒否は、狭い許可で例外にできない
読み取りの拒否Read(./.env) のように、パスを指定して拒否する.claudeignore は効かないと明記されている
効く範囲組み込みのファイル読み取り、cat・head・tail・sed などの認識されたシェル命令、リダイレクトファイルを名指ししない grep -r や、PythonやNodeのスクリプトが開く読み取りには効かない
より強い守りサンドボックスを有効にすると、OSの段階で全プロセスのアクセスを止められる拒否ルールとの併用が勧められている

ここで大事なのは、拒否ルールは「Claudeが組み込みのツールや、よく使うシェル命令で読む」場合に効くもので、別のプログラムが勝手にファイルを開く場合までは止めないことです。公式も、シェルのルールはセキュリティの境界ではないと書いています。

3. 8つのリポジトリを走査した結果

リモートを設定している8つのリポジトリについて、追跡しているファイルを走査しました(2026年11月11日)。探したのは、鍵や秘密の典型的な形7種です。Google系のAPIキー、sk-で始まる鍵、GitHubのトークン、AWSのアクセスキーID、Slackのトークン、秘密鍵のヘッダ、「名前に key や secret を含む変数に長い文字列を代入している行」です。

表2:リポジトリごとの走査結果(2026年11月11日の実測。名前は伏せ、追跡ファイル数の多い順)
リポジトリ追跡ファイル走査できたファイル鍵らしい文字列
1211件55件0件
2107件89件0件
351件45件0件
444件33件0件
526件26件0件
620件20件0件
716件16件0件
815件8件0件

合計は、追跡ファイル490件のうち、文字として読めて2MB以下だった292件を走査して、鍵らしい文字列は0件でした。残りの198件は、画像などのバイナリか、2MBを超えるファイルです。

8つのリポジトリの走査結果の棒グラフ。追跡ファイル490件、走査できたのは292件、鍵らしい文字列が見つかったファイルは0件
図2:走査の結果(2026年11月11日の実測)

4. 検査自身を試したら、5種を見逃した

0件という結果を信じる前に、検査自身が動いているかを確かめました。本物ではないダミーの文字列を12種作り、同じ検査に通したのです。形が決まっている7種(Google系、sk-、GitHub、AWS、Slack、秘密鍵のヘッダ、変数への代入)は、7種とも見つかりました。

見逃したのは次の5種で、5種とも検知できませんでした。

つまり、「8リポジトリで0件」は、形の決まった鍵は入っていないと言えるだけです。形を変えた鍵が入っていないとは言えません。また、過去のコミット履歴は走査していません。いったん入れて消した鍵は、履歴に残っている可能性があります。

5. この結果から言えないこと

6. 同じ点検を自分でやるなら

  1. 公式のpermissionsのページを開いて、自分の設定に読み取りの拒否が入っているかを数える。
  2. 追跡しているファイルだけを対象に、形の決まった鍵のパターンで走査する。
  3. ダミーの文字列を何種か作って、検査が拾うかを先に確かめる。拾えない種類が、自分の見逃しの範囲です。
  4. 過去の履歴も、別の手段で一度は確かめる。
  5. 見つかったら、値を書き換えるより先に、その鍵を発行元で無効にして作り直す。

よくある質問

CLAUDE.mdに「.envを読まないで」と書くだけで十分ですか?

足りないと考えたほうが安全です。解説記事(サーバーワークス、2026年11月11日に確認)は、これは自然言語のお願いにすぎず、文脈によっては守られないと説明しています。技術的に止めるには、permissionsの拒否ルールが使えます。

拒否ルールを入れれば、catやgrepでの読み取りも止まりますか?

公式ドキュメントによると、拒否ルールは組み込みのファイル読み取りと、catやheadなど認識されたシェル命令に効きます。ファイルを名指ししないgrep -rや、スクリプトが開く読み取りには効かないので、完全に止めるにはサンドボックスが勧められています。

走査して0件なら、秘密は漏れていないといえますか?

いえません。僕の検査は、ダミー12種のうち5種(接頭辞のない値、分割した鍵、JWT、Base64、改行で割った値)を見逃しました。形の決まった鍵の有無しか言えず、過去の履歴も別に確かめる必要があります。

まとめ

次の1アクションとして、自分の設定ファイルを開いて、ファイルの読み取りを拒否するルールが何件あるかを数えてみてください。0件なら、まずこの記事の表1を見ながら、秘密のファイルを1つだけ拒否に入れてみるのが出発点です。

ほかにも、自分で運営して測った記録を書いています。内部ファイルを404にする方法を6通り試した実測や、自作の検査を記事33本に当てた実測もどうぞ。

公開: / 更新: