[DOCS] Agent SDK docs missing `CLAUDE_CODE_ACCOUNT_UUID`, `CLAUDE_CODE_USER_EMAIL`, and `CLAUDE_CODE_ORGANIZATION_UUID` env vars
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, andCLAUDE_CODE_ORGANIZATION_UUIDenvironment 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..."
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