结论先说
- 内网自签名证书报错的核心解法是配置
NODE_EXTRA_CA_CERTS:向企业 IT 安全管理员获取包含根证书(Root CA)与中间证书(Intermediate CA)的完整.pem证书链文件,将其绝对路径写入settings.json的env块中。 - 先试升级客户端读系统证书库:新版 Claude Code 原生二进制安装包(以及运行在 Node.js 22.15 及以上版本的安装环境)支持读取 Windows 证书管理器或 macOS 钥匙串里的系统受信证书;若 IT 已推送到系统库,升级后常可直接使用。
- 严禁使用
NODE_TLS_REJECT_UNAUTHORIZED=0偷懒绕过:这会彻底关闭整条链路的 TLS 校验,导致企业 API 令牌与业务源码暴露在中间人劫持风险下。 - 对接企业内部 LLM 网关认准
ANTHROPIC_BASE_URL:配合网关签发的鉴权令牌与托管设置锁定,即可把部门全部流量收口到公司统一合规入口。 - Claude Code 订阅与高配额开通入口:国内无境外卡可通过本站 iOS 免上号自助卡密开通 Claude Pro 会员 或 5 倍以上额度的 Claude Max 会员,完整档位选型见 Claude Code 订阅说明页。

图:本站根据 Claude Code 官方文档:Enterprise network configuration 与 LLM gateway 整理的示意图
本文根据 Claude Code 官方文档《Enterprise network configuration》《LLM gateway configuration》《Settings》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「claude code 证书 报错」「NODE_EXTRA_CA_CERTS claude code」,在公司内网电脑启动就报
SELF_SIGNED_CERT_IN_CHAIN或UNABLE_TO_GET_ISSUER_CERT_LOCALLY的企业研发人员; - 公司安全部门部署了企业级 TLS 安全审计网关(如 Zscaler、Netskope)或内部私有 CA 签发机构,浏览器能正常打开内网页面但命令行工具握手失败的人;
- 负责把团队研发终端统一接入公司自建企业级 LLM 网关(Enterprise LLM Gateway)做身份鉴权、预算管控与合规留痕的平台工程师。
如果你遇到的是常规的账号权限 403 或文件编辑报错,可先对照 /guides/claude-code-common-errors。
一、配置 NODE_EXTRA_CA_CERTS 解决内网自签名证书报错
当企业内网安全网关采用内部私有 CA 重签 TLS 流量,或者你们连接的公司内部网关使用的是内网自签发证书时,运行时默认内置的公共根证书列表不认识这家私有机构,就会直接抛出证书链不受信任异常。
按官方规范分三步根治:
1. 准备完整的 PEM 格式证书链
联系公司 IT 或网络运维获取企业内部 CA 证书。这里最容易踩的坑是只导出了顶层根证书,漏掉了中间签发证书(Intermediate CA),导致配完以后依然报 UNABLE_TO_GET_ISSUER_CERT_LOCALLY。
请确保文件为标准 Base64 文本编码的 .pem 格式(打开能看到 -----BEGIN CERTIFICATE----- 字样;如果是 .cer 或 .crt 二进制 DER 格式需先用 openssl x509 转换),并把中间证书和根证书按顺序拼接在同一个 corporate-ca-bundle.pem 文件里。
2. 写进 settings.json 而不是只写在临时终端
如果在命令行里临时敲 export NODE_EXTRA_CA_CERTS=...,换个窗口、从 VS Code 插件启动(见 /guides/claude-code-vscode)或派生后台任务时很容易丢失变量。官方推荐直接写进 ~/.claude/settings.json(或由 IT 统一部署到系统级托管设置文件中,路径优先级详见 /guides/claude-code-settings-json):
json
{
"env": {
"NODE_EXTRA_CA_CERTS": "C:/ProgramData/CorpCerts/corporate-ca-bundle.pem"
}
}
Windows 路径在 JSON 里建议统一用正斜杠 / 或双反斜杠 \\,不要写单反斜杠以免转义报错。
3. 开启零信任双向认证(mTLS,按需配置)
如果你们公司的零信任安全网关不仅校验服务端证书,还强制要求员工电脑出示客户端证书(Mutual TLS),官方原生支持在同一个 env 块里补齐客户端证书与私钥路径:
json
{
"env": {
"NODE_EXTRA_CA_CERTS": "/etc/corp-certs/ca-bundle.pem",
"CLAUDE_CODE_CLIENT_CERT": "/etc/corp-certs/client.pem",
"CLAUDE_CODE_CLIENT_KEY": "/etc/corp-certs/client-key.pem"
}
}
若私钥文件设了保护口令,可额外加上 CLAUDE_CODE_CLIENT_KEY_PASSPHRASE 环境变量。
二、对接企业内部 LLM 网关(Enterprise LLM Gateway)
很多中大型企业不允许研发终端散装持有上游云厂商的原始密钥,而是要求全部连向公司内网自建的统一 LLM 网关(后端再由网关集中对接 Anthropic API、Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry,各云平台差异见 /guides/claude-code-other-models-bedrock-vertex-foundry)。
按官方《LLM gateway configuration》文档,只要公司网关暴露了兼容 Anthropic Messages 格式的接口,在 settings.json 中配置以下核心字段即可打通:
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://llm-gateway.internal.example.com",
"ANTHROPIC_AUTH_TOKEN": "YOUR_ENTERPRISE_GATEWAY_TOKEN",
"NODE_EXTRA_CA_CERTS": "/etc/corp-certs/ca-bundle.pem",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
关键字段说明如下:
ANTHROPIC_BASE_URL:将请求目标指向公司内部网关根地址;企业管理员还可在系统级托管设置中配合allowedProviders策略锁死仅允许连接合规端点;- 鉴权方式选择:网关要求标准
Authorization: Bearer头时用ANTHROPIC_AUTH_TOKEN;要求x-api-key头时用ANTHROPIC_API_KEY;若公司使用短期动态刷新的 SSO 令牌,可在settings.json顶层配置apiKeyHelper脚本动态获取;需要透传自定义部门标识头时则用ANTHROPIC_CUSTOM_HEADERS; CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:在严格限制外网出站的内网环境里设为"1",可关掉自动更新检查等非核心后台请求,减少防火墙告警日志。
Claude Code 额度与成品号准备提示:长仓库重构、子代理并行与高频工具调用较消耗 5 小时与每周配额。自有账号免密自助续费可看 Claude Pro 自助充值 与 Claude Max 充值页;若尚未注册账号,也可了解 Claude Pro 成品号 或 Claude Max 5x 成品号(按 Anthropic 消费者条款禁止共享账号且违规可终止无退款,成品号均明确标注不质保封号)。
三、网关断流与握手异常排错清单

