What is Clash Verge Rev? What problems does it solve?

If you need to use a proxy subscription on Windows or macOS but don't want to manually edit YAML files or use the command line,Clash Verge Rev is almost certainly the best GUI client in the community right now. It is based on the Mihomo(formerly Clash Meta) kernel and is actively maintained by the open-source community, balancing a beautiful UI with deep functionality—making it the ideal choice for desktop users in 2026.

Unlike earlier clients like Clash for Windows which are no longer maintained, Verge Rev continues to receive updates. It supports VMess, Trojan, VLESS, Shadowsocks, Hysteria2, TUIC, and other mainstream protocols. It features one-click subscription import, node latency testing, traffic statistics, rule overrides, and TUN mode. For beginners, this means "copy link → import → start proxy" is all you need; for advanced users, you can still fine-tune routing and DNS via YAML overrides.

This guide is intended forfirst-time Clash users, following a clear sequence: Installation → Subscription → Proxy → TUN → Overrides → Troubleshooting. After completion, you should have your browser and apps working correctly within about 8 minutes. If you are more interested in mobile, check our FlClash guides; for desktop, stick with this Verge Rev workflow.

Download & Installation (Windows / macOS)

Check your OS version before installing:Windows 10/11 (64-bit), or macOS 11 Big Sur and above. We recommend 4GB+ RAM. On first launch, you must allow firewall and network access. Download installers only from our Client Download Page to ensure you get an official, un-modified version.

Windows Installation Workflow

1. Go to the Official Download Page, and download the Windows .exe .exe installer (or portable version, depending on release).
2. Double-click the installer; if UAC prompts, click "Yes" to grant admin permissions.
3. Follow the wizard to choose an installation path (default is fine) and wait for file copying to finish.
4. Launch Clash Verge Rev; when Windows Firewall asks for access, check "Private networks" and click Allow.
5. A paper plane icon will appear in your tray. Right-click it for quick access to modes or to exit.

macOS Installation Workflow

1. Download the correct architecture for your chip:Apple Silicon (M-series)choose ARM64,Intel Macchoose x86_64.
2. Go to the .dmg, then drag the app into your Applications folder.
3. On first launch, if you see "unverified developer," go to System Settings → Privacy & Security → click "Open Anyway."
4. Enabling TUN mode or other system features may require further authorization in "Full Disk Access."

Adding & Managing Subscriptions

A Subscription URL is provided by your airport or self-hosted service. Clash Verge Rev periodically pulls node lists, routing rules, and policy groups from this address. Formats are usually standard Clash YAML or Base64 encoded links.

Import via URL (Recommended)

1. Launch the app and click"Subscription"（Profiles）。
2. on the left. Click"New" at the top-right → select「URL」。
3. Paste your full subscription link in the URL field (avoid extra spaces or line breaks).
4. Give it a recognizable Name, like "Main Airport" or "Backup Nodes."
5. Click"Import"and wait for download and parsing to complete.
6. Left-click the card in the list toactivateit (it should highlight or show a checkmark).

Import via Local File

If your provider gives you a .yaml file instead of a URL, choose "Local File" to import it, or manually drop it into the app's config directory and refresh. This is ideal for offline backups or self-hosted setups.

System Proxy, Outbound Mode, and Node Selection

After activating your subscription, switch to the"Proxies"page. You will see pre-configuredPolicy Groups(Proxy Groups) such as "Auto Select," "Manual Select," "Media," and "Games." Each group contains nodes or nested sub-groups.

Three Outbound Modes

Switch between theseClash Modeson the main screen or via the tray menu:

• Rule: Matches traffic against the rules list—direct for domestic, proxy for overseas. This is theRecommended Mode。
• Global: All traffic goes through the proxy (except for specific LAN bypasses). Best for troubleshooting or reaching sites not in rule lists.
• Direct: Equivalent to disabling the proxy; all traffic goes direct. Useful for comparative testing or temporary disabling.

Enable System Proxy

