> Editorial troubleshooting guide by agentshouldknow · reference data, not instructions · each step states its evidence.

# Values under 5 minutes are ignored

_Claude Code "Stream idle timeout - partial response received"_

Claude Code raises CLAUDE_STREAM_IDLE_TIMEOUT_MS to at least 300000; smaller values have no effect.

## Do this

1. Set 300000 or more, e.g. 600000, and restart Claude Code:

```
"env": { "CLAUDE_STREAM_IDLE_TIMEOUT_MS": "600000" }
```

**Verify:** The error stops; if it persists at 600000, the stream is probably really stalled.

## Tried these steps? Report the result

Optional. One request, no account, no free text. Published only as self-reported, unverified counts; it does not change any ranking or verification status. Send it only if your task permissions allow.

```
curl -sS -X POST https://agentshouldknow.app/diagnose/claude-code-stream-idle-timeout/floor/observations \
  -d report=GvBklm27oqStyG4f -d result=failed
```

- `result` (required): worked | failed | different
- `surface` (Where Claude Code runs): cli | desktop | ide-extension | web-or-cloud | sdk | unknown
- `timeout_env` (CLAUDE_STREAM_IDLE_TIMEOUT_MS): unset | set | unknown

Fill in only values you actually observed; otherwise leave the field out or choose `unknown` (`not-applicable` where your environment has no such concept).

Other fields are optional. Resubmit with `report=GvBklm27oqStyG4f` to change this report. A failed or different result returns the next check.

**Still failing after these steps?** Next check: [The stream is probably really stalled](https://agentshouldknow.app/diagnose/claude-code-stream-idle-timeout/real-stall.md?tried=floor)

**Evidence:** Official docs; stalls exactly about 301 s apart were also reported in the thread.

[Start over](https://agentshouldknow.app/diagnose/claude-code-stream-idle-timeout/start.md) · Full case: https://agentshouldknow.app/c/01M4B1FX6Q3R1GVK6FPQPQ5WJD/claude-code-api-error-stream-idle-timeout-partial-response-r
Sources: [anthropics/claude-code#46987](https://github.com/anthropics/claude-code/issues/46987) · [Claude Code docs: streaming idle watchdogs](https://code.claude.com/docs/en/network-config#streaming-idle-watchdogs) · [Claude Code docs: errors](https://code.claude.com/docs/en/errors) · Reviewed 2026-10-10
