Claude Codeに.envを読ませない設定はdenyだけでは足りない

この記事の目次
Claude Codeの設定に Read(./.env) のdenyルールを入れても、それだけで.envの中身を読まれなくなるわけではありません。本番の鍵が入った.envがあるリポジトリでClaude Codeを使うなら、denyルールに加えてサンドボックスもオンにするのが弊社の結論です。反対に作業するリポジトリと端末に本番の鍵が1つも無いなら、denyルールだけで問題ありません。
GitGuardianの2026年版の報告ではClaude Codeを使ったコミットで鍵が漏れた率は3.2%で、公開のGitHubの全コミットの1.5%の約2倍でした。AIに作業を任せるほど、鍵の扱いは設定で決めておく必要があります。
この記事ではdenyルールが止める読み方と止めない読み方の違いを説明します。そのうえで2026年11月時点の公式の説明に沿って、サンドボックスまで入れて確かめる手順を書きます。
Readのdenyルールが止めるのはファイルの名前が見える読み方だけ
Claude CodeのReadのdenyルールは、ファイルの名前がはっきり分かる読み方だけを止めます。Claude Code公式の権限の説明には、ReadとEditのdenyルールはClaude Codeのファイルを読む道具とBashの中の cat・head・tail・sed のような名前の分かるコマンドに効くと書かれています。
同じ説明には、効かない読み方も書かれています。.envがあるフォルダで grep -r を実行したときのようにファイルの名前を出さずに読むコマンドと、PythonやNodeのスクリプトが自分でファイルを開く場合です。Claude Codeがテストのためにスクリプトを動かせば、そのスクリプトは.envを開けます。
もう1つ大事なのは、CLAUDE.mdに「.envを読まないで」と書いても守りにはならないことです。公式の説明では、権限のルールを守らせているのはClaude Code本体でモデルではないとされています。CLAUDE.mdの指示はClaudeが何をしようとするかを変えるだけで、何が許されるかは変えません。
denyルールはClaudeがcatで.envを開くのは止めますが、スクリプトの中から開くのは止めません。
サンドボックスはオンにしても初期のままではほぼ全体を読める
スクリプトからの読み取りまで止めるのがサンドボックスです。Claude Code公式のサンドボックスの説明によると、サンドボックスはClaudeが実行するシェルのコマンドとそこから起きたプロセスにOSの側で制限をかけます。PythonやNodeのスクリプトも同じ制限の中で動きます。
ただしサンドボックスは初期設定ではオフです。オンにしても、初期のままでは ~/.ssh や ~/.aws/credentials を含む端末のほぼ全体を読めます。初期の設定で書き込めるのは作業するフォルダと一時フォルダなどに限られますが、読み取りは広く開いています。
読ませない場所を決めるには、sandbox.filesystem.denyRead に場所を書きます。サンドボックスがオンのときは Read(./.env) のようなReadのdenyルールもサンドボックスの設定に足し合わされ、OSの側で読めなくなります。
もう1つの落とし穴が、サンドボックスの中で失敗したコマンドをClaudeが外でやり直せることです。公式の説明では、この抜け道は allowUnsandboxedCommands を false にすると止まります。また依存のパッケージが無いとサンドボックスが起動せずに制限なしで動くので、failIfUnavailable を true にすると起動しないで止まります。サンドボックスはmacOSとLinuxとWSL2で動き、Windowsでそのまま使うとサンドボックス無しで動きます。
サンドボックスはオンにするだけでなく、読ませない場所と外でのやり直しの禁止までそろえて初めて.envを守れます。
鍵は外から入った指示でも読まれる
鍵が漏れるのは、Claudeが勝手に.envを読みにいくからとは限りません。Microsoftは2026年6月5日のセキュリティのブログで、Claude CodeのGitHub Actionで鍵が漏れる経路を報告しました。
Issueの本文に表示されない形で指示を隠しておくと、それを読んだClaudeがReadの道具で /proc/self/environ を開いてワークフローのAPIキーを読めたという内容です。Microsoftは2026年4月29日に報告し、Anthropicは5月5日にClaude Codeのv2.1.128で対策しました。この件はMicrosoftの検証の環境で確かめた経路で、実際の被害の報告ではありません。
Microsoftは対策として、外から来た文章と鍵と外へ送る道具の3つを1つのAIの作業にそろえないことを挙げています。あわせて鍵の権限を作業に必要な分だけにすることもすすめています。
外から来た文章を読ませる作業ほど、鍵に届かない設定をClaude Codeの側で先に決めておく必要があります。
denyルールだけでいいかは鍵の置き場所で決まる
サンドボックスまで入れるかどうかは、Claude Codeが届く場所に本番の鍵があるかで決まります。社内で説明するときは、次の表をそのまま使えます。
確かめること | denyルールだけでよい | サンドボックスまで入れる |
|---|---|---|
リポジトリの.env | 無いか試しの値だけ | 本番のAPIキーやデータベースの鍵が入っている |
端末の鍵のファイル | ~/.ssh や ~/.aws に本番の鍵が無い | 本番のサーバーやクラウドに入れる鍵がある |
読ませる文章 | 自分で書いた指示だけ | IssueやWebのページなど外から来た文章を読ませる |
Claudeに動かさせるもの | コードを読んで直すだけ | テストやスクリプトを動かさせる |
右の列に1つでも当てはまるなら、次の節の手順でサンドボックスまで入れてください。
4つとも左の列なら、denyルールだけで問題ありません。読まれて困る鍵が届く場所に無いので、サンドボックスの依存のパッケージを入れる手間をかける必要はありません。
denyルールとサンドボックスを入れて確かめる手順
2026年11月時点のClaude Codeの公式の説明に沿った手順です。macOSかLinuxかWSL2で、リポジトリの直下にClaude Codeの設定を置く場合を例にします。
- 今の設定のファイルをバックアップとしてコピーします。
.claude/settings.jsonがすでにあるならcp .claude/settings.json .claude/settings.json.bakを実行してから直します。 - リポジトリの
.claude/settings.jsonに次の設定を書きます。.claude/settings.jsonのdenyルールは、リポジトリを信頼する確認を待たずにすぐ効きます。{ "$schema": "https://json.schemastore.org/claude-code-settings.json", "permissions": { "deny": [ "Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)" ] }, "sandbox": { "enabled": true, "allowUnsandboxedCommands": false, "failIfUnavailable": true } } - LinuxとWSL2では、サンドボックスが使う bubblewrap と socat を入れます。Ubuntuなら次のコマンドです。
sudo apt-get install bubblewrap socat - Claude Codeを起動して
/sandboxを実行します。足りないパッケージがあると Dependencies のタブだけが表示されるので、表示されなくなるまで入れ直して起動し直します。 /statusを実行し、Setting sources の行にプロジェクトの設定のファイルが入っているかを確かめます。無ければ設定のファイルが読まれていないので、JSONの書き方の間違いをclaude doctorで確かめます。- Claudeに
cat .envの実行を頼み、断られるかを確かめます。次に下のコマンドの実行を頼み、エラーになって中身が表示されないかを確かめます。python3 -c "print(open('.env').read())" - これまでに.envを読ませたことがあるなら、その鍵は発行元の管理画面で作り直します。設定を入れる前に読まれた分は取り消せないためです。
うまくいったかは、6の2つのコマンドがどちらも.envの中身を出さないことで判断します。Pythonのコマンドで中身が出たなら、サンドボックスがオンになっていません。
やりがちな失敗は、サンドボックスでビルドが失敗したときに allowUnsandboxedCommands を true に戻してしまうことです。公式の説明では、外に書き込みが必要な道具は sandbox.filesystem.allowWrite で場所を足す形がすすめられています。抜け道を開けずに、必要な場所だけを足してください。
弊社がAIで作るときに人が必ず見る所
弊社も制作にAIを使いますが、鍵の扱いは次の2つを守っています。
- 秘密の鍵はサーバーの側だけで使う:公開の前に名前が
NEXT_PUBLIC_で始まる環境変数を一覧で見て、画面に出てはいけない鍵が入っていないかを確かめます - AIが作ったものは人が承認してから先へ進める:弊社の業務の自動化でも、AIが書いた記事は人が社内の確認用のボードで承認してから公開しています
AIに任せる作業が増えるほど、どこまで届いてよいかは人が設定で決めると弊社は考えています。
弊社がやっていること
弊社はClaude CodeやChatGPTなどのAIで作ったサイトの点検と公開を引き受けています。点検ではコードを書き直さずにそのまま読み、直した方がよい所を報告に書きます。Claude Codeでサイトを作る流れは別の記事で紹介しています。
上の表で4つとも左の列ならこの記事の設定はdenyルールだけで足りるので、弊社に頼む必要はありません。Claude Codeの設定そのものは御社の端末で行う作業なので、この記事の手順で進めてください。
点検の中身はAIで作ったサイトの引き継ぎと点検のページに、料金は料金の一覧にあります。AIで作ったサイトを公開してよいか迷う場合は相談の窓口からご連絡ください。初回の30分は無料です。
よくある質問
CLAUDE.mdに.envを読まないでと書けば足りますか
足りません。Claude Codeの公式の説明では権限のルールを守らせているのはClaude Code本体で、CLAUDE.mdの指示は何が許されるかを変えないとされています。読ませたくないファイルはdenyルールとサンドボックスで止めてください。
Windowsでもサンドボックスは使えますか
Windowsでそのまま動かすとサンドボックス無しで動きます。サンドボックスを使うならWSL2の中でClaude Codeを動かしてください。
チーム全員に同じ設定を入れるにはどうしますか
リポジトリの.claude/settings.jsonに書いてコミットします。denyのルールは各自のファイルと足し合わされるので、各自の設定で消されることはありません。会社として必ず守らせたい場合は管理者の設定で配る方法があります。
サンドボックスを入れるとビルドが動かなくなりませんか
作業するフォルダの外に書き込む道具は失敗することがあります。そのときはサンドボックスの外でのやり直しを許さずに、sandbox.filesystem.allowWriteで必要な場所だけを足してください。