claude doctor 是什么？三命令排查法

AI 编程工具用久了，总会遇到些说不清的不对劲：装完命令跑不起来、登录状态对不上号、会话越用越钝。Claude Code 为这类时刻自带了一套自检工具——claude doctor、claude status 与 /context 三条命令，各管一段：安装健康、账号状态、上下文占用。很多人的第一反应却是卸载重装，其实重装是整条排查链的最后一步，前面有更便宜也更快的定位手段。这篇按排查顺序把三件套讲清：每条命令看什么、结论怎么读，以及为什么 claude update 常常是动手前的第一招。

三件套各管一段

Claude Code 的故障大体落在三层：安装层，命令本身跑不跑得起来；账号层，身份、订阅与计费道对不对；会话层，上下文占用与模型表现。三件套正好一层一条：claude doctor 查安装，claude status 查账号，/context 查会话。先分层再动手，是排障省时间的核心——报错指向哪一层，就先用哪一条，别一上来就在配置文件里翻找。三条命令的成本几乎为零，各跑几秒就有结论，比盲改配置、反复重装划算得多。

claude doctor：安装先自检

claude doctor 是安装健康检查，在终端直接敲这条命令，它会报告安装方式、依赖版本与常见冲突。最典型的检查项是双版本并存：npm 全局装了一份、原生安装器又装了一份，两份都躺在 PATH 里互相抢位，今天跑的是哪份都说不清，行为自然时好时坏。doctor 会把这类冲突直接写在报告里，照单处理即可。如果连 claude 这条命令都敲不出来，那是 PATH 的问题，先看command not found一篇；安装环节本身没走通的，回安装教程补课。

claude status：报错先看身份

账号层的怪现象不少：明明订了订阅却按量扣费、额度显示对不上、换号之后行为变了。claude status（会话内用 /status）把登录账号、订阅档位与当前认证方式一次报清。它最大的价值是分流：确认请求到底走的订阅，还是被挂着的 API key 静默接管——两者并存时，环境变量会悄悄改走按量计费，很多「账对不上」都出在这里，排查思路见残留 key 干扰一篇。报错先看 status，身份清白了再往下查，方向不会错。

/context：变钝先看占了多少

会话层的典型表现是变钝：响应变慢、指令容易被忘、开始答非所问。先跑 /context 看上下文窗口被什么占了——读过的大文件、长会话堆下来的历史，都在往里装，占用一高，模型能用的思考空间就被挤窄。占用高就压缩：/compact 带着保留指令压一轮，或者 /clear 换任务直接清空，两者的取舍细节会话管理另有专篇讲。先看占用再动手，比凭感觉重开会话省事得多。

claude update：万能的第一招

动手深挖之前，还有一招成本最低的：claude update。新版本在持续修旧问题，社区里不少「诡异表现」其实是已修复的旧版本 bug，升级一条命令，几分钟后表现消失。所以顺序应该是：先升级再深挖，升级后复现不了，就省下了后面所有折腾。走到最后仍复现，才轮到重装——卸载、清缓存、重装的干净三步，见npm 权限一篇；升级与重装都无效的报错，按报错文案分流，包装类报错先剥外壳再定方向，剥法可参考 Codex 侧的重试上限分流一篇，思路通用。

三命令排查速查

• 分层定位：doctor 查安装、status 查账号、/context 查会话
• claude doctor 先跑，双版本并存是高频冲突项
• claude status 分清订阅与 API key，账才对得上
• 变钝先看 /context 占用，高就压缩或清空
• 先 claude update 再深挖，重装排在最后

三命令自检怎么办速查

• doctor 报告看不懂怎么办？：把报告原文贴给 DeepSeek，让它逐条解释术语与建议动作；再用豆包交叉确认处理顺序，照单执行即可。
• 三条命令的先后顺序是什么？：按报错指向走：命令层面的问题先 doctor，账号与计费问题先 status，会话变钝先 context；不确定时按 doctor、status、context 的顺序各跑一遍。
• 升级和重装都做了还不行怎么办？：留存 doctor 报告与完整报错文案，带着这些信息去官方仓库提 issue，比一句「用不了」的反馈有效得多。