Claude Code 终端连不上:先区分网络故障和账号限制
使用 Claude Code 时,常见的困扰是浏览器能打开网页,终端里的登录却超时;或者登录完成后,命令一直等待模型响应。这里要先分清两类问题:一类发生在连接建立之前,例如 DNS 解析、TCP 连接或 TLS 握手失败;另一类发生在请求已经到达服务端之后,例如账号权限、地区可用性、配额或认证错误。Clash Verge 能帮助管理本机流量的代理路径,但不能替代账号资格,也不能把服务端拒绝请求变成成功。
还要注意,Claude Code 的流量不一定只有一个出口。登录可能涉及浏览器或设备授权流程,命令行本身会访问服务端接口,安装和更新还可能经过 npm 等包管理源。浏览器遵循系统代理,并不代表独立启动的终端、IDE 集成终端、容器或远程 SSH 会话也会自动使用代理。排查时应把它们当作几条独立的网络路径,而不是只用浏览器能否打开网页来判断整个开发环境是否正常。
建议按顺序确认:Clash Verge 是否运行、节点是否可用、系统代理或 TUN 是否开启、当前配置是否为预期模式、终端是否拿到代理设置,最后再看 Claude Code 的错误类型。若返回的是明确的权限或配额提示,应优先核对账号和服务状态;若报错是连接超时、连接重置或证书握手失败,再重点检查代理、DNS 和分流规则。
先检查 Clash Verge:模式、端口和系统代理
打开 Clash Verge,确认当前配置已启用,并选中一个实际可用的策略组节点。建议先使用规则模式,而不是长时间保持全局模式:规则模式便于只将需要代理的服务送入对应策略组,也更容易从连接记录判断规则是否命中。若尚未确认规则是否正确,可以短暂切换到全局模式做对照测试;测试结束后及时切回,避免国内站点、局域网服务或其他开发流量也被不必要地转发。
接着确认系统代理状态。系统代理主要帮助遵循操作系统代理设置的应用,并不保证所有命令行工具都能识别它。Clash Verge 中的混合端口通常同时接受 HTTP 代理与 SOCKS 代理连接;常见端口是 7890,但不同配置可能使用其他端口。请以客户端界面或内核配置中显示的实际端口为准,不要照抄示例值。终端变量中使用 HTTP 代理时,地址通常写成 http://127.0.0.1:端口,即使访问目标是 HTTPS,也通常由 HTTP 代理通过 CONNECT 建立隧道。
7890 仅为示例。若端口填写错误、代理监听未启动,终端访问会失败;若 Clash Verge 只监听本机回环地址,也不要把它改成局域网可访问地址来绕过故障。
给终端设置代理变量,并确认变量真的生效
在 macOS 或 Linux 的当前 shell 中,可以先临时设置代理变量进行验证。以下命令只影响当前终端会话及其启动的子进程;关闭该终端后通常不会保留。将端口替换为 Clash Verge 当前显示的混合端口:
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="socks5h://127.0.0.1:7890"
不少程序会识别大写变量,也有程序主要读取小写变量。若设置后仍表现为直连,可在当前会话中同时补充小写形式,再重新启动 Claude Code。注意,ALL_PROXY 的支持情况取决于具体运行时和依赖库;如果不确定,可先保留 HTTP_PROXY 与 HTTPS_PROXY,避免同时设置多套互相矛盾的代理地址。
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
Windows PowerShell 可在当前窗口使用下面的写法。若使用 Git Bash、WSL 或 IDE 自带终端,应在对应的终端环境里设置变量;Windows 主机的系统代理状态不会自动保证 WSL 内部的回环地址和网络路由也相同。
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:ALL_PROXY = "socks5h://127.0.0.1:7890"
设置之后,先查看变量值,再用一个 HTTPS 请求做连接层测试。测试目标应根据当前实际报错和服务文档选择;这里用官方 API 主机名示意,返回 HTTP 错误码也不一定代表代理失败,因为没有有效凭据时服务端可能拒绝请求。判断重点是连接是否能建立、是否仍然超时,以及 Clash Verge 的连接记录是否显示请求经过预期策略组。
printf '%s\n' "$HTTPS_PROXY"
curl -I --max-time 15 https://api.anthropic.com/
如果 curl 能建立连接,但 Claude Code 仍无法工作,请完全退出并重新启动 Claude Code,确认它继承了刚才设置的环境变量。已经运行的 IDE、集成终端或后台进程不会因为你后来修改 shell 变量而自动更新环境。若命令在容器或远程主机中执行,也要在真正发出请求的那个环境里检查变量;本机 Clash Verge 的图形界面并不能自动替远端进程配置代理。
调整分流规则:优先精确匹配,再依据日志补充
如果终端变量已经指向本地代理,下一步是确认请求最终命中了什么规则。可以在 Clash Verge 的连接或内核日志中观察连接目标、匹配规则和策略组。对 Claude 相关流量,可先为 Anthropic 与 Claude 域名准备一个已有的代理策略组,例如配置中实际存在的 AI。策略组名称必须与当前配置一致;下面只是展示规则结构,不是可以直接套用的完整订阅:
rules:
- DOMAIN-SUFFIX,anthropic.com,AI
- DOMAIN-SUFFIX,claude.ai,AI
# Add only hosts confirmed in connection logs or official documentation
这些规则应放在可能提前匹配到同一流量的宽泛规则之前。Mihomo 规则通常按顺序匹配,先命中的规则会决定连接去向;如果前面已有宽泛的关键字、地理位置或直连规则,后面追加的精确条目就可能没有机会生效。使用远程订阅时,不要直接修改一份会被更新覆盖的生成配置;应通过客户端支持的覆写或规则合并方式维护自定义条目,并在修改后检查最终生效配置。
不要为了省事就把所有包含 anthropic 字样的连接,或大量无关云服务域名一律塞进代理组。更可靠的做法是先用最小范围测试,随后根据日志中的实际主机名逐条补充。若登录跳转、安装更新或模型请求对应不同域名,应分别观察,不要假设域名清单在所有版本和工作流中都完全相同。规则的目标是解释流量去向,而不是追求一份看起来越长越安心的列表。
系统代理不够时,再评估 TUN 与常见故障
如果系统代理与终端变量都无法覆盖某个进程,可以评估 Clash Verge 的 TUN 模式。TUN 在系统网络层转发流量,适合处理不读取常规代理变量的命令行程序或多层子进程;但它涉及虚拟网卡、路由与权限,可能与其他 VPN、容器网络或企业安全软件冲突。启用前确认如何关闭并恢复网络,启用后仍要检查规则是否把应直连的国内服务和局域网地址送入了错误策略组。TUN 能接管路径,不代表每条流量都会自动获得正确的分流结果。
- 浏览器正常,终端超时:优先检查终端环境变量、终端进程是否在设置变量之后启动,以及请求是否由 WSL、容器或远程会话发出。
- 所有程序都连接失败:检查节点状态、Clash Verge 内核是否运行、混合端口是否正确,以及是否同时启用了冲突的代理软件。
- 能连接但登录失败:查看错误是否属于账号权限、登录流程或服务端拒绝;不要仅凭 HTTP 状态码认定代理坏了。
- 时好时坏或只有部分功能失败:查看日志中是否有不同目标域名命中不同规则,并留意 DNS 解析、节点切换和规则覆盖顺序。
- 出现证书错误:先检查系统时间、证书链和是否存在企业 HTTPS 检查,不要把关闭 TLS 校验当作常规解决方案。
还应注意代理变量可能被其他工具覆盖,或者 NO_PROXY 中包含了需要走代理的域名。排查时可以检查当前进程环境中的变量,临时移除不必要的例外后重试;确认原因后再设置精确的例外列表。不要把含账号令牌、API 密钥或完整认证请求的日志粘贴到公开论坛,也不要为了排障将本地代理监听端口开放给不可信的局域网设备。
常见问题
开启系统代理后,为什么 Claude Code 还是连不上?
系统代理主要服务于会读取操作系统代理设置的应用。命令行运行时可能不读取它,因此需要在启动 Claude Code 的终端中设置代理环境变量,或者在确认系统路由和规则无冲突后评估 TUN。
curl 返回错误码,是否说明 Clash 代理没有生效?
不一定。若请求已经成功建立连接并收到服务端响应,代理链路可能已经工作;错误码也可能与请求路径、认证信息或服务端策略有关。请结合 curl 的连接错误、Claude Code 提示以及 Clash Verge 日志判断,不要只看一个状态码。
排查时应该使用规则模式还是全局模式?
日常使用通常优先选择规则模式,便于按目标分流。全局模式可作为短时对照测试,帮助判断是否与规则命中有关;测试完成后建议恢复原模式,并检查国内站点和局域网是否仍按预期直连。
什么时候需要开启 TUN?
当某个工具不识别代理变量、又无法通过系统代理工作时,TUN 可以作为进一步排查方案。它会影响更广泛的系统流量,启用前应确认权限、路由和冲突风险,并确保自己知道如何快速关闭。
与某些只适用于单一应用、或需要逐个进程手动配置的代理方式相比,Clash Verge 可以把规则、策略组和连接日志放在同一处管理;终端变量与 TUN 则分别覆盖了不同的命令行网络路径。若你希望按自己的设备与使用场景选择客户端,可以先了解可用版本,再逐项验证连接,而不必一开始就把整台机器长期设为全局代理。