223 pages for debug.

Choose a permission mode Claude Code CLI · in the page permission-modes …hropic-configured classifier model | The configured model. [Check the debug log](#classifier-model-check) to see which | | Runs on Claude Sonnet 4.6 | Sonnet 4.6 | | Has [`ANTHROPIC_DEFAULT_SONNET_MOD… Configure permissions Claude Code CLI · in the page permissions …when an interactive session starts, and in [`claude doctor`](/docs/en/debug-your-config#check-resolved-settings) output. A parameter rule matches when Claude calls the tool with that parameter set to… Test plugins with evals Claude Code CLI · in the page plugin-evals …p` | Off | Keep every run's sandbox directory and print its path, for debugging what Claude produced | ### Run evals in CI In your CI job, run the suite with `--json` to write the result for archivi… Add components to a plugin Claude Code CLI · in the page plugins/components …that exits 0 shows nothing in the transcript, so confirm it ran with [debug logging](/docs/en/hooks.md#debug-hooks) or by what the script itself changes. Hooks in `hooks/hooks.json` and in the `hooks… Create a Claude Code plugin Claude Code CLI · in the page plugins/create …without a marketplace](#develop-without-a-marketplace) and [Test and debug](#test-and-debug). * **Files under `.claude/` already**: do the first-plugin walkthrough once to learn the layout, then foll… Plugin loading reference Claude Code CLI · in the page plugins/loading …lects your settings. Only the log Claude Code writes under `~/.claude/debug/` when you start with `--debug` records `Plugin "<name>" from --plugin-dir overrides installed version` * **A skills-dire… Manage mods for your organization Claude Code CLI · in the page plugins/mods/admin …r ./first-mod`. The mod's hooks don't run, and the transcript and the debug log have the [guard's message](/docs/en/plugins/mods/troubleshoot.md#messages-from-the-built-in-guard), which names the mod… Use the mods API Claude Code CLI · in the page plugins/mods/api …and doesn't start one. If the callback throws, the error goes to the [debug log](/docs/en/plugins/mods/troubleshoot.md#read-the-debug-log) and the timer runs again at the next interval. ### Show some… Create a mod Claude Code CLI · in the page plugins/mods/create …lugins/mods/troubleshoot.md): the reasons a mod does nothing, and the debug log * [Read the source of built-in mods](/docs/en/plugins/mods/overview.md#read-the-source-of-built-in-mods): complete plugi… Draw in the interface with a mod Claude Code CLI · in the page plugins/mods/interface …Text prop "bogusProp" is not allowed; the engine drew its own`. The [debug log](/docs/en/plugins/mods/troubleshoot.md#read-the-debug-log) records it as `ui.render (Pane): a hook returned a tree that… Mods overview Claude Code CLI · in the page plugins/mods/overview …lugins/mods/troubleshoot.md): the reasons a mod does nothing, and the debug log * [Manage mods for your organization](/docs/en/plugins/mods/admin.md): defaults, managed settings, reviewing a mod, and… Mods reference Claude Code CLI · in the page plugins/mods/reference …o Claude Code, listed as `cc-plugin-sec-default` in `/plugin` and the debug log. It loads ahead of every mod a person installs on a machine with managed settings, or in a session whose credential is a… Troubleshoot a mod Claude Code CLI · in the page plugins/mods/troubleshoot …mptom or message to its cause, look up refusal messages, and read the debug log. When a mod's module or one of its hooks fails, Claude Code skips it and the session continues, so a broken mod can loo… Troubleshoot plugins Claude Code CLI · in the page plugins/troubleshooting …#extraknownmarketplaces) declaration of the same name When `(see the debug log)` follows `is added but ignored` in place of a reason, Claude Code refuses the marketplace's name, such as [another spel… How Claude Code uses prompt caching Claude Code CLI · in the page prompt-caching …h-ttl-each-request-gets) Set `FORCE_PROMPT_CACHING_5M=1` when you're debugging cache behavior, comparing the two TTLs, or overriding a longer TTL set in [managed settings](/docs/en/managed-settings.m… Prompt library Claude Code CLI · in the page prompt-library …lows' }, { id: 'find-and-fix-a', sdlc: 'operate', cat: 'Debug', startN: 3, roles: [], prompt: 'the {test} test is failing, find out why and fix it', slots: { test:… Continue local sessions from any device with Remote Control Claude Code CLI · in the page remote-control …rmissions` mode. Requires Claude Code v2.1.273 or later. | | `-d`, `--debug[=<filter>]` | Turn on debug logging for the server, optionally filtered by category. Pass a filter only in the `=` form, suc… Choose a sandbox environment Claude Code CLI · in the page sandbox-environments …n runtime paths such as `/tmp/claude`, `~/.npm/_logs`, and `~/.claude/debug`. Don't take a clean start as proof your settings loaded. * If the settings file exists but is empty, unreadable, or invalid… Configure the sandboxed Bash tool Claude Code CLI · in the page sandboxing …e. A localhost service that doesn't require authentication, such as a debugger, can then act for the command outside the sandbox, and a command that listens on a non-loopback address accepts connectio… Customize sessions in self-hosted environments Claude Code CLI · in the page self-hosted-environments-configuration …ion's working trees. Empty for zero-repo sessions. | | `CLAUDE_RUNNER_DEBUG_LOG_PATH` | Path to the session's debug log, still on disk while the hook runs | | `CLAUDE_RUNNER_API_BASE_URL` | Anthropic… Deploy self-hosted environments to production Claude Code CLI · in the page self-hosted-environments-deploy …s its lifecycle log, including `[runner:fatal]` lines, to stdout, and debug output to stderr, all as plain-text lines rather than JSON. The base directory failures described in the troubleshooting ent… Self-hosted environments reference Claude Code CLI · in the page self-hosted-environments-reference …en/self-hosted-environments-deploy.md#harden-your-deployment). | | `--debug-token-dir <path>` | `SELF_HOSTED_RUNNER_DEBUG_TOKEN_DIR` | unset | Write live tokens to disk for inspection. Debug only; don… Configure server-managed settings Claude Code CLI · in the page server-managed-settings …invalid entry is never presented for approval and never executes. To debug delivery issues, run `claude --debug-file <path>` and search the log for `Remote settings`. Validate a payload change with `… Claude Code settings Claude Code CLI · in the page settings …uns with `-p` print a summary to stderr. * [`claude doctor`](/docs/en/debug-your-config) lists each invalid entry with its source and field. Validate policy changes by running `claude doctor` on a te… All settings Claude Code CLI · in the page settings-reference …ere it's available, for interactive work like rapid iteration or live debugging where you want speed at a higher cost per token. You don't usually edit this key by hand: running `/fast` writes `fastMo… Extend Claude with skills Claude Code CLI · in the page skills …lt-in commands like `/help` and `/compact`, and bundled skills like `/debug` and `/code-review`, see the [commands reference](/docs/en/commands.md). > > **Custom commands have been merged into skills.… Claude Code in Slack Claude Code CLI · in the page slack …l features or refactor code based on team feedback. * **Collaborative debugging**: When team discussions provide crucial context (for example, error reproductions or user reports), Claude can use that… Customize your status line Claude Code CLI · in the page statusline …ur administrator whether this setting applies to you. * Run `claude --debug` to log your script's stderr on every status line invocation, and its exit code on the first invocation in a session * Ask C… Create custom subagents Claude Code CLI · in the page sub-agents …ols": ["Read", "Grep", "Glob", "Bash"], "model": "sonnet" }, "debugger": { "description": "Debugging specialist for errors and test failures.", "prompt": "You are an expert debugger. A… Tools reference Claude Code CLI · in the page tools-reference …When it can't set the cgroup up, commands run without a cap, and the debug log from `claude --debug` says why. * After the first process Claude Code starts has turned the cap on, or has turned it off… Troubleshoot installation and login Claude Code CLI · in the page troubleshoot-install …tion problems such as settings not applying or hooks not firing, see [Debug your configuration](/docs/en/debug-your-config.md). ## Find your error Match the error message or symptom you're seeing to… Troubleshooting Claude Code CLI · in the page troubleshooting …| Settings not applying, hooks not firing, MCP servers not loading | [Debug your configuration](/docs/en/debug-your-config.md) | | Session started in auto mode, or Claude edits files and runs commands… Use Claude Code in VS Code Claude Code CLI · in the page vs-code …th your code or files, whether that's explaining how something works, debugging an issue, or making changes. > [!TIP] > > Claude automatically sees your selected text. Press `Option+K` (Mac) / `Alt+K… Get started with Claude Code in the cloud Claude Code CLI · in the page web-quickstart …ommand that works locally needs a different invocation on Ubuntu. To debug, add `set -x` at the top of the script to see which command failed. For non-critical commands, append `|| true` so they don'… Week 20 · May 11–15, 2026 Claude Code CLI · in the page whats-new/2026-w20 …peed for a higher per-token cost, useful for rapid iteration and live debugging. Pricing is unchanged at \$30/\$150 per MTok, the same as Opus 4.6 fast mode. To pin fast mode to Opus 4.6, set `CLAUDE_… Week 24 · June 8–12, 2026 Claude Code CLI · in the page whats-new/2026-w24 …claude --safe-mode ``` [Test against a clean configuration](/docs/en/debug-your-config.md#test-against-a-clean-configuration) Other wins [`fallbackModel`](/docs/en/model-config#fallback-model-chain… Run parallel sessions with worktrees Claude Code CLI · in the page worktrees …[change how worktrees are created](#customize-worktree-creation), or [debug a failure](#troubleshooting). ## Start Claude in a worktree Pass `--worktree` or `-w` with a name to create an isolated wo… Give Claude access to your tools Claude Documentation · in the page claude-tag/admins/add-connections …mins/connections/pagerduty.md) | Read | Logs, metrics, and errors for debugging and incident work | | Issue tracking | [Linear](/docs/claude-tag/admins/connections/linear.md), [Asana](/docs/claude-tag… Connect Datadog Claude Documentation · in the page claude-tag/admins/connections/datadog …nnecting Datadog lets Claude query metrics, logs, and monitors during debugging in any channel where the connector is on. Claude connects with its own credential, not a person's. Pair this connector… Identity token reference Claude Documentation · in the page claude-tag/admins/federated-access/token-reference …that doesn't echo the token. To read a captured token's claims while debugging, decode its middle segment. JWT payloads are base64url-encoded, so a plain `base64 -d` often fails: ```bash theme={null… Control when Claude Tag responds Claude Documentation · in the page claude-tag/users/when-claude-responds …ow something like `Claude [reviewing the launch checklist]`, `Claude [debugging a failing deploy]`, or `Claude [summarizing customer feedback]`. ## Make a channel quieter If Claude is replying to me… Build an MCP server for Claude Claude Documentation · in the page connectors/building/index …cal server, and preparing test credentials for review. To connect and debug from the Claude Code command line, see the [Claude Code MCP quickstart](https://code.claude.com/docs/en/mcp-quickstart). ##… Troubleshoot MCP Apps Claude Documentation · in the page connectors/building/mcp-apps/troubleshooting # Troubleshoot MCP Apps > Debug MCP Apps in Claude with developer tools on desktop and iOS, and fix invisible apps, large tool results, iOS-only request failures, and ui.domain errors. When an MCP A… Build your first MCP server for Claude Claude Documentation · in the page connectors/building/quickstart …sting.md): add your hosted server to Claude as a custom connector and debug connection failures * [Build your first plugin](/docs/plugins/quickstart.md): bundle your connector with a skill that teache… Test your connector Claude Documentation · in the page connectors/building/testing …ows **Connect** or **Reconnect** instead, sign-in didn't finish, and [Debug connection failures](#debug-connection-failures) covers the usual causes * **Your tools**: open the connector's page and loo… Available settings Claude Documentation · in the page government/config/settings …**, **Errors only**, **Warnings and errors**, **Informational**, or **Debug**. | **Errors only** | Claude Desktop | | **Telemetry resource attributes** | Labels added to every telemetry record each pr… Use Claude for Excel Claude Documentation · in the page office-agents/excel …workbooks, adjust assumptions while preserving formula relationships, debug errors, and build or populate models, all without leaving Excel. > [!NOTE] > > Claude for Excel is generally available to P… Use Claude for M365 with third-party platforms Claude Documentation · in the page office-agents/third-party-platforms …ervers, skills, and dynamic config. | | `/claude-for-msft-365-install:debug` | Diagnoses deployment issues: stale config after a manifest update, connection failures, an add-in that does not appear, s… Plugin structure and testing Claude Documentation · in the page plugins/build …gainst [Check what each app loads](#check-what-each-app-loads) before debugging. An agent that never appears in chat, or a local server that chat doesn't start, is the surface behaving as designed. #… Configuration reference Claude Documentation · in the page third-party/claude-desktop/configuration …rver side. Desktop offers its own Developer menu, developer tools and debugger on the person's computer. > **More detail** > > When on (default), a user can turn on **Developer Mode** (Help → Trouble…