Claude Code国内怎么用？Clash访问与终端配置指南

Claude Code 国内连接异常，先分清是哪一段出了问题 详解

搜索「Claude Code 国内怎么用」「Claude Code 连接超时」或「Clash 终端代理怎么设置」时，常见情形并不只有一种：安装命令下载缓慢或报错，Claude Code 启动后无法登录，浏览器完成授权但终端迟迟没有响应，或者登录成功后发送提示词时反复出现网络错误。它们看起来都像是“代理没开”，实际可能分别发生在包管理器、浏览器授权回调、Claude Code 发出的 HTTPS 请求，以及 Clash 规则选择等不同环节。

最容易忽略的一点是，浏览器能访问网站，不代表终端程序也在走代理。Clash 的系统代理通常会影响遵从操作系统代理设置的应用，但终端里的 Node.js 程序、Shell 脚本及其子进程可能使用自己的网络实现，不一定自动读取系统代理。即使你已经在 Clash Verge 或其他客户端中打开系统代理，Claude Code 仍可能直接连接网络；反过来，终端代理变量设置正确，如果 Clash 规则把目标域名送进了直连策略组，也一样会失败。

因此排障时不要一开始就反复换节点或重装工具，而应按顺序确认：Clash 是否正在运行、混合端口是多少、当前终端是否设置代理变量、目标域名命中了哪条规则、请求是否已经到达服务端。每次只调整一个环节，再用同一条命令或同一个提示词复测，才能区分网络问题、规则问题与帐号或服务端返回的错误。本文讨论的是终端代理配置与连接诊断；代理设置不能改变 Claude 服务的地区可用性、帐号资格或服务条款要求。

先确认服务可用性：使用前请核对 Anthropic 当前面向你所在地区的服务政策、帐号条件和官方说明。Clash 负责转发符合规则的网络请求，不会替代帐号验证，也不应被用来规避服务限制。

配置前先核对 Clash 端口、运行状态与代理策略 全面解析

Claude Code 的终端代理通常需要一个本机 HTTP 代理入口。Clash Verge、Clash Verge Rev、Mihomo Party 等客户端常见的做法是启用混合端口（Mixed Port），由同一个端口接收 HTTP 代理和 SOCKS 请求。默认端口经常是 7890，但用户可能改过端口，客户端配置也可能使用其他值，因此不要只照抄示例；应在客户端的设置、端口信息或配置文件中确认当前实际端口。若客户端运行在另一台设备、虚拟机或容器里，127.0.0.1 指向的是当前运行环境，不一定是运行 Clash 的那台主机。

确认端口后，再看 Clash 当前是否已载入可用配置、代理组是否有可选择的节点，以及连接列表是否正常刷新。测试时可暂时在代理组中手动选择一个稳定节点，避免自动测速策略组在复测期间切换出口。节点延迟测试通过只能说明测速地址可达，并不能证明 Anthropic 相关域名也能连接；如果稍后出现握手失败或连接超时，应以 Claude Code 请求发生时的 Clash 日志为准。

检查项目 确认方式 常见误区
Clash 运行状态 客户端显示内核运行，配置已加载 界面已打开，但内核停止或配置未生效
混合端口 查看客户端设置或当前配置中的端口值 把示例中的 7890 当成所有机器的固定端口
代理组与节点 确认策略组中有可用节点，并先手动固定测试 只看测速结果，没有检查实际请求日志
规则命中 启动 Claude Code 时观察目标连接及策略组 看到连接记录就以为它已经走了代理

若不确定端口是否可用，可先从当前终端向本机代理发送一次简单请求。不同系统的命令工具和参数略有差异，关键是确认请求确实连接到本地端口；若提示拒绝连接，优先检查 Clash 是否运行、端口是否填错，以及终端所在环境能否访问宿主机。不要把 Clash 的外部控制器端口误当作 HTTP 混合端口：两者用途不同，控制器通常用于管理和查询，不能直接作为普通网页请求的代理地址。

给终端设置 HTTP_PROXY 与 HTTPS_PROXY 一次讲透

