Claude Code 怎么设置代理：HTTPS_PROXY、NO_PROXY 与 settings.json

Claude Code 读取的变量

下表列出了这些变量，以及文档对每个变量的说明。小写名称同样有效。Claude Code 按以下顺序读取最先设置的变量：https_proxy、HTTPS_PROXY、http_proxy、HTTP_PROXY。它对 localhost、::1 和 127.0.0.0/8 的 WebSocket 连接从不经过代理，因此无需在 NO_PROXY 中为回环地址添加条目。

• 来源：
• Claude Code 文档：企业网络配置

Claude Code 读取的变量: 对比

摘自下方引用的 Claude Code 文档页面，读取于 2026 年 10 月 22 日。引号中的词句出自文档原文。

仅支持 HTTP 代理，不支持 SOCKS

文档明确说明：Claude Code 不支持 SOCKS 代理。SOCKS5 地址无法在这里使用，请改用支持 HTTP 的代理。对于需要 NTLM 或 Kerberos 等高级认证的代理，文档建议改用 LLM 网关服务。

带用户名和密码的代理 URL

使用基本认证时，把账号和密码直接写进 URL，如下例所示。

文档警告不要在脚本中硬编码密码，建议改用环境变量，或用专门保存密码的安全存储。如果密码中包含 @、: 或 / 等字符，需在 URL 中进行百分号编码，所有带账号和密码的 URL 都是这样。

带用户名和密码的代理 URL: 示例

export HTTPS_PROXY=http://username:[email protected]:8080

仅为示例：请把占位值换成你自己的值。

启动前设置变量

在 shell 中导出的变量仅在启动时读取一次，正在运行的会话不会感知后续更改。请先设置变量，再在同一 shell 中启动 Claude Code。

命令提示符中的会话形式为：set HTTPS_PROXY=http://username:[email protected]:8080。

启动前设置变量: macOS, Linux, WSL

# macOS, Linux, WSL
export HTTPS_PROXY=http://username:[email protected]:8080
claude

仅为示例：请把占位值换成你自己的值。

启动前设置变量: Windows PowerShell

# Windows PowerShell
$env:HTTPS_PROXY = "http://username:[email protected]:8080"
claude

仅为示例：请把占位值换成你自己的值。

写入 settings.json 永久生效

该文档页面上的每个环境变量都可以在 settings.json 中设置。这对后台代理至关重要。每个用户有一个监督进程，托管通过 claude agents、--bg 和 /background 启动的会话。它比你的 shell 活得更久，继承的是最先启动它的那个 shell 的环境，所以只在 shell 里导出的变量能否传到后台代理，全凭运气。文档指出，只有 settings 里的配置能传到每一个后台会话。

把下面的代码块放进 ~/.claude/settings.json；如果由管理员统一部署，则放进托管设置（managed settings）。

• 来源：
• Claude Code 文档：企业网络配置

写入 settings.json 永久生效: 示例

{
  "env": {
    "HTTPS_PROXY": "http://username:[email protected]:8080"
  }
}

仅为示例：请把占位值换成你自己的值。

自定义证书颁发机构

默认情况下，Claude Code 信任自带的 Mozilla 证书和操作系统的证书库。文档指出，企业的 TLS 检查代理只要根证书已装进操作系统信任库、且 Claude Code 能读取，就无需额外配置。原生安装版始终可以读取；通过 npm 安装则需要 Node 22.15 或更高版本。其他情况下，请把 NODE_EXTRA_CA_CERTS 指向证书文件，如下所示。

这只对需要检查流量的代理有意义，普通转发代理不需要此设置。

自定义证书颁发机构: 示例

export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

仅为示例：请把占位值换成你自己的值。

检查 Claude Code 实际使用的配置

Claude Code 读取网络设置时不会验证大部分配置。唯一例外是代理 URL：如果无法解析该值（例如缺少 http://），它会在启动时停止并报错指出需修复的变量。要确认其余配置：

• 在交互式会话中运行 /status。Proxy 行显示当前代理 URL，并将其无法解析的值标记为无效并忽略。

• 使用 claude --debug 启动。日志会写入 ~/.claude/debug/<session-id>.txt，或通过 --debug-file 设置的路径。

• 在终端里用下面的命令直接测试代理，它会显示站点看到的出口 IP、国家和网络。

ip、country、city 和 org 这几个字段的含义，见代理 IP 怎么查。

• 代理 IP 怎么查

• 来源：
• Claude Code 文档：企业网络配置

检查 Claude Code 实际使用的配置: 示例

curl -x http://username:[email protected]:8080 https://ipinfo.io/json

仅为示例：请把占位值换成你自己的值。

连接失败怎么办

• Claude Code 一启动就停止：代理 URL 缺少协议前缀。请写完整的 http://... URL。

• 407 Proxy Authentication Required：代理拒绝了用户名或密码。请重新复制，不要手动重输。

• SOCKS5 地址：不受支持，请改用 HTTP 代理。

• 在 shell 中可用，但在后台代理中不可用：在 settings.json 中设置变量。

• 中间有防火墙：文档列出了 Claude Code 所需的主机，包括 api.anthropic.com、claude.ai 和 platform.claude.com。请在代理规则中允许这些主机。

