Claude Code 是 Anthropic 推出的终端 AI 编程工具,能够在命令行中理解项目、编辑文件并协助运行开发任务。若网页端可以访问、终端里的 Claude Code 却登录失败或反复超时,常见原因并不是程序安装错误,而是终端进程没有使用 Clash 代理、代理端口填写不匹配,或相关域名被规则分配到了不合适的策略组。本文按「确认代理 → 设置终端环境变量 → 检查 Clash 分流 → 定位故障」的顺序说明操作方法。服务可用性还受所在地区、账号资格、Anthropic 服务条款与网络条件影响;配置代理本身不会改变账号的可用地区或访问权限。

先弄清终端与 Clash 的代理关系

Clash Verge、Clash Verge Rev、Clash for Windows、ClashX、Clash for Android 等客户端通常会提供系统代理、TUN 模式或本地代理端口。浏览器能打开网站,只能证明浏览器当前的网络请求可用,不能据此判断 Claude Code 也走了代理。终端程序通常通过环境变量读取 HTTP 代理地址;如果没有设置,或者设置成了错误端口,命令行请求可能直接连接网络。

在 Clash 客户端中先确认核心正在运行,并查看「端口设置」「端口」或「覆写」页面中的 HTTP 或 mixed-port。很多配置会使用 7890,但这只是常见示例,不是所有客户端的固定值。若 HTTP 和 SOCKS 端口分别显示为不同数字,请优先使用客户端明确标出的 HTTP 端口;mixed-port 通常同时接受 HTTP 与 SOCKS 请求。不要把 Dashboard 的控制端口误当作代理端口。

检查项应确认的内容常见误区
Clash 核心客户端显示运行中,节点或策略组可正常选择只打开客户端窗口,但核心没有启动
代理端口记下 HTTP 或 mixed-port 的实际端口号照抄示例端口,忽略本机配置不同
终端环境变量HTTP_PROXY、HTTPS_PROXY 指向本机代理地址只启用系统代理,认为所有命令行程序都会自动跟随
分流策略相关域名命中预期策略组,节点可用节点测速成功,但目标域名实际被规则直连

建议先在 Clash 面板中手动选定一个可用策略组,再开始测试。这样可以把问题拆开:若代理连通性测试本身失败,应先处理节点或 Clash;若代理测试成功、Claude Code 仍失败,再检查环境变量、域名规则、认证状态和客户端日志。启用 TUN 并不意味着一定要额外配置终端代理变量;但为了排查命令行请求,显式设置变量通常更直观,也便于确认流量的去向。

先核对端口再配置:以下示例中的 7890 和 127.0.0.1 仅适用于代理监听在本机且端口确实为 7890 的情况。如果 Clash 运行在另一台设备、虚拟机或容器中,应改用终端能够访问的地址,并确认监听范围与防火墙设置允许连接。

为终端设置代理环境变量

Claude Code 的终端请求需要使用终端进程能够读取的代理设置。最简单的方法是在启动 Claude Code 的同一个终端会话中设置 HTTP_PROXY 和 HTTPS_PROXY。使用本地 HTTP 或 mixed-port 时,地址一般写成 http://127.0.0.1:端口;即便目标网站使用 HTTPS,代理地址也通常仍以 http:// 开头,因为这里描述的是终端到本机代理的连接方式,而不是目标网站的加密协议。

macOS、Linux、WSL:当前终端会话
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"

# 查看变量是否已写入当前会话
printenv | grep -i proxy

# 在同一终端中启动
claude

变量只对当前终端会话及其启动的子进程生效。关闭终端后,临时设置通常会消失,适合先验证而不是立即写入长期配置。若确认可用,再将设置放入正在使用的 shell 配置文件,例如 Zsh 的 ~/.zshrc 或 Bash 的 ~/.bashrc,保存后重新打开终端,或运行对应的配置加载命令。不要在共享设备或不受信任的脚本中随意写入包含用户名、密码的代理 URL。

Windows PowerShell 可在当前窗口中设置进程级变量。先确认 Clash 客户端的代理地址和端口,再执行下面的命令;新打开的 PowerShell 窗口不会自动继承这个临时设置。

Windows PowerShell:当前窗口
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:http_proxy = $env:HTTP_PROXY
$env:https_proxy = $env:HTTPS_PROXY

# 检查当前窗口中的变量
Get-ChildItem Env:*proxy*

# 在同一个窗口启动
claude

如果你的环境只提供 SOCKS 端口,可以依据所用工具及其版本支持情况设置 ALL_PROXY,例如使用 socks5h://127.0.0.1:端口。其中 socks5h 表示域名解析也通过代理端处理;但并非每个终端工具或运行时都支持相同的代理协议。遇到连接异常时,先改用 Clash 提供的 HTTP 或 mixed-port 做基准测试,避免同时更改协议、端口与规则,导致故障原因难以区分。

配置完成后,可用支持代理环境变量的命令行工具测试目标服务的网络连通性。HTTP 状态码不是判断账号能否使用的依据:例如服务端返回需要认证或不接受当前请求,仍可能说明 DNS 解析、TLS 握手和代理转发已经到达服务端。测试时不要将 API 密钥放进命令行历史记录、截图或公开日志,也不要为了排错关闭 TLS 证书验证。