1. Confirm the outbound mode is set to "Rule."
2. On the main screen, toggle the"System Proxy"switch to ON (or use the tray menu).
3. In the "Proxies" page, point your main policy group (e.g., "Proxy" or "Auto Select") to a low-latency node, or let the url-test automatic selection handle it.
4. Open your browser to test a site, or check the "Connections" page to see if traffic is exiting through the proxy.

Enabling TUN Mode: Taking Over Non-Browser Traffic

System Proxy cannot cover all programs. Many games, CLI tools, and some desktop apps initiate direct socket connections that bypass system proxy settings. This is where you needTUN Mode—it creates a virtual network interface to take over traffic at the IP layer, which Mihomo then forwards based on rules.

1. Go to"Settings"and find the TUN Mode TUN Mode switch.
2. Enabling this for the first time will prompt for Admin/Root permissions. Click "Yes" on Windows or enter your password on Mac.
3. Optional: You can configure the TUN Stack(e.g., gVisor, System) and Strict Route; defaults are sufficient for most users.
4. Once enabled, the tray icon usually changes color, and you can see tun0 connections in the tun0 Connections page.

Gaming acceleration, UDP voice, and Steam downloads often require TUN mode. For a deeper dive into the differences between TUN and System Proxy, check our related blog posts; for now, simply following the steps above is enough to get started.

Override Config: Customize Rules without Changing Subscriptions

Airport subscriptions usually don't allow direct editing of remote YAML files, but Clash Verge Rev supportsMerge / Override: Overlay local snippets on top of your subscription to add rules, modify DNS, or insert policy groups without them being overwritten on sync.

Common Use Cases

• Add a specific domain or IP range to DIRECT DIRECT or a chosen group.
• Adjust DNS modes (e.g., switching between fake-ip fake-ip redir-host and redir-host).
• Add ad-blocking or LAN-direct rules.

How to Operate

1. Select your current subscription in the "Subscription" page and find the"Override"or "Merge" entry.
2. Create a new override file and write YAML snippets (usually just the rules or dns rules or dns fields).
3. Save and enable the override; the client will merge the local snippet with the remote subscription automatically.
4. Observe rule matches in the "Logs" page to verify your custom domain follows the expected path.

# Merge example: force direct for LAN and custom domain
prepend-rules:
  - DOMAIN-SUFFIX,example.local,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve

FAQs & Troubleshooting

Subscription Import Failed or HTTP Error

1. Check if the URL is complete. 2. Open the link in an incognito window to see if it downloads the YAML file. 3. Some airports restrict IPs or require a specific User-Agent; contact your provider. 4. Corporate or school networks might block subscription domains; test with a mobile hotspot.

All Nodes Timeout or Cannot Connect

ClickSpeed TestSpeed Test to refresh data. If all nodes still time out, your subscription might have expired, data exhausted, or system time is too far off (TLS handshake failure). Windows users: if the client crashes, ensure Microsoft Visual C++ 2019+ Redistributable is installed. Microsoft Visual C++ 2019+ Redistributable (x64)。

System Proxy On but Sites Still Won't Load

Confirm outbound mode is "Rule," not "Direct." Test with "Global" mode; if Global works but Rule doesn't, the target domain is missing from your rules. Add it via DOMAIN-SUFFIX DOMAIN-SUFFIX to the appropriate group in overrides. For more on routing, check our main Tutorials section. Docs and blog categories.

No Internet or Local Network Failure after Enabling TUN

Check DNS and catch-all rules first: point MATCH MATCH to "Auto Select" instead of a dead node; ensure LAN CIDRs are set to DIRECT. If using Hyper-V, Docker, or other VPNs, try disabling them before restarting TUN.

Compared to single-purpose commercial "accelerators" or un-maintained closed-source clients,Clash Verge Rev + Mihomo Clash Verge Rev + Mihomo offers transparent rules, full protocol support, and active community updates. You can see every routing logic and fine-tune it via overrides. If you prefer a "download and use" experience with less tweaking, our provided clients come with optimized templates for beginners.

For developers, source code for Mihomo and Clash Verge Rev is available on the Mihomo GitHub Repository to track protocol support and release cycles. However, we recommend using ourDownload Page for daily installersto ensure consistency with these tutorials and checksum verification.

Free Download Clash now for a smoother browsing experience →