[DOCS] Environment variables reference missing `CLAUDE_STREAM_IDLE_TIMEOUT_MS`

Resolved 💬 2 comments Opened Mar 26, 2026 by coygeek Closed Mar 28, 2026

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 launching claude, or configure them in settings.json under the env key 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)

View original on GitHub ↗

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