Clash Verge Rev · 2026

Clash Verge Rev — install it, import your subscription, master the routing modes.

If one-click VPN apps like Happ no longer cut it and you want full control over which traffic goes through the VPN and which runs directly, Clash Verge is the tool — specifically its active, modern fork, Clash Verge Rev. This guide covers downloading the client safely on Windows and macOS, importing your subscription profile, understanding the two-level routing model (System Proxy vs TUN, then Rule vs Global vs Direct), and fixing the failures everyone hits.

Clash Verge Rev · the short version

What Clash Verge Rev actually is

Clash Verge Rev isn't a VPN service — it's a graphical dashboard for the Mihomo routing core, which does the real work: routing traffic, managing DNS queries, and executing rule sets.

Rev is the living fork — the original is dead

The original Clash Verge (the zzzgydi/clash-verge repository) shipped its last update in October 2023. There is no reason to install it today: it lacks modern protocol support and receives no security fixes. Clash Verge Rev is the active continuation, run by a new team with regular releases. Outdated guides still point at the old project — check the repository name before downloading.

A GUI over the Mihomo core

Mihomo handles the technical work — traffic routing, DNS, rule execution. Clash Verge Rev gives it a friendly dashboard: profile cards, a proxies panel with latency checks, and one-click toggles for System Proxy and TUN. It's built to parse advanced Clash/Mihomo YAML configs, merge multiple subscription profiles, and enforce custom routing rules.

Windows install — two paths

On the GitHub Releases page, most PCs need the standard x64 installer (ARM devices take the arm64 build). On Windows 11 you can skip the browser entirely: winget install ClashVergeRev.ClashVergeRev in a terminal. If the app opens as a blank white window, your system is missing the WebView2 runtime — download the build with fix_webview2 in the filename.

macOS install — match your chip

macOS 12 or newer. Apple Silicon (M1/M2/M3) takes the installer with aarch64 in the name; Intel Macs take x64. macOS 11 and older aren't officially supported — you'd need to upgrade the OS or run the routing core manually via CLI. Enabling System Proxy on macOS asks for administrator authentication; if you cancel that prompt, the proxy settings silently don't apply.

Setup with an IT CRP subscription · 5 minutes

The same steps work for any provider that issues Clash-compatible subscription links.

STEP 01

Download from the official GitHub and install

Go to the Releases page at github.com/clash-verge-rev/clash-verge-rev, take the latest stable version, and download the installer for your OS — x64 for most Windows PCs, aarch64 for Apple Silicon Macs. Third-party download portals offer unofficial builds that may bundle malware or ads; the developers publish only on GitHub.

STEP 02

Import your subscription profile

Copy the subscription URL from your IT CRP dashboard. In Clash Verge Rev, open the Profiles tab in the sidebar, paste the link into the input field at the top, and click Import. When the profile card appears, click it once to activate it. IT CRP supports subscription metadata, so the card shows your plan details, remaining traffic, and expiration date.

STEP 03

Pick Rule mode and a server

Go to the Proxies tab, select the Rule routing mode, and choose a server location. Click the latency check icon (the lightning bolt / radar symbol) — a ping value like 75 ms means the server is online; timeout means it's currently unreachable, so pick another.

STEP 04

Toggle System Proxy (or TUN) and verify

At the bottom of the window, switch on System Proxy — or TUN Mode if you need gaming, calls, or CLI tools covered. The toggle turns green. Open an IP-check site like ipinfo.io or 2ip.io: if your location shows the VPN server's, you're connected.

The routing modes, untangled

The configuration operates on two independent levels: ingress — how traffic from your computer enters the client — and egress — where the client routes it next. Pick one from each level.

System Proxy · ingress, the simple default

The client registers itself as the system-wide proxy in Windows/macOS settings. Browsers and most desktop apps route their HTTP/HTTPS traffic through it automatically. Limitations: some applications bypass system proxy settings entirely, and system proxies don't handle UDP — which online gaming, torrents, and VoIP calls (Discord, Telegram calls) require.

TUN Mode · ingress, catches everything

The client creates a virtual network interface and forces all inbound and outbound traffic through it — including games, CLI tools, and proxy-ignoring apps — with full UDP support. On Windows, enable Service Mode in the settings for a stable setup: it installs a background service so TUN activates without running the app as administrator every time.

Rule · egress, the daily driver

The recommended mode for daily use — split tunneling. The client decides per connection whether to go direct or through the VPN based on rule sets bundled with your subscription profile: local and regional sites stay on your direct connection (faster, no location flags), blocked sites go through the tunnel.

