本页面显示的所有环境变量也可以在
settings.json 中配置。代理配置
环境变量
Claude Code 遵守标准代理环境变量:Claude Code 不支持 SOCKS 代理。
基本身份验证
如果您的代理需要基本身份验证,请在代理 URL 中包含凭证:CA 证书存储
默认情况下,Claude Code 信任其捆绑的 Mozilla CA 证书和您的操作系统的证书存储。读取操作系统存储需要具有tls.getCACertificates 的运行时:本机安装程序始终具有它,npm 安装需要 Node 22.15 或更高版本。在较旧的 Node 版本上,仅捆绑的集合和 NODE_EXTRA_CA_CERTS 适用。企业 TLS 检查代理(如 CrowdStrike Falcon 和 Zscaler)在其根证书安装在操作系统信任存储中且运行时可以读取它时无需额外配置即可工作。
CLAUDE_CODE_CERT_STORE 接受逗号分隔的源列表。识别的值为 bundled(Claude Code 附带的 Mozilla CA 集)和 system(操作系统信任存储)。默认值为 bundled,system。
仅信任捆绑的 Mozilla CA 集:
CLAUDE_CODE_CERT_STORE 没有专用的 settings.json 架构密钥。通过 ~/.claude/settings.json 中的 env 块或直接在进程环境中设置它。自定义 CA 证书
如果您的企业环境使用自定义 CA,请配置 Claude Code 以直接信任它:mTLS 身份验证
对于需要客户端证书身份验证的企业环境:网络访问要求
Claude Code 需要访问以下 URL。在您的代理配置和防火墙规则中将这些 URL 列入白名单,特别是在容器化或受限网络环境中。
如果您通过 npm 安装 Claude Code 或管理自己的二进制分发,最终用户不需要原生安装程序,自动更新程序不需要使用
downloads.claude.ai。表中的其他用途无论安装方法如何都适用。
Claude Code 默认还会发送可选的操作遥测数据,您可以使用环境变量禁用它。请参阅 遥测服务 了解如何在最终确定您的白名单之前禁用它。
使用 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或已登录的 Claude apps gateway 会话时,模型流量和身份验证会转到您的提供商或网关,而不是 api.anthropic.com、claude.ai 或 platform.claude.com。WebFetch 工具仍会调用 api.anthropic.com 进行其 域名安全检查,除非您在 settings 中设置 skipWebFetchPreflight: true。
Claude Code on the web 和 Code Review 从 Anthropic 管理的基础设施连接到您的存储库。如果您的 GitHub Enterprise Cloud 组织按 IP 地址限制访问,请启用 已安装 GitHub Apps 的 IP 允许列表继承。Claude GitHub App 注册了其 IP 范围,因此启用此设置允许访问而无需手动配置。要 手动将范围添加到您的允许列表,或配置其他防火墙,请参阅 Anthropic API IP 地址。
对于防火墙后的自托管 GitHub Enterprise Server 实例,请将相同的 Anthropic API IP 地址 列入白名单,以便 Anthropic 基础设施可以访问您的 GHES 主机来克隆存储库和发布审查评论。
Desktop 和 claude.ai
前面的表格主要涵盖独立 CLI。Claude Desktop 应用和浏览器中的 claude.ai 从其他 Anthropic CDN 主机加载其应用代码,包括assets-proxy.anthropic.com。允许 claude.ai 而阻止这些主机会产生空白页面而不是错误。请参阅 Desktop 页面上的 网络访问要求。