Claude Code 常见报错排查清单

很多人一看到报错就想大改配置，其实大多数问题都有顺手的排查顺序。先排简单的，再碰复杂的，别一上来掀桌子。

同系列还可以顺手看：

安装失败先查什么 · 登录失败怎么排 · 权限卡住怎么判断

命令找不到、版本看不到、终端里根本认不出 Claude Code，这通常都是安装或 PATH 问题。先别跑远。

能装上，不等于能正常用。登录没走通、账号权限不对、第三方平台凭证没配好，都会让人误以为是工具坏了。

如果它能说话、能读项目，但一到执行命令或改文件就卡，多半是权限和沙箱设置在拦。

这类问题别靠猜，先看它到底是“不能读”“不能写”还是“不能执行”。三种不是一回事。

如果你基础功能都稳，偏偏是插件、MCP、hooks 一挂就出事，那就缩小范围：先关掉新增那一项，再一点点加回来。

排错最怕一边改三样，最后连自己都不知道是哪一刀起作用了。

我的建议一直是：先安装，再登录，再权限，再插件和 MCP。前面三层没走稳，后面那些高级能力查起来只会更乱。

你把这顺序守住，哪怕当下还没把问题修好，至少不会越排越散。