[DOCS] Agent SDK docs missing `CLAUDE_CODE_ACCOUNT_UUID`, `CLAUDE_CODE_USER_EMAIL`, and `CLAUDE_CODE_ORGANIZATION_UUID` env vars

Resolved 💬 2 comments Opened Feb 24, 2026 by coygeek Closed Mar 8, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://platform.claude.com/docs/en/agent-sdk/python

Section/Topic

SDK caller identity/account metadata configuration and related environment variables.

Current Documentation

Agent SDK input docs currently only provide a generic user field:

user | str | None | None | User identifier

Monitoring docs describe telemetry attributes:

organization.id — Organization UUID (when authenticated) user.account_uuid — Account UUID (when authenticated) user.email — User email address (when authenticated via OAuth)

No documentation defines CLAUDE_CODE_ACCOUNT_UUID, CLAUDE_CODE_USER_EMAIL, or CLAUDE_CODE_ORGANIZATION_UUID.

What's Wrong or Missing?

Release v2.1.51 added:

CLAUDE_CODE_ACCOUNT_UUID, CLAUDE_CODE_USER_EMAIL, and CLAUDE_CODE_ORGANIZATION_UUID environment variables for SDK callers to provide account info synchronously...

These new variables are not documented in SDK or settings docs, leaving users without:

  • Accepted values/format
  • Where to set them (CLI env vs SDK process env)
  • Precedence relative to auth-derived metadata
  • Privacy/telemetry implications

Suggested Improvement

Add a "Caller identity environment variables" section in Agent SDK docs and settings docs with:

  • Definitions for all three variables
  • End-to-end SDK examples (Python and TypeScript)
  • Precedence and fallback behavior
  • Security/privacy guidance for handling PII values

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://platform.claude.com/docs/en/agent-sdk/python | Add env-var based identity metadata guidance for SDK callers |
| https://platform.claude.com/docs/en/agent-sdk/typescript | Parallel guidance needed for TypeScript SDK users |
| https://code.claude.com/docs/en/monitoring-usage | Should link identity env vars to telemetry attributes |
| https://code.claude.com/docs/en/settings | Environment variable reference should include these new variables |

Total scope: 4 pages affected

Source: Claude Code release v2.1.51
Changelog entry: "Added CLAUDE_CODE_ACCOUNT_UUID, CLAUDE_CODE_USER_EMAIL, and CLAUDE_CODE_ORGANIZATION_UUID environment variables for SDK callers to provide account info synchronously..."

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