59 pages for /debug.

Debugging Model Context Protocol · path docs/2024-11-05/tools/debugging Debugging Model Context Protocol · path docs/2025-03-26/tools/debugging Debugging Model Context Protocol · path docs/2025-06-18/tools/debugging Debugging Model Context Protocol · path docs/2025-11-25/tools/debugging Debugging Model Context Protocol · path docs/2026-07-28/tools/debugging Debugging Model Context Protocol · path docs/draft/tools/debugging Channels reference Claude Code CLI · in the page channels-reference …lopment-channels server:webhook` and check the debug log at `~/.claude/debug/<session-id>.txt`. * **`curl` fails with "connection refused"**: the port is either not bound yet or a stale process from a… Checkpointing Claude Code CLI · in the page checkpointing …ory. To see which paths a restore skips, turn on debug logging with `/debug` before you restore: the debug log at `~/.claude/debug/<session-id>.txt` names each skipped path. For every skip reason and… Explore the .claude directory Claude Code CLI · in the page claude-directory …, or file isn't taking effect, see [Debug your configuration](/docs/en/debug-your-config) for the inspection commands and a symptom-first lookup table. ## Application data Beyond the config you auth… Commands Claude Code CLI · in the page commands …at diagnoses installation and configuration issues and can fix them, `/debug` diagnoses runtime issues, and `/feedback` reports a bug with session context attached. ## All commands The table below l… Debug your configuration Claude Code CLI · in the page debug-your-config …content Claude can derive from the codebase, with proposed fixes | | `/debug [issue]` | Enables debug logging for the session and prompts Claude to diagnose using the log output and settings paths | |… Environment variables Claude Code CLI · in the page env-vars …rectory. Requires debug mode to be enabled separately via `--debug`, `/debug`, or the `DEBUG` environment variable: setting this variable alone does not enable logging. The [`--debug-file`](/docs/en/c… Error reference Claude Code CLI · in the page errors …shell, Claude Code writes this message to the debug log at `~/.claude/debug/<session-id>.txt`: ```text theme={null} Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters an… Extend Claude Code Claude Code CLI · in the page features-overview …led skills](/docs/en/commands.md) like `/code-review`, `/batch`, and `/debug` that work without setup. You can also create your own. **When:** Depends on the skill's configuration. By default, descri… Glossary Claude Code CLI · in the page glossary …aybooks included with Claude Code, such as `/batch`, `/code-review`, `/debug`, and `/loop`. Unlike built-in commands, which execute fixed logic, bundled skills give Claude a detailed prompt and let it… Hooks reference Claude Code CLI · in the page hooks …th `claude --debug`. If you don't start sessions from a shell, type [`/debug`](/docs/en/commands#all-commands) first in the new session instead. 2. Invoke the same skills in the same order, includ… Automate actions with hooks Claude Code CLI · in the page hooks-guide …](/docs/en/hooks.md#debug-hooks) with `claude --debug` or by running `/debug` mid-session. #### Structured JSON output Exit codes only let you block or stay silent. For more control, exit 0 and prin… Interactive mode Claude Code CLI · in the page interactive-mode …inutes and no turn or subagent is running * The [debug log](/docs/en/debug-your-config.md) says why tasks were stopped, or why a pressure event left them running * Set [`CLAUDE_CODE_DISABLE_BG_SHE… Connect Claude Code to an LLM gateway Claude Code CLI · in the page llm-gateway-connect …look for the `[gatewayDiscovery]` lines in the debug log at `~/.claude/debug/<session-id>.txt`. The first time discovery succeeds, Claude Code logs how many models it cached, and it logs again only wh… Deploy managed settings Claude Code CLI · in the page managed-settings …runs with `-p` print a summary to stderr. * [`claude doctor`](/docs/en/debug-your-config) lists each invalid entry with its source and field. #### Keys that fail closed When a managed source sets a… How Claude remembers your project Claude Code CLI · in the page memory …cificity. ## Related resources * [Debug your configuration](/docs/en/debug-your-config.md): diagnose why CLAUDE.md or settings aren't taking effect * [Skills](/docs/en/skills.md): package repeatable… Monitoring Claude Code CLI · in the page monitoring-usage …with [`--debug`](/docs/en/cli-reference#cli-flags) or after running `/debug` in the session * stderr, in non-interactive sessions started with `-p` #### Refresh behavior The headers helper script r… Enterprise network configuration Claude Code CLI · in the page network-config …`bash theme={null} claude --debug ``` Debug output goes to `~/.claude/debug/<session-id>.txt` rather than the terminal, or to a path you set with `--debug-file <path>`. In the log, look for the lines… Output styles Claude Code CLI · in the page output-styles …ngside skills, hooks, and agents * [Debug your configuration](/docs/en/debug-your-config.md): diagnose why an output style isn't taking effect 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 t… Plugin loading reference Claude Code CLI · in the page plugins/loading …flects 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-dir… Troubleshoot plugins Claude Code CLI · in the page plugins/troubleshooting …name-is-another-spelling-of-a-reserved-name). The [debug log](/docs/en/debug-your-config.md) names the entry. **What to do:** * Follow the fix in the message. In your shell, run `claude plugin marke… Choose a sandbox environment Claude Code CLI · in the page sandbox-environments …in 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 invali… Claude Code settings Claude Code CLI · in the page settings …runs 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 t… All settings Claude Code CLI · in the page settings-reference …variable the launch environment already sets. The [debug log](/docs/en/debug-your-config.md) names each ignored variable. * To cancel a shell export, set the variable to `""`. Claude Code treats an em… Extend Claude with skills Claude Code CLI · in the page skills …ilt-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… Create custom subagents Claude Code CLI · in the page sub-agents …erence#cli-flags) in your shell and search the debug log at `~/.claude/debug/<session-id>.txt` for `does not recognize or apply`. The debug log names up to five top-level fields in the subagent's file… Troubleshoot installation and login Claude Code CLI · in the page troubleshoot-install …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 a fix: | What you see | Solution… Troubleshooting Claude Code CLI · in the page troubleshooting …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 without asking | [Which mode a se… 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-chai… Build an MCP client Model Context Protocol · in the page docs/2024-11-05/develop/build-client …run a command similar to: `cargo run -- ../weather-server-rust/target/debug/weather` The client will: 1. Start and connect to the specified MCP server 2. List the tools available from that server 3… Build an MCP server Model Context Protocol · in the page docs/2024-11-05/develop/build-server …do?** > > Please refer to our [debugging guide](/docs/2024-11-05/tools/debugging) for better debugging tools and more detailed guidance. > **Weather API Issues** > > **Error: Failed to retrieve grid… Connect to local MCP servers Model Context Protocol · in the page docs/2024-11-05/develop/connect-local-servers …do?** > > Please refer to our [debugging guide](/docs/2024-11-05/tools/debugging) for better debugging tools and more detailed guidance. > **ENOENT error and `$\{APPDATA\}` in paths on Windows** > >… MCP Inspector Model Context Protocol · in the page docs/2024-11-05/tools/inspector …ugging MCP servers. While the [Debugging Guide](/docs/2024-11-05/tools/debugging) covers the Inspector as part of the overall debugging toolkit, this document provides a detailed exploration of the In… Build an MCP client Model Context Protocol · in the page docs/2025-03-26/develop/build-client …run a command similar to: `cargo run -- ../weather-server-rust/target/debug/weather` The client will: 1. Start and connect to the specified MCP server 2. List the tools available from that server 3… Build an MCP server Model Context Protocol · in the page docs/2025-03-26/develop/build-server …do?** > > Please refer to our [debugging guide](/docs/2025-03-26/tools/debugging) for better debugging tools and more detailed guidance. > **Weather API Issues** > > **Error: Failed to retrieve grid… Connect to local MCP servers Model Context Protocol · in the page docs/2025-03-26/develop/connect-local-servers …do?** > > Please refer to our [debugging guide](/docs/2025-03-26/tools/debugging) for better debugging tools and more detailed guidance. > **ENOENT error and `$\{APPDATA\}` in paths on Windows** > >… MCP Inspector Model Context Protocol · in the page docs/2025-03-26/tools/inspector …ugging MCP servers. While the [Debugging Guide](/docs/2025-03-26/tools/debugging) covers the Inspector as part of the overall debugging toolkit, this document provides a detailed exploration of the In… Build an MCP client Model Context Protocol · in the page docs/2025-06-18/develop/build-client …run a command similar to: `cargo run -- ../weather-server-rust/target/debug/weather` The client will: 1. Start and connect to the specified MCP server 2. List the tools available from that server 3… Build an MCP server Model Context Protocol · in the page docs/2025-06-18/develop/build-server …do?** > > Please refer to our [debugging guide](/docs/2025-06-18/tools/debugging) for better debugging tools and more detailed guidance. > **Weather API Issues** > > **Error: Failed to retrieve grid… Connect to local MCP servers Model Context Protocol · in the page docs/2025-06-18/develop/connect-local-servers …do?** > > Please refer to our [debugging guide](/docs/2025-06-18/tools/debugging) for better debugging tools and more detailed guidance. > **ENOENT error and `$\{APPDATA\}` in paths on Windows** > >… MCP Inspector Model Context Protocol · in the page docs/2025-06-18/tools/inspector …ugging MCP servers. While the [Debugging Guide](/docs/2025-06-18/tools/debugging) covers the Inspector as part of the overall debugging toolkit, this document provides a detailed exploration of the In… Build an MCP client Model Context Protocol · in the page docs/2025-11-25/develop/build-client …run a command similar to: `cargo run -- ../weather-server-rust/target/debug/weather` The client will: 1. Start and connect to the specified MCP server 2. List the tools available from that server 3… Build an MCP server Model Context Protocol · in the page docs/2025-11-25/develop/build-server …do?** > > Please refer to our [debugging guide](/docs/2025-11-25/tools/debugging) for better debugging tools and more detailed guidance. > **Weather API Issues** > > **Error: Failed to retrieve grid… Connect to local MCP servers Model Context Protocol · in the page docs/2025-11-25/develop/connect-local-servers …do?** > > Please refer to our [debugging guide](/docs/2025-11-25/tools/debugging) for better debugging tools and more detailed guidance. > **ENOENT error and `$\{APPDATA\}` in paths on Windows** > >…