936 pages for error.

Plugin loading reference Claude Code CLI · in the page plugins/loading …code.claude.com/docs/en/plugins/install.md) > * **You have a specific error message**: see [Troubleshoot plugins](https://code.claude.com/docs/en/plugins/troubleshooting.md) Start with [Check which s… 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 mods for your organization Claude Code CLI · in the page plugins/mods/admin …does-nothing). The note appears in the plugin's details and in the **Errors** tab of `/plugin`. It requires Claude Code v2.1.299 or later. It names each hook from the table as the mod registered it,… Use the mods API Claude Code CLI · in the page plugins/mods/api …ch Claude reads as the tool's result. When the server answers with an error status, Claude reads `Lookup failed with status` and the number. > [!TIP] > > When [MCP tool search](https://code.claude.co… Create a mod Claude Code CLI · in the page plugins/mods/create …ual cause is a misspelled event name, which the command reports as an error such as `"tool.calls" is not an event`. Follow these rules so that static analysis can find every hook and call: * Write e… React to events with a mod Claude Code CLI · in the page plugins/mods/events …e) // A refused call comes back as { deny }, and a failed one has isError set const changed = !result.deny && !result.isError if (changed && e.file_path.endsWith('.mdx')) $.ui.log('Claude change… Draw in the interface with a mod Claude Code CLI · in the page plugins/mods/interface …ept only `true`. To leave one off, omit it. Passing `false` throws an error such as `ui.open: focus is true or left out`. To set one of them conditionally, add the field only when the condition holds.… Mods reference Claude Code CLI · in the page plugins/mods/reference …gistration with one method, `.catch(handler)`, which sets the hook's [error handler](https://code.claude.com/docs/en/plugins/mods/events.md#handle-a-hook-that-fails). | Argument | What it is | | :- |… Test a mod Claude Code CLI · in the page plugins/mods/test …p-what-a-stub-returns) shows which form each common name takes. These errors mean a stub is wrong or missing. A failed test's output includes a block headed `the engine reported:`, and each error appe… Troubleshoot a mod Claude Code CLI · in the page plugins/mods/troubleshoot …ad the module, for example because its top-level code threw. Fix the error the reason names. If the reason ends with `; the version loaded before is unloaded`, no version of the mod is running now.… Manage Claude Code plugins for your organization Claude Code CLI · in the page plugins/org …<name>@<marketplace> --scope project`. Until they do, the `/plugin` **Errors** tab can show `Plugin "<name>" is enabled in project settings but isn't installed here` or [`not cached`](https://code.cla… 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](https://code.claude.com/docs/en/plugins/cli-reference.md#plugin-validate) lists which files each… 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 …in CMD, not PowerShell. > > If the install command fails with `syntax error near unexpected token '<'`, a `403`, or any other error, see [Troubleshoot installation](https://code.claude.com/docs/en/tro… 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 scheduled tasks Claude Code CLI · in the page routines …your monitoring tool calls the scheduled task's API endpoint when an error threshold is crossed, passing the alert body as `text`. The task's prompt tells Claude to investigate the alert in the fire… Configure the sandboxed Bash tool Claude Code CLI · in the page sandboxing …calling tool receives AWS's own rejection response instead of a proxy error. #### Mask credential files To mask a credential file, set `"mode": "mask"` on its `credentials.files` entry. Masking file… Run prompts on a schedule Claude Code CLI · in the page scheduled-tasks …a [notice that the wakeup won't fire](https://code.claude.com/docs/en/errors.md#restarted-after-its-next-loop-wakeup-was-due). To continue the loop, [reply to the session](https://code.claude.com/docs… Customize sessions in self-hosted environments Claude Code CLI · in the page self-hosted-environments-configuration …hen every API call that uses the token 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 9 and… Deploy self-hosted environments to production Claude Code CLI · in the page self-hosted-environments-deploy …nvironments. | | `browser-intake-us5-datadoghq.com` | 443 | Anthropic error-report uploads, sent only when [error reporting](https://code.claude.com/docs/en/data-usage.md#telemetry-services) is enable… Verify session identity in self-hosted environments Claude Code CLI · in the page self-hosted-environments-identity …ken(raw: string) { > if (!raw.startsWith(PREFIX)) { > throw new Error("not a self-hosted runner session token"); > } > const jwt = raw.slice(PREFIX.length); > > const { payload } = await j… Self-hosted environments quickstart Claude Code CLI · in the page self-hosted-environments-quickstart …who runs them. If the runner will run as another user, it exits with `error: Failed to read environment secret file <path> (EACCES: permission denied, open '<path>')`. In that case, run both commands… 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. ### Session startup… Test self-hosted environments end to end Claude Code CLI · in the page self-hosted-environments-testing …_id":"..."}` * **Session creation failed**: the line `{"ok":false,"error":"..."}`, and the command exits with status 1 * **Some earlier errors**, such as cloud sessions being unavailable for you… Configure server-managed settings Claude Code CLI · in the page server-managed-settings …ws a warning and relabels the save button. The label is **Update with errors** when settings are already saved, and **Add with errors** when no settings are saved yet. That button still saves, because… Manage sessions Claude Code CLI · in the page sessions …nd shows a [warning naming the agent](https://code.claude.com/docs/en/errors.md#session-agent-no-longer-available). * Permission mode: if you resume from a terminal with `claude --continue`, `claude -… 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 …knows [don't accept that combination](https://code.claude.com/docs/en/errors.md#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 …in CMD, not PowerShell. > > If the install command fails with `syntax error near unexpected token '<'`, a `403`, or any other error, see [Troubleshoot installation](https://code.claude.com/docs/en/tro… 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. ``` Th… Claude Code in Slack Claude Code CLI · in the page slack …ch to the task. To give Claude something a teammate wrote, such as an error report, paste its text into the message where you @mention Claude. > [!WARNING] > > When @Claude is invoked in Slack, Claud… 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 …t startup with the total token count](https://code.claude.com/docs/en/errors.md#agent-descriptions-are-over-the-15000-token-limit). Trim the `description` fields of your subagents, and move detail int… Configure your terminal for Claude Code Claude Code CLI · in the page terminal-config …the keybinding block to add yourself](https://code.claude.com/docs/en/errors.md#terminal-setup-left-your-zed-keymap-unchanged) If you are running inside tmux, Shift+Enter also requires the [tmux conf… Enterprise deployment overview Claude Code CLI · in the page third-party-integrations …more information, such as connecting to ticket management systems or error logs. Have one central team configure MCP servers and check a `.mcp.json` configuration into the codebase so that all users… 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) | No | | `Monitor` | Runs a command in the background and feeds e… 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](https://code.claude.com/docs/en/troubleshoot-install.md) | | Update or install down… 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](https://code.claude.com/docs/en/keybindings.md) for the full keybi… Use Claude Code in VS Code Claude Code CLI · in the page vs-code …ns out, the minutes disappear and the icon turns red, or your theme's error color, until the next response. The cache has likely expired, so expect a slower, more expensive response to your next messa… Get started with Claude Code in the cloud Claude Code CLI · in the page web-quickstart …auth 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 your setu… Orchestrate subagents at scale with dynamic workflows Claude Code CLI · in the page workflows …erifier agents can't check a claim, such as after a rate limit or API error, the report lists that claim as unverified instead of counting it as refuted. To run a workflow for your own task, [have Cl… Run parallel sessions with worktrees Claude Code CLI · in the page worktrees …once there to accept the trust dialog, or `--worktree` exits with an error prompting you to. Non-interactive runs with `-p` skip the trust check, so `claude -p --worktree` proceeds without it. > [!T… Zero data retention Claude Code CLI · in the page zero-data-retention …Claude Code terminal during startup, attempting to use it returns an error indicating the organization's policies do not allow that action. Future features may also be disabled if they require stori…