Claude Code 国内怎么用？先理解它为什么需要稳定代理

如果你搜索的是「Claude Code 国内怎么用」「Claude Code 登录失败」「Clash Verge 怎么配置 Claude」，真正需要解决的通常不是安装命令本身，而是终端进程、浏览器授权和模型请求没有走同一条稳定链路。Claude Code 是面向开发者的命令行 AI 编程工具，可以读取项目文件、解释代码、生成补丁、执行测试，并通过自然语言协助完成重构、排错和文档编写。它的使用体验高度依赖网络：登录阶段要访问 Anthropic 账号服务，模型对话需要维持连续的 HTTPS 请求，安装或更新依赖时还可能访问 npm、GitHub 和其他代码托管站点。

很多用户已经在浏览器中打开了 Claude 网页，却发现终端里的 Claude Code 仍然报错，原因在于浏览器扩展代理不等于系统代理，系统代理也不一定能被 Node.js 子进程完整继承。另一个常见情况是，Clash Verge 界面显示「系统代理已开启」，但终端使用的包管理器、Git 或开发工具仍然直连。本文以 Clash Verge 为例，从订阅导入、基础模式、域名分流到终端验证，讲清楚一套适合新手的配置顺序。不同版本的菜单名称可能略有变化，但 Profile、Proxies、Logs、Settings 和 TUN 等核心概念基本一致。

先说明边界：Clash 只能负责本机网络转发，不能替代 Claude 账号、订阅服务或 Anthropic 的地区与账户政策。请使用合法合规的网络服务和账号；如果日志已经显示请求成功到达目标服务器，却返回权限、额度或地区错误，就不应继续盲目更换节点。

开始前准备：安装 Clash Verge 并导入可用订阅

首次配置时，建议把问题拆成「客户端能不能运行」「订阅能不能更新」「节点能不能连接」「终端能不能使用」四层，不要一上来就打开 TUN 或修改大量 YAML。这样做的好处是每一步都有明确的检查结果，出现故障时也容易回退。你需要准备一台 Windows、macOS 或 Linux 电脑，一条仍然有效的订阅链接，以及能够正常启动的 Clash Verge 或 Clash Verge Rev 客户端。

  1. 确认客户端来源：从可信的项目发布页或正规软件渠道获取安装包，按照系统架构选择 Windows、macOS 或 Linux 版本。不要使用来源不明的「增强版」「破解版」或把订阅链接预先写入安装包的二次打包文件。
  2. 导入订阅：打开 Clash Verge 的 Profiles 或配置页面，粘贴订阅 URL，点击导入或下载。订阅链接应当像密码一样保管，避免发到群聊、截图或提交到公开代码仓库；如果怀疑泄露，应在服务商后台重置。
  3. 选择配置：导入完成后，点击新配置旁边的启用按钮。若配置下载成功但无法启用，先查看 YAML 解析提示，并确认当前客户端使用的是 Mihomo 内核，而不是无法识别新语法的旧内核。
  4. 选择节点：进入 Proxies 页面，在主要策略组中选择延迟稳定、丢包较少的节点。第一次测试不要使用会频繁自动切换的复杂策略组，固定一个节点更容易判断网络问题。
  5. 开启系统代理：在 Clash Verge 的设置中打开 System Proxy 或「系统代理」。然后用浏览器访问一个普通的国内网站和一个你需要使用的服务页面，确认开关打开后网络没有整体中断。

订阅能成功更新，只能证明「订阅地址」可访问，不代表 Claude Code 的模型请求已经通畅。订阅下载通常只是一次短连接，而 AI 编程请求可能持续更久，还会伴随登录跳转、代码文件上传、流式响应和多次 API 请求。因此，完成导入后还要继续检查连接日志和终端环境。

新手建议：第一次不要同时修改 DNS、TUN、规则集和代理端口。先用「固定节点 + 规则模式 + 系统代理」跑通浏览器与终端，再根据具体软件是否绕过代理决定要不要启用 TUN。

为 Claude Code 设置分流：不要只写一个模糊的全局规则