Global · egress, everything through one server

Forces all traffic through the selected VPN server, bypassing the rule list. Use it to test a specific server location, or as a quick workaround when the rules fail to route a particular site properly.

Direct · egress, VPN off

Bypasses the VPN entirely and routes everything over your regular connection. Useful for troubleshooting: if a site fails in Direct mode too, the problem is your ISP connection, not the VPN.

Troubleshooting — the failures everyone hits

  • Subscription import fails with client error (Connect) or UnknownIssuer. Right-click the profile card (or click its gear icon), enable the Allow invalid certificates toggle, and update the profile again.
  • Server selected, but traffic bypasses the VPN. Certain apps — like the App Store version of Telegram on macOS — ignore system-wide proxy rules. Either enter the proxy settings manually inside the app's own options, or switch to TUN Mode, which they can't bypass. On macOS, also check you didn't cancel the administrator prompt when enabling System Proxy — without it the settings never apply.
  • No internet after closing the app. A crash or force-close on Windows can leave the system proxy switched on with nothing behind it. Windows Settings → Network & Internet → Proxy → turn off the proxy server manually.
  • TUN Mode won't connect. Windows Defender Firewall or third-party antivirus can block the Mihomo core — add Clash Verge Rev to the exclusion list. Other VPN adapters and virtual machines (VirtualBox, VMware) can conflict with the TUN interface; disable unused virtual adapters in Windows Network Connections.
  • Specific sites won't load. Two usual suspects: the default port 7897 is occupied by another program (change it in settings), or a third-party utility (game boosters are notorious) has edited your local hosts file, which Mihomo queries by default — disable use-system-hosts in the profile's advanced configuration if that's the cause.

Clash Verge Rev vs Happ vs v2rayN — which client should you run?

All three accept IT CRP subscription URLs. The right one depends on how much control you want.

Clash Verge Rev — complete control

Built to parse advanced Clash/Mihomo YAML configurations, merge multiple subscription profiles, manage DNS resolution, handle UDP tunneling, and enforce custom routing rules. Choose it if you need real split tunneling and per-rule routing — this page's subject.

Happ — set-and-forget

Fully optimized for VLESS/VMess, imports keys instantly, and hides the networking details entirely. The best choice for regular users who just want the VPN to work — and our default recommendation on phones. See the Happ setup guide.

v2rayN — the Windows utility knife

Every modern protocol, on-the-fly core switching between Xray and sing-box, works perfectly with standard subscription links. Simpler than Clash Verge Rev, more hands-on than Happ. See the v2rayN setup guide.

$9 / mo
Free 1 GB key first · Solo upgrade $9/mo · 5 devices · works in Clash Verge, v2rayN, and Happ
Get free 1 GB key

Clash Verge Rev questions

Is Clash Verge Rev free?
Yes, it is entirely free and open-source. There are no built-in charges or subscriptions inside the app itself — you only pay your VPN provider for the network access it routes.
Is Clash Verge a VPN service?
No. Clash Verge Rev is only a client utility — a graphical frontend for the Mihomo routing core. It runs no servers of its own. To access the internet through it, you must add a valid subscription profile from a VPN provider such as IT CRP.
Should I use System Proxy or TUN Mode?
For standard web browsing, System Proxy is perfectly fine — browsers and most desktop apps route through it automatically. For gaming, Discord or Telegram calls, torrents, or command-line developer tools, TUN Mode is the better choice: it captures traffic from all software including apps that ignore proxy settings, and fully supports UDP. On Windows, enable Service Mode in the settings for a stable TUN setup without running the app as administrator every time.
The internet isn't working after setup. What should I check?
Go through this checklist: 1) Is the profile card highlighted (active) in the Profiles tab? 2) Under Proxies, do you see a ping value like 80 ms rather than timeout when you run the latency check? 3) Is either the System Proxy or TUN toggle enabled (green) at the bottom of the window? Most connectivity issues are resolved by completing one of these three steps.
Clash Verge Rev opens as a blank white window. How do I fix it?
A blank white window on Windows means your system is missing the WebView2 runtime, which the app's interface depends on. Go back to the official GitHub releases page and download the build containing fix_webview2 in the filename — it bundles the runtime and resolves the blank window.
Clash Verge Rev setup guide · last verified July 2026 · steps match the current stable Clash Verge Rev release for Windows 10/11 and macOS 12+.
IT CRP is operated outside mainland China. Founders, payment processing, and servers are outside Chinese jurisdiction.