Claude Code 在终端中发起网络请求时，常用的代理配置方式是设置 HTTP_PROXY 和 HTTPS_PROXY 环境变量，并让它们指向 Clash 的本机 HTTP 混合端口。变量一般需要在启动 Claude Code 的同一个终端会话中生效。只在一个窗口里设置、随后从另一个终端或 IDE 按钮启动程序，环境变量可能不会继承过去；如果你使用 VS Code 集成终端、远程开发容器或 WSL，也要确认命令实际运行在哪个环境。

在 macOS、Linux 或常见的类 Unix Shell 中，可按实际端口执行以下命令。这里使用 7890 作为示例值，若 Clash 配置显示的端口不同，应一并替换。对于无需代理的本机回环地址及内网服务，可设置 NO_PROXY，避免本地授权回调或开发服务绕远路。

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1

claude

Windows PowerShell 中可以在当前窗口设置对应变量，再从同一窗口启动程序：

$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:NO_PROXY = "localhost,127.0.0.1,::1"

claude

这种设置通常只对当前终端进程及其子进程生效，关闭窗口后变量就不再保留，适合先验证链路。若确认有效，再考虑写入 Shell 配置文件或 Windows 用户环境变量；长期保存之前，建议先了解团队开发环境的代理规范，避免把临时代理地址写进项目脚本、共享配置或提交到代码仓库。企业设备还可能使用集中管理的代理或证书策略，擅自覆盖环境变量会影响其他工具。

  1. 核对端口：从 Clash 客户端确认混合端口，并在命令中替换示例值。
  2. 设置变量：在即将运行 Claude Code 的终端内设置 HTTP_PROXY 与 HTTPS_PROXY。
  3. 启动程序：从同一个终端执行 claude，不要先设置变量再从未继承环境的图形启动器打开。
  4. 观察日志：在 Clash 连接列表中查找启动或登录时出现的目标域名，确认策略组和连接结果。
  5. 记录结果：记下错误发生在安装、登录还是模型请求阶段，并保留终端错误文本，方便下一步针对性排查。

实用提示：先用临时环境变量验证，再决定是否永久设置。如果终端里的请求已经出现在 Clash 连接列表，但策略组显示为直连，问题通常在分流规则；如果完全没有相关连接记录，则优先检查代理变量是否被当前进程读取，或应用是否使用了不遵循这些变量的网络实现。

为 Claude Code 配置分流：让相关请求走正确的策略组 深入理解

环境变量只告诉终端“向哪里发送代理请求”，并不负责决定流量最终使用哪个节点。分流由 Clash 配置中的规则和策略组控制。可以先建立或选用一个明确的代理策略组，再根据本机连接日志与当前官方文档，确认 Claude Code 登录、帐号验证和模型请求实际访问的主机名。常见排查范围可能涉及 anthropic.com 及其相关子域，也可能出现用于帐号或网页授权的其他服务域名；具体请求会随产品版本、登录方式和功能变化，不应把未经验证的静态域名清单视为永久完整名单。

使用 Mihomo 配置时，规则顺序尤其重要。针对目标域名的规则应放在可能提前匹配的宽泛规则之前，并指向实际存在的代理组名称。下面是展示写法的示例：将 YOUR_PROXY_GROUP 换成配置里真实的策略组名，并结合连接日志决定是否需要为其他明确观察到的域名补充规则。不要把示例占位符原样粘贴到正式配置中。

rules:
  - DOMAIN-SUFFIX,anthropic.com,YOUR_PROXY_GROUP
  - DOMAIN-SUFFIX,claude.ai,YOUR_PROXY_GROUP
  - MATCH,DIRECT

如果配置使用远程规则集或客户端覆写功能，建议优先通过客户端支持的规则覆写方式追加本地规则，而不是直接改动每次更新都会被覆盖的订阅文件。修改后检查 YAML 缩进和策略组名称，再重新载入配置。若规则写在兜底规则之后，或者规则引用了不存在的组，结果可能与预期不同；应以客户端显示的生效配置和该请求实际命中的规则为准。

