環境変数

CLAUDE_CODE_SUBPROCESS_ENV_SCRUB

1 を設定すると、Bash コマンド、フック、stdio MCP サーバーなど、Claude Code が起動するサブプロセスの環境から認証情報を剥ぎ取る。スクラブは変数名または値によって認証情報を認識し、GitHub トークンとプロキシ設定はそのまま残す。削除される内容については What the subprocess environment scrub removes を参照。claude-code-action は allowed_non_write_users が設定されるとこれを自動的に設定する。

使い方・用途

  • Bash コマンド、フック、stdio MCP サーバーなど Claude Code が起動するサブプロセスの環境変数から認証情報を除去したいときに使う
  • サンドボックスの有効無効にかかわらず、すべてのサブプロセスから認証情報を剥がしたいときに sandbox.credentials の代わりに設定する
  • この環境変数を設定すると filesystem.disabled がどの設定ソースから指定されていても無視されファイルシステム分離が維持されるため、管理者がサンドボックス設定を固定したいときに使う
英語原文(公式ドキュメントより)

Set to 1 to strip credentials from the environments of the subprocesses Claude Code starts, such as Bash commands, hooks, and stdio MCP servers. The scrub recognizes a credential by its variable name or its value, and it leaves GitHub tokens and proxy settings in place. See What the subprocess environment scrub removes. claude-code-action sets this automatically when allowed_non_write_users is configured

関連ドキュメント

関連する変更履歴

v2.1.98(1件)

Added
Linux 環境において CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 有効時の PID ネームスペース隔離によるサブプロセス・サンドボックス機能、およびセッションごとのスクリプト実行回数を制限する CLAUDE_CODE_SCRIPT_CAPS 環境変数を追加しました。
英語原文を表示
Added subprocess sandboxing with PID namespace isolation on Linux when CLAUDE_CODE_SUBPROCESS_ENV_SCRUB is set, and CLAUDE_CODE_SCRIPT_CAPS env var to limit per-session script invocations

変更後

AIにコマンド実行権限を与える際の安全性が高まり、プロンプトインジェクション等による情報の漏洩やリソースの枯渇リスクを大幅に低減できます。

関連ドキュメント

v2.1.83(1件)

Added
サブプロセス環境(Bash ツール、フック、MCP stdio サーバー)から Anthropic やクラウドプロバイダーの認証情報を削除する CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 を追加しました
英語原文を表示
Added CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 to strip Anthropic and cloud provider credentials from subprocess environments (Bash tool, hooks, MCP stdio servers)

変更後

開発環境における機密情報の露出を最小限に抑え、信頼できないコードを分析したり、外部の MCP ツールを利用したりする際の安全性が大幅に向上します。

関連ドキュメント