Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / Settings keys

timeout

setting never mined JSON

A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

TaskOutput ignores the old wait_up_to setting and just uses the 30 second default timeout.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.221.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 149on this box, as of v2.1.308
Written about v2.0.72 first named in a changelog, 17 Dec 2025

In the changelogs

42

Releases whose published page names timeout.

  1. v2.1.300
    Command hooks can now be stopped by their configured timeout

    Command hooks run through this path now stop when their configured timeout in seconds runs out

    found in this entry's text

  2. v2.1.300
    Hooks run on another machine can carry their own time limit

    A hook sent to run on another machine can now include an optional time limit, and its error message no longer says plugin

    found in this entry's text

  3. v2.1.296
    Usage data now drops error text that is not a short code

    An error value in usage data is dropped unless it is a short code of lowercase letters, digits and underscores

    found in this entry's text

  4. v2.1.295
    Bash tool accepts command_description in place of description

    If Claude sends command_description instead of description to the Bash tool, Claude Code now treats it as the description

    found in this entry's text

  5. v2.1.293
    Remote managed-settings fetch report now says why a fetch failed

    The usage report sent when Claude Code fetches remote managed settings now sorts failures into causes like timeout, network or no credentials

    found in this entry's text

  6. v2.1.292
    SDK MCP servers accept disableAutoBackground and report bad settings

    SDK MCP servers can now set disableAutoBackground as well as timeout, and Claude Code logs which invalid setting it ignored

    found in this entry's text, named in this entry

  7. v2.1.292
    SDK warns when disableAutoBackground changes for an existing MCP server

    setMcpServers now warns when a server already registered is passed a different timeout or disableAutoBackground, and keeps the registered values

    found in this entry's text

  8. v2.1.288
    Bash tool instructions no longer explain timeouts for background commands

    Claude's instructions for the Bash tool no longer say how timeout limits a command running in the background, or what happens at that limit

    found in this entry's text

  9. v2.1.288
    Clearer reason when a timeout or env option can't be checked

    Permission explanations for commands wrapped in timeout or env now name the exact option that can't be checked before it runs

    found in this entry's text

  10. v2.1.288
    Shorter explanations when a command cannot be checked before it runs

    Permission prompts for timeout, command -p/-v and jobs -x now give shorter reasons why the command can't be checked in advance

    found in this entry's text

  11. v2.1.287
    Clearer reasons when a shell command needs your permission

    Reasons shown when Claude Code cannot check a shell command ahead of time now say it 'cannot be checked in advance'

    found in this entry's text

  12. v2.1.287
    Clearer message when a timeout command can't be checked

    The message for a timeout command that can't be checked ahead of time now reads as a plain sentence

    found in this entry's text

  13. v2.1.285
    Background commands now have a time limit

    Commands run in the background now have a default time limit of 1800000 and a maximum of 7200000, and stop when they reach it

    found in this entry's text, named in this entry

  14. v2.1.285
    Background shell commands are now stopped after a time limit, 30 minutes by default

    A shell command Claude runs in the background is now stopped when its timeout runs out: 30 minutes by default, up to 2 hours

    found in this entry's text, named in this entry

  15. v2.1.281
    AWS/GCP auth refresh commands run under a new process supervisor that kills the whole process tree on timeout, abort or shutdown

    awsAuthRefresh and gcpAuthRefresh commands now stop together with everything they started on timeout, cancel or shutdown

    found in this entry's text

  16. v2.1.280
    New terminal/failure states for a bounded operation ('refused', 'input_too_long')

    A bounded operation's list of failure outcomes grew to include 'refused' and 'input_too_long'

    found in this entry's text

  17. v2.1.277
    A tool-input schema case (C4) was removed from a validator

    A tool-input validation case for task_id/agentId/bash_id fields was removed from a validator

    found in this entry's text

  18. v2.1.275
    New coordinator-only Bash guardrail restricting to verified read-only commands

    A new guardrail restricts the coordinator role to read-only, verified Bash commands

    found in this entry's text

  19. v2.1.269
    OAuth token validation now classifies failure reasons instead of one generic error

    OAuth token validation now reports a specific failure reason instead of one generic error

    found in this entry's text

  20. v2.1.268
    New bash-command taxonomy for telemetry

    Claude Code now classifies every bash command you run for internal telemetry

    found in this entry's text

  21. v2.1.261
    GCP credential check becomes tri-state and honors ANTHROPIC_GOOGLE_CLOUD_PROJECT

    GCP credential checks now distinguish timeout from failure and honor a new project env var fallback.

    found in this entry's text

  22. v2.1.251
    Cancelling an orphaned MCP task no longer hangs

    Cancelling leftover work after an MCP server dies now times out instead of hanging.

    found in this entry's text

  23. v2.1.248
    Backgrounded shell commands may return a structured task acknowledgement

    Backgrounded shell commands may return a structured task record instead of raw output.

    found in this entry's text

  24. v2.1.248
    /web-setup warns when your GitHub CLI token lacks the workflow scope

    /web-setup warns if your gh token lacks the workflow scope before you connect.

    found in this entry's text

  25. v2.1.248
    Per-server timeouts for SDK-hosted MCP servers

    SDK-hosted MCP servers can each carry their own timeout, applied when registered.

    found in this entry's text

  26. v2.1.242
    A broader classifier for destructive shell commands

    A broader detector for destructive shell commands exists, but nothing visibly uses its verdict.

    found in this entry's text

  27. v2.1.234
    Per-model token limits fetched from the API

    Model token limits can now come from the API with caching and a timeout instead of a built-in table.

    found in this entry's text

  28. v2.1.234
    Agent and session lookups now say when the list was too long to search

    Session and agent lookups now say when the list was truncated, so "not found" no longer misleads.

    found in this entry's text

  29. v2.1.232
    Prompt hooks that time out are now logged

    A prompt hook that times out is now logged and recorded instead of vanishing silently.

    named in this entry, found in this entry's text

  30. v2.1.229
    Marketplaces can ship a plugin built by running a local command

    Marketplace plugins can be built by a local command, with a timeout and optional link mode.

    named in this entry, found in this entry's text

  31. v2.1.229
    Plugins can be installed from a command that prints a directory

    Marketplaces can install a plugin by running a command that prints a directory path, with your consent.

    named in this entry, found in this entry's text

  32. v2.1.225
    send_message: clearer story about sessions on other machines

    Messaging an unknown peer now explains that sessions on other machines could not be checked, so retry.

    found in this entry's text

  33. v2.1.224
    Peer lookups say when other machines' sessions could not be checked

    If peer listing failed, the not-found message now says other machines could not be checked.

    found in this entry's text

  34. v2.1.222
    Connectivity check rewritten on fetch, with a timeout and proxy awareness

    Connection checks now time out properly and record whether your proxy was used.

    found in this entry's text

  35. v2.1.221
    TaskOutput no longer honours the legacy wait_up_to parameter

    TaskOutput ignores the old wait_up_to setting and just uses the 30 second default timeout.

    named in this entry

  36. v2.1.215
  37. v2.1.198
    MCP Per-Server HTTP Request Timeout

    found in this entry's text

  38. v2.1.118
    MCP Tool Hooks (mcp_tool)

    found in this entry's text

  39. v2.1.79
    Tool Input Coercion for Numeric Parameters

    found in this entry's text

  40. v2.1.73
    Improved Bash Command Safety Analysis

    found in this entry's text

  41. v2.1.50
    Improved Bash Command Prefix Suggestions

    found in this entry's text

  42. v2.0.72
    Bash Command Prefix Stripping

    found in this entry's text

First cited

0

No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.

Presence across releases

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.

Feedback