用 MCP 给 Claude Code 加一个代理工具

MCP 可以给 Claude Code 增加工具。装上 proxy302-mcp 后，Claude Code 能在对话里直接获取 Proxy302 代理，并通过它打开网页，不用再切到控制台。下面这条命令会把它装给你所有的项目用。

proxy302-mcp 是 Proxy302 官方的 MCP 服务，在 GitHub 开源，由 Proxy302 团队维护。Proxy302 也在 https://proxy302.com/v1/mcp 托管了一份：Claude Code、Cursor、VS Code 这类能带 Authorization 请求头的客户端，填 API 密钥就能连，不用安装。

这和本页其余部分是两套互不相干的设置。Claude Code 自己连接 Anthropic 用的代理，是上文用 HTTPS_PROXY 设置的那个；MCP 服务器提供的工具另有各自的设置，装上它并不会改变 Claude Code 自己的连接方式。工具清单、其他客户端和使用限制见 Proxy302 MCP 服务器指南。

• Proxy302 MCP 服务器指南

• 来源：
• Claude Code docs: Connect Claude Code to tools via MCP
• proxy302-mcp 的 README（Proxy302 官方 MCP 服务）

用 MCP 给 Claude Code 加一个代理工具: 命令

claude mcp add proxy302 -s user -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp

把 <key id>:<secret> 换成你的 Proxy302 API 密钥。-s user 表示所有项目都能用；不加的话只装给当前项目。

• 来源：
• Claude Code docs: Connect Claude Code to tools via MCP

用 Proxy302 怎么做

静态住宅 ISP 代理适合此任务：在租期内 IP 固定且不轮换，购买时选择 HTTP（即 Claude Code 所需的协议）。控制台中的 Claude 预设默认使用 SOCKS5，因此在生成前请将「协议」切换为 HTTP。Claude 代理页面包含预设和完整设置。下表是我们对七个国家出口的 Claude 进行的每小时最新检测，包含每个出口的网络和站点响应时间。

• Claude 代理

实测出口：Claude 从七个国家的连通

Proxy302 探测器每小时检测一次，本次检测时间：2026 年 10 月 22 日 14:18 UTC。每个国家通过一个动态住宅出口、经公开的 Proxy302 入口向 Claude 发一次请求。IP 只公开前三段。每国一个样本，不是平均值，之后的检测结果会不同。

• 来源：
• Proxy302 每小时连通检测

用 Proxy302 怎么做: 步骤

1. 第 1 步

   打开静态住宅 ISP 页面，选择「地区」，把「协议」设为 HTTP，再选「租期」和「数量」，然后点击「确认费用并生成」。

2. 第 2 步

   打开「我的资产」（控制台里放着你买到的全部代理），复制 HOST、PORT、USERNAME 与 PASSWORD。「工具与检测」页里有填好你自己连接信息的现成示例。

3. 第 3 步

   在 shell 中设置 HTTPS_PROXY=http://USERNAME:PASSWORD@HOST:PORT，或将其写入 ~/.claude/settings.json 的 env 块。

4. 第 4 步

   启动 claude，运行 /status，并使用上述 curl 命令检查出口。

价格与限制

静态住宅 ISP IP 的价格为一天 US$0.50、30 天 US$7.99，约合每天 US$0.27，各国价格一致。可用性每日变化，在订单页面显示。没有免费试用，最小购买量是 1 个 IP、1 天。代理仅改变网络出口：Anthropic 关于支持地区的规则仍适用于你，详见 ChatGPT、Claude、Gemini 支持哪些国家和地区。

• ChatGPT、Claude、Gemini 支持哪些国家和地区
• 预算有限？可选普通静态住宅 IP

• 来源：
• Proxy302 产品事实与价格表

Proxy302 一览

价格按 PTC 从钱包扣，1 PTC = 1 美元。没有免费试用：最小一单是 1 GB 动态住宅流量，或一个 IP 用 1 天。核对于 2026-11-04。

• 来源：
• Proxy302 产品事实与价格表
• Proxy302 ISP for AI subscriptions: public catalog

常见问题

延伸阅读

Claude 代理

Claude 代理即 Claude 专用 ISP：美国、法兰克福、日本、伦敦的独享原生 IP，30 天 15 PTC，Claude Code 走 HTTP，并讲清 Anthropic 的地区政策。

查看配置与价格

ChatGPT、Claude、Gemini 支持的国家和地区

对照 OpenAI、Anthropic、Google 四份官方名单：中国大陆、香港、澳门、台湾能否使用，报错是什么意思，附 7 个国家每小时实测。

代理 IP 怎么查：IP 地址、国家、运营商

30 秒查清代理的 IP、国家和运营商；为什么不同查询网站城市对不上、纯净度分数看什么。附我们对三家查询服务的实测。

Cursor 怎么设置代理

在 Cursor 中用 http.proxy 设置代理，处理密码里的特殊字符，流式响应卡住时切换到 HTTP/1.1，并用 Run Diagnostics 验证。

代理 MCP 服务器

讲清楚代理 MCP 服务器是什么、本地和远程 MCP 服务器有什么区别、怎么装进 Claude Code、Codex CLI 和 Cursor，以及 MCP 服务器自己的网络请求怎么走代理。