Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Search the documentation

50 pages for refused.

Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it. Cut at 50, so a narrower query shows the rest.

Or, for the model with the same capabilities and no access approval requirement: Claude Developer Platform · in the page about-claude/models/migration-guide …he full set. You are not billed for the input tokens of a request refused before any output is generated. When a classifier fires mid-stream, the input and already-streamed output are billed; disc… optimizing-for-cost-and-intelligence Claude Developer Platform · in the page about-claude/models/optimizing-for-cost-and-intelligence …ools (August 26 to 27, 2026); scored on the 33 tasks no configuration refused, with attempts the production safety classifiers cut short removed; costs are what a customer is billed, the platform's re… browser-use-tool Claude Developer Platform · in the page agents-and-tools/tool-use/browser-use-tool …d` doesn't. Other common cases: <AccordionGroup> <Accordion title="Refused navigation scheme"> ```json { "type": "tool_result", "tool_use_id": "toolu_01LeUTyqkhRxBFq1QTG3pkwN",… Beta Claude Developer Platform · in the page api/beta …rom a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens for… Messages Claude Developer Platform · in the page api/beta/messages …rom a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens for… Batches Claude Developer Platform · in the page api/beta/messages/batches …a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens… Create a Message Batch Claude Developer Platform · in the page api/beta/messages/batches/create …a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens… Retrieve Message Batch results Claude Developer Platform · in the page api/beta/messages/batches/results …Opaque code that refunds the cache-miss cost when retrying this refused request on the fallback model. Pass it as `fallback_credit_token` on the retry request. Expires 5… Create a Message Claude Developer Platform · in the page api/beta/messages/create …rom a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens for… fallback-credit Claude Developer Platform · in the page build-with-claude/fallback-credit …escription: Avoid paying the prompt-cache cost twice when you retry a refused request on another model. --- Prompt caches are per-model. When a model declines a request and you retry on another model… handling-stop-reasons Claude Developer Platform · in the page build-with-claude/handling-stop-reasons …stop_details` is `null` for all stop reasons other than `refusal`. A refused request on Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, or Claude Opus 5 can usually be served by retrying on anothe… overview Claude Developer Platform · in the page build-with-claude/overview …| Avoid paying the prompt-cache cost twice when you retry a refused request on another model. The refusal carries a credit token, and echoing it on the retry bills the retry as though the co… refusals-and-fallback Claude Developer Platform · in the page build-with-claude/refusals-and-fallback …le and Claude Opus models return classifier refusals and how to retry refused requests on a fallback model. --- Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, and Claude Opus 5 include safety cla… search-results Claude Developer Platform · in the page build-with-claude/search-results …ect and handle refusal stop reasons in streaming responses, and retry refused requests on a fallback model. </Card> <Card title="Citations" icon="book" href="https://platform.claude.com/docs/en/b… thinking Claude Developer Platform · in the page build-with-claude/thinking …it the model's internal reasoning as part of the response text can be refused with `stop_details.category: "reasoning_extraction"`. See [Refusal categories](https://platform.claude.com/docs/en/build-w… inference-hooks-endpoint Claude Developer Platform · in the page manage-claude/inference-hooks-endpoint …ly routable host (private, loopback, and carrier-grade NAT ranges are refused at connect time), with a certificate that validates against the public CA trust store, responding without redirects. The c… Or, for the Project Glasswing model with the same capabilities: Claude Developer Platform · in the page models/fable-5-1/migration-guide …nd reading `stop_details.category` before response content. To re-run refused requests on another model automatically, set `fallbacks: "default"` (beta, `server-side-fallback-2026-07-01` header). `"de… whats-new-fable-5-1 Claude Developer Platform · in the page models/fable-5-1/whats-new-fable-5-1 …se) object naming the policy area that fired. * **Fallback:** retry a refused request on another model with [server-side fallback](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fa… introducing-claude-fable-5-and-claude-mythos-5 Claude Developer Platform · in the page models/fable-5/introducing-claude-fable-5-and-claude-mythos-5 …lback-credit). ### Billing You are not billed for a request that is refused before any output is generated. When you retry on another model, [fallback credit](https://platform.claude.com/docs/en/bui… Or, for the model with the same capabilities and no access approval requirement: Claude Developer Platform · in the page models/fable-5/migration-guide …he full set. You are not billed for the input tokens of a request refused before any output is generated. When a classifier fires mid-stream, the input and already-streamed output are billed; disc… Opus migration Claude Developer Platform · in the page models/opus-5/migration-guide …e cyber-category refusals can fall back to Claude Opus 4.8. To re-run refused requests on another model automatically, consider the `fallbacks` parameter with the `"default"` mode (`fallbacks: "defaul… Sonnet migration Claude Developer Platform · in the page models/sonnet-5/migration-guide …ests that involve prohibited or high-risk cybersecurity topics may be refused. Refusals return as a successful HTTP 200 response with `stop_reason: "refusal"`, not an error. See [Real-time cyber safeg… whats-new-sonnet-5 Claude Developer Platform · in the page models/sonnet-5/whats-new-sonnet-5 …ests that involve prohibited or high-risk cybersecurity topics may be refused. Refusals return as a successful HTTP 200 response with `stop_reason: "refusal"`, not an error. See [Real-time cyber safeg… overview Claude Developer Platform · in the page release-notes/overview …PI returns `stop_reason: "refusal"`. You are not billed for a request refused before any output is generated. An opt-in `fallbacks` parameter (in beta on the Claude API and Claude Platform on AWS; not… handle-streaming-refusals Claude Developer Platform · in the page test-and-evaluate/strengthen-guardrails/handle-streaming-refusals …ect and handle refusal stop reasons in streaming responses, and retry refused requests on a fallback model. --- Starting with Claude 4 models, streaming responses from Claude's API return **`stop_rea… Escalate hard decisions with the advisor tool Claude Code CLI · in the page advisor …model`](/docs/en/model-config#setting-your-model). If the API already refused the saved advisor in the current conversation, it stays off until `/clear` or `/compact`, even after you switch models. O… Subagents in the SDK Claude Code CLI · in the page agent-sdk/subagents …ltracode](/docs/en/model-config#adjust-effort-level) active are never refused. See the [concurrent subagent limit](/docs/en/sub-agents#concurrent-subagent-limit) | | Spend… Agent SDK reference - TypeScript Claude Code CLI · in the page agent-sdk/typescript …an absent field tell you. * `startup_failure_reason`: why Claude Code refused to start, on the `error_during_execution` result it writes before exiting on a known startup failure. See [`startup_failur… Manage multiple agents with agent view Claude Code CLI · in the page agent-view …-unpushed <commit>@<worktree-id>` | Delete a session whose delete was refused over unpushed commits, discarding the worktree along with its branch and commits. Pass the exact value that refusal printe… Share session output as artifacts Claude Code CLI · in the page artifacts …sn't decode, or that contains the replacement character `U+FFFD`, is [refused with the line and column to fix](/docs/en/errors#the-source-file-is-not-valid-utf-8-text).… Configure auto mode Claude Code CLI · in the page auto-mode-config …-safety-of-an-action), because a safety check separate from auto mode refused the classifier's own request or its response didn't parse, Claude Code denies the action without recording it under **Rece… Claude Code changelog Claude Code CLI · in the page changelog …ile scope when that capability was re-sent without them; they are now refused * Fixed `/ultrareview` reporting a stopped cloud review as completed or as an error to retry, and waiting out the full t… Channels reference Claude Code CLI · in the page channels-reference …claude/debug/<session-id>.txt`. * **`curl` fails with "connection refused"**: the port is either not bound yet or a stale process from an earlier run is holding it. `lsof -i :<port>` shows what's… Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry Claude Code CLI · in the page claude-apps-gateway …and sign-in to one on a public address outside every listed block is refused as before. A declared block narrows who can sign in but doesn't prove where a machine is, so declare only address space y… Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …s-gateway-deploy#threat-model-summary) blocks every export with `ECONNREFUSED_SSRF` unless you set `CLAUDE_GATEWAY_ALLOW_LOOPBACK=1` in the gateway's environment * `http://127.0.0.1:<port>` or `http:/… Claude apps gateway deployment and operations Claude Code CLI · in the page claude-apps-gateway-deploy …ification page, with the settings to check. It also writes a `sign-in refused` log line that names the setting to change. ## Operations Once the gateway is serving traffic, day-to-day operation is r… 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 …to an earlier Opus, except that flagged biology content on Opus 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… Message your other Claude Code sessions Claude Code CLI · in the page cross-session-messaging …when you approve it or a later mode or settings change allows it. * **Refused**: Claude Code drops the message without delivering it. Once delivered, the message counts toward [usage](/docs/en/costs)… Error reference Claude Code CLI · in the page errors …| | `Agent aborted: auto mode classifier request refused by the safety safeguard`… Speed up responses with fast mode Claude Code CLI · in the page fast-mode …ection) allowlist excludes the fast-mode Opus model, turning it on is refused with "is not in your organization's allowed models". In a session already running on an allowed Opus model that supports f… Hooks reference Claude Code CLI · in the page hooks …a classifier verdict because [a safety check separate from auto mode refused the classifier's own request](/docs/en/errors#auto-mode-cannot-determine-the-safety-of-an-action) or its response didn't p… Connect Claude Code to an LLM gateway Claude Code CLI · in the page llm-gateway-connect …| | `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` when nothing answers at the address, or `Can't reach the API… Deploy managed settings Claude Code CLI · in the page managed-settings …sages](/docs/en/cross-session-messaging#control-inbound-messages) are refused until the value is fixed. The developer sees [a warning](/docs/en/errors#crosssessioninbound-must-be-one-of-accept-hold-re… 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… Model configuration Claude Code CLI · in the page model-config …or later * **[Fast mode](/docs/en/fast-mode)**: enabling fast mode is refused when the model the session would run on afterward is outside the allowlist ```json theme={null} { "availableModels": ["… Monitoring Claude Code CLI · in the page monitoring-usage …ce, machines whose policy helper is failing, and the reason a machine refused to start. Requires Claude Code v2.1.274 or later. By default, the event carries the managed sources and the policy helper… Choose a permission mode Claude Code CLI · in the page permission-modes …the prompt doesn't appear again * **Block from now on**: the read is refused, and Claude Code sets [`permissions.blockReadsOutsideWorkingDirectories`](/docs/en/settings-reference#permissions-blockrea… Test plugins with evals Claude Code CLI · in the page plugin-evals …code and suite you'd run yourself. Pass it in CI so the job is never refused by or left waiting at the prompt. See [What a run can access](#security)… Create and distribute a plugin marketplace Claude Code CLI · in the page plugin-marketplaces …plugins in a bulk install still install. A plugin that depends on the refused plugin fails to install until the user installs the refused plugin by itself. * **Background auto-update, or session start…
Feedback