浏览器能打开 claude.ai,终端里的 Claude Code 却一直 reconnecting,或者登录跳转之后回不来。这是大陆用户最常见的一类问题,而且它和「Claude 网页打不开」不是同一个问题。
原因通常只有一句:很多代理客户端默认只接管图形界面的系统代理,命令行工具根本不读那个设置。
下面按排查顺序写。
这是唯一需要先做的一步,跳过它后面全是猜。
在你出问题的那个终端里,让 curl 去问一个能显示出口 IP 的站,看它报出来的地址是境外的还是你本地的:
curl -s https://api.ipify.org
再确认一次 curl 有没有真的读到代理设置:
curl -s -x http://127.0.0.1:7890 https://api.ipify.org
把端口换成你客户端的本地端口。这一条如果返回境外 IP,说明「代理本身是好的,只是没被用上」。
三个常见原因,按出现频率排:
① 客户端只开了「系统代理」,没开 TUN。 系统代理本质是给遵守系统设置的应用读的一个配置项,浏览器遵守,很多命令行工具不遵守。TUN 模式是在网卡层接管全部流量,命令行自然也被算进去。
② shell 启动文件里设了代理,但那个终端没重新加载。 你在 .zshrc 或 .bash_profile 里加了 export HTTPS_PROXY=...,但已经开着的终端窗口不会自动生效。新开一个窗口,或者 source 一下。
③ 用了 sudo 或者别的用户跑。 环境变量不跨用户继承,sudo 会重置环境。用 sudo -E 或者给 root 单独配。
代理走通了,但 Claude Code 还是失败,要分两种:
登录握手失败、跳转到浏览器之后卡住。 这是浏览器和终端走了不同出口导致的。Claude Code 的登录流程是终端发起、浏览器授权、再把结果带回终端,两边 IP 不一致时握手对不上。
常见踩法:浏览器装了单独的代理插件(和系统代理是两套),或者你开了多个客户端同时跑。排查方式很简单——把浏览器插件关掉,只留系统代理,再试一次。
能连上,但用一会儿就断,然后一直 reconnecting。 这是长连接被打断。Claude Code 和网页版不一样,它维持的是长连接:网页版抖一下你刷新就好,长连接抖一下就是断开重连。
长连接断的原因里,线路拥塞比被封常见得多。判断方法:换一个时段(比如早上)再试,同一节点早上正常、晚高峰断,那就是拥塞,换线路有用,换 IP 没用。
DNS。 有些终端环境的 DNS 解析走的是系统默认,而你代理客户端的分流规则是按域名做的,两边不一致时会走错分支。如果你用的是「规则模式」,把 anthropic.com、claude.ai 明确指到代理组里,比依赖默认规则可靠。
IPv6。 代理通常只代理 IPv4 流量。如果你的环境同时有 IPv6 出口,应用可能优先走 IPv6,而那条路上没有任何代理——表现就是「有的请求成功,有的直接裸奔」。站内有一篇专门讲这个的:Claude Code 与 IPv6,症状对得上可以去对照。
终端里 curl https://api.ipify.org
├─ 报本地 IP ──────→ 终端没走代理 → 开 TUN / 加环境变量 / 新开窗口
└─ 报节点 IP
├─ 登录跳转失败 ─→ 浏览器和终端出口不一致 → 关浏览器代理插件
├─ 用一会儿就断 ─→ 长连接问题
│ ├─ 换时段正常 → 线路拥塞,换线路
│ └─ 任何时段都断 → 出口被针对,换 IP 类型
└─ 一直连不上 ───→ 看 DNS 分流 / IPv6 泄漏
如果你连第一步的 curl 都还没跑,先跑它。大半的问题在那一刻就有答案了,不需要买任何东西。
我们提供美国住宅 IP 线路,客户端覆盖 Windows、macOS、iOS、Android 和 Linux,桌面端支持 TUN 模式接管全部流量——包括终端。
为什么浏览器能打开 Claude,Claude Code 就不行?
最常见的原因是终端没走代理。系统代理是给遵守系统设置的应用读的,很多命令行工具不读。用 curl https://api.ipify.org 一测就知道。
开了 TUN 之后还是不行?
先确认 TUN 真的生效了(同样用 curl 测出口 IP)。有些客户端显示「已开启」但实际路由没接管,测一下比看界面可靠。
登录时浏览器跳转完卡住,回不到终端。
多半是浏览器和终端走了不同出口。如果浏览器装了单独代理插件,先关掉它,让两边都走同一个系统代理,再试一次。
用一会儿就断,是不是节点被封了?
不一定,而且是线路拥塞的可能性更大。判断方法:换一个时段试。早上正常、晚上断,是拥塞;任何时段都断,才更像被针对。
需要一直挂着网页版吗?
不需要。Claude Code 是独立的终端工具,和网页版登录状态没有必然关系,但两边的出口要一致,否则登录交接容易失败。
本文由易联团队维护。文中排查方法基于我们的观察和用户反馈,不构成对 Anthropic 官方行为的说明;具体以官方文档为准。