Skip to content

TLS 握手卡住不再无限等待:2.1.321 的网络稳定性修复 ​

在公司代理、防火墙或不稳定网络下用 Claude Code 的朋友,2.1.321 有两条修复值得关注。

一、登录与续期不再卡死 ​

有些网络设备会接受 TCP 连接,却始终不回应 TLS 握手。修复前,登录、刷新令牌和登出在这种情况下会无限等待,终端看起来像是「卡住了」,只能手动中断。

现在这几个操作遇到握手无响应会超时并给出结果,而不是一直挂着。

二、回复中途断线不再直接报错 ​

另一种情况是回复已经输出了一半,连接中途断开,回合直接以:

API Error: EPROTO: The TLS handshake failed

结束。2.1.321 把行为恢复到 2.1.302 之前:已经收到的部分回复会保留,或者请求会自动重试,不再白白丢掉。

排查建议 ​

如果升级后仍频繁遇到网络问题:

  1. 检查代理是否对 Anthropic 相关域名做了 TLS 拦截或截断;
  2. 公司环境下确认根证书配置正确(例如 NODE_EXTRA_CA_CERTS 指向有效证书文件);
  3. 尝试换一个网络或关闭代理,判断问题出在本机还是链路上。

小结 ​

这两条修复都不需要改配置,升级到 2.1.321 或更高即可。网络不稳定时,最大的改善是「不再卡死、不再丢回复」。

Claude-cn.org,专注于 Claude Code 中文教程