检查代理连通性(不验证账号权限)
curl -I --max-time 15 https://api.anthropic.com

如果命令报告无法连接到 127.0.0.1:7890,优先检查 Clash 是否运行、端口是否正确,以及终端与 Clash 是否处于同一网络环境。若请求等待后超时,而本地端口可连接,进一步查看 Clash 连接记录,确认请求是否进入预期策略组,以及选中的节点是否可访问目标服务。

检查 Clash 分流与规则匹配

终端代理变量解决的是「请求如何进入 Clash」,而 Clash 规则决定「请求从哪里出去」。如果目标域名命中直连规则,设置好环境变量后请求仍可能没有经过所选节点;若命中代理策略组,但组内节点不可用,也会表现为登录停滞或请求超时。排查时打开 Clash 的连接、日志或规则命中页面,观察 Claude Code 请求对应的目标域名、规则名称和策略组,不要仅凭浏览器访问结果推断。

如果确认需要为特定域名使用代理,可在自己维护的配置或客户端支持的规则覆写中添加域名规则,并将它放在可能提前匹配的宽泛规则之前。规则目标名称必须与当前配置中实际存在的策略组名称一致;不同订阅的策略组名称并不通用。不要直接改写由订阅管理的原始配置,订阅更新可能覆盖修改。更稳妥的做法是使用客户端提供的合并配置、规则覆写或独立规则管理功能。

规则示例:由指定策略组处理目标域名
rules:
  - DOMAIN-SUFFIX,anthropic.com,你的代理策略组
  - DOMAIN-SUFFIX,claude.ai,你的代理策略组
  - MATCH,你的默认策略组

上例只是规则结构示意。实际使用时,请将“你的代理策略组”和“你的默认策略组”替换为配置中存在的名称,并检查客户端对规则格式及覆写方式的说明。不要为了让一个工具运行,就把所有流量一律强制代理;按域名精确分流更便于发现规则冲突,也能减少无关流量受到影响。域名清单应以当前客户端连接记录中实际出现的请求为依据,不要依赖过时的网帖清单。

若使用 Mihomo 内核或支持规则集的客户端,可以把相关规则放在便于维护的位置,并确认规则集已经加载、更新时间正常。出现“配置已保存但行为不变”时,检查覆写是否应用到当前活动配置、规则是否处于正确顺序,以及当前运行核心是否接受该语法。完成修改后使用客户端的配置检查或重载功能;如果解析错误,先恢复到最近可用配置,再逐项调整。

分流不等于授权:代理只能改变连接路径,不能保证服务在你的地区可用,也不能替代账号资格、服务条款或组织网络政策。请遵守 Anthropic 的适用条款及当地规定;不要使用来历不明的中转服务,也不要把账号凭据交给第三方代配。

按症状排查登录失败与请求超时

当 Claude Code 无法连接时,先记录准确的错误信息和发生时间,再按层次定位。每次只改一个变量:先验证代理端口,再验证终端请求,随后检查 Clash 命中规则,最后检查账号与客户端状态。这样能够区分网络层错误、认证问题和服务本身的可用性问题,避免不断更换节点或重装工具却无法确认原因。

现象优先检查建议操作
提示连接拒绝或无法连接代理代理端口、Clash 核心、监听地址核对客户端实际端口;确认 Clash 正在运行;在同一终端检查代理变量
连接等待后超时策略组、节点状态、规则命中在 Clash 连接日志中确认目标请求是否进入预期策略组,并测试其他可用节点
浏览器可用,终端不可用系统代理与进程环境变量的差异在启动 Claude Code 的终端中显式设置 HTTP_PROXY 和 HTTPS_PROXY
请求到达服务端但登录失败账号认证、授权流程、设备时间按官方登录流程重新确认授权;核对系统时间;不要将认证失败误判为代理故障
只在某个项目或终端失败项目环境、启动脚本、容器代理检查脚本是否覆盖变量;确认容器内能访问代理主机与端口

如果 curl 通过代理能够建立连接,但 Claude Code 仍然无法使用,查看 Claude Code 输出的具体错误,并确认命令是在设置变量的同一终端中启动。某些编辑器的内置终端、远程 SSH 会话、WSL、Dev Container 和容器环境,与桌面系统的网络命名空间不同:其中的 127.0.0.1 指向当前环境自身,不一定是运行 Clash 的主机。此时应检查客户端或开发环境文档,确定容器访问宿主机的正确地址,并避免将本机代理端口暴露到不可信网络。

若终端变量已正确、Clash 日志显示请求命中预期代理策略组、节点也可连接,但服务返回认证或权限提示,应转向检查官方账号登录状态、订阅或 API 使用方式以及服务当时的可用状态。不要通过随意设置 ANTHROPIC_BASE_URL 将请求指向未知服务;只有在你明确使用组织批准的兼容接口、并已核实服务商与数据处理规则时,才应按其正式文档配置相应地址。

排查结束后,确认长期配置是否符合自己的使用习惯。若只需临时访问,保留当前会话变量即可;若写入 shell 配置文件或 Windows 用户环境变量,应记录变更位置,便于日后恢复。最终以终端请求、Clash 连接记录和账号官方状态三者相互印证为准:代理连通不代表账号一定可用,账号可用也不代表终端已经正确使用 Clash。按这三个层次逐步检查,通常比反复重装客户端更快找到问题所在。