日志排查时可以这样判断：若看到目标域名并命中代理组，继续检查节点是否可连接以及服务端返回内容；若命中直连，检查规则顺序、域名匹配方式和 DNS 解析结果；若完全看不到目标域名，回到终端变量和进程启动方式排查。对于使用自动选择、负载均衡或故障转移策略的场景，测试阶段先固定节点，避免一个请求通过代理、另一个请求换到不同出口，导致现象难以复现。确认连接稳定后，再恢复日常策略。

不要把规则结果等同于服务可用：命中代理组只说明 Clash 按规则转发了请求，不代表帐号有权限、地区符合服务要求，或服务端一定接受连接。若 TLS 连接已完成而终端返回明确的认证、权限或地区提示，应按照官方帐号与服务说明处理，不要持续更换节点来掩盖服务端拒绝。

登录失败、请求超时与“浏览器能用终端不行”排查 详解

Claude Code 的首次登录可能会打开浏览器完成授权，再由本地终端进程继续工作。此时浏览器网页与终端 API 请求是两条相关但不完全相同的路径：浏览器能完成授权，不足以证明 Claude Code 后续请求使用了同一代理；终端也可能因为本机回调地址、浏览器启动方式或网络策略而无法顺利完成登录。不要把访问本机的 localhost 或 127.0.0.1 的回调请求强行送往远程代理，按需将回环地址放进 NO_PROXY，并确认本地安全软件没有拦截回调端口。

现象 优先检查 下一步处理
安装命令卡住或超时 包管理器请求、终端代理变量、安装源连通性 先单独验证安装网络，不要和模型请求故障混为一谈
浏览器授权后终端仍等待 本机回调、终端进程状态、Clash 是否记录相关连接 确认回环地址未被错误代理，并重新观察登录日志
登录成功但提示词请求超时 模型请求域名命中规则、代理节点稳定性 固定节点复测，检查连接日志中的目标和失败阶段
浏览器正常，终端无法连接 启动 Claude Code 的 Shell 是否继承代理变量 在同一终端设置变量后直接启动程序，再对照连接记录
连接成功但返回认证或权限错误 帐号状态、服务资格、地区政策与请求信息 依据官方说明排查服务端问题，不要只通过换节点处理

如果终端错误中出现超时，先区分是 DNS 查询、TCP 建连、TLS 握手还是服务端响应阶段。Clash 日志里的连接目标和错误信息能帮助缩小范围：没有连接记录，多半需要检查环境变量、应用代理支持或是否从正确的终端启动；记录显示直连，则看规则命中和配置顺序；显示代理节点连接失败，则检查节点状态与客户端网络；显示连接已建立但应用返回认证或权限错误，则应转向帐号和服务端条件。每次只改一个变量，并在修改后重复同一项测试，避免同时改 DNS、TUN、节点和规则，最后无法判断哪项真正起效。

当本机终端变量无法被应用识别时，可以再考虑由 Clash 的 TUN 模式接管更多系统流量，但这会涉及虚拟网卡、路由表、DNS 和系统权限，影响范围比单独配置终端代理更大。建议先用环境变量完成最小范围的验证；确实有多个不支持代理变量的开发工具需要统一接管时，再阅读所用客户端的 TUN 设置说明，并留意 Docker、WSL、虚拟机和公司 VPN 可能带来的路由冲突。对日常使用而言，清楚区分“终端变量控制应用如何连接”和“Clash 规则决定流量走哪里”，比一开始启用所有代理模式更容易维护。

与手动在每个终端和项目里反复试错相比，有些代理客户端在端口、策略组和日志入口方面的说明不够直观，新手容易把系统代理、TUN 与终端环境变量混成一个开关；Clash 则围绕 Clash 客户端的实际配置与排障流程整理信息，便于按步骤核对本机端口、规则命中和请求状态。若你还需要准备合适的 Clash 客户端，再根据自己的系统与使用习惯查看可用版本，不妨前往下载后按本文方法逐项验证。