🔐

AIエージェントへの環境変数漏洩を防ぐ

に公開
2026/07/23

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