1. 为什么需要代理?
Claude Code 调用的是 Anthropic 的海外 API,在国内网络环境下直接访问可能会遇到连接问题。Verge Clash 是一个基于 Clash 内核的图形化代理客户端,可以帮助你:
- 稳定访问 Claude API 等海外服务
- 通过规则分流,让国内流量走直连、海外流量走代理
- 提供系统级代理,命令行工具(如 Claude Code)也能自动使用
合法合规使用
请确保你的代理服务来源合法,并遵守当地法律法规。本教程推荐的订阅服务商为正规运营平台。
2. 下载 Clash Verge
Clash Verge 是 Clash 内核的跨平台 GUI 客户端,支持 Windows、macOS 和 Linux。
- 访问 Clash Verge Rev GitHub Releases
- 根据你的系统下载对应版本:
| 系统 | 下载文件 |
|---|---|
| macOS (Apple Silicon M1/M2/M3) | Clash.Verge_x.x.x_aarch64.dmg |
| macOS (Intel) | Clash.Verge_x.x.x_x64.dmg |
| Windows 64-bit | Clash.Verge_x.x.x_x64-setup.exe |
3. 安装与启动
- 打开下载的
.dmg文件 - 将 Clash Verge 拖到 Applications 文件夹
- 首次启动时,系统会提示无法打开,前往「系统设置」→「隐私与安全性」→ 点击「仍要打开」
- 启动后,菜单栏会出现 Clash 图标
💻 macOS 本地
Terminal
# 如果通过命令行启动(便于查看日志)
/Applications/Clash\ Verge.app/Contents/MacOS/Clash\ Verge
macOS 权限提示
macOS 对非 App Store 应用有严格限制。如果无法打开,除了「隐私与安全性」设置外,还可以按住 Control 键点击应用图标,选择「打开」。
- 运行下载的
.exe安装程序 - 按向导完成安装(建议安装到默认路径)
- 安装完成后,从开始菜单或桌面快捷方式启动
- 首次启动时,Windows 防火墙可能会提示允许网络访问,点击「允许」
4. 购买并获取订阅链接
订阅链接包含了代理节点列表和路由规则,需要在代理服务商处购买。
- 访问 https://y-too.net/
- 注册账号并完成购买(选择适合你的套餐)
- 登录用户中心,找到「订阅」或「订阅链接」页面
- 复制 Clash 格式的订阅链接(通常以
https://开头,包含 token 参数)
订阅链接是什么?
订阅是一个 URL 链接,包含了你的代理节点列表和路由规则。服务商会在用户中心提供这个链接。定期更新订阅可以获取最新的节点信息。
5. 配置代理订阅
启动 Clash Verge 后,导入从 y-too.net 获取的订阅链接。
- 在 Clash Verge 主界面,点击左侧「订阅」
- 点击「导入」或「+」按钮
- 粘贴你从 y-too.net 复制的订阅 URL
- 点击「确定」,等待订阅下载完成
- 下载完成后,点击「使用」激活该订阅
6. 设置系统代理
为了让命令行工具(如 Claude Code)也能使用代理,需要启用系统代理模式。
- 在 Clash Verge 主界面,点击左下角的「系统代理」开关,将其打开
- 确保「TUN 模式」也处于开启状态(这会让所有流量都经过 Clash 路由)
- 在「设置」中,将「启动时自动运行」和「开机自启」打开(可选但推荐)
TUN 模式 vs 系统代理
系统代理:仅影响支持系统代理设置的应用(浏览器等)。
TUN 模式:在系统底层创建一个虚拟网卡,所有网络流量都会经过 Clash 路由。命令行工具必须开启 TUN 模式才能走代理。
7. 验证代理是否生效
打开终端,测试能否访问 Claude API。
💻 macOS 本地
Terminal
# 测试访问 Claude API(应返回 JSON 响应,而非连接超时)
curl -s https://api.anthropic.com/v1/health | head -c 200
# 如果开启 TUN 模式后仍无法访问,检查 Clash 日志
# 在 Clash Verge → 设置 → 日志 中查看连接记录
# 查看当前系统代理设置(确认已生效)
scutil --proxy
🪟 Windows 本地
PowerShell
# 测试访问 Claude API
Invoke-RestMethod -Uri "https://api.anthropic.com/v1/health" -Method GET
# 如果 TUN 模式正常工作,应该能看到响应
# 如果报错,检查 Clash Verge 是否已开启 TUN 模式
# 查看当前代理设置
netsh winhttp show proxy