命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
启用调试日志并诊断排查会话问题
/debug [description]/debug 是 Claude Code 的内置会话诊断命令。官方文档的原文定义为：
Enables debug logging for the session and prompts Claude to diagnose using the log output and settings paths.
即：在当前会话内即时开启 debug 日志，同时让 Claude 读取日志输出与配置路径，主动向你报告诊断结论。它属于配置诊断命令族的一员，与 /doctor、/hooks、/mcp、/permissions、/status 等并列于同一张官方命令对照表中（/context 仅出现在该表上方的散文说明里，不在表内）。
/debug
不带参数时，Claude Code 开启 debug 日志并读取当前 settings 路径，让 Claude 自行判断问题所在。
/debug [issue]
将问题描述作为 [issue] 传入，Claude 会聚焦于该具体问题进行诊断，例如：
/debug hooks 不触发
/debug MCP server 无法连接
/debug CLAUDE.md 指令似乎被忽略
[issue] 为可选参数；留空时 Claude 依据日志和 settings 路径自主判断。
/debug 是会话内命令，与以下两个启动时CLI 标志不同：
# 启动时即开启 debug，专门用于 hook 调试
claude --debug hooks
# --verbose 显示非阻断的 hook 错误；与 --debug 组合时显示全部细节
claude --verbose
claude --debug hooks 会在 debug 日志中记录每个 hook 事件、matcher 匹配过程、exit code 及完整 stderr；/debug 则适用于已在运行的会话，无需重启。
下列为配置诊断相关命令的对照（其中 /debug、/doctor、/hooks、/mcp、/status 同列于官方 debug-your-config 命令表，/context 仅在该页散文中提及）：
| 命令 | 诊断对象 |
|---|---|
/debug [issue] | 开启 debug 日志，由 Claude 综合日志与 settings 路径出具诊断 |
/doctor | 静态校验配置文件：无效 key、schema 错误、安装健康状态 |
/context | 显示当前 context 窗口内所有内容（system prompt、memory、skills、MCP tools、对话消息）的分类占用 |
/hooks | 列出当前会话已注册的所有 hook，按事件分组 |
/mcp | 显示各 MCP server 的连接状态与工具数量 |
/status | 列出生效的 settings 来源，包括是否有托管 settings 覆盖 |
选择时机：怀疑是运行时问题（日志里有异常）→ /debug；只想校验配置文件语法和 key 是否合法 → /doctor；想看 context 到底塞了什么 → /context。
/debug hook 不触发 让 Claude 读取 debug 日志定位原因。/debug 后 Claude 会结合 settings paths 出具溯源分析。--debug 的启动命令。/debug 与 --debug 的混淆：/debug 是会话内 slash 命令，--debug hooks 是 CLI 启动标志，两者作用层次不同——前者在已运行的会话里追加 debug 能力，后者从一开始就以 debug 模式启动。需要看 hook matcher 评估细节时官方建议使用 claude --debug hooks，而非在已有会话中输入 /debug。
SDK 环境中不可用：Agent SDK 仅支持在 system/init 消息 slash_commands 中列出的无需交互终端的命令（官方示例输出为 ["clear","compact","context","usage"]，标注为 "// Example output"，实际可用命令依会话而异，并非固定穷举）；/debug 需要交互式终端，在 SDK headless 场景下无法分发。