故障排查 · 更新于 2026-10-03
Claude Code / CC Switch 连接被拒绝怎么排查
从地址、旧代理和连通性入手，排查 ConnectionRefused、ECONNREFUSED。
先判断错误发生在哪一步
ConnectionRefused 或 ECONNREFUSED 表示目标连接被拒绝，不等同于模型不存在。先确认客户端到底连接哪个地址，尤其注意旧的本机代理端口。
第一步：检查当前终端的配置
Windows CMD 可以查看以下非密钥配置：
echo %ANTHROPIC_BASE_URL%
echo %HTTPS_PROXY%
echo %HTTP_PROXY%
where claude变量没有设置时，CMD 可能原样显示 %HTTPS_PROXY%，这不代表它是一个真实代理地址。不要使用命令输出完整认证密钥。
CC Switch 中的配置可能通过本机代理生效。若 Base URL 指向 127.0.0.1 或 localhost，需要确认对应代理正在运行，端口也正确。
第二步：只检查网站连通性
curl.exe -I https://pelicanapi.com/这个检查不调用模型、不扣费。网站能访问，仅说明到网站的网络基本可达，不能证明客户端模型请求配置正确。
如果官网能访问而 Claude Code 连接被拒绝，优先对比客户端实际地址、代理设置，以及配置是否在当前终端生效。
第三步：重新启动客户端
保存配置后关闭旧终端和客户端，再打开终端运行。不要同时在多个位置设置互相冲突的 Base URL。
不要为了排查直接关闭所有防火墙；先核对被拒绝的具体地址与端口。
哪些报错应转入其他排查
- 401：认证密钥无效、过期或不完整。
- 模型不存在或无权限：核对模型名称、密钥分组和模型限制。
- 429：请求频率或上游额度限制。
- 5xx、超时：记录时间、模型名和错误码，由站长查看渠道日志。