環境変数

CLAUDE_CODE_ACCOUNT_UUID

すべてのセッションおよびそこから起動されるサブプロセスに適用される環境変数を設定できますが、CLAUDE_CODE_REMOTEやCLAUDE_CODE_ACCOUNT_UUIDなどのホスティング環境固有のID用変数は、ここで設定しても無視されます。

使い方・用途

  • 起動されるすべてのサブプロセスに対して、特定の環境変数（NO_COLORやFORCE_COLORなど）を一括で適用したい場合に使用します（空文字を設定するとシェルからエクスポートされた値をオーバーライドして未設定として扱えます）
  • CLAUDE_CODE_ACCOUNT_UUID などのシステムID情報はホスティング環境によって設定されるため、 settings の env ブロックに記述しても無視される制限があります
英語原文(公式ドキュメントより)

| env | Environment variables applied to every session and to subprocesses Claude Code spawns from it. Set a variable to "" to override a shell export with an empty string, which Claude Code treats as unset for provider selection. Subprocesses still inherit the empty value. NO_COLOR and FORCE_COLOR set here reach only subprocesses; to change Claude Code's own interface colors, set them in your shell before launching claude. As of v2.1.195, identity variables that Claude Code's hosting environments set, for example CLAUDE_CODE_REMOTE and CLAUDE_CODE_ACCOUNT_UUID, are ignored when set here. CLAUDE_CODE_MESSAGING_SOCKET is also ignored here, because Claude Code exports its own per-session value; ignoring it requires Claude Code v2.1.224 or later | {"FOO": "bar"} |

関連する変更履歴

v2.1.51(1件)

Added
Settings
SDK呼び出し元がアカウント情報を同期的に提供できるように、CLAUDE_CODE_ACCOUNT_UUID, CLAUDE_CODE_USER_EMAIL, CLAUDE_CODE_ORGANIZATION_UUID 環境変数が追加されました。これにより、初期テレメトリイベントにアカウントメタデータが欠落する競合状態が解消されます。
英語原文を表示
Added CLAUDE_CODE_ACCOUNT_UUID, CLAUDE_CODE_USER_EMAIL, and CLAUDE_CODE_ORGANIZATION_UUID environment variables for SDK callers to provide account info synchronously, eliminating a race condition where early telemetry events lacked account metadata.

変更前

SDK経由でテレメトリデータを送信する際、初期段階でアカウント情報が利用できないことがあり、データに不整合が生じる可能性がありました。

変更後

必要なアカウント情報環境変数が追加されたことで、SDK呼び出し元は同期的に情報を渡せるようになり、テレメトリデータの正確性が向上しました。

ユーザーへの恩恵

テレメトリデータの正確性が向上し、より信頼性の高い分析とデバッグが可能になります。

関連ドキュメント