936 pages for error.

Work with sessions Claude Code CLI · in the page agent-sdk/sessions …== "success") { console.log(message.result); } } } catch (error) { // A single-shot query() throws after yielding an error result, // so the follow-up query below still runs. console… Extend agents with skills Claude Code CLI · in the page agent-sdk/skills …` rejects the list before the session starts. See [Invalid skill name error](#invalid-skill-name-error) for the name rules and the error each SDK raises. The model doesn't see unlisted skills and the… Streaming Input Claude Code CLI · in the page agent-sdk/streaming-vs-single-mode …k's `source` is missing or isn't an object, the SDK doesn't report an error. Claude Code sends Claude a text note in place of the image, such as `[Image could not be processed: image block has no sour… Get structured output from agents Claude Code CLI · in the page agent-sdk/structured-outputs …validation does not succeed within the retry limit, the result is an error instead of structured data; see [Error handling](#error-handling). For full type safety, use [Zod](#type-safe-schemas-with-… Subagents in the SDK Claude Code CLI · in the page agent-sdk/subagents …ls with [`subagent_type is required`](https://code.claude.com/docs/en/errors#subagent-type-is-required). ## What subagents inherit Unless the subagent is a [fork](https://code.claude.com/docs/en/sub… Track todos Claude Code CLI · in the page agent-sdk/todo-tracking …a session reaches its turn limit first, that result message has the `error_max_turns` subtype. Check `subtype` to detect that ending. * **Error handling**: these examples use single-shot `query()` ca… Scale to many tools with tool search Claude Code CLI · in the page agent-sdk/tool-search …== "success") { console.log(message.result); } } } catch (error) { // A single-shot query() throws after yielding an error result console.log(`Session ended with an error: ${error}`);… Troubleshoot the Agent SDK Claude Code CLI · in the page agent-sdk/troubleshooting # Troubleshoot the Agent SDK > Fix Agent SDK errors when the Claude Code CLI fails to start, the CLI process exits, or a successful result arrives without structured output. This page covers Agent S… Agent SDK reference - TypeScript Claude Code CLI · in the page agent-sdk/typescript …along with the functions that rename, tag, and delete sessions, `AbortError`, the runtime constants, and every type. Importing the alpha `prewarm()` from `/core` requires Agent SDK v0.3.314 or later.… Handle approvals and user input Claude Code CLI · in the page agent-sdk/user-input …hat omitted `updatedInput` and denied the tool call with a validation error. When denying, provide a message explaining why. Claude sees this message and may adjust its approach. Beyond allowing or… Orchestrate teams of Claude Code sessions Claude Code CLI · in the page agent-teams …requires the [`it2` CLI](https://github.com/mkusaka/it2) and shows an error with the install command if `it2` is missing. The setup prompt that offers to install `it2` or switch to tmux appears under… Manage multiple agents with agent view Claude Code CLI · in the page agent-view …task finished successfully | | Failed | Red | The task ended with an error | | Stopped | Grey | You stopped the session with `Ctrl+X` or `claude stop`, [its process was ended from outside Claude Code… Claude Code on Amazon Bedrock Claude Code CLI · in the page amazon-bedrock …IAM Identity Center about once per credential lifetime. A credential error from the API clears the cache, and the retry resolves fresh credentials. The cache covers every credential method listed at… Share session output as artifacts Claude Code CLI · in the page artifacts …. If the terminal shows `Artifacts need a claude.ai login`, see [that error's entry](https://code.claude.com/docs/en/errors.md#artifacts-need-a-claude-ai-login) for how to sign in. ### When Claude Co… Authentication Claude Code CLI · in the page authentication …and when refresh fails, requests fail with an [expired profile login error](https://code.claude.com/docs/en/errors.md#anthropic-profile-login-expired) until you sign in again. You don't get the choi… Auto mode classifier request charges Claude Code CLI · in the page auto-mode-classifier-billing …he server returned no safety verdict](https://code.claude.com/docs/en/errors.md#the-server-returned-no-safety-verdict): the denial you see when the server gives no verdict for an action * [Manage cost… Configure auto mode Claude Code CLI · in the page auto-mode-config …and Claude may try it again * **No row, and `Not run` or a classifier error in the conversation**: auto mode's classifier gave no verdict. To see how to run the action, read [Auto mode cannot determin… Best practices for Claude Code Claude Code CLI · in the page best-practices …n your message. * An image: paste the screenshot of the design or the error into the prompt. * Command output: pipe it in from your shell with `cat error.log | claude -p "what's going on here"`. Phra… Champion kit Claude Code CLI · in the page champion-kit …" | Encourage them to provide the failure back to Claude. Pasting the error message or failing test is far more effective than rephrasing the original request. | [Common workflows](https://code.claude… Claude Code changelog Claude Code CLI · in the page changelog …worktree` session that couldn't set up its worktree: it now shows the error from its beginning, not an internal tag or its last 200 characters * Improved the messages shown when an artifact is in anot… Push events into a running session with channels Claude Code CLI · in the page channels …rence.md#example-build-a-webhook-receiver)**: a webhook from CI, your error tracker, a deploy pipeline, or other external service arrives where Claude already has your files open and remembers what yo… Channels reference Claude Code CLI · in the page channels-reference …rver's status. A `failed` status usually means a dependency or import error in your server file. To see the stderr trace, restart with `claude --debug --dangerously-load-development-channels server:we… Checkpointing Claude Code CLI · in the page checkpointing …fail with [`No files were restored`](https://code.claude.com/docs/en/errors#no-files-were-restored). To keep snapshots longer, set [`cleanupPeriodDays`](https://code.claude.com/docs/en/settings-refer… Use Claude Code with Chrome Claude Code CLI · in the page chrome …oding tasks in a single workflow: * **Live debugging**: read console errors and DOM state directly, then fix the code that caused them * **Design verification**: build a UI from a Figma mock, then op… Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry Claude Code CLI · in the page claude-apps-gateway …y of those is unreachable or misconfigured, the gateway exits with an error rather than serving traffic in a degraded state. A successful boot doesn't validate the inference path, because Amazon Bedr… Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …hema at boot, so a malformed config fails at start with a field-level error rather than at first use. The [complete example](#complete-example) at the end of this page exercises every section. ## Fi… Claude apps gateway deployment and operations Claude Code CLI · in the page claude-apps-gateway-deploy …traight to [Troubleshooting](#troubleshooting), which is keyed on the error you see. ## Identity provider setup Register a confidential OAuth/OpenID Connect (OIDC) web application with a single redi… Deploy Claude apps gateway on AWS Claude Code CLI · in the page claude-apps-gateway-on-aws …before relying on it. ## Troubleshooting For gateway boot and login errors, see the platform-agnostic [troubleshooting table](https://code.claude.com/docs/en/claude-apps-gateway-deploy.md#troublesho… Deploy Claude apps gateway on Google Cloud Claude Code CLI · in the page claude-apps-gateway-on-gcp …to your environment. ## Troubleshooting For gateway boot and login errors, see the platform-agnostic [troubleshooting table](https://code.claude.com/docs/en/claude-apps-gateway-deploy.md#troublesho… Claude apps gateway spend limits Claude Code CLI · in the page claude-apps-gateway-spend-limits …nd in one Postgres query. A developer over any cap gets a `429` with `error.type: billing_error` and header `x-should-retry: false`. For a cap above `"0"`, the message gives the UTC date that cap res… Use Claude Code in the cloud Claude Code CLI · in the page claude-code-on-the-web …ed config file. The [refusal message](https://code.claude.com/docs/en/errors.md#the-repository-upload-cant-follow-a-git-setting) names the setting and the fix * Sessions created from a bundle can push… Explore the .claude directory Claude Code CLI · in the page claude-directory …urce: \`foo.ts\` -> \`foo.test.ts\` - All API routes return \`{ data, error }\` shape`, docsLink: '/en/memory' }, { id: 'mcp-json', label: '.mcp.json', type: 'fil… Claude Code on Claude Platform on AWS Claude Code CLI · in the page claude-platform-on-aws …the key takes precedence over SigV4 and a stale key produces the same error. Regenerate the key in the AWS Console under **Claude Platform on AWS → API keys** or unset the variable to fall back to you… Let Claude coordinate ongoing work with Projects Claude Code CLI · in the page claude-projects …confirm the repository is listed under **Repository access**. For the error messages a thread or the project reports when access is still wrong, see [Repository access errors](#repository-access-error… claude-tag Claude Code CLI · in the page claude-tag …te(attr, shouldShow ? "visible" : "hidden"); } catch (e) { console.error(e); document.documentElement.setAttribute(attr, "hidden"); } })( {}, "en", [], "data-banner-state", "bannerDism… CLI reference Claude Code CLI · in the page cli-reference …ude -c -p "query"` | Continue via SDK | `claude -c -p "Check for type errors"` | | `claude -r "<session>" "query"` | Resume session by ID or name | `claude -r "auth-refactor" "Finish this PR"` | | `cl… Configure cloud environments Claude Code CLI · in the page cloud-environments …e [what a blocked request looks like](https://code.claude.com/docs/en/errors.md#host-not-allowed-in-a-cloud-session). | | **Full** | Any domain | Whichever level you pick, sessions can still reach th… Code Review Claude Code CLI · in the page code-review # Code Review > Set up automated PR reviews that catch logic errors, security vulnerabilities, and regressions using multi-agent analysis of your full codebase <Note> Code Review is in research pr… Customize Code Review Claude Code CLI · in the page code-review-customize …rollback: incorrect logic, unscoped database queries, PII in logs or error messages, and migrations that aren't backward compatible. Style, naming, and refactoring suggestions are Nit at most. ## Ca… Read and request reviews on a pull request Claude Code CLI · in the page code-review-pull-requests …| scan("^<!-- bughunter-severity: (.*) -->$")[0] | fromjson)? // error("no severity line")' ``` This prints a JSON object with a count per severity and its keys in alphabetical order, for exampl… Commands Claude Code CLI · in the page commands …from the added directory. You can't add most [network paths](/docs/en/errors#working-directory-is-a-network-path), such as `\\server\share`. After a successful add, your [`DirectoryAdded` hooks](/docs… Common workflows Claude Code CLI · in the page common-workflows …igation *** ### Fix bugs efficiently Suppose you've encountered an error message and need to find and fix its source. **1. Share the error with Claude** ```text wrap theme={null} I'm seeing an er… Communications kit Claude Code CLI · in the page communications-kit …de`. *Try it now:* pick the bug you have been avoiding and paste the error message in. 📖 Quickstart → https://code.claude.com/docs/en/quickstart ``` ### Project memory **`/init` and CLAUDE.md** `… Let Claude use your computer from the CLI Claude Code CLI · in the page computer-use …d click through each tab to make sure nothing crashes. Screenshot any error states you find. ``` ## Approve apps per session Enabling the `computer-use` server doesn't grant Claude access to every a… Explore the context window Claude Code CLI · in the page context-window …o to Claude. For PostToolUse hooks, exit code 2 surfaces stderr as an error but cannot block since the tool already ran. Output over 10,000 characters is saved to a file; Claude gets a preview and the… Run Claude Code behind a corporate launcher Claude Code CLI · in the page corporate-launcher …ersions ignore it as an unknown key, apply no launcher, and report no error. > > After deploying either form, use the [Verify step](#set-up-the-launcher) to confirm the running version applies it. ##… Manage costs effectively Claude Code CLI · in the page costs …d request in a session that hadn't loaded usage yet always showed the error with no bars. A message such as `rate limited until 3:14am` in `/usage` means Claude Code can't fetch your plan limits agai… Message your other Claude Code sessions Claude Code CLI · in the page cross-session-messaging …sing to send a cross-session message](https://code.claude.com/docs/en/errors.md#refusing-to-send-a-cross-session-message) lists these checks. The receiving session checks each arriving message agains… Data usage Claude Code CLI · in the page data-usage …th and public-api, with optional telemetry flows carrying metrics and error reports to Anthropic and third-party services. Feedback sent with /feedback goes to Google Cloud Storage and optionally crea… Launch sessions from links Claude Code CLI · in the page deep-links …e%20is%20elevated%20on%20web-gateway.%20Check%20recent%20deploys%2C%20error%20logs%20from%20the%20last%2030%20minutes%2C%20and%20open%20incidents%20in%20Linear.) 3. Post initial findings in #incident.…