网络

修复 Claude Code 报错

报错原文

TLS connect error / unable to get local issuer certificate

含义 / 原因

TLS 握手失败,通常是系统 CA 证书过期,或公司代理在做 TLS 拦截(self-signed / SELF_SIGNED_CERT_IN_CHAIN)。安装阶段和运行阶段都可能撞上。

修复步骤

1更新系统 CA 证书:Ubuntu/Debian 跑 sudo apt-get update && sudo apt-get install ca-certificates;macOS 更新系统即更新根证书。
2公司代理做 TLS 拦截时,安装用 curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash。
3装好后让 Claude Code 的 API 请求信任同一份 CA:export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem。切勿用 NODE_TLS_REJECT_UNAUTHORIZED=0 关掉校验。