Claude Code 公司内网自签名证书报错怎么办:NODE_EXTRA_CA_CERTS 与企业 LLM 网关官方配置

在公司办公网运行 Claude Code 报 SELF_SIGNED_CERT_IN_CHAIN 或 UNABLE_TO_GET_ISSUER_CERT_LOCALLY?本文按官方文档讲清企业内网根证书 PEM 链配置、NODE_EXTRA_CA_CERTS 持久化与内部 LLM 网关参数。

NNathaniel bigo··原创首发·AI 辅助撰写
14 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 Team / 企业 账号

结论先说

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

企业内网证书与 LLM 网关标准配置四步

图:本站根据 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 整理的示意图

配完文件后,按下面两步做最终验收与疑难排查:

  1. 用 --debug 与 /status 双重核验:在终端运行 claude --debug,从启动日志里确认自定义 CA 证书已被成功读取且无格式报错;进入会话后输入 /status,核对当前显示的连接地址(Base URL)与鉴权来源是否确实落在了公司内部网关上;
  2. 排查内网安全设备对压缩请求体的拦截:部分企业老款安全网关或流量审计设备无法正确解析开发者工具发出的 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 官方文档: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

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  2. 02

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 开源本地部署(Docker Compose)与提示词版本管理(Prompt Management)从零上手教程

    企业内网严禁业务日志出境,又想免费拥有大模型调用链追踪与不发版热更新提示词的能力?本文按 Langfuse 官方文档整理 Docker Compose 本地一键启动(含 ClickHouse 架构注意事项)、密钥配置与 Prompt Management 标签化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入门教程:给 LangGraph 与原生 OpenAI / Claude 接口加调用链追踪、Token 成本统计与免费层限额

    智能体多步调用总是找不到哪一轮提示词跑偏、单次请求到底烧了多少 Token?本文按 LangSmith 官方文档讲清环境变量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 与 @traceable 追踪原生接口,以及 Developer 免费层额度与留存规则。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效读英文文献:PDF 翻译插件、批注导出精读与防捏造参考文献流程

    在 Zotero 里读英文顶会论文怎么无缝联动 Claude 与 ChatGPT?本文整理 Translate for Zotero 划词翻译配置、高亮批注导出精读提示词,以及杜绝 AI 捏造假 DOI 参考文献的核验闭环。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 与本地 Ollama 做个人双链笔记问答:主流插件配置与隐私脱敏边界

    想在 Obsidian 里基于自己的双链笔记库做 AI 问答又担心隐私外泄?本文对比 Copilot 与 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 与本地 Ollama 的步骤及敏感目录隔离规则。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~