Skip to content

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