CLAUDE_CODE_PERFETTO_TRACE
Updated by Alex Sorokoletov
CLAUDE_CODE_PERFETTO_TRACE is a Claude Code environment variable: Enable Perfetto trace output to file path (server-gated). Present since v2.1.69 or earlier and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Present since v2.1.69 or earlier |
| Category | Telemetry |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_PERFETTO_TRACE=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_PERFETTO_TRACE": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_PERFETTO_WRITE_INTERVAL_SCLAUDE_CODE_BYOC_ENABLE_DATADOG: Opt-in Datadog telemetry for BYOC (Bring Your Own Cloud) Bedrock/Vertex deployments.CLAUDE_CODE_DATADOG_FLUSH_INTERVAL_MS: Datadog metrics flush interval (ms).CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY: Survey prompts.CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL: Re-enables the session quality survey for enterprise deployments with OTEL enabled.CLAUDE_CODE_ENABLE_TELEMETRY: Enable telemetry collection.CLAUDE_CODE_ENHANCED_TELEMETRY_BETA: Enable enhanced telemetry (beta).CLAUDE_CODE_GB_DISK_CACHE_WHEN_TELEMETRY_OFF: Opts GrowthBook (GB) flag data back into the on-disk cache under a telemetry-off profile, where feature-flag caching would otherwise be skipped.
Frequently asked questions
What does CLAUDE_CODE_PERFETTO_TRACE do?
Enable Perfetto trace output to file path (server-gated)
Which Claude Code version has CLAUDE_CODE_PERFETTO_TRACE?
Present since v2.1.69 or earlier and still present in v2.1.294.
How do I set CLAUDE_CODE_PERFETTO_TRACE?
Export it before starting Claude Code (export CLAUDE_CODE_PERFETTO_TRACE=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.