261 pages for refuse.

Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry Claude Code CLI · in the page claude-apps-gateway …tp-tuning) to the same blocks you declare here, so the gateway itself refuses clients from anywhere else. Behind a load balancer or ingress, set `listen.trusted_proxies` to that front end as well, bec… Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …, in PKCS#8 or PKCS#1 PEM form, and a certificate for it. The gateway refuses to start with any key that doesn't meet these conditions. This `openssl` command creates such a key with a self-signed cer… Claude apps gateway deployment and operations Claude Code CLI · in the page claude-apps-gateway-deploy …E] > > **Plan your gateway's network first.** At sign-in, Claude Code refuses a Claude apps gateway whose hostname resolves to a public IP address, even one the internet can't reach. > > A Claude apps… Deploy Claude apps gateway on AWS Claude Code CLI · in the page claude-apps-gateway-on-aws …session started without it runs the default model, which the gateway refuses for them. The gateway enforces `availableModels` on every request, not only in the model picker, and AWS billing groups t… Use Claude Code in the cloud Claude Code CLI · in the page claude-code-on-the-web …want the cloud session to see * On macOS, Linux, and WSL, Claude Code refuses the upload when it can't follow a git setting that affects which attribute rules apply to your files, such as `core.attrib… CLI reference Claude Code CLI · in the page cli-reference …w#manage-sessions-from-the-shell) from the list. When the removal is [refused over the session's worktree](/docs/en/agent-view#what-deleting-a-session-removes) and a second `claude rm` can resolve it,… Communications kit Claude Code CLI · in the page communications-kit …amily, except that flagged biology content on Opus 5 or Sonnet 5.5 is refused. *Try it now:* type `/model` and pick Sonnet if you haven't already. It is the right default for most tasks. 📖 Model con… Run Claude Code behind a corporate launcher Claude Code CLI · in the page corporate-launcher …. ## The launcher contract When the launcher can't run, Claude Code refuses to start the process instead of starting it unwrapped. On Windows, [the variable is ignored](#what-the-launcher-covers) an… Message your other Claude Code sessions Claude Code CLI · in the page cross-session-messaging …th its own tools, subject to that session's permissions. Claude Code refuses a message in the following cases: * The message is [over the size cap](#limitations). Claude Code refuses it in the sendi… Desktop application Claude Code CLI · in the page desktop …SessionInbound`](/docs/en/settings-reference#crosssessioninbound) to `refuse` in the receiving session, Claude Code drops messages from this surface. Claude Code reports the refusal to the Claude desk… Environment variables Claude Code CLI · in the page env-vars …t-subagent-limit) can be running in one session before the Agent tool refuses to spawn another (default: 20). Accepts a positive whole number in plain digits; anything else is ignored, so the variable… Error reference Claude Code CLI · in the page errors …safety-of-an-action) | | `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) | | `The server-side auto… Speed up responses with fast mode Claude Code CLI · in the page fast-mode …at set [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) refuse `/fast on` with the same message everywhere except an interactive terminal session. > * **Fast-mode model not allowed**: if… Claude Code on Google Cloud's Agent Platform Claude Code CLI · in the page google-vertex-ai …als Claude Code switches to your configured fallback instead. To have refused requests fail rather than switch, set [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/en/env-vars). A fallback chain… Set up Claude Code (local mode) for a HIPAA-ready organization Claude Code CLI · in the page hipaa-setup …/settings-reference#allowedproviders) | `["anthropic"]` | Claude Code refuses to start on a cloud provider or a gateway | | [`cleanupPeriodDays`](/docs/en/settings-reference#cleanupperioddays) | The n… Hooks reference Claude Code CLI · in the page hooks ….md#create-a-marketplace), then install it from there. If Claude Code refuses the marketplace with [`is blocked by enterprise policy`](/docs/en/plugins/troubleshooting#marketplace-source-is-blocked-by… Other LLM gateways Claude Code CLI · in the page llm-gateway …y's `ANTHROPIC_BASE_URL` in that file's `env` block. Claude Code then refuses a session pointed anywhere else, including at Anthropic directly or at a developer's own proxy, and accepts `ANTHROPIC_BAS… Connect Claude Code to an LLM gateway Claude Code CLI · in the page llm-gateway-connect …ocs/en/errors.md#your-apikeyhelper-script-is-failing) | | `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` when nothing answers at the address, or `Can't reach the API… Control MCP server access for your organization Claude Code CLI · in the page managed-mcp …ted as an alias for `http`. * `url` is an `https://` URL. Claude Code refuses a plain `http://` URL, including one that points at `localhost`. * The entry has no `command`, `args`, `env`, or `headersH… Deploy managed settings Claude Code CLI · in the page managed-settings …A file that isn't valid JSON doesn't produce this state; Claude Code [refuses to start](#find-entries-claude-code-dropped) instead. When you deployed through server-managed settings instead, run `c… Connect Claude Code to tools via MCP Claude Code CLI · in the page mcp …on fails with a transient error, such as a 5xx response, a connection refused, or a timeout, Claude Code retries up to three times. If the connection still fails, Claude Code marks the server as faile… How Claude remembers your project Claude Code CLI · in the page memory …ude reads `CLAUDE.md` through the link, but the Edit and Write tools [refuse to write through a symlink](/docs/en/errors.md#refusing-after-a-symlink-changed), and the refusal directs Claude to edit th… Claude Code on Microsoft Foundry Claude Code CLI · in the page microsoft-foundry …URCE` to the resource name alone, such as `my-resource`. Claude Code [refuses a URL or host name](/docs/en/errors.md#anthropic-foundry-resource-must-be-a-foundry-resource-name) when you send a message… Model configuration Claude Code CLI · in the page model-config …ins) deliver, for example because a managed plugin failed to load, it refuses the switch rather than apply it unchecked, and it checks again on each new attempt. See [Model switch was blocked by a Pre… Monitoring Claude Code CLI · in the page monitoring-usage …op event and a later `false` final event when the fallback model also refuses. * `has_category`: `true` when the API response carried a `stop_details.category` of `"cyber"`, `"bio"`, `"frontier_llm"`,… Choose a permission mode Claude Code CLI · in the page permission-modes …lock reads outside the working directories from now on**: the read is refused, and Claude Code sets [`permissions.blockReadsOutsideWorkingDirectories`](/docs/en/settings-reference#permissions-blockrea… Configure permissions Claude Code CLI · in the page permissions …tion, Claude Code runs npm scripts and git commits without asking and refuses commands that begin with `git push`. A push written another way, such as `git -C . push`, isn't matched; see [what a Bash… Test plugins with evals Claude Code CLI · in the page plugin-evals …Bash or PowerShell on a machine with no sandbox backend, Claude Code refuses each run rather than running it unconfined, and the case shows a run error and usually scores 0. Native Windows has no bac… Plugin commands reference Claude Code CLI · in the page plugins/cli-reference …Y, and you pass neither `-y` nor `--accept-command`**: the install is refused. The output says the command was only displayed, and the exit code is `1` * **Claude runs the command through its Bash too… Create a marketplace Claude Code CLI · in the page plugins/create-marketplace …tion. When you add a marketplace with one of those names, Claude Code refuses it with a message that starts `The name '<name>' is reserved for official Anthropic marketplaces`. * **When you install a… Plugin dependencies Claude Code CLI · in the page plugins/dependencies …ependency is declared in the marketplace entry, the install itself is refused with a message that starts `Dependency "audit-logger@your-shared-marketplace" (required by deploy-kit@your-marketplace) is… Host and maintain a marketplace Claude Code CLI · in the page plugins/host-marketplace …Code v2.1.224 or later. Pin each archive with `sha256` so Claude Code refuses a changed download. To send credentials with the download, see [Authenticate archive downloads](#authenticate-archive-down… Install and manage plugins Claude Code CLI · in the page plugins/install …hen another enabled plugin still needs the one you named, Claude Code refuses and prints a chained command that disables both in the right order. * **Uninstall**: auto-installed dependencies stay unti… Plugin loading reference Claude Code CLI · in the page plugins/loading …ude.ai loads even if you disabled it earlier. `claude plugin disable` refuses it with `Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change… Plugin manifest reference Claude Code CLI · in the page plugins/manifest-reference …one of Anthropic's own`. `claude plugin init` and `claude plugin tag` refuse a name that draws the error. Claude Code still installs and loads a plugin whose name they refuse. ### `displayName` The… Marketplace reference Claude Code CLI · in the page plugins/marketplace-reference …leString`, `toString`, and `valueOf`. `claude plugin marketplace add` refuses a marketplace that uses one with [`Claude Code reserves this name and cannot register a marketplace under it`](/docs/en/pl… Manage mods for your organization Claude Code CLI · in the page plugins/mods/admin …in what order. You can also install a mod of your own that watches or refuses what other mods do. This page is for the person who deploys managed settings for Claude Code, whether as a file, through… Use the mods API Claude Code CLI · in the page plugins/mods/api …d.register` throws for a taken name, with a message such as `"/focus" refused: it is the built-in /focus`. A hook that throws is skipped, so the rest of your `session.start` hook doesn't run either. R… Create a mod Claude Code CLI · in the page plugins/mods/create …s/interface#keep-state). You also see one line for each hook that can refuse an action, such as `gating hook without .catch: tool.call`, which says whether that hook has a [`.catch` handler](/docs/en/… React to events with a mod Claude Code CLI · in the page plugins/mods/events …in, so later mods and Claude Code's own behavior don't run. This hook refuses every Bash command: ```javascript theme={null} on('tool.call', { tool: 'Bash' }, async () => { // No call to next, so t… Draw in the interface with a mod Claude Code CLI · in the page plugins/mods/interface …`--plugin-dir`, a transcript line says so, such as `ui.render (Pane) refused: Text prop "bogusProp" is not allowed; the engine drew its own`. The [debug log](/docs/en/plugins/mods/troubleshoot.md#rea… Mods overview Claude Code CLI · in the page plugins/mods/overview …ocked. To check when a mod can also approve a call that a `deny` rule refuses, see [Extend permissions with hooks](/docs/en/permissions.md#precedence-among-rules-hooks-and-mods). A mod can restyle mu… Mods reference Claude Code CLI · in the page plugins/mods/reference …resume-subagents) tool, your `agent.spawn` hook doesn't run again. To refuse the `SendMessage` calls that resume a subagent, match that tool in a [`tool.call`](/docs/en/plugins/mods/events#guard-or-ch… Test a mod Claude Code CLI · in the page plugins/mods/test …nization lists in [`prependPlugins`](/docs/en/plugins/mods/admin) can refuse another mod before it loads. To test one, set your mod's tier and give the test a second mod for yours to allow or refuse:… Troubleshoot a mod Claude Code CLI · in the page plugins/mods/troubleshoot …ssion. When a module doesn't load, a hook is skipped, or another mod refuses yours, Claude Code writes one line that names your mod. Where you read that line depends on the session: * **A session th… Manage Claude Code plugins for your organization Claude Code CLI · in the page plugins/org …ngs > Plugins**](https://claude.ai/admin-settings/plugins). claude.ai refuses a repository that the allowlist doesn't admit or that the blocklist names. It doesn't re-check a marketplace that was adde… Plugin security and trust Claude Code CLI · in the page plugins/security …in to a commit SHA, which it does for nearly every entry, Claude Code refuses to install a different commit. ### Official marketplace names These marketplace names make up the official tier: * `cla… Troubleshoot plugins Claude Code CLI · in the page plugins/troubleshooting …owner/repo` or a `gitlab.example.com/group/project` path. Claude Code refused it with this message and a list of accepted forms. The `owner/repo` shorthand is GitHub-only and has to follow GitHub's n… Continue local sessions from any device with Remote Control Claude Code CLI · in the page remote-control …or `--model`. For any other flag, such as `--settings`, Claude Code [refuses to start](/docs/en/errors.md#not-carried-over-to-the-sessions-remote-control-starts) and names the flag to remove. To san… Choose a sandbox environment Claude Code CLI · in the page sandbox-environments …d hooks are also inside the boundary. On Linux and macOS, Claude Code refuses to start with this flag when running as root, so run the container, VM, or sandbox runtime as a non-root user. [Auto mode…