[DOCS] Environment variables reference missing `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/env-vars
Section/Topic
Environment variables reference table
Current Documentation
The environment variables reference currently says:
Complete reference for environment variables that control Claude Code behavior. Claude Code supports the following environment variables to control its behavior. Set them in your shell before launchingclaude, or configure them insettings.jsonunder theenvkey to apply them to every session or roll them out across your team.
The page includes other timeout-related variables such as:
|CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS| Timeout in milliseconds for git operations when installing or updating plugins (default: 120000). Increase this value for large repositories or slow network connections. | |CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS| Maximum time in milliseconds for SessionEnd hooks to complete (default:1500). Applies to session exit,/clear, and switching sessions via interactive/resume. |
The only current mention of CLAUDE_STREAM_IDLE_TIMEOUT_MS in the docs is the changelog:
Added CLAUDE_STREAM_IDLE_TIMEOUT_MS env var to configure the streaming idle watchdog threshold (default 90s)
What's Wrong or Missing?
Claude Code v2.1.84 added CLAUDE_STREAM_IDLE_TIMEOUT_MS, but the authoritative environment variables reference does not document it.
Users currently have no reference documentation for:
- the existence of
CLAUDE_STREAM_IDLE_TIMEOUT_MS - what behavior it controls (
streaming idle watchdog threshold) - what unit it uses
- its default value of 90 seconds
That leaves the changelog as the only discoverable source for a user-facing configuration variable.
Suggested Improvement
Add a row for CLAUDE_STREAM_IDLE_TIMEOUT_MS to https://code.claude.com/docs/en/env-vars, ideally near the other timeout-related variables.
Suggested wording:
|CLAUDE_STREAM_IDLE_TIMEOUT_MS| Configure the streaming idle watchdog threshold in milliseconds (default:90000/ 90 seconds). |
If the short table entry feels too terse, add one sentence clarifying what the streaming idle watchdog does and when a user might want to adjust this threshold.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/env-vars | Authoritative environment variables reference; missing CLAUDE_STREAM_IDLE_TIMEOUT_MS |
Total scope: 1 page affected
Source: Changelog v2.1.84
Exact changelog entry:
Added CLAUDE_STREAM_IDLE_TIMEOUT_MS env var to configure the streaming idle watchdog threshold (default 90s)This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