文章

Claude Code 怎么配置代理

发布 · 更新

简短回答

在 ~/.claude/settings.json 的 env 里写上 HTTPS_PROXY,指向代理客户端的 HTTP 端口,例如 http://127.0.0.1:7890。Claude Code 不支持 SOCKS 代理。

改完在 Claude Code 里输入 /status,「Proxy」一行显示这个地址就说明生效了。截至 2026 年 11 月,按官方文档。

用哪个环境变量

变量作用
HTTPS_PROXY官方推荐。Claude 的请求都是 HTTPS,主要靠它
HTTP_PROXY没有 HTTPS 代理时的备选
NO_PROXY不走代理的地址,空格或逗号分隔,例如 localhost,192.168.1.1,.example.com;写 * 表示全部不走代理

小写写法也认。四个变量同时存在时,按 https_proxy、HTTPS_PROXY、http_proxy、HTTP_PROXY 的顺序取第一个有值的。访问本机地址的连接不会走代理,不用专门写进 NO_PROXY。

写进 settings.json,不要只在终端里 export

~/.claude/settings.json
{
  "env": {
    "HTTPS_PROXY": "http://127.0.0.1:7890",
    "HTTP_PROXY": "http://127.0.0.1:7890"
  }
}

端口换成你的代理客户端的 HTTP 端口(Clash 系常见 7890,以客户端设置为准)。官方文档给了两个理由:

启动环境里已经设了同名变量时,以启动环境为准,settings 里的值会被忽略。

只有 SOCKS 端口怎么办

官方文档写明 Claude Code 不支持 SOCKS 代理,socks5:// 开头的地址用不了。Clash、Mihomo、Surge 这类客户端默认同时提供 HTTP 端口(或 HTTP 与 SOCKS 共用的混合端口),在客户端设置里找到它填进去即可。

也可以不设环境变量,直接打开代理客户端的 TUN 模式,让全部流量都经过代理。这时要确认分流规则里有 Claude 的域名,写法见 分流策略。

代理要用户名和密码

把用户名和密码写进地址:http://username:password@proxy.example.com:8080。密码里有特殊字符时要先做 URL 编码。

怎么确认代理生效

代理生效只说明请求走了代理,出口 IP 本身干不干净、有没有泄露,还要用 Claude 检测 看。时区、遥测等其他配置项见 部署检验。

需要放行的域名

用公司防火墙或白名单时,官方文档列出的必需域名主要有:api.anthropic.com(API 请求)、claude.ai 与 claude.com(claude.ai 账号登录)、platform.claude.com(Console 登录和令牌刷新,claude.ai 账号也需要)、downloads.claude.ai(安装与自动更新)。插件、MCP 连接器等功能另需其他域名,以官方文档为准。

出处

接着看

想直接看自己的出口 IP 有没有问题?Claude 检测和ChatGPT 检测免费、在浏览器里完成,一次看完出口 IP、分流、纯净度、泄露和设备环境。自己配不好,可以看看远程服务。