148 pages for idle.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
session-observability
Claude Developer Platform · in the page
managed-agents/session-observability
…tive time, and the tracked list cost. Fetch the session after it goes idle to read the latest totals. ```json { "id": "sesn_01...", "status": "idle", "usage": { "input_tokens": 5000, "o…
session-operations
Claude Developer Platform · in the page
managed-agents/session-operations
…---------------------------------------------------------------- | | `idle` | Agent is waiting for input, including user messages or tool confirmations. Sessions created without `initial_event…
session-threads
Claude Developer Platform · in the page
managed-agents/session-threads
…thread is working and a thread waits on your client, the session is `idle`; see [Know when the work is done](https://platform.claude.com/docs/en/managed-agents/workflow-runs#know-when-the-work-is-don…
sessions
Claude Developer Platform · in the page
managed-agents/sessions
…ently supported. When the session reaches the cap, it pauses and goes idle with the stop reason `budget_reached`. The cap is enforced between model requests, so the request that crosses it completes f…
tools-web-restrictions
Claude Developer Platform · in the page
managed-agents/tools-web-restrictions
…cs/en/managed-agents/events-and-streaming) event. It then returns to `idle` without retrying. To continue the session: 1. Fix the setting by [updating the session’s tools](https://platform.claude.co…
webhooks
Claude Developer Platform · in the page
managed-agents/webhooks
…ents/events-and-streaming). For example, the stream’s `session.status_idle` and `session.status_running` correspond to the `session.status_idled` and `session.status_run_started` webhook events.…
workflow-runs
Claude Developer Platform · in the page
managed-agents/workflow-runs
…n moves through its states <Frame>  </Fra…
handle-streaming-refusals
Claude Developer Platform · in the page
test-and-evaluate/strengthen-guardrails/handle-streaming-refusals
…vent. * **Managed Agents**: A refused turn ends, and the session goes idle. Treat a turn as refused if `stop_details.type` or `stop_reason.type` is `"refusal"`. Starting with Claude 4 models, streami…
Use Claude Code features in the SDK
Claude Code CLI · in the page
agent-sdk/claude-code-features
…vents beyond Python, including `SessionStart`, `SessionEnd`, `TeammateIdle`, and `TaskCompleted`. See the [hooks guide](https://code.claude.com/docs/en/agent-sdk/hooks.md) for the full event compatibi…
Intercept and control agent behavior with hooks
Claude Code CLI · in the page
agent-sdk/hooks
…a result (`PostToolUse`), a subagent started or stopped, the agent is idle, or execution finished. See the [full list of events](#available-hooks). **2. The SDK collects registered hooks** The SDK c…
Hosting the Agent SDK
Claude Code CLI · in the page
agent-sdk/hosting
…t updates back. Best for sessions that span many interactions but sit idle between them. The container spins down during idle periods and spins back up when the user returns. Example workloads includ…
Agent SDK reference - Python
Claude Code CLI · in the page
agent-sdk/python
…gents. While the stream watchdog is on, the default is `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, which comes to `600000` unless you raise that variable. With the stream watchdog off, the default…
Agent SDK reference - TypeScript
Claude Code CLI · in the page
agent-sdk/typescript
…gents. While the stream watchdog is on, the default is `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, which comes to `600000` unless you raise that variable. With the stream watchdog off, the default…
Orchestrate teams of Claude Code sessions
Claude Code CLI · in the page
agent-teams
…mate's transcript, Escape interrupts that teammate's current turn An idle teammate's row stays in the panel while any teammate or subagent is still working, so you can select it to review its transcr…
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…ist, [holds an unattended session here too](#attach-to-a-session) | | Idle | Dimmed | The session has nothing to do and is ready for your next prompt | | Completed | Green | The task finished successf…
Share session output as artifacts
Claude Code CLI · in the page
artifacts
…eplying on its own in any of these ways: * **Press Ctrl+C once at an idle prompt**: Claude pauses replying on every artifact your session is watching. Replies start again after you send your next mes…
Best practices for Claude Code
Claude Code CLI · in the page
best-practices
…> > On the one-hour cache, a session past about 200K tokens that sits idle is compacted shortly before the cache expires, so after lunch you continue from a summary. If you don't need the history at a…
Claude Code changelog
Claude Code CLI · in the page
changelog
…ository's settings files and skills from running * Fixed a case where idle background sessions started through a shell-exported LLM gateway left the gateway after an update * Fixed help links in `/sta…
Channels reference
Claude Code CLI · in the page
channels-reference
…let nextId = 1 Bun.serve({ port: 8788, hostname: '127.0.0.1', idleTimeout: 0, // don't close idle SSE streams async fetch(req) { const url = new URL(req.url) // GET /events: SSE st…
Use Claude Code with Chrome
Claude Code CLI · in the page
chrome
…ps during long sessions The Chrome extension's service worker can go idle during extended sessions, which breaks the connection. If browser tools stop working after a period of inactivity, run `/chro…
Claude apps gateway deployment and operations
Claude Code CLI · in the page
claude-apps-gateway-deploy
…redirects them breaks sign-in and token refresh. Give the proxy any idle timeout longer than the gateway's keepalive interval, which depends on the upstream: * On every upstream except `provider: a…
Deploy Claude apps gateway on AWS
Claude Code CLI · in the page
claude-apps-gateway-on-aws
…ncer-attributes --load-balancer-arn "$ALB_ARN" \ > --attributes Key=idle_timeout.timeout_seconds,Value=3600 > ``` > > Create the service. The deployment circuit breaker rolls a deployment whose task…
Use Claude Code in the cloud
Claude Code CLI · in the page
claude-code-on-the-web
…y other conversation. If Claude asks a question and the session sits idle, you can still answer when you come back, up to [environment expiry](#environment-expired), and the session continues from yo…
Let Claude coordinate ongoing work with Projects
Claude Code CLI · in the page
claude-projects
…R** opens the pull request on GitHub. * **Create PR** appears when an idle thread has pushed a branch but hasn't opened a pull request. Clicking it creates the pull request from that branch directly r…
claude-tag
Claude Code CLI · in the page
claude-tag
…s Claude is working with, and is discarded when the conversation goes idle. See <a href="/docs/claude-tag/concepts/how-it-works" class="link">how Claude Tag works</a> for the full lifecycle.</span> <s…
Configure cloud environments
Claude Code CLI · in the page
cloud-environments
…ward, which happens in two cases: * **The VM is restored after being idle**: after a few minutes without activity, a session's VM pauses with its files saved. Your next message restores the same VM a…
Explore the context window
Claude Code CLI · in the page
context-window
…reserves. For when Claude Code also compacts a conversation you leave idle, see [idle compaction](/docs/en/settings-reference#idlecompaction). You can also act before the automatic pass runs: * **Co…
Manage costs effectively
Claude Code CLI · in the page
costs
…When the cache is cold, the line shows how long the session has been idle. When no response has reported cache tokens, the line ends with `no prompt caching reported by the API` instead. The counts…
Message your other Claude Code sessions
Claude Code CLI · in the page
cross-session-messaging
…his machine, Claude can also [ask it for one notice when it next goes idle or exits](#get-a-notice-when-another-session-goes-idle). * **Message across machines**: reach one of your sessions on another…
Desktop application
Claude Code CLI · in the page
desktop
…is working, the same as any other message, and the session returns to idle once the turn finishes. Local sessions load your personal skills from `~/.claude/skills/`. An [SSH](#ssh-sessions) session r…
Schedule recurring tasks in Claude Code Desktop
Claude Code CLI · in the page
desktop-scheduled-tasks
…puter sleeps through a scheduled time, the run is skipped. To prevent idle-sleep, turn on **Keep computer awake** in **Settings > Desktop app** or **Settings > This computer > System**. Closing the la…
Environment variables
Claude Code CLI · in the page
env-vars
…| | `API_FORCE_IDLE_TIMEOUT` | Override the 5-minute body idle timeout that aborts a streaming model response when…
Error reference
Claude Code CLI · in the page
errors
…API` | [Server errors](#no-response-from-api) | | `API Error: Stream idle timeout - no chunks received` | [Streaming idle watchdogs](https://code.claude.com/docs/en/network-config.md#streaming-idle-w…
Extend Claude Code
Claude Code CLI · in the page
features-overview
…e.com/docs/en/mcp.md#scale-with-mcp-tool-search) is on by default, so idle MCP tools consume minimal context. > > > [!TIP] > > > > Run `/mcp` to see each server's connection status. Run `/context all`…
Glossary
Claude Code CLI · in the page
glossary
…ntext-fills-up) · [When Claude Code compacts a conversation you leave idle](https://code.claude.com/docs/en/settings-reference.md#idlecompaction) ### Connector An [MCP server](#mcp-server) added to…
Keep Claude working toward a goal
Claude Code CLI · in the page
goal
…oal` | The previous turn finishes, or, in an interactive session, an [idle check-in](#background-work-defers-evaluation) or an [automatic retry](#other-errors-retry-or-pause-the-goal) comes due | A mo…
Run Claude Code programmatically
Claude Code CLI · in the page
headless
…e Code stops whatever is still running after 10 minutes of continuous idle waiting by default and drops its partial result. To change the 10-minute cap, set [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](ht…
Hooks reference
Claude Code CLI · in the page
hooks
…Created, TaskCompleted), and Stop or StopFailure, followed by TeammateIdle, PreCompact, PostCompact, and SessionEnd, with Elicitation and ElicitationResult nested inside MCP tool execution, Permission…
Automate actions with hooks
Claude Code CLI · in the page
hooks-guide
…#network-isolation), and the prompt has waited about six seconds | | `idle_prompt` | Claude finished responding about 60 seconds ago and you haven't typed since | | `auth_success` | Authentication com…
Interactive mode
Claude Code CLI · in the page
interactive-mode
…ystem reports critical memory pressure, provided the session has been idle for at least 30 minutes and no turn or subagent is running * The [debug log](https://code.claude.com/docs/en/debug-your-con…
Claude Code gateway compatibility guide
Claude Code CLI · in the page
llm-gateway-protocol
…eaming response once no bytes reach it for longer than its [streaming idle timeout](https://code.claude.com/docs/en/network-config.md#streaming-idle-watchdogs). During a long thinking pause, the upstr…
Connect Claude Code to tools via MCP
Claude Code CLI · in the page
mcp
…A per-server `timeout` of at least 1000 also acts as a floor on the idle timeout described below: Claude Code never aborts that server's tool calls for idleness sooner than the per-server `timeout`.…
Model configuration
Claude Code CLI · in the page
model-config
…ID](#correct-the-window-for-a-gateway-or-custom-model-id) See the [`idleCompaction`](https://code.claude.com/docs/en/settings-reference#idlecompaction) setting for when Claude Code also compacts a c…
Monitoring
Claude Code CLI · in the page
monitoring-usage
…unter Tracks actual time spent actively using Claude Code, excluding idle time. This metric is incremented during user interactions, such as typing and reading responses, and during CLI processing, s…
Enterprise network configuration
Claude Code CLI · in the page
network-config
…e agents` or `--bg` starts a supervisor that honors it. ## Streaming idle watchdogs Claude Code runs four independent timers that abort a streaming model response when it goes quiet, so a dead conne…
Use the mods API
Claude Code CLI · in the page
plugins/mods/api
…hat sentence, add `asUser: true`. The call waits until the session is idle and then starts a new turn. It resolves when that turn starts, so don't `await` it in a handler that runs while Claude is wor…
Draw in the interface with a mod
Claude Code CLI · in the page
plugins/mods/interface
…pane's `focus: true` request only when the panel has focus, Claude is idle with no question waiting, and the prompt box is empty. * **The question dialog**: at `AskUserQuestion`, the panel keeps its o…
Mods reference
Claude Code CLI · in the page
plugins/mods/reference
…teammates, each with a `status` of `pending`, `running`, `waiting`, `idle`, `completed`, `failed`, or `killed`, where `idle` and `waiting` require Claude Code v2.1.289 or later. | | [`$.model`](https…
Test a mod
Claude Code CLI · in the page
plugins/mods/test
…) hook returns `next(e)`, for example to draw nothing while Claude is idle, [mounting it](#test-a-drawing) fails with `no implementation for ui.render`. Register a stub that returns an element as plai…
How Claude Code uses prompt caching
Claude Code CLI · in the page
prompt-caching
…lding a new one as compaction does. If you leave a long conversation idle while it is on the [one-hour TTL](#which-ttl-each-request-gets), Claude Code can compact it. To turn idle compaction off, set…