CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS
Updated by Alex Sorokoletov
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS is a Claude Code environment variable: OpenTelemetry shutdown timeout; default 2000ms. Present since v2.1.69 or earlier and still present in v2.1.310. It is listed in the official reference.
| Status | Present in v2.1.310 |
|---|---|
| Added | Present since v2.1.69 or earlier |
| Category | Telemetry |
| Official docs | Listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS: OpenTelemetry flush timeout; default 5000ms.CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL: Re-enables the session quality survey for enterprise deployments with OTEL enabled.CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH: Caps the length of content attributes on OpenTelemetry spans and logs; the truncation function takes the minimum of this value (default 60 KB) and the standard OTEL attribute-length limits, appending a "[TRUNCATED — Content exceeds NKB limit]" marker.CLAUDE_CODE_OTEL_DIAG_STDERRCLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS: Debounce for OTEL headers helper.OTEL_ATTRIBUTE_VALUE_LENGTH_LIMITOTEL_LOG_ASSISTANT_RESPONSESOTEL_LOG_MANAGED_SETTINGS
Frequently asked questions
What does CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS do?
OpenTelemetry shutdown timeout; default 2000ms
Which Claude Code version has CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS?
Present since v2.1.69 or earlier and still present in v2.1.310.
How do I set CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS?
Export it before starting Claude Code (export CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS=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.