44 pages for --debug.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
errors
Claude Developer Platform · in the page
api/errors
…`` ```bash CLI # The request-id header is printed to stderr with --debug: ant --debug messages create \ --model claude-sonnet-5 \ --max-tokens 1024 \ --message '{role: user, content…
claude-platform-on-aws
Claude Developer Platform · in the page
build-with-claude/claude-platform-on-aws
…y authentication). export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY" # --debug prints the HTTP response, including the X-Amzn-Requestid and # Request-Id headers, to stderr ant --debug messages crea…
using
Claude Developer Platform · in the page
cli-sdks-libraries/cli/using
…`--workspace-id`, which names the workspace they manage instead. | | `--debug` | Print full HTTP request and response to stderr…
workspaces
Claude Developer Platform · in the page
manage-claude/workspaces
…"user", "content": "Hello, Claude"}] }' ``` ```bash CLI # --debug prints the HTTP response, including the Anthropic-Workspace-Id # header, to stderr ant --debug messages create \ -…
Claude Code changelog
Claude Code CLI · in the page
changelog
…er finishing * Fixed `claude --help` text for `--tools`, `--resume`, `--debug`, `--json-schema`, `--disable-slash-commands`, `--system-prompt-snapshot` and `claude update` to match actual behavior * F…
Channels reference
Claude Code CLI · in the page
channels-reference
…or in your server file. To see the stderr trace, restart with `claude --debug --dangerously-load-development-channels server:webhook` and check the debug log at `~/.claude/debug/<session-id>.txt`. * *…
Claude apps gateway deployment and operations
Claude Code CLI · in the page
claude-apps-gateway-deploy
…d what changed recently * **Login issue**: the developer runs `claude --debug-file ./claude-debug.txt`, reproduces, and sends that file plus the gateway's audit log for the same window * **Inference i…
Explore the .claude directory
Claude Code CLI · in the page
claude-directory
…ogs, written while debug logging is on, such as when you start with [`--debug`](/docs/en/cli-reference#cli-flags) or run `/debug` | | `paste-cache/` | Contents of large pastes | | `image-cache/<sessio…
CLI reference
Claude Code CLI · in the page
cli-reference
…ons` | | `--debug` | Enable debug mode with optional category filtering, such as `--debug='mcp,startup…
Commands
Claude Code CLI · in the page
commands
…log. Debug logging is off by default unless you started with `claude --debug`, so running `/debug` mid-session starts capturing logs from that point forward. Optionally describe the issue to focus th…
Manage costs effectively
Claude Code CLI · in the page
costs
…appears under PreToolUse. You can also start Claude Code with `claude --debug-file ./claude-debug.txt` and ask Claude to run `npm test`. When the hook rewrites the command, that log file contains a `m…
Message your other Claude Code sessions
Claude Code CLI · in the page
cross-session-messaging
…ows `unavailable` and the reason in its `Peer address` row, and the [`--debug`](/docs/en/cli-reference#cli-flags) log records the full refusal. Alongside the socket's path, Claude Code exports a per-…
Debug your configuration
Claude Code CLI · in the page
debug-your-config
…ct **Reconnect** from `/mcp`. If the count stays at zero, run `claude --debug=mcp` and read the server's stderr in the debug log at `~/.claude/debug/<session-id>.txt`. For configuration locations and…
Environment variables
Claude Code CLI · in the page
env-vars
…h, not a directory. 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`]…
Error reference
Claude Code CLI · in the page
errors
…its-name-is-reserved) | | `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Configuration warnings](#skill-or-command-name-refused) | | `Ignoring N p…
Claude Code GitHub Actions
Claude Code CLI · in the page
github-actions
…ated list of allowed tools. The `--allowed-tools` alias also works * `--debug`: enable debug output ## Upgrade from beta If your workflows still reference `anthropics/claude-code-action@beta`, updat…
Claude Code GitLab CI/CD
Claude Code CLI · in the page
gitlab-ci-cd
…ptEdits --allowedTools "Bash Read Edit Write mcp__gitlab" --debug ``` After adding the job and your `ANTHROPIC_API_KEY` variable, test by running the job manually from **CI/CD** → **Pipel…
Hooks reference
Claude Code CLI · in the page
hooks
…g logging on: 1. Start a new session from your shell with `claude --debug`. If you don't start sessions from a shell, type [`/debug`](/docs/en/commands#all-commands) first in the new session inste…
Automate actions with hooks
Claude Code CLI · in the page
hooks-guide
…r, enable [debug logging](/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…
Interactive mode
Claude Code CLI · in the page
interactive-mode
…start Claude Code To find out which of these happened, start `claude --debug` with spell checking on and type a word. Then look for the `[spellcheck]` lines in the debug log at `~/.claude/debug/<sess…
Customize keyboard shortcuts
Claude Code CLI · in the page
keybindings
…ts * Duplicate bindings in the same context Start Claude Code with [`--debug`](/docs/en/cli-reference#cli-flags) to see the details.
Connect Claude Code to an LLM gateway
Claude Code CLI · in the page
llm-gateway-connect
…when it doesn't supply one. To confirm discovery ran, start `claude --debug` and look for the `[gatewayDiscovery]` lines in the debug log at `~/.claude/debug/<session-id>.txt`. The first time discov…
Claude Code gateway compatibility guide
Claude Code CLI · in the page
llm-gateway-protocol
…tes a `[gatewayDiscovery] skipped` line to the debug log of a `claude --debug` session. If you supply a credential only through `ANTHROPIC_CUSTOM_HEADERS`, Claude Code still skips discovery. Claude C…
Connect Claude Code to tools via MCP
Claude Code CLI · in the page
mcp
…aude Code names it in a debug-log line. To read the line, run `claude --debug-file /tmp/claude-debug.log` and search that file for `never expanded toward a remote server`. #### How references appear…
How Claude remembers your project
Claude Code CLI · in the page
memory
…e frontmatter and loads the rule as if it had no `paths`. Run `claude --debug` to see the parse error. #### Share rules across projects with symlinks The `.claude/rules/` directory supports symlinks…
Model configuration
Claude Code CLI · in the page
model-config
…able model, enforcement is skipped with a warning visible only under `--debug`. Keep at least one guaranteed-available entry in the list to avoid this. Deploy both keys together in the highest-ranked…
Monitoring
Claude Code CLI · in the page
monitoring-usage
…er_prompt` event. If nothing arrives, start Claude Code with `claude --debug-file <path>` and check the log it writes to that path. Claude Code reports failures from the exporters you configure as `[…
Enterprise network configuration
Claude Code CLI · in the page
network-config
…t, start Claude Code with debug logging: ```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-…
Output styles
Claude Code CLI · in the page
output-styles
…style still loads under its file name with no fields set; run `claude --debug` to see the parse error. | Field | Required | Description | | :- | :- | :- | | `name` | No | Name of the output style, sh…
Choose a permission mode
Claude Code CLI · in the page
permission-modes
…e classifier used From your shell, start an auto mode session with [`--debug-file`](/docs/en/cli-reference#cli-flags): ```bash theme={null} claude --permission-mode auto --debug-file classifier-debu…
Add components to a plugin
Claude Code CLI · in the page
plugins/components
…`. When the binary isn't there, the server fails to start and `claude --debug` logs `LSP server <name> failed to start` * **Extension conflicts**: when two enabled servers claim the same extension, th…
Plugin loading reference
Claude Code CLI · in the page
plugins/loading
…log Claude Code writes under `~/.claude/debug/` when you start with `--debug` records `Plugin "<name>" from --plugin-dir overrides installed version` * **A skills-directory plugin**: replaced with…
Manage mods for your organization
Claude Code CLI · in the page
plugins/mods/admin
…policy on a test machine, in your shell start a session with `claude --debug` and read the debug log: * **Your mod**: its `hooks module` line has `tier prepend` * **A mod the user installed**: a lin…
Troubleshoot a mod
Claude Code CLI · in the page
plugins/mods/troubleshoot
…#read-the-debug-log) only. To get one, start the session with `claude --debug`. * **A `claude -p` run with `--plugin-dir`**: stderr, in the default text output format. A refusal by another mod goes to…
Troubleshoot plugins
Claude Code CLI · in the page
plugins/troubleshooting
…ed. To read the error the server printed while starting, run `claude --debug` and open the log at `~/.claude/debug/<session-id>.txt`. The `--debug` flag doesn't print to the terminal. A server entry…
Continue local sessions from any device with Remote Control
Claude Code CLI · in the page
remote-control
…Permissions` 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, s…
Self-hosted environments reference
Claude Code CLI · in the page
self-hosted-environments-reference
…s/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; d…
Configure server-managed settings
Claude Code CLI · in the page
server-managed-settings
…r 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 doctor` on a test machine be…
All settings
Claude Code CLI · in the page
settings-reference
…that turn telemetry off, and logs a warning you can see with `claude --debug`. They include: * Variables that choose where Claude Code stores or writes its own files: `CLAUDE_CONFIG_DIR`, `CLAUDE_…
Extend Claude with skills
Claude Code CLI · in the page
skills
…. To find out which name Claude Code refused, start it with [`claude --debug`](/docs/en/cli-reference#cli-flags) from your shell and search the [debug log](/docs/en/debug-your-config.md) for `[names]…
Customize your status line
Claude Code CLI · in the page
statusline
…your 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…
Create custom subagents
Claude Code CLI · in the page
sub-agents
…* To find a misspelled field in a subagent that loaded, run [`claude --debug`](/docs/en/cli-reference#cli-flags) in your shell and search the debug log at `~/.claude/debug/<session-id>.txt` for `does…
Tools reference
Claude Code CLI · in the page
tools-reference
…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 because of an off valu…
Troubleshoot installation and login
Claude Code CLI · in the page
troubleshoot-install
…detects Git Bash as if it were unset, logging a warning visible with `--debug`. A path that doesn't exist gets the same fallback and warning. Before v2.1.219, Claude Code used any existing file as the…