Search the documentation
7 pages for --debug-file.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
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…
CLI reference
Claude Code CLI · in the page
cli-reference
…| | `--debug-file <path>` | Write debug logs to a specific file path. Implicitly enables debug mode. Takes pr…
Environment variables
Claude Code CLI · in the page
env-vars
…variable: setting this variable alone does not enable logging. The [`--debug-file`](/docs/en/cli-reference#cli-flags) flag does both at once. Defaults to `~/.claude/debug/<session-id>.txt`…
Hooks reference
Claude Code CLI · in the page
hooks
…nothing to the terminal. To confirm the hooks ran, start with `claude --debug-file <path> --init-only`, replacing `<path>` with a log file location, and check the log for the Setup and SessionStart ho…
Automate actions with hooks
Claude Code CLI · in the page
hooks-guide
…tdout, and stderr, read the debug log. Start Claude Code with `claude --debug-file /tmp/claude.log` to write to a known path, then `tail -f /tmp/claude.log` in another terminal. If you started without…
Enterprise network configuration
Claude Code CLI · in the page
network-config
…session-id>.txt` rather than the terminal, or to a path you set with `--debug-file <path>`. In the log, look for the lines that confirm each file loaded: ```text theme={null} CA certs: Appended extra…
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…