145 pages for retries.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
api
Claude Developer Platform · in the page
manage-claude/opentelemetry/api
…destination’s later requests without compression for about a day. * **Retries:** The API retries a delivery later, a limited number of times, after a timeout, a connection, TLS, or DNS failure, an inv…
organization-webhooks
Claude Developer Platform · in the page
manage-claude/organization-webhooks
…(the same value as the `webhook-id` header). Deduplicate on it. * **Retries:** If a delivery fails, Anthropic retries it a few times over the next few minutes. If every attempt fails, Anthropic drop…
spawn.sh: called once per claimed work item
Claude Developer Platform · in the page
managed-agents/self-hosted-sandboxes
…the session's work is queued again and the next worker that claims it retries the mount. | ## Serve custom tools from your s…
self-hosted-sandboxes-operations
Claude Developer Platform · in the page
managed-agents/self-hosted-sandboxes-operations
…he session’s work is queued again, and the next worker that claims it retries the mount. | ### A custom tool call never retu…
webhooks
Claude Developer Platform · in the page
managed-agents/webhooks
…ject directly with a `GET` call. This avoids delivering stale data on retries and keeps every delivery small. ## Supported event types <Tabs> <Tab title="Session events"> Some of these events…
workflow-runs
Claude Developer Platform · in the page
managed-agents/workflow-runs
…he turn in which the agent reads the run’s result can start one. * **`retries_exhausted`:** The agent’s turn failed on an error: retries ran out, or the error can’t be retried, such as a billing failu…
migration-guide
Claude Developer Platform · in the page
models/fable-5-2/migration-guide
…declined requests on another model, set `fallbacks: "default"`, which retries on the model Anthropic recommends for that category, or build your own retry. That parameter is in beta on the Claude API…
whats-new-fable-5-2
Claude Developer Platform · in the page
models/fable-5-2/whats-new-fable-5-2
…on Google Cloud (Anthropic managed). With it, `fallbacks: "default"` retries a declined request on the model Anthropic recommends for that category. For categories with no recommended fallback, such…
whats-new-opus-5-5
Claude Developer Platform · in the page
models/opus-5-5/whats-new-opus-5-5
…-and-fallback#server-side-fallback) (`fallbacks: "default"`, in beta, retries on the model Anthropic recommends for that category), the [SDK middleware](https://platform.claude.com/docs/en/build-with-…
migration-guide
Claude Developer Platform · in the page
models/sonnet-5-5/migration-guide
…n/build-with-claude/claude-models-on-google-cloud/anthropic-managed), retries `"cyber"` and `"frontier_llm"` declines on Claude Sonnet 5. It doesn’t retry `"bio"`, `"reasoning_extraction"`, or `"gener…
handle-streaming-refusals
Claude Developer Platform · in the page
test-and-evaluate/strengthen-guardrails/handle-streaming-refusals
…set up its retry in your client. * **Redeem fallback credit on manual retries:** If you build the retry yourself, pass the refusal’s [fallback credit](https://platform.claude.com/docs/en/build-with-cl…
How the agent loop works
Claude Code CLI · in the page
agent-sdk/agent-loop
…r example, a cancelled request) | No | | `error_max_structured_output_retries` | No valid structured output was produced within the configured retry limit: every attempt failed validation, or a model…
Agent SDK reference - Python
Claude Code CLI · in the page
agent-sdk/python
…env={ "API_TIMEOUT_MS": "120000", "CLAUDE_CODE_MAX_RETRIES": "2", "CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS": "120000", }, ) ``` * [`API_TIMEOUT_MS`](https://code.claude.com…
Quickstart
Claude Code CLI · in the page
agent-sdk/quickstart
…DK handles the orchestration, tool execution, context management, and retries, so you consume the stream. The loop ends when Claude finishes the task or hits an error. The message handling inside the…
Persist sessions to external storage
Claude Code CLI · in the page
agent-sdk/session-storage
…n. ### Mirror writes are best-effort If `append()` rejects, the SDK retries the batch up to two more times with a short backoff, for at most three attempts in total. A call that times out isn't retr…
Get structured output from agents
Claude Code CLI · in the page
agent-sdk/structured-outputs
…er yielding an error result, such as // error_max_structured_output_retries; see the Error handling section. console.error(`Session ended with an error: ${error}`); } ``` ```python Python theme={…
Agent SDK reference - TypeScript
Claude Code CLI · in the page
agent-sdk/typescript
…...process.env, API_TIMEOUT_MS: "120000", CLAUDE_CODE_MAX_RETRIES: "2", CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS: "120000", }, }, }); ``` * [`API_TIMEOUT_MS`](https://code.claude.c…
Orchestrate teams of Claude Code sessions
Claude Code CLI · in the page
agent-teams
…process teammate that is waiting to retry a failed API request, so it retries immediately instead of waiting for the full retry delay. The lead can stop early too, deciding the team is finished befor…
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…ull request doesn't need to exist yet when Claude pushes: Claude Code retries the branch lookup after up to five later `git`, `gh`, `glab`, or `curl` commands run in the same directory, so a pull requ…
Claude Code on Amazon Bedrock
Claude Code CLI · in the page
amazon-bedrock
…d on their timestamp or when the API returns a credential error, then retries the request with refreshed credentials. * **`awsCredentialExport`**: runs at session start and on each credential reload,…
Claude Code changelog
Claude Code CLI · in the page
changelog
…when the server keeps refusing to renew model access: the runner now retries sooner and posts a warning in the session * Fixed `/permissions` in cloud sessions replying only that it isn't available;…
Claude apps gateway configuration
Claude Code CLI · in the page
claude-apps-gateway-config
…s the TTL, the request fails, and neither the gateway nor Claude Code retries it with the five-minute TTL. For Amazon Bedrock, check [supported models, regions, and limits](https://docs.aws.amazon.com…
Claude apps gateway deployment and operations
Claude Code CLI · in the page
claude-apps-gateway-deploy
…onds` period, which is 10 minutes by default. Then double it to cover retries and developers who sign in to both Claude Code and Claude Desktop. For example, 10,000 developers behind 4 egress address…
Claude Code on Claude Platform on AWS
Claude Code CLI · in the page
claude-platform-on-aws
…edential-configuration) so Claude Code re-runs your login command and retries instead of failing. Add the command to your [settings file](https://code.claude.com/docs/en/settings.md), such as `~/.clau…
Code Review
Claude Code CLI · in the page
code-review
…s are best-effort, and a failed run never blocks your PR. Code Review retries some interrupted reviews on its own. This section covers how to run a review again yourself and where to look when the che…
Environment variables
Claude Code CLI · in the page
env-vars
…| | `CLAUDE_CODE_MAX_RETRIES` | Override the number of times to retry failed API requests (default: 10). Capped at 15 as…
Error reference
Claude Code CLI · in the page
errors
…/ `The response stalled before a response was produced` | [Automatic retries](#automatic-retries) | | `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#aut…
Speed up responses with fast mode
Claude Code CLI · in the page
fast-mode
…jects fast mode requests whether or not they're set. Claude Code then retries the request at standard speed, turns fast mode off, and `/fast` reports that your organization has disabled fast mode. ##…
Keep Claude working toward a goal
Claude Code CLI · in the page
goal
…or later, Claude Code also prints a line naming the cause and either retries on its own or waits for you: * **Retry**: after a failure that tends to clear on its own, such as an overloaded server or…
Run Claude Code programmatically
Claude Code CLI · in the page
headless
…g `/<skill-name>` as the prompt**: v2.1.287 or later #### Handle API retries When an API request fails with a retryable error, Claude Code emits a `system/api_retry` event before retrying. On v2.1.2…
Connect Claude Code to an LLM gateway
Claude Code CLI · in the page
llm-gateway-connect
…stname doesn't resolve, often after a silent pause while Claude Code [retries with backoff](https://code.claude.com/docs/en/errors.md#automatic-retries). The code in parentheses varies; [Unable to con…
Claude Code gateway compatibility guide
Claude Code CLI · in the page
llm-gateway-protocol
…ponse headers](#response-headers): what to return so stall detection, retries, and usage limit display work * The [system prompt attribution block](#system-prompt-attribution-block) and how it interac…
Roll out an LLM gateway for your organization
Claude Code CLI · in the page
llm-gateway-rollout
…ng or unreachable base URL produces a different symptom: Claude Code [retries the connection with backoff](https://code.claude.com/docs/en/errors.md#automatic-retries) and can sit with no output for s…
Connect Claude Code to tools via MCP
Claude Code CLI · in the page
mcp
…on Claude Code reconnects a remote server that drops mid-session and retries an HTTP or SSE server's first connection after a transient error. For a stdio server, see [Stdio servers that exit or fail…
Connect to MCP servers
Claude Code CLI · in the page
mcp-quickstart
…Connected`. If it still shows `✘ Failed to connect` after a couple of retries, see [Troubleshooting](#troubleshooting). **3. Use the browser** Give Claude a task that needs the browser: ```text wra…
Model configuration
Claude Code CLI · in the page
model-config
…n's policy check](https://code.claude.com/docs/en/errors.md#automatic-retries), never trigger a switch; those follow their normal retry and error handling. It does switch when [Amazon Bedrock](https:/…
Monitoring
Claude Code CLI · in the page
monitoring-usage
…n the parent span | | | `duration_ms` | Wall-clock duration including retries | | | `ttft_ms` | Time to first token in milliseconds | | | `first_content_ms` | Time from request start to the first cont…
Enterprise network configuration
Claude Code CLI · in the page
network-config
…connection reset or a TLS handshake error, it re-reads both files and retries the request with the new pair. Before v2.1.232, Claude Code didn't re-read on connection errors, so it kept the pair it ha…
Plugin commands reference
Claude Code CLI · in the page
plugins/cli-reference
…is already at the latest version (1.0.0).` and exits `0`, unless it [retries the plugin's dependency install](#retry-an-unfinished-dependency-install) and that install fails. #### Which scope the co…
Continue local sessions from any device with Remote Control
Claude Code CLI · in the page
remote-control
…ssion. * **Interactive session**: keep working locally. Claude Code retries for as long as the outage lasts and reconnects on its own when the network returns. * **Attachments that don't download**:…
Configure the sandboxed Bash tool
Claude Code CLI · in the page
sandboxing
…de-the-sandbox-with-excludedcommands) run unsandboxed * **Unsandboxed retries**: Claude can [ask to run a command unsandboxed](#the-unsandboxed-retry-escape-hatch), usually after it fails in the sandb…
Self-hosted environments
Claude Code CLI · in the page
self-hosted-environments
…he runner can't parse, the runner keeps serving its live sessions and retries after a second or two instead of waiting for the next scheduled poll. For example, an intercepting proxy that answers the…
Deploy self-hosted environments to production
Claude Code CLI · in the page
self-hosted-environments-deploy
…host rejects the credential, or you didn't configure one, the runner retries a few times and then fails repository preparation when the repository is the one the session pushes results to. For a repo…
Self-hosted environments reference
Claude Code CLI · in the page
self-hosted-environments-reference
…ttempt the orchestrator sends its existing environment secret, and it retries automatically with exponential backoff, capped at 30 seconds plus jitter. ## Environment-variable-only settings These ru…
All settings
Claude Code CLI · in the page
settings-reference
…the rest of the turn and shows a notice. Without a chain, Claude Code retries the same model and then surfaces the server's error, and you retry or switch models yourself. A switch means one turn wit…
Tools reference
Claude Code CLI · in the page
tools-reference
…call. * When the extraction step hits an overloaded API, Claude Code retries it with backoff; a fetch that still fails returns an error result. In Manual and `acceptEdits` [permission modes](https:/…
Troubleshoot installation and login
Claude Code CLI · in the page
troubleshoot-install
…cmd ``` When the script's own downloads hit the same errors, it retries them with best-effort revocation checking automatically, so the flag is only needed on the command you run yourself. Best-…
Voice dictation
Claude Code CLI · in the page
voice-dictation
…ts. If you're still recording when the rejection arrives, Claude Code retries a status outside the 400 range once before showing this message; it doesn't retry a status in the 400 range. In v2.1.229 t…
Orchestrate subagents at scale with dynamic workflows
Claude Code CLI · in the page
workflows
…ion failure. To change the attempt count, set [`MAX_STRUCTURED_OUTPUT_RETRIES`](https://code.claude.com/docs/en/env-vars). ### Edit a saved script To change a [workflow you saved](#save-the-workflow…
Literature access
Claude Documentation · in the page
claude-science/literature-access
…doesn't use it. | | Institutional **EZproxy URL** + session cookie | Retries publisher links through your library | OpenAlex has its own entry in the same **Services** list: add a free **OpenAlex AP…