762 pages for error.

Plugin dependencies Claude Code CLI · in the page plugins/dependencies …/plugins/install#manage-installed-plugins) * **Reading a dependency error**: see [Dependency errors](/docs/en/plugins/troubleshooting#dependency-errors) * **Declaring the npm and Bun packages that… Host and maintain a marketplace Claude Code CLI · in the page plugins/host-marketplace …ects a plugin that has one and syncs the rest of the marketplace. The error message starts with `Plugin contains a top-level bin/ directory`. Keep executables in another directory, such as `scripts/`,… Install and manage plugins Claude Code CLI · in the page plugins/install …ttps://claude.com/docs/plugins/overview) * **Claude Code printed an error**: find it in [Troubleshoot plugins](/docs/en/plugins/troubleshooting) </Note> Start with [Install a plugin](#install-a-plu… Plugin loading reference Claude Code CLI · in the page plugins/loading …d manage plugins](/docs/en/plugins/install) * **You have a specific error message**: see [Troubleshoot plugins](/docs/en/plugins/troubleshooting) </Note> Start with [Check which stage a plugin reac… Plugin manifest reference Claude Code CLI · in the page plugins/manifest-reference …s, and `monitors` entries are strict. An unknown key inside one is an error, and the plugin doesn't load ### Validate the manifest `claude plugin validate` is the authoritative check for a manifest.… Marketplace reference Claude Code CLI · in the page plugins/marketplace-reference …laude-plugins-v2`, and any name containing a non-ASCII character. The error is `Marketplace name impersonates an official Anthropic/Claude marketplace`. A control or bidirectional-formatting character… Manage Claude Code plugins for your organization Claude Code CLI · in the page plugins/org …place Claude Code can't find doesn't load. `/plugin` shows the policy error for it rather than a not-found error. The common case is a stale `enabledPlugins` entry for a marketplace nobody registered.… Publish and distribute a plugin Claude Code CLI · in the page plugins/publish …with the path to your plugin directory. The command catches manifest errors locally; [plugin validate](/docs/en/plugins/cli-reference#plugin-validate) lists which files each run reads. The portal app… Recommend plugins for your org Claude Code CLI · in the page plugins/relevance …l} claude plugin validate ./my-marketplace ``` The validator reports errors and warnings on the `relevance` block, including these: * Reports unknown keys under `relevance` and `relevance.signals` a… Plugin security and trust Claude Code CLI · in the page plugins/security …marketplace or to install a plugin in these cases, each with its own error message: * **Untrusted marketplace source**: when a marketplace uses an official or community name but its source is outsid… Troubleshoot plugins Claude Code CLI · in the page plugins/troubleshooting # Troubleshoot plugins > Fix plugin errors in Claude Code. Find the exact message you saw, grouped by stage from where /plugin runs through install and org policy. This page lists error messages and… How Claude Code uses prompt caching Claude Code CLI · in the page prompt-caching …provider's own endpoint. * **Rejects the marked request with a `400` error naming `cache_control`**: Claude Code re-sends the request with the marker moved off the block and onto your last conversati… Prompt library Claude Code CLI · in the page prompt-library …, cat: 'Plan', roles: ['design', 'pm'], prompt: 'list the error states, empty states, and edge cases for {feature} that the design needs to cover', slots: { feature: 'the file up… Quickstart Claude Code CLI · in the page quickstart …S` when you're in CMD. If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/docs/en/troubleshoot-install#fi… Continue local sessions from any device with Remote Control Claude Code CLI · in the page remote-control …ady. Without an eligible login, `claude remote-control` exits with an error, while `claude --remote-control` still starts an interactive session and shows a Remote Control failure notification shortly… Automate work with routines Claude Code CLI · in the page routines …iage.** Your monitoring tool calls the routine's API endpoint when an error threshold is crossed, passing the alert body as `text`. The routine's prompt tells Claude to investigate the alert in the fi… Configure the sandboxed Bash tool Claude Code CLI · in the page sandboxing …turns `0`, skip this step. If it prints a `No such file or directory` error, the key doesn't exist and you can skip this step. If it returns `1`, add an AppArmor profile that grants `bwrap` this capab… Run prompts on a schedule Claude Code CLI · in the page scheduled-tasks …`.claude` directory or that file is a symlink, Claude Code returns an error instead of scheduling the task. A saved task runs only in the project folder where you created it. If you copy the file into… Customize sessions in self-hosted environments Claude Code CLI · in the page self-hosted-environments-configuration …lifetime expires, then every API call fails with `401 authentication_error`. If your wrapper must background the child, for example to keep a teardown trap alive, save stdin on file descriptor 4 or h… Deploy self-hosted environments to production Claude Code CLI · in the page self-hosted-environments-deploy …| | `browser-intake-us5-datadoghq.com` | 443 | Anthropic error-report uploads, sent only when [error reporting](/docs/en/data-usage#telemetry-services) is enabled for the session's accoun… Verify session identity in self-hosted environments Claude Code CLI · in the page self-hosted-environments-identity …raw: string) { if (!raw.startsWith(PREFIX)) { throw new Error("not a self-hosted runner session token"); } const jwt = raw.slice(PREFIX.length); const { payload } = aw… Self-hosted environments quickstart Claude Code CLI · in the page self-hosted-environments-quickstart …runner can't create or write to the path, it exits at startup with an error naming the directory instead of registering. See [Troubleshooting](/docs/en/self-hosted-environments-deploy#troubleshooting)… Self-hosted environments reference Claude Code CLI · in the page self-hosted-environments-reference …p behaves differently per surface: * **Flag**: startup fails with an error. * **Environment variable**: the runner clamps the value to the timer ceiling rather than rejecting it. ## Orchestrator CLI… Test self-hosted environments end to end Claude Code CLI · in the page self-hosted-environments-testing …ations) for the organization, the call fails with a `403` `permission_error` reading `self-hosted runners are disabled by your organization's policy`. Start a runner on this host with `SELF_HOSTED_RU… Configure server-managed settings Claude Code CLI · in the page server-managed-settings …a payload fails schema validation, Claude Code surfaces a validation error and applies every remaining valid setting; [Invalid entries in managed settings](/docs/en/managed-settings#invalid-entries-i… Manage sessions Claude Code CLI · in the page sessions …ith the default tools and shows a [warning naming the agent](/docs/en/errors#session-agent-no-longer-available). * Permission mode: if you resume from a terminal with `claude --continue`, `claude --re… Claude Code settings Claude Code CLI · in the page settings …bad policy push cannot prevent Claude Code from starting. Validation errors surface in three places: * Interactive sessions show a dialog at startup listing the invalid entries. * Headless runs with… All settings Claude Code CLI · in the page settings-reference …her level to models it knows [don't accept that combination](/docs/en/errors#effort-isnt-available-with-thinking-turned-off), such as Opus 5. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean… Advanced setup Claude Code CLI · in the page setup …S` when you're in CMD. If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/docs/en/troubleshoot-install#fi… Extend Claude with skills Claude Code CLI · in the page skills …r three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes. ```… Claude Code in Slack Claude Code CLI · in the page slack …ugging**: When team discussions provide crucial context (for example, error reproductions or user reports), Claude can use that information to inform its debugging approach. * **Parallel task executio… Customize your status line Claude Code CLI · in the page statusline …r with its separators removed and the command fails without a visible error. Write file paths in the `command` string with forward slashes, as shown in the examples below. The `~` shorthand also works… Create custom subagents Claude Code CLI · in the page sub-agents …Code shows a [warning at startup with the total token count](/docs/en/errors#agent-descriptions-are-over-the-15000-token-limit). Trim the `description` fields of your subagents, and move detail into e… Configure your terminal for Claude Code Claude Code CLI · in the page terminal-config …e unchanged and prints the keybinding block to add yourself](/docs/en/errors#terminal-setup-left-your-zed-keymap-unchanged) If you are running inside tmux, Shift+Enter also requires the [tmux configu… Enterprise deployment overview Claude Code CLI · in the page third-party-integrations …more information, such as connecting to ticket management systems or error logs. We recommend that one central team configures MCP servers and checks a `.mcp.json` configuration into the codebase so… Tools reference Claude Code CLI · in the page tools-reference …a language servers: jump to definitions, find references, report type errors and warnings. See [LSP tool behavior](#lsp-tool-behavior)… Troubleshoot installation and login Claude Code CLI · in the page troubleshoot-install …Fix command not found, PATH, permission, network, and authentication errors when installing or signing in to Claude Code. If installation fails or you can't sign in, find your error below. For runti… Troubleshooting Claude Code CLI · in the page troubleshooting …-- | | `command not found`, install fails, PATH issues, `EACCES`, TLS errors | [Troubleshoot installation and login](/doc… Find bugs with ultrareview Claude Code CLI · in the page ultrareview …name has a typo, Claude Code suggests the closest branch name in the error. A commit id or tag also works as the base, and the review then covers the changes on your branch since that commit. ### R… Voice dictation Claude Code CLI · in the page voice-dictation …ications and can't be bound at all. For example, `Caps Lock` shows an error if you try to bind it. See [customize keyboard shortcuts](/docs/en/keybindings) for the full keybinding syntax and the list… Use Claude Code in VS Code Claude Code CLI · in the page vs-code …nthropic credentials, the dialog still opens, but submitting shows an error and sends nothing: unlike the CLI's `/bug`, the extension doesn't write a local archive. Requires Claude Code v2.1.229 or la… Get started with Claude Code in the cloud Claude Code CLI · in the page web-quickstart …test in `tests/test_auth.py`" is better than "fix tests" * Paste error output if you have it * Describe the expected behavior, not just the symptom Claude clones the repositories, runs y… Week 13 · March 23–27, 2026 Claude Code CLI · in the page whats-new/2026-w13 …until it's green. No more babysitting a PR through six rounds of lint errors.</p> <Frame> <img src="https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/auto-fix.png?fit=max&auto=f… Week 18 · April 27 – May 1, 2026 Claude Code CLI · in the page whats-new/2026-w18 …/code> since v2.1.129</div> <div>MCP servers that hit a transient error during startup now auto-retry up to 3 times instead of staying disconnected</div> <div><code>ANTHROPIC\_BEDROCK\_SERVICE… Week 23 · June 1–5, 2026 Claude Code CLI · in the page whats-new/2026-w23 …laude feedback and keep the turn going instead of being treated as an error</div> <div><code>claude mcp</code> list, get, and add no longer print secrets: environment-variable references are not e… Week 27 · June 29 – July 3, 2026 Claude Code CLI · in the page whats-new/2026-w27 …om a hyphenated MCP server</div> <div>Transient server rate-limit errors unrelated to your usage limit are now retried automatically with backoff for subscribers instead of failing the turn</div>… Week 33 · August 10–14, 2026 Claude Code CLI · in the page whats-new/2026-w33 …imit resets.</p> <a className="digest-feature-link" href="/docs/en/errors#youve-hit-your-session-limit">What to do when you hit a usage limit</a> </div> <div className="digest-feature"> <div cla… Week 34 · August 17–21, 2026 Claude Code CLI · in the page whats-new/2026-w34 …en you ask for an explanation or more detail, Claude answers in full. Error reports, security warnings, and confirmations for destructive actions keep their complete content.</p> <Frame> <video… Week 35 · August 24–28, 2026 Claude Code CLI · in the page whats-new/2026-w35 …ns, Agent SDK runs, and cloud sessions, Claude Code <a href="/docs/en/errors#the-response-above-may-be-incomplete">continues a response</a> that a server error, dropped connection, or stall cut off mi… Week 37 · September 7–11, 2026 Claude Code CLI · in the page whats-new/2026-w37 …ols-reference#webfetch-tool-behavior">the fetch fails with a deadline error</a> instead of hanging; set <code>CLAUDE\_CODE\_WEBFETCH\_DEADLINE\_MS</code> to change the deadline, or to <code>0</code> t…