Troubleshoot¶
These commands find and report problems in the installation, the configuration and the session.
Diagnose¶
| Command | Aliases | Description |
|---|---|---|
/doctor [prompt-audit [path]] |
/checkup |
Skill. Find problems in the installation, configuration, extensions and CLAUDE.md. Claude applies the fixes after you approve. prompt-audit audits your instructions |
/debug [description] |
Skill. Turn on debug logs for the session and read them to find a problem. The description sets the focus | |
/heapdump |
Write a JavaScript heap snapshot and a memory report to ~/Desktop or your home directory. Hidden from the menu |
Do not share the .heapsnapshot file, because it contains your full conversation and credentials. Attach only the -diagnostics.json file to a memory report.
Report¶
| Command | Aliases | Description |
|---|---|---|
/bug [report] |
/share |
Report a bug. You choose how much session history to include and approve it before Claude Code sends it |
/feedback [report] |
Send product feedback. It opens the same dialog as /bug. With no argument, it can show the feedback drafts from Claude |
If you use a third-party provider, /bug writes the report to ~/.claude/feedback-bundles/. You must send that archive yourself.
Start a debug session from the shell¶
claude --debug