257 pages for attempt.

Rewind file changes with checkpointing Claude Code CLI · in the page agent-sdk/file-checkpointing …was not set to `true`) * The session wasn't properly completed before attempting to resume and rewind **Solution**: Ensure `enable_file_checkpointing=True` (Python) or `enableFileCheckpointing: true`… Connect to external tools with MCP Claude Code CLI · in the page agent-sdk/mcp …`MCP_TIMEOUT`](/docs/en/env-vars), 30 seconds by default, per connect attempt; the connection fails at that deadline | A server has a cached tool list only when the [MCP discovery cache](/docs/en/mcp… Observability with OpenTelemetry Claude Code CLI · in the page agent-sdk/observability …ches telemetry and exports on an interval. On a clean process exit it attempts to flush pending data, but the flush is bounded by a short timeout, so spans can still be dropped if the collector is slo… Configure permissions Claude Code CLI · in the page agent-sdk/permissions …is removed from the request. Claude does not see the tool and cannot attempt it. | | `disallowed_tools=["Bash(rm *)"]` | `Bash` stays available. Calls matching `rm *` [as written](/docs/en/permission… Agent SDK reference - Python Claude Code CLI · in the page agent-sdk/python …) ``` * [`API_TIMEOUT_MS`](/docs/en/env-vars): how long each request attempt can wait for response headers, in milliseconds. It doesn't limit how long a streaming response runs after the headers arri… Securely deploying AI agents Claude Code CLI · in the page agent-sdk/secure-deployment …s due to prompt injection), that code runs in the container and could attempt kernel exploits. With gVisor, the attack surface is much smaller: the malicious code would need to exploit gVisor's usersp… Persist sessions to external storage Claude Code CLI · in the page agent-sdk/session-storage …he batch up to two more times with a short backoff, for at most three attempts in total. A call that times out isn't retried, since the original call may still land. If the batch still fails, the SDK… Get structured output from agents Claude Code CLI · in the page agent-sdk/structured-outputs …see [Error handling](#error-handling) for the result you get when no attempt succeeds. If your application shows or logs tool calls, skip the ones named `StructuredOutput` so the mechanism doesn't a… Agent SDK reference - TypeScript Claude Code CLI · in the page agent-sdk/typescript …; ``` * [`API_TIMEOUT_MS`](/docs/en/env-vars): how long each request attempt can wait for response headers, in milliseconds. It doesn't limit how long a streaming response runs after the headers arri… Handle approvals and user input Claude Code CLI · in the page agent-sdk/user-input …ing example asks Claude to create and delete a test file. When Claude attempts each operation, the callback prints the tool request to the terminal and prompts for y/n approval. ```python Python them… Orchestrate teams of Claude Code sessions Claude Code CLI · in the page agent-teams …restore in-process teammates. After resuming a session, the lead may attempt to message teammates that no longer exist. If this happens, tell the lead to spawn new teammates. * **Task status can lag*… Manage multiple agents with agent view Claude Code CLI · in the page agent-view …out deleting. The second press deletes the session even when the stop attempt fails, for example because the [background service isn't responding](#agent-view-says-the-background-service-did-not-respo… Authentication Claude Code CLI · in the page authentication …g`](/docs/en/errors#your-apikeyhelper-script-is-failing) within three attempts. `apiKeyHelper`, `ANTHROPIC_API_KEY`, and `ANTHROPIC_AUTH_TOKEN` apply to the CLI and the surfaces that wrap it, includi… Best practices for Claude Code Claude Code CLI · in the page best-practices …ps. Though Claude occasionally solves problems perfectly on the first attempt, correcting it quickly generally produces better solutions faster. * **`Esc`**: stop Claude mid-action with the `Esc` key… Claude Code changelog Claude Code CLI · in the page changelog …mand runners it now counts up from your last message and shows failed attempts **2.1.306** October 21, 2026 * Fixed `claude -p` inside cloud sessions reporting "Not logged in" when started without… Use Claude Code with Chrome Claude Code CLI · in the page chrome …e v2.1.216, these sessions could enable Chrome integration, but every attempt to connect to the browser extension failed with a 403 error. > [!NOTE] > > Chrome integration is not available through th… Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …A whole number from `1` to `60`, default `5`. Raise it if connection attempts time out when a new gateway instance starts. Requires Claude Code v2.1.274 or later on the gateway server. Earlier versio… Claude apps gateway deployment and operations Claude Code CLI · in the page claude-apps-gateway-deploy …Claude Code v2.1.274 or later shows `The gateway is limiting sign-in attempts right now`. A gateway on v2.1.274 or later shows `Too many attempts came from your network address` on the verification p… Data usage Claude Code CLI · in the page data-usage …[settings](/docs/en/settings.md). Disabling the check means WebFetch attempts to retrieve any URL without consulting the blocklist, so combine it with [`WebFetch` permission rules](/docs/en/permissio… Desktop application Claude Code CLI · in the page desktop …t another push, because Desktop can try again. After three unanswered attempts it waits until you retry or send a message. > * **Jump host, pushes keep coming**: where Desktop can't tell that nobody a… Environment variables Claude Code CLI · in the page env-vars …. Set to `false` to prevent this. Set to `true` to force a connection attempt when auto-detection fails, such as when tmux obscures the parent terminal. Takes precedence over the [`autoConnectIde`](/d… Error reference Claude Code CLI · in the page errors …teway-config.md#upstream-error-messages) | | `all upstreams failed (N attempted)` on a Claude apps gateway session | [Upstream error messages](/docs/en/claude-apps-gateway-config.md#upstream-error-mes… Glossary Claude Code CLI · in the page glossary …ostile instructions embedded in a file, web page, or tool result that attempt to redirect Claude toward actions you never asked for. Claude Code's defenses include the permission system, command injec… Keep Claude working toward a goal Claude Code CLI · in the page goal …tice starting with `Goal still active` shows the wait before the next attempt. After three automatic retries, the goal pauses instead. * **Pause**: after a failure that a retry would only repeat, such… Run Claude Code programmatically Claude Code CLI · in the page headless …third consecutive retry onward. The quiet retries still count toward `attempt`. You can use the event to show retry progress in your own interface. | Field | Type | Description | | - | - | - | | `typ… How Claude Code works Claude Code CLI · in the page how-claude-code-works …ely after each summary, Claude Code stops auto-compacting after a few attempts and shows an error instead of looping. See [Auto-compaction stops with a thrashing error](/docs/en/troubleshooting.md#aut… Set up Claude Code in a monorepo or large codebase Claude Code CLI · in the page large-codebases …#redirections) such as `< file`. Claude Code also makes a best-effort attempt to leave denied paths out of the results of the built-in Grep and Glob tools. A Bash search such as `grep -r` or `find` ov… Connect Claude Code to tools via MCP Claude Code CLI · in the page mcp …in this list report a configuration decision rather than a connection attempt, so Claude Code prints them without connecting to the server: * ``⏸ Pending approval (run `claude` to approve)``: a proje… Connect to MCP servers Claude Code CLI · in the page mcp-quickstart …shooting](#troubleshooting) | | `✘ Connection error` | The connection attempt threw an error. See [Troubleshooting](#troubleshooting) | | ``⏸ Pending approval (run `claude` to approve)`` | A project-s… Model configuration Claude Code CLI · in the page model-config …witch rather than apply it unchecked, and it checks again on each new attempt. See [Model switch was blocked by a PreModelSwitch hook](/docs/en/errors.md#model-switch-was-blocked-by-a-premodelswitch-h… Monitoring Claude Code CLI · in the page monitoring-usage …Time from request start to the first content block of the successful attempt, in milliseconds. Absent on requests that fell back to the non-streaming path. Requires Claude Code v2.1.268 or later | |… Enterprise network configuration Claude Code CLI · in the page network-config …one of two ways: * **Where the first-byte deadline runs**: the first attempt ends no later than that deadline. To change it, set `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`. For the retry's wait, see [No r… Choose a permission mode Claude Code CLI · in the page permission-modes …structed to plan without editing, but a file edit or shell command it attempts during planning runs without prompting. Explicit [ask rules](/docs/en/permissions.md#manage-permissions) and recognized `… Configure permissions Claude Code CLI · in the page permissions …m *)` leaves the tool available and blocks matching calls when Claude attempts them. Bare-name removal applies to every tool except [`EndConversation`](/docs/en/tools-reference#endconversation-tool-b… Host and maintain a marketplace Claude Code CLI · in the page plugins/host-marketplace …TPLACE_ON_FAILURE=1`, Claude Code keeps the existing checkout without attempting the re-clone when the background check can't reach or authenticate to the remote. Plugins keep working from the last sy… Plugin manifest reference Claude Code CLI · in the page plugins/manifest-reference …ver stopped instead of restarting it | | `maxRestarts` | No | Restart attempts before giving up, zero or more | | `diagnostics` | No | Whether to push diagnostics into context after edits. Defaults to… Manage Claude Code plugins for your organization Claude Code CLI · in the page plugins/org …erminal attached to a cloud session never registers it. * **A blocked attempt is remembered**: if a machine ever ran under a policy that blocked the official marketplace, Claude Code records the block… Troubleshoot plugins Claude Code CLI · in the page plugins/troubleshooting …ODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` is set * After a failed attempt that's waiting to retry The `claude plugin` shell commands never register it for you. Add it, then retry the install: `… How Claude Code uses prompt caching Claude Code CLI · in the page prompt-caching …t change which tools Claude sees. Claude Code checks them when Claude attempts a call, leaving the prefix intact. ### Compacting the conversation [Compaction](/docs/en/context-window.md#what-survive… Prompt library Claude Code CLI · in the page prompt-library …y in the same prompt so Claude iterates instead of stopping after one attempt. To check the finished change against the running app, run [`/verify`](/docs/en/skills#run-and-verify-your-app). ```text… Continue local sessions from any device with Remote Control Claude Code CLI · in the page remote-control …connection, then run `/remote-control` or run the command again. Each attempt checks for the policy again, so you don't need to restart Claude Code. If the message keeps appearing, run `claude doctor`… Security Claude Code CLI · in the page security …t prompt injection Prompt injection is a technique where an attacker attempts to override or manipulate an AI assistant's instructions by inserting malicious text. Claude Code includes several safegu… Catch security issues as Claude writes code Claude Code CLI · in the page security-guidance …ules, supply-chain checks, and policy enforcement the plugin does not attempt | To find security issues in code you already have, rather than in changes Claude is writing, ask Claude in a session to… Customize sessions in self-hosted environments Claude Code CLI · in the page self-hosted-environments-configuration …nonical UUID form. Empty for pre-warming requests. | | `CLAUDE_RUNNER_ATTEMPT` | A per-session counter to use for logging. It isn't a retry count or a request count. `0` for pre-warming requests, thou… Deploy self-hosted environments to production Claude Code CLI · in the page self-hosted-environments-deploy …boundary on every environment. Session code is model-directed and can attempt connections to arbitrary hosts; default-deny egress at the network layer bounds where those attempts can land. This applie… Self-hosted environments reference Claude Code CLI · in the page self-hosted-environments-reference …t header and TLS SNI as `--scm-connector-host`. | On each connection attempt the orchestrator sends its existing environment secret, and it retries automatically with exponential backoff, capped at 3… Claude Code settings Claude Code CLI · in the page settings …t Foundry deployments with restrictive egress. When skipped, WebFetch attempts any URL without consulting the blocklist… Advanced setup Claude Code CLI · in the page setup …un `claude doctor` in your shell to see the result of the last update attempt Claude Code recorded. On a native installation, if it reports a failed attempt, see [`Auto-update failed` in the session f… Create custom subagents Claude Code CLI · in the page sub-agents …to refuse write requests, so the hook is a backstop: if the subagent attempts a write anyway, Claude Code blocks the command and the subagent sees the `Blocked: Write operations not allowed. Use SELE… Tools reference Claude Code CLI · in the page tools-reference …ituations: * as a last resort against sustained abusive input, after attempts to redirect the conversation have failed and after a clear warning in an earlier message * when you explicitly ask to see…