14 pages for --debug-file.

Claude Code changelog Claude Code CLI · in the page changelog …sandbox * Fixed memory growth under heavy debug logging (`--debug`, `--debug-file`), and a hang on exit when the debug log is on a disk or network mount that stops accepting writes * Fixed memory gro… 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… 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… 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 …ebug log](/docs/en/hooks#debug-hooks). 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… 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… 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 …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… 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… Troubleshoot a mod Claude Code CLI · in the page plugins/mods/troubleshoot …o write one, in your shell start Claude Code with `--debug`, or with `--debug-file <path>` to choose where it goes: ```bash theme={null} claude --debug-file ./mod-debug.log --plugin-dir ./first-mod `… Continue local sessions from any device with Remote Control Claude Code CLI · in the page remote-control …as `--debug=api,hooks`. Requires Claude Code v2.1.282 or later. | | `--debug-file <path>` | Write debug logs to the given file. | | `--verbose` | Show detailed connection and session logs. | | `--san… 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…