{"name":"--debug","slug":"debug","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Enable debug mode with optional category filtering, such as `--debug='mcp,startup'` or `--debug='!1p'`. The filter binds only in the `=` form; a space-separated filter enables debug mode without filtering","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":{"version":"2.1.247","released_at":"2026-08-26 18:02:01","spans":9}},"aliases":[],"entries":[{"version":"2.1.305","anchor":"oauth-authorize-url-can-request-an-extra-scope","heading":"Some failed logins now suggest running with --debug","line":"One kind of login failure now tells you to run with `--debug` to see the underlying error, and sign-in links can ask for one extra scope","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text, named in this entry"},{"version":"2.1.305","anchor":"sign-in-flow-gets-a-paste-code-fallback-when-the-local-callb","heading":"Sign-in can fall back to pasting a code from the browser","line":"If Claude Code cannot receive the browser sign-in automatically, it now asks you to paste the code shown after signing in","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.304","anchor":"usage-rate-limit-message-shows-hold-time","heading":"\/usage now says when you can try again after a rate limit","line":"When \/usage is rate limited, its message now shows when it can be tried again instead of saying \"try again in a moment\"","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.299","anchor":"warning-when-skill-or-command-names-are-refused","heading":"Claude Code now warns when skill or command names are refused","line":"A new high-priority notice reports how many skill or command names were refused and tells you to rerun with `--debug` to see which","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"claude-mcp-serve-gains-an-http-transport-port-and-ses","heading":"claude mcp serve gains an HTTP mode, limited to remote cloud sessions","line":"In remote cloud sessions only, `claude mcp serve` can now listen over HTTP with `--transport`, `--port` and `--session-tunnel`","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.290","anchor":"cloud-error-messages-are-sanitized","heading":"Unusual or very long cloud error messages are hidden unless you use --debug","line":"Error text from the cloud service is now hidden when it is too long or has unusual characters, and --debug shows it","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text, named in this entry"},{"version":"2.1.290","anchor":"cloud-session-move-errors-surface-server-message-via-shared","heading":"Clearer errors when moving a session to the cloud fails","line":"A failed move of a session to the cloud now shows the server's message, falling back to a hint about --debug if it is too generic","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text, named in this entry"},{"version":"2.1.286","anchor":"claude-test-launch-failure-message-replaces-bundled-skill-as","heading":"Error message for when Claude Test cannot connect its browser helper","line":"Claude Code contains an error saying Claude Test did not start because its browser helper did not connect, with steps to try","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text"},{"version":"2.1.282","anchor":"claude-remote-control-accepts-debug-d-and-debug-in","heading":"claude remote-control accepts --debug and -d instead of failing","line":"`claude remote-control` no longer stops with an unknown-argument error when given `--debug`, `-d` or `--debug=\u2026`","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text, named in this entry"},{"version":"2.1.281","anchor":"recap-failure-reports-an-outcome","heading":"Recap failure reports an outcome","line":"A failed recap now records its outcome as failed, alongside the \"Couldn't generate a recap\" message","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"}],"entries_total":24,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"api","path":"api\/errors","title":"errors","documented":false},{"source":"api","path":"build-with-claude\/claude-platform-on-aws","title":"claude-platform-on-aws","documented":false},{"source":"api","path":"cli-sdks-libraries\/cli\/using","title":"using","documented":false},{"source":"api","path":"manage-claude\/workspaces","title":"workspaces","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"channels-reference","title":"Channels reference","documented":false},{"source":"claude-code","path":"claude-apps-gateway-deploy","title":"Claude apps gateway deployment and operations","documented":false},{"source":"claude-code","path":"claude-directory","title":"Explore the .claude directory","documented":false},{"source":"claude-code","path":"commands","title":"Commands","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/debug","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}