🔐
AIエージェントへの環境変数漏洩を防ぐ
dotenvx で AI エージェントへの環境変数漏洩を防ぐ
1. なぜ AI エージェントに環境変数を見せてはいけないのか
Claude Code や Codex CLI は、コマンド実行・ファイル読み取り・ログ出力を行えます。もし DOTENV_PRIVATE_KEY_* を保持した状態で AI を起動すると、printenv や /proc/self/environ から読み取られ、ログ・会話経由で漏洩する経路が必ず存在します。「AI を信頼する」のではなく、AI プロセスに最初から鍵を存在させない設計が必要です。
2. この記事でやっていること
-
.envを dotenvx で暗号化して Git 管理する(平文を残さない) - 復号鍵
.env.keysはホストだけに置き、devcontainer へは 環境変数としてのみ渡す -
dotenvx runは人間のシェルでだけ実行し、AI エージェント経由では復号しない - Claude / Codex は 必ずラッパー経由で起動し、
DOTENV_PRIVATE_KEY_*を削除してから実行する - 構成例のリポジトリ https://github.com/mumuMun/secure-dotenvx-devcontainer
3. 前提となるフォルダ構成(例)
Host
.
├─ secrets/
│ └─ .env.keys # 復号鍵(ホストのみ。絶対にマウントしない)
└─ Project/
├─ app/
│ ├─ .env # dotenvx で暗号化(Git 管理)
│ └─ ...
├─ docker-compose.yml
└─ .devcontainer/
└─ devcontainer.json
Devcontainer(Container)
└─ /project # ← Host の Project/ 全体をマウント
└─ app/ # 作業ディレクトリ
重要ポイント:
-
secrets/.env.keysはProject/の外に置き、マウント範囲外にする - コンテナには鍵ファイルを渡さず、環境変数としてのみ渡す
- 作業ディレクトリは
/project/app
4. 秘匿ファイルの取り扱い手順
Step 1: 前提準備(フォルダ構成・マウント範囲)
- devcontainer / docker-compose でマウントするのは
Project/のみ(secrets/を含めない)。
mkdir ~/secrets
Step 2: dotenvx で .env を暗号化
cd Project/app
npx dotenvx encrypt -f .env
# 必要に応じて環境別:
npx dotenvx encrypt -f .env.prod
- 例:
DOTENV_PRIVATE_KEY,DOTENV_PRIVATE_KEY_PRODといった鍵名が発行される。 - 暗号化後の
.envは Git にコミットしてよい(平文が残らない)。
mv .env.keys ~/secrets/
- secrets フォルダに移動する。
Step 3: 復号鍵をホストで管理し direnv で export
secrets/.env.keys(ホストのみ、マウントしない):
DOTENV_PRIVATE_KEY=xxxx
# DOTENV_PRIVATE_KEY_PROD=yyyy # 必要に応じて
Project/app/.envrc:
# secrets/.env.keys から必要な鍵だけを export
export $(grep '^DOTENV_PRIVATE_KEY' ~/secrets/.env.keys)
適用:
cd Project/app
direnv allow
- これでホストのシェルに復号鍵をexportします。
Step 4: ホストで dotenvx run(ホストで動作確認)
cd Project/app
npx dotenvx run -f .env -- npm run dev
# 別コマンド例:
# npx dotenvx run -f .env -- bin/your-command
- まずホスト側で復号と実行が通ることを確認する。
Step 5: docker-compose / devcontainer で環境変数注入
- docker-compose:
environmentに 変数名だけ列挙(値は書かない)。 - devcontainer:
containerEnvにlocalEnvを介して鍵を渡す。 - 鍵ファイルはマウントしない。
cd Project
code .
Project/Dockerfile(node ユーザーでグローバルインストールする最小例):
FROM node:20-bullseye
ENV USE_BUILTIN_RIPGREP=0
# npm のグローバル先をホーム配下に変更し、PATH はラッパー優先
RUN mkdir -p /home/node/.npm-global && chown -R node:node /home/node/.npm-global
ENV PATH="/home/node/.local/bin:/home/node/.npm-global/bin:${PATH}"
USER node
RUN npm config set prefix /home/node/.npm-global \
&& npm install -g @anthropic-ai/claude-code@latest || true
RUN npm install -g @openai/codex@latest
RUN npm install -g wrangler@latest
WORKDIR /project/app
Project/docker-compose.yml:
version: "3.8"
services:
app:
build:
context: .
dockerfile: Dockerfile
working_dir: /project/app
volumes:
- .:/project # Project/ 全体をマウント
environment:
- DOTENV_PRIVATE_KEY # 変数名だけ列挙(値はホストから渡る)
command: bash -lc "cd /project/app && npm i && npx dotenvx run -f .env -- npm run dev"
tty: true
stdin_open: true
Project/.devcontainer/devcontainer.json:
{
"name": "secure-dotenvx",
"dockerComposeFile": ["../docker-compose.yml"],
"service": "app",
"workspaceFolder": "/project/app",
"containerEnv": {
"DOTENV_PRIVATE_KEY": "${localEnv:DOTENV_PRIVATE_KEY}"
},
"postCreateCommand": "cd /project/app && npm i --no-audit --no-fund || true"
}
運用上の注意:
-
direnvが効いたシェルからcode .を起動し、localEnvに鍵が載った状態で devcontainer を開始する。 -
secrets/.env.keysはマウント範囲外なのでコンテナから見えない。
Step 6: Claude / Codex をラッパー経由で起動(鍵を削除)
~/.local/bin/claude(Codex なら ~/.local/bin/codex も同様に):
#!/usr/bin/env bash
set -euo pipefail
# 実体パスは環境に合わせて調整
REAL_CLAUDE="/home/node/.npm-global/bin/claude"
args=()
while IFS= read -r v; do
args+=("-u" "$v")
done < <(compgen -e DOTENV_PRIVATE_KEY_)
exec env "${args[@]}" "$REAL_CLAUDE" "$@"
chmod +x ~/.local/bin/claude
# Codex 用も同じように作成して chmod +x
- ラッパーを
$PATHの先頭に置き、which claude/which codexで確認。 - これにより AI プロセスは復号鍵を一切保持しない。
7. 何が防げて、何が防げないか
| 項目 | 結果 |
|---|---|
AI が DOTENV_PRIVATE_KEY_* の値を読む |
❌ 不可 |
| AI が鍵をログや会話に出力する | ❌ 不可 |
AI が rg で変数名を検索する |
✅ 可能(値は無し) |
| 人間が dotenvx で復号する | ✅ 可能 |
8. なぜこの設計が強いのか
-
静的防御:
.envを暗号化し、鍵ファイルをコンテナに持ち込まない。 -
動的防御: AI 起動時に
DOTENV_PRIVATE_KEY_*を削除するラッパーでプロセス境界を作る。 - 人間のフローだけが復号を行い、AI には最初から秘密が存在しない状態を保証する。
9. まとめ
- dotenvx で
.envを暗号化し、復号鍵はホストだけで管理する。 - devcontainer / docker-compose には鍵を「環境変数としてのみ」渡し、ファイルは渡さない。
- Claude / Codex は必ずラッパー経由で起動し、
DOTENV_PRIVATE_KEY_*を事前に削除する。 - この手順をコピペで適用すれば、AI エージェントを使う開発でも環境変数(復号鍵)の漏洩を構造的に防げる。
セキュリティが気になる方へ
AI生成アプリのセキュリティが気になる方向けに、危険度チェックから本番公開までを私がチェックするサービスを運営しています。

Discussion