Windows
macOS
Linux选择系统和架构对应的安装包
从 官方稳定版 Releases 下载，展开 Assets 后核对系统与处理器架构。日常使用选正式版，AutoBuild 用于测试反馈。GitHub 的 Source code 是源码压缩包，不能当安装程序运行。
| 设备 | 选择方法 |
|---|---|
| Windows | 在系统信息中查看架构；Intel/AMD 常见为 x64，ARM 设备选择发布页对应包。 |
| macOS | 在“关于本机”查看芯片，Intel 与 Apple 芯片分别选择对应 DMG。 |
| Linux | Debian/Ubuntu 选 DEB，Fedora 等选 RPM，同时核对 x64 或 ARM 架构。 |
当前安装文档要求 Windows 10/11、macOS 12 及以上；仓库简介仍出现 macOS 11+ 的表述，旧系统应以 安装文档与该版本发布说明 为准。这个项目没有 Android 或 iOS 安装包。
安装与首次启动
- Windows 运行官方安装程序，保留明确的安装位置，首次启动观察界面和服务状态。不要同时启动旧版 Clash Verge 与新版客户端。
- macOS 打开 DMG，把应用拖到 Applications 后再启动；遇到系统拦截，先核对来源和发布说明，再按系统给出的应用授权入口处理。
- Linux 使用发行版包管理器安装对应 DEB/RPM，让它同时处理依赖；不要把其他发行版的包强行解压替代安装。
Windows 如果只有托盘图标、窗口白屏或点击没有反应，检查 WebView2 是否被卸载或禁用。官方另外提供带 WebView2 的安装包，具体名称以当前 Assets 为准。先解决界面启动问题，再配置节点，避免把运行环境故障误判为订阅不可用。
导入订阅或本地 YAML
- 准备兼容 Clash/mihomo 的订阅地址或 YAML 配置文件。普通网站首页、账户登录页与订阅 URL 不相同。
- 进入订阅管理区域，使用链接导入功能粘贴完整地址；成功后确认新增配置中出现预期的节点与策略组。
- 已有本地文件时使用本地配置导入；官方也支持把配置文件拖入界面。导入后启用该配置，不能只停留在“已经下载”这一步。
- 为配置起一个自己能识别的名称，记录来源与最后更新时间，后续只更新需要使用的订阅。
如果收到的是 vmess://、vless:// 等单节点分享链接，先确认提供方是否有 Clash 格式，不要把不同格式直接改后缀为 YAML。导入方式见 官方订阅文档。订阅 URL 常含账户令牌，截图和求助时隐藏完整地址。
选择节点和流量接管方式
配置启用后，先给承担流量的策略组选一个节点。规则模式按 YAML 分流，全局模式使用全局策略；浏览器是否进入客户端，则由系统代理或应用设置决定。
第一次配置先开启系统代理，使用浏览器验证。系统代理修改操作系统的代理设置，许多浏览器会遵循，但部分命令行、游戏或其他应用不会。需要处理这类应用时，再考虑 TUN 虚拟网卡模式，并按授权提示安装或启用所需服务。
TUN 涉及网卡、DNS 和路由，启动失败时先关闭它，确认系统代理路径仍能工作。公司网络、虚拟机或另一个 VPN 已有路由设置时，逐项核对冲突。官方快速入门 给出了节点选择与两种接管方式。
验证浏览器与本地代理入口
- 查看客户端是否显示内核正常运行，并记下当前 HTTP 或混合代理端口，不照抄其他教程的默认端口。
- 打开你实际需要使用的网站，同时观察连接列表：目标域名、匹配规则、策略组和节点应符合预期。
- 在 首页验证工具 选择 HTTP 代理和实际端口，生成 curl 命令。在 Windows PowerShell 使用
curl.exe，避免同名命令别名造成差异。 - 分别测试一个应直连的目标和一个应代理的目标，最后关闭代理，确认普通网络恢复。
延迟测试成功只说明测试目标在当时能够响应，不代表所有网站、UDP 应用或吞吐量都满足要求。显式 curl 请求成功而浏览器失败时，优先检查浏览器独立代理设置、系统代理开关和绕过列表，而不是立即更换全部配置。
白屏、订阅失败和 TUN 故障
- 订阅导入失败：核对 URL 是否完整、是否返回配置内容以及当前网络能否访问订阅域名。证书报错先检查系统时间和服务端证书，不把关闭证书校验作为常规解决办法。
- 节点或策略组空白：检查已启用的配置和内核日志，区分配置解析失败与客户端连接内核失败。
- 系统代理正常、TUN 失败：检查服务状态、权限和其他虚拟网卡；若提示服务安全检查失败，阅读官方说明，不自行放宽整个安装目录的写入权限。
- 退出客户端后断网：检查操作系统是否残留指向本机端口的手动代理，关闭残留设置再重试。
Windows 的具体错误见 官方故障说明。向项目反馈时提供系统、版本、接管方式和复现步骤，日志中的订阅令牌、UUID 与节点密码先脱敏。
备份、规则修改与更新
更新前导出配置和设置，并记下常用策略组、端口和 TUN 状态。使用 WebDAV 时，额外保存一份本地备份，恢复时不必依赖远端服务。
订阅更新可能替换远程 YAML。需要长期保留的自定义分流应放到客户端提供的扩展配置或规则管理机制中，先用少量规则验证，避免直接改完远程文件后下次更新全部丢失。备份本身也可能包含访问凭据，应放在受控存储中。
从正式发布渠道更新后，重复导入检查、真实请求与退出恢复三项验证。如果迁移后出现问题，保留原备份与错误日志，不急于清空配置目录；先区分应用升级、内核变化和订阅内容变化。
常见问题
Clash Verge Rev 可以在 iPhone 或 Android 上使用吗？
它是 Windows、macOS 和 Linux 桌面客户端，没有官方 Android 或 iOS 安装包。手机可在工具目录查看 FlClash、Hiddify 等对应平台客户端，配置格式仍需分别确认。
Windows 界面打不开，是否应该重新买订阅？
先检查 WebView2 和安装包架构。只有托盘图标或白屏通常属于界面运行环境问题，与订阅是否有效没有直接关系。按官方安装与 Windows 故障文档处理后再验证连接。
为什么手动改好的规则在更新订阅后消失了？
远程订阅更新可能重新写入配置文件。把需要保留的修改放到扩展配置或规则管理功能中，更新前备份，并在更新后检查规则优先级和实际命中结果。
参考资料
下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。