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
{
"env": {
"HTTPS_PROXY": "http://127.0.0.1:7890",
"HTTP_PROXY": "http://127.0.0.1:7890"
}
}端口换成你的代理客户端的 HTTP 端口(Clash 系常见 7890,以客户端设置为准)。官方文档给了两个理由:
- 后台会话。后台代理由一个共享进程启动,它继承的是第一个启动它的终端的环境变量。只在某个终端里 export,后台会话有时有代理、有时没有。settings 是唯一能稳定覆盖所有后台会话的地方。
- Claude 桌面端。由桌面端管理连接的会话,只从管理员设置和
~/.claude/settings.json读取代理变量,不读项目里的配置文件。
启动环境里已经设了同名变量时,以启动环境为准,settings 里的值会被忽略。
只有 SOCKS 端口怎么办
官方文档写明 Claude Code 不支持 SOCKS 代理,socks5:// 开头的地址用不了。Clash、Mihomo、Surge 这类客户端默认同时提供 HTTP 端口(或 HTTP 与 SOCKS 共用的混合端口),在客户端设置里找到它填进去即可。
也可以不设环境变量,直接打开代理客户端的 TUN 模式,让全部流量都经过代理。这时要确认分流规则里有 Claude 的域名,写法见 分流策略。
代理要用户名和密码
把用户名和密码写进地址:http://username:password@proxy.example.com:8080。密码里有特殊字符时要先做 URL 编码。
怎么确认代理生效
- 在 Claude Code 里输入
/status,「Proxy」一行显示当前使用的代理地址;地址写错时会标为无效并忽略。 - 代理地址缺了
http://这类无法解析的写法,Claude Code 启动时直接报错,并指出是哪个变量。 - 需要更多细节时用
claude --debug启动,日志写在~/.claude/debug/下。
代理生效只说明请求走了代理,出口 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、分流、纯净度、泄露和设备环境。自己配不好,可以看看远程服务。