先分清问题在哪:Claude Code、终端与 Clash 是三层
运行 Claude Code 时出现登录失败、请求超时,或者网页能打开、命令行却连不上,未必是同一个故障。通常要分别检查三层:第一层是 Claude 服务与账号本身是否可用;第二层是运行 Claude Code 的终端进程有没有使用代理;第三层是 Clash 当前节点、规则和 DNS 是否能把请求送到合适的出口。把三层混在一起反复切换节点,容易掩盖真正原因。
Clash 负责网络转发,不负责账号授权或地区资格。它不能替你创建 Anthropic 账号、绕过服务的地区限制或修复账号风控。如果账号所在地区、付款方式或服务条款不符合要求,即使代理连接正常,Claude Code 仍可能拒绝登录或使用。开始排查前,请先确认你所在地区、账号状态与服务可用性;不要把网络连通误当成服务一定可用。
另一个常见误区是认为桌面客户端开启了「系统代理」,所有终端程序就会自动走代理。浏览器通常会读取系统代理设置,但命令行程序是否读取、读取哪种变量,取决于程序和运行环境。Claude Code 从外部终端、IDE 集成终端、SSH 会话或容器启动时,继承到的代理设置也可能不同。
先检查 Clash:确认模式、节点和本地代理端口
先在 Clash Verge、Clash Verge Rev 或其他 Mihomo 客户端中确认内核正在运行,选中的节点可用,且不是误选了已失效的策略组。第一次排查建议使用规则模式,并在 Clash 的连接或日志页面观察后续请求;不要一开始就长期切换全局模式。全局模式可能让更多不相关流量进入代理,增加延迟,也会让问题来源更难辨认。
接着查看客户端显示的 HTTP、SOCKS 或混合代理端口。常见示例端口是 7890,但实际值可能不同,必须以本机设置为准。确认本地监听地址通常是 127.0.0.1,不要把示例端口直接当成固定值。若使用远程桌面、虚拟机、容器或 WSL,容器里的 127.0.0.1 指向容器自身,并不一定是宿主机上的 Clash;此时需要单独确认宿主机地址、网络模式和防火墙规则。
再观察 Clash 的连接记录:启动 Claude Code 或执行一次连通性测试后,是否出现新的请求?如果完全没有记录,优先怀疑终端没有使用代理、请求未从当前设备发出,或端口地址不正确。如果记录出现但被送到 DIRECT,就检查规则与策略组;如果命中代理组后仍超时,再检查节点质量、DNS、TLS 连接和服务端响应。不同版本菜单名称略有差异,按「端口」「系统代理」「连接」「日志」等功能入口查找即可。
给终端显式设置代理:先在当前会话验证
如果浏览器能通过 Clash 正常访问,而 Claude Code 在终端中报网络错误,最直接的下一步通常是为该终端设置代理环境变量。下面以 macOS、Linux 和多数类 Unix Shell 为例,假设 Clash 的 HTTP 代理端口是 7890。请替换成自己的实际端口:
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
环境变量仅对当前 Shell 及其启动的子进程生效。设置后,从同一个终端启动 Claude Code,才可以确认它是否继承到这些变量。若你在一个终端窗口中设置变量,却从另一个窗口、桌面快捷方式或 IDE 菜单启动程序,后者未必能读到这组设置。
可以先做一次不包含账号凭据的 HTTPS 测试:
curl -I --max-time 15 https://api.anthropic.com/
返回 HTTP 状态码并不等于 API 已通过身份验证。测试根路径可能返回错误状态,重点是观察它是否能在合理时间内完成 DNS、代理连接和 TLS 握手;如果命令仍停在连接阶段,先检查变量值、端口和 Clash 日志。也可以用 env | grep -i proxy 检查当前 Shell 是否持有代理变量,注意不要把带有用户名或密码的代理地址复制到公开日志。
在 Windows PowerShell 中,可在当前窗口临时设置环境变量,再从该窗口启动程序:
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
claude
如果你的客户端只暴露 SOCKS 端口,不要未经确认就把 SOCKS 地址填进只接受 HTTP 代理的变量。优先使用 Clash 的 HTTP 或混合端口;如果确实需要 SOCKS,先核对 Claude Code、运行时与代理变量对相应协议的支持情况。永久写入 Shell 配置文件或 Windows 用户环境变量之前,建议先用临时会话验证,避免代理停用后其他开发工具仍指向失效端口。
检查规则命中:让相关请求走预期策略组
Clash 规则通常按顺序匹配,先命中的规则会决定连接的去向。排查时不要只看配置里有没有某个域名,更要确认规则有没有排在可能拦截它的宽泛规则之前,以及日志中实际使用了哪一个策略组。Claude Code 可能涉及 Anthropic 服务域名及登录、遥测或其他依赖服务;具体请求目标会随版本、功能和账号流程变化,不应把一份固定域名清单当成永远完整的答案。
可以先从服务主域的精确或后缀规则开始,再根据 Clash 日志中实际观察到的主机名补充。以下示例仅演示规则结构,策略组名称必须与你自己的配置相符;如果没有名为 AI 的策略组,直接照抄会导致配置校验失败:
rules:
- DOMAIN-SUFFIX,anthropic.com,AI
- DOMAIN-SUFFIX,claude.ai,AI
# Add hosts only after confirming them in the connection log
不要为了「覆盖全面」就把所有含有 ai 字样的域名,或所有云服务域名,一律交给同一个代理组。过宽规则可能影响无关网站、增加延迟,也会让日志失去诊断价值。若日志显示某个请求命中了错误规则,优先调整已观察到的具体条目,并确认它出现在更宽泛的匹配规则之前。使用远程订阅时,尽量通过客户端支持的覆写或规则合并功能添加本地规则,不要直接改动会被下次更新覆盖的订阅文件。
区分网络故障与登录、账号或服务错误
当网络请求已经完成连接,错误却来自身份验证或服务端,就不应继续只换节点。典型线索包括:登录页面可以打开,但回调失败;认证信息过期或被拒绝;服务明确提示账号不可用;或者接口返回配额、权限与请求格式相关错误。此时请记录错误的完整文字和 HTTP 状态码,移除日志中的访问令牌、Cookie、邮箱等敏感信息,再判断是账号状态、服务地区、权限还是请求配置问题。
如果 Claude Code 使用浏览器完成登录,浏览器与终端可能处于不同的网络出口。登录过程中频繁切换节点或规则模式,有时会使会话的网络环境变化,触发额外验证。排查期间尽量保持同一节点与同一代理路径,完成一次完整登录流程后再测试命令行请求。若涉及组织账号、团队策略或企业代理,请同时确认管理员设置、证书检查和网络访问策略;不要通过关闭安全校验来掩盖证书问题。
对服务端错误也要保留判断空间:401 或 403 更常指向认证、权限或访问策略,429 可能与速率限制或额度有关,5xx 可能是服务端暂时异常。这些状态码本身不能单独证明原因,但能帮助区分「连接没建立」与「请求已经到达服务端」。如果网络正常而错误持续存在,应查看 Claude Code 官方说明、账号页面或组织管理员提供的信息。
按顺序排障:避免同时改太多变量
- 确认服务可用性。核对服务地区、账号状态和组织权限,排除与代理无关的限制。
- 确认 Clash 正常运行。检查内核状态、节点、HTTP 端口和策略组,记录当前配置模式。
- 确认终端环境。在启动 Claude Code 的同一个终端查看代理变量,确保地址和端口正确。
- 单独测试连接。用
curl观察请求能否完成连接与 TLS 握手,再查看 Clash 日志是否出现对应连接。 - 对照规则与结果。确认实际主机名、命中规则和策略组;逐项修正,不要一次替换全部规则。
- 最后再启动 Claude Code。若网络测试通过但登录或 API 仍失败,转向检查认证状态、权限、配额、版本和服务端错误。
如果终端程序运行在 Docker、远程 SSH 主机、WSL 或 IDE 的远端开发容器里,应在实际运行 Claude Code 的环境中设置代理,而不是只修改桌面宿主机。容器网络、DNS 和证书信任可能与宿主机不同;尤其不要把宿主机的回环地址误认为容器可访问的代理地址。远程环境还应核对企业网络政策,并避免将代理凭据写入镜像、仓库或共享脚本。
常见问题
浏览器能用,为什么 Claude Code 仍然超时?
浏览器可能自动读取系统代理,终端程序却未必如此。请在启动 Claude Code 的同一个终端设置并检查 HTTP_PROXY 与 HTTPS_PROXY,随后观察 Clash 日志是否出现对应连接。
代理端口一定是 7890 吗?
不一定。7890 只是常见示例,不同客户端、配置或用户设置可能使用其他端口。请以 Clash 当前显示的 HTTP 或混合代理端口为准,并确认该端口正在监听。
curl 返回 401 或 404,是否代表代理失败?
不一定。服务可能已收到请求,只是根路径不提供可直接访问的内容,或请求缺少认证信息。应同时检查命令是否完成 TLS 握手、响应是否及时,以及 Clash 日志中的连接去向;不要把 HTTP 错误码直接等同于网络超时。
排查时要不要一直开全局模式?
通常不需要。先用规则模式和明确的终端代理变量验证目标请求,按日志修正规则。如果某些进程确实无法使用代理变量,再评估 TUN 等接管方式,并确认它符合设备、网络和组织策略。
部分命令行工具只依赖自己的代理参数,另一些会读取系统设置,还有一些运行在容器或远程环境中;因此,笼统的「全局代理」虽方便,却可能带来流量范围过宽、问题难以定位等代价。相比之下,Clash 可以通过终端代理变量、规则匹配和连接日志,把 Claude Code 的网络请求逐步验证并按需分流。若你希望先准备好适合当前设备的客户端,再按步骤完成设置,可以从下载与教程入口开始。