/debug
为当前会话启用调试日志,并借助会话调试日志协助排查问题。
/debug [描述] 是一个组合型 skill，它会为当前会话开启调试日志记录，之后帮助分析会话调试日志，从而找出问题的根源。默认情况下调试日志是关闭的，除非会话是用 claude --debug 启动的；如果是在会话进行到一半时才调用 /debug，日志只会从这个时间点开始记录——之前发生的事件不会出现在日志里。可以选择附加一段问题描述，让之后的分析更聚焦，比如针对某个具体的 MCP 服务器、某一次工具调用，或某个 hook 问题。
/debug 与相关的诊断命令有所不同：/doctor 会全面检查安装、配置和环境设置，并且可以自动修复其中一部分问题；/heapdump 在内存占用过高时，会把 JavaScript 堆快照连同内存分布情况写入 ~/Desktop。而 /debug 专门用于追踪当前会话内的运行时问题，例如与 MCP 服务器的连接中断，或者其他难以重现的异常工具行为。
✅ 什么时候用？
针对可复现的问题从当下开始记录日志
在再次触发问题之前直接执行 /debug MCP server keeps disconnecting。
在排查难以追踪的问题之前系统性地开启日志记录
在尝试下一步操作之前调用 /debug，把工具调用和错误记录到会话调试日志中。
⛔ 什么时候不该用？
错误在此之前就已经发生了
/debug 只从激活时刻起记录日志，之前发生的事件不会出现在日志中。
更好的选择: 用 claude --debug 重新启动会话，从一开始就记录日志。
诊断安装问题或环境设置错误
/debug 针对的是当前会话的运行时行为，而不是安装问题、PATH 问题或有误的设置文件。
更好的选择: 使用 /doctor，它会执行环境设置检查，并能自动修复其中一部分问题。
来源
- Claude Code 文档（官方） ↗ code.claude.com