故障排查
Claude Code 故障排查知识库
这里收录 Claude Code 命令行与 Claude API 使用过程中真实遇到过的报错， 按报错原话组织。 每篇的结构固定：现象 → 原因 → 诊断命令 → 解决 → 怎么确认修好了， 全部来自实测，命令可直接复制执行。
Claude Code 启动报 "Is a directory" 怎么解决
一句话：软链指到了版本目录而不是目录里的二进制文件。两种目录布局并存，按老习惯配软链就会踩这个。
故障排查 · 更新于 2026-08-21
配好 ANTHROPIC_BASE_URL 后请求返回 404 的原因
一句话：路径写重了。客户端会自己补
/v1/messages，你再写一遍就变成了/v1/messages/v1/messages。故障排查 · 更新于 2026-08-21
调用 Claude 5 系列模型报 "temperature is deprecated" 400 错误
一句话：新模型已弃用
temperature参数，请求里带上就直接 400。删掉这个参数即可。故障排查 · 更新于 2026-08-21
claude update 卡住不动、最后超时怎么办
一句话：官方发布源响应不稳定时，从 npm 镜像源取同一份二进制手工替换即可。
故障排查 · 更新于 2026-08-21
Claude Code 所有请求都超时，但 curl 测端点却是通的
一句话：多半是 shell 里残留的网络相关环境变量指向了一个当前环境不可用的地址，每个请求都要先撞一次超时。
故障排查 · 更新于 2026-08-21