图:本站根据 Claude Code 官方文档:Enterprise network 与 LLM gateway 整理的示意图
配完文件后,按下面两步做最终验收与疑难排查:
- 用
--debug与/status双重核验:在终端运行claude --debug,从启动日志里确认自定义 CA 证书已被成功读取且无格式报错;进入会话后输入/status,核对当前显示的连接地址(Base URL)与鉴权来源是否确实落在了公司内部网关上; - 排查内网安全设备对压缩请求体的拦截:部分企业老款安全网关或流量审计设备无法正确解析开发者工具发出的 Gzip 压缩请求体,表现为握手过了但一发长提示词就报连接重置或 400。此时在
env中加入"CLAUDE_CODE_GZIP_REQUEST_BODIES": "0"关闭请求体压缩即可恢复稳定。
对于没有自建内部网关基础设施的中小研发团队或独立开发者,如果是在常规公网办公环境下使用,直接采用官方账号登录即可免去网关运维成本;需要核对个人与常规订阅方案时,可参考本站 Claude Code 充值页 的说明。
常见问题
问:我已经把 .pem 证书双击导入了 Windows 系统受信任的根证书颁发机构,还需要配 NODE_EXTRA_CA_CERTS 吗?
答:如果你使用的是最新官方原生安装版 Claude Code(或 Node.js 22.15+),通常会自动读取系统证书存储而无需重复配置;但在 WSL2 Linux 子系统里,WSL 并不会自动继承宿主 Windows 的系统证书库,依然需要在 WSL 内单独配置 NODE_EXTRA_CA_CERTS。
问:为什么终端 CLI 连内网网关正常了,但沙箱化的桌面安装包还是报证书错误?
答:部分受容器或应用商店沙箱隔离的图形桌面包读取不到你只写在 .zshrc 里的 Shell 环境变量。把 NODE_EXTRA_CA_CERTS 统一写进 ~/.claude/settings.json 的 env 对象里,各端才能一致读取。
问:管理员怎么防止员工自己改本地配置绕开公司 LLM 网关?
答:企业 IT 应把 ANTHROPIC_BASE_URL、NODE_EXTRA_CA_CERTS 与 allowedProviders 写入操作系统只读目录的托管配置文件(Managed settings.json,如 Windows 的 C:\Program Files\ClaudeCode\managed-settings.json 或 Linux 的 /etc/claude-code/managed-settings.json),托管层优先级最高,个人配置无法覆盖。
问:国内没有海外银行卡,怎么给 Claude Code 开通 Pro 或 Max 订阅?
答:可在 Claude Code 订阅页 选择走 iOS 订阅链路的 Claude Pro 自助卡密 或 Claude Max 充值,支持支付宝、微信支付与 AlipayHK,无需交出账号密码;若账号弹出身份核验也可查看 Claude KYC 认证人工协助(失败不收费,封号不在质保范围)。
相关教程
- Claude Code settings.json 配置详解:文件位置、优先级与常用示例
- Claude Code 可以使用其他模型吗:官方云平台 Bedrock、Vertex、Foundry 说明
- Claude Code 常见报错与解决:403、400、Error editing file、command not found
- Claude Code VS Code 插件使用教程:安装、登录与常用操作
参考资料
- Claude Code 官方文档:Enterprise network configuration — https://code.claude.com/docs/en/network-config
- Claude Code 官方文档:LLM gateway configuration — https://code.claude.com/docs/en/llm-gateway
- Claude Code 官方文档:Claude Code settings — https://code.claude.com/docs/en/settings
0 条评论
还没有评论,来抢沙发~