50 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 Authentication Claude Code CLI · in the page authentication …profile auth` line with the source name to the debug log at `~/.claude/debug/<session-id>.txt`. When Claude Code passes over a `user_oauth` active profile because you have a working `/login` credentia… Channels reference Claude Code CLI · in the page channels-reference …or import error in your server file; check the debug log at `~/.claude/debug/<session-id>.txt` for the stderr trace. * **`curl` fails with "connection refused"**: the port is either not bound yet… 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… Extend Claude Code Claude Code CLI · in the page features-overview …undled skills](/docs/en/commands) like `/code-review`, `/batch`, and `/debug` that work out of the box. You can also create your own. **When:** Depends on the skill's configuration. By default, d… 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… Automate actions with hooks Claude Code CLI · in the page hooks-guide …ing](/docs/en/hooks#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 …Then look for the `[spellcheck]` lines in the debug log at `~/.claude/debug/<session-id>.txt`. One line names the program Claude Code started, or lists the ones it looked for and didn't find. Later l… 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`: a success logs how many models were cached, and a `404`, timeout, or redirect is recorded there too. For… 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 A few enforcement keys aren't… How Claude remembers your project Claude Code CLI · in the page memory …cificity. ## Related resources * [Debug your configuration](/docs/en/debug-your-config): diagnose why CLAUDE.md or settings aren't taking effect * [Skills](/docs/en/skills): package repeatable workf… 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): 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… 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. * When you pass `--settings`, the runtime refuses to start if the… 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… 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). **Custom commands have been merged into skills.**… 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). ## Find your error Match the error message or symptom you're seeing to a fix: | What you see… Troubleshooting Claude Code CLI · in the page troubleshooting …| [Debug your configuration](/docs/en/debug-your-config) | | Session started in auto mode, or Claude edits files and runs comman… Week 24 · June 8–12, 2026 Claude Code CLI · in the page whats-new/2026-w24 …e-mode ``` <a className="digest-feature-link" href="/docs/docs/en/debug-your-config#test-against-a-clean-configuration">Test against a clean configuration</a> </div> <div className="digest-wins"… 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` </Note> The client will: 1. Start and connect to the specified MCP server 2. List the tools avai… Build an MCP server Model Context Protocol · in the page docs/2024-11-05/develop/build-server …o?** Please refer to our [debugging guide](/docs/2024-11-05/tools/debugging) for better debugging tools and more detailed guidance. </Accordion> <Accordion title="Weather API Issues"> **… 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. </Accordion> <Accordion title="ENOENT error and `${APPDATA… 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` </Note> The client will: 1. Start and connect to the specified MCP server 2. List the tools avai… Build an MCP server Model Context Protocol · in the page docs/2025-03-26/develop/build-server …o?** Please refer to our [debugging guide](/docs/2025-03-26/tools/debugging) for better debugging tools and more detailed guidance. </Accordion> <Accordion title="Weather API Issues"> **… 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. </Accordion> <Accordion title="ENOENT error and `${APPDATA… 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` </Note> The client will: 1. Start and connect to the specified MCP server 2. List the tools avai… Build an MCP server Model Context Protocol · in the page docs/2025-06-18/develop/build-server …o?** Please refer to our [debugging guide](/docs/2025-06-18/tools/debugging) for better debugging tools and more detailed guidance. </Accordion> <Accordion title="Weather API Issues"> **… 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. </Accordion> <Accordion title="ENOENT error and `${APPDATA… 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` </Note> The client will: 1. Start and connect to the specified MCP server 2. List the tools avai… Build an MCP server Model Context Protocol · in the page docs/2025-11-25/develop/build-server …o?** Please refer to our [debugging guide](/docs/2025-11-25/tools/debugging) for better debugging tools and more detailed guidance. </Accordion> <Accordion title="Weather API Issues"> **… 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. </Accordion> <Accordion title="ENOENT error and `${APPDATA… MCP Inspector Model Context Protocol · in the page docs/2025-11-25/tools/inspector …ugging MCP servers. While the [Debugging Guide](/docs/2025-11-25/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/2026-07-28/develop/build-client …run a command similar to: `cargo run -- ../weather-server-rust/target/debug/weather` </Note> The client will: 1. Start and connect to the specified MCP server 2. List the tools avai… Build an MCP server Model Context Protocol · in the page docs/2026-07-28/develop/build-server …o?** Please refer to our [debugging guide](/docs/2026-07-28/tools/debugging) for better debugging tools and more detailed guidance. </Accordion> <Accordion title="Weather API Issues"> **… Connect to local MCP servers Model Context Protocol · in the page docs/2026-07-28/develop/connect-local-servers …do?"> Please refer to our [debugging guide](/docs/2026-07-28/tools/debugging) for better debugging tools and more detailed guidance. </Accordion> <Accordion title="ENOENT error and `${APPDATA… MCP Inspector Model Context Protocol · in the page docs/2026-07-28/tools/inspector …<Card title="Debugging guide" icon="bug" href="/docs/2026-07-28/tools/debugging"> Broader debugging strategies beyond the Inspector. </Card> </CardGroup>