762 pages for error.

Connect to external tools with MCP Claude Code CLI · in the page agent-sdk/mcp …transport types, tool search for large tool sets, authentication, and error handling. The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) is an open standar… Modifying system prompts Claude Code CLI · in the page agent-sdk/modifying-system-prompts …reviewed. Unattended coding automation, like a CI job that fixes lint errors or reviews diffs, still fits the preset because the work itself is what the preset is written for. * **Different identity**… Observability with OpenTelemetry Claude Code CLI · in the page agent-sdk/observability …| | Log events | Structured records for each prompt, API request, API error, and tool result | `OTEL_LOGS_EXPORTER` | | Traces | Spans for each inter… Plugins in the SDK Claude Code CLI · in the page agent-sdk/plugins ….message.content); } } } runWithPlugin().catch(console.error); ``` ```python Python theme={null} #!/usr/bin/env python3 """Example demonstrating how to use plugins with the Age… Agent SDK reference - Python Claude Code CLI · in the page agent-sdk/python …hon installs, running `pip install` against system Python fails with `error: externally-managed-environment`. ```bash theme={null} python3 -m venv .venv source .venv/bin/activate pip install claude-a… Quickstart Claude Code CLI · in the page agent-sdk/quickstart …If PowerShell blocks `Activate.ps1` with an execution policy error, run `Set-ExecutionPolicy -Scope Process RemoteSigned` first. </Tab> </Tabs> <Note> Both the TypeScript… Securely deploying AI agents Claude Code CLI · in the page agent-sdk/secure-deployment …pt injection (instructions embedded in content they process) or model error. Claude models are designed to resist this; see the [model overview](https://platform.claude.com/docs/en/about-claude/models… Persist sessions to external storage Claude Code CLI · in the page agent-sdk/session-storage …oreEntry] | None: ... # Optional — omit or raise NotImplementedError async def list_sessions( self, project_key: str ) -> list[SessionStoreListEntry]: ... async def… 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 …for example when a file it reads is missing, the stream ends with an error that reads `Claude Code process aborted by user` instead of the original error, so check the code inside your generator firs… 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 …lt, and such a call fails with [`subagent_type is required`](/docs/en/errors#subagent-type-is-required). </Note> ## What subagents inherit Unless the subagent is a [fork](/docs/en/sub-agents#fork-th… 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 …ess") { 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. It adds no names of its own. To keep the code your application loads small, `/core`… 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 …| | Failed | Red | The task ended with an error… Claude Code on Amazon Bedrock Claude Code CLI · in the page amazon-bedrock …on failed to authenticate with a `Session token not found or invalid` error. **Option D: AWS Management Console credentials** ```bash theme={null} aws login ``` [Learn more](https://docs.aws.amazon… Share session output as artifacts Claude Code CLI · in the page artifacts …acter `U+FFFD`, is [refused with the line and column to fix](/docs/en/errors#the-source-file-is-not-valid-utf-8-text).… Authentication Claude Code CLI · in the page authentication …fails, requests fail with [Anthropic profile login expired](/docs/en/errors#anthropic-profile-login-expired) until you sign in again. You don't get the choice on every machine. Claude Code creates a… Configure auto mode Claude Code CLI · in the page auto-mode-config …on. When the classifier produces [no verdict on the action](/docs/en/errors#auto-mode-cannot-determine-the-safety-of-an-action), because a safety check separate from auto mode refused the classifier'… Best practices for Claude Code Claude Code CLI · in the page best-practices …ailing"* | *"the build fails with this error: \[paste error]. fix it and verify the build succeeds. address the root cause, don't suppress the error"*… 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.… Claude Code changelog Claude Code CLI · in the page changelog …in-dir` load-failure entries in the stream-json `system/init` `plugin_errors`, naming the directory that did not load * Added an opt-in `load_test_mode` block to the Claude apps gateway config: requ… Push events into a running session with channels Claude Code CLI · in the page channels …eference#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 …snapshots are gone can fail with [`No files were restored`](/docs/en/errors#no-files-were-restored). To keep snapshots longer, set [`cleanupPeriodDays`](/docs/en/settings-reference#cleanupperioddays)… 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… 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. <Note> **Deploy on your private network.** Claude Code only connects to a gateway whose address is private. This… 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](/docs/en/claude-apps-gateway-deploy#troubleshooting). The entries below… 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](/docs/en/claude-apps-gateway-deploy#troubleshooting). The entries below… 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`. The message names the period and reset time, such as `spend limit… Use Claude Code in the cloud Claude Code CLI · in the page claude-code-on-the-web …ngs at claude.ai/admin-settings/claude-code. </Note> #### Output and errors On success, the command prints the session ID and a link to view the session: ``` Sent to cloud session. Session ID: sess… 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… CLI reference Claude Code CLI · in the page cli-reference …| `claude -c -p "Check for type errors"` | | `claude -r "<session>" "query"` | Resume session by ID or name… 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… 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 …</Tip> *** ### Fix bugs efficiently Suppose you've encountered an error message and need to find and fix its source. <Steps> <Step title="Share the error with Claude"> ```text wrap theme={n… 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. </No… 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. ### Analyze your usage patterns Run [`/insights`](/docs/en/commands#all-commands) for a report on how you wo…