Claude Code
不确定具体报错原因时的通用排查入口
报错原文
各类未分类的启动失败 / 命令无响应 / 配置异常
出现场景
Claude Code 表现异常但报错信息模糊, 不属于以上任何明确分类, 不知从何下手排查。
可能原因(按概率)
- 本地配置文件损坏或版本不匹配
- 环境变量冲突(代理、API Key、BASE_URL 等叠加设置)
- 网络与认证问题混合, 单靠报错文案无法区分层级
修复步骤(从最简单的开始)
- 第一步始终先跑: claude /doctor , 会列出当前网络、认证、配置层面的具体问题项
- 其次跑 claude /status 确认当前登录方式(订阅 vs API Key)和用量情况
- 怀疑是环境变量冲突, 用干净终端(不 source 任何自定义 profile)重新测试一次做对照
- 整理不清的情况可执行 claude /feedback 生成诊断包并自动预填 GitHub issue 提交给官方
大陆网络环境注记
大陆用户排查时建议先用 /doctor 区分清楚是网络层(代理/地域封锁)还是认证层(token/环境变量)问题, 再对号入座查上面对应条目, 避免代理和认证问题混在一起互相干扰判断。
反复被网络 / 支付 / 限流问题耗时间?国内直连的 API 网关一个 key 通多家模型,绕开这一整类报错。
了解 newapi 网关claude-code诊断doctor排查