Clash Verge 的规则模式会按照配置文件中的顺序匹配域名、IP 或进程流量。对于 Claude Code，重点不是把所有流量永久设置为全局代理，而是让账号授权、模型服务和必要的代码托管域名进入正确的策略组，同时保留国内网站直连。这样可以降低不必要的延迟，也避免国内镜像、企业内网和本地开发服务被错误转发。

Claude 相关域名可能随登录方式、客户端版本和服务端架构变化，不能把一份网上流传的列表当成永久答案。常见情况下，可以重点观察连接日志中出现的 Anthropic、Claude 或登录授权相关主机名，例如 anthropic.com、claude.ai 及其子域名。实际配置时更稳妥的做法是先用日志确认真实目标，再使用后缀规则逐步补充，而不是把陌生域名全部加入代理。

  • 账号与网页授权：登录过程中如果浏览器跳转到 Claude 或 Anthropic 的账号页面，应确认对应域名在 Clash 连接列表中命中了代理策略组。
  • 模型请求：Claude Code 启动后发送 prompt、读取模型响应时，重点观察是否有新的 Anthropic API 主机名出现，以及请求是否被错误分配到 DIRECT。
  • 代码下载：项目初始化、依赖安装或示例代码拉取可能访问 GitHub、npm registry、CDN 等站点。这些流量不一定属于 Claude 域名，需要根据项目实际依赖单独处理。
  • 本地地址：localhost、127.0.0.1、局域网开发服务器和数据库地址通常应保持直连，避免代理规则干扰本地回调、热更新或调试接口。

如果你习惯直接编辑配置文件，可以在 rules 区域加入与你现有策略组名称一致的规则。下面只是表达思路的示例，策略组名称必须替换成你配置里真实存在的名称：

rules:
  - DOMAIN-SUFFIX,anthropic.com,Claude
  - DOMAIN-SUFFIX,claude.ai,Claude
  - DOMAIN-SUFFIX,github.com,Developer
  - DOMAIN-SUFFIX,npmjs.org,Developer
  - MATCH,DIRECT

规则顺序非常重要。更具体的域名规则应放在宽泛规则之前，最终的 MATCH 只能作为兜底。如果前面已经存在一个把所有国外域名送往其他策略组的规则，后面再添加 Claude 规则不会生效。修改后重新载入配置，并在 Logs 或 Connections 页面查看命中结果。若配置由远程订阅自动更新，建议使用 Clash Verge 的 Merge、Patch 或覆写功能保存本地规则，否则下次刷新订阅时手工修改可能被覆盖。

不要盲目复制域名：把整个 google、github 或「所有国外网站」加入同一个代理组，短期可能看似有效，长期却会让故障难以定位。最可靠的依据是 Claude Code 实际运行时的连接日志、错误信息和当前版本文档。

让终端真正走 Clash：系统代理、环境变量与 TUN 的选择

这是最容易被忽略的一步。Clash Verge 开启系统代理后，浏览器通常会立即生效，但命令行程序是否使用代理取决于程序实现。部分 Node.js 工具会读取 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY 环境变量，部分 Git、包管理器或开发框架则有自己的代理配置。若 Claude Code 在浏览器登录正常、终端请求超时，应优先确认终端是否能访问 Clash 的本机混合端口。

在 Clash Verge 的设置页面找到 HTTP、HTTPS 或 Mixed Port。常见端口可能是 7897、7890 或其他数字，不能照抄示例，必须以客户端当前显示值为准。在 macOS 或 Linux 的终端中，可以临时设置环境变量：

export HTTP_PROXY=http://127.0.0.1:7897
export HTTPS_PROXY=http://127.0.0.1:7897
export ALL_PROXY=http://127.0.0.1:7897

Windows PowerShell 可以使用类似方式：

$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"
$env:ALL_PROXY="http://127.0.0.1:7897"

设置后只对当前终端窗口有效，关闭窗口便会失效。这样做适合测试，确认链路没有问题后，再决定是否写入 Shell 配置文件或 Windows 用户环境变量。不要把带有账号密码的代理地址直接写入公开项目，也不要把这些变量复制进团队仓库中的脚本。

验证时不要只执行 Claude Code 命令。先做低成本检查：观察 Clash Connections 是否出现新的终端连接，确认请求命中了预期策略组，再执行 Claude Code 的登录或简单 prompt。如果终端工具支持详细日志，可开启 debug 模式，重点看 DNS 解析、TLS 握手、代理连接失败和 HTTP 状态码。对于 Git 和 npm，还应分别测试它们自己的代理设置，因为某个工具成功并不意味着所有子进程都会继承相同配置。

TUN 模式适合那些不读取系统代理、无法方便设置环境变量，或由多个子进程发起请求的开发环境。它通过虚拟网卡和路由接管更多 TCP、UDP 流量，能够覆盖部分桌面软件、容器和终端进程，但也会引入管理员权限、DNS 劫持、路由冲突及虚拟机兼容性等新变量。建议先用系统代理和环境变量完成 Claude Code 的基础验证；只有确认程序确实绕过代理，再在 Clash Verge 中启用 TUN，并保留关闭 TUN 后的回退方案。

  • 开启 TUN 前，确认客户端具有所需权限，并关闭其他 VPN、代理软件或重复的虚拟网卡。
  • 启用后先访问本地开发服务、国内网站和 Claude 相关页面，确认不是「部分能用但内网失效」。
  • 如果出现所有网站打不开、DNS 解析异常或 WSL／Docker 网络中断，先关闭 TUN，恢复到系统代理模式再排查。
  • 开发机使用多个网络接口时，检查自动识别出口网卡是否正确，避免 Wi-Fi、网线和虚拟网卡之间发生路由竞争。

登录与运行排障：按日志定位，不要反复换节点

完成代理设置后，Claude Code 的登录流程仍可能受到浏览器回调、缓存凭据和本地端口的影响。授权页面打开但终端迟迟没有成功，先确认浏览器和终端是否运行在同一台电脑上；如果使用远程 SSH、容器或 WSL，浏览器回调地址可能无法回到真正启动登录流程的环境。此时要看 Claude Code 提示的回调方式，并确保本机回环地址没有被代理或安全软件拦截。

现象 优先检查 处理方向
浏览器打不开授权页 Claude 或 Anthropic 域名是否命中代理 查看 Connections，补充真实命中的域名规则并固定节点。
授权完成但终端一直等待 本地回调、127.0.0.1 与防火墙 确认终端与浏览器在同一环境，临时检查安全软件和本地端口占用。
能登录但第一次提问超时 模型请求是否被 DIRECT 在请求发生时查看日志，确认目标主机和策略组，不要只测试网页。
代码生成中途断开 节点稳定性、自动切换和长连接 先固定低抖动节点，避免 url-test 在会话过程中切换出口。
npm 或 Git 下载失败 包管理器自己的代理配置 分别检查 registry、CDN、Git 远程地址和环境变量是否生效。

如果错误码是 401、403 或订阅额度不足，首先检查账号状态、登录身份和服务权限；如果是 404，可能是客户端版本、接口路径或产品配置不匹配；如果是连接超时、TLS 错误、连接被重置，则更像是代理链路、DNS、节点质量或终端未走代理。不要把所有错误都归因于 Clash，也不要因为一次成功就认为配置永久稳定。AI 服务端点、客户端依赖和订阅规则都会变化，定期查看日志比维护一份过时的固定域名清单更可靠。

完成排障后，可以把配置整理成简单的日常流程：启动 Clash Verge，确认订阅没有过期，选择稳定节点，打开系统代理或 TUN，然后在终端确认环境变量，最后再运行 Claude Code。长时间生成代码时尽量不要频繁切换节点；项目依赖下载和模型请求可以使用不同策略组，但要保证组内节点都经过实际测试。这样既能减少全局代理带来的副作用，也能让每一次失败都留下清晰的排查线索。

相比一些只提供单一全局开关的同类工具，部分方案在终端代理继承、规则命中查看、TUN 回退和订阅覆写方面配置较分散，遇到 Claude Code 登录与 npm 下载同时异常时，往往只能反复重装或更换节点。Clash 官网 的优势在于把 Clash Verge、Mihomo 内核、终端环境变量和分流排障放在同一套可核对的步骤中，既能从系统代理开始低风险验证，也能在需要时逐步升级到 TUN 和精细规则；如果你正准备按本文配置 Claude Code，不妨前往下载，再结合日志把自己的规则维护起来。