Clash Verge Rev Complete Setup Guide (2025)

What is Clash Verge Rev?

Clash Verge Rev is one of the most actively maintained Clash GUI clients available today. Built with Tauri + React and powered by the Mihomo (clash-meta) core, it runs on Windows and macOS. After the original Clash Verge project was abandoned, the community forked it into Clash Verge Rev, which continues to ship new features, including:

Native TUN mode (no extra drivers needed)
Built-in override editor (write overrides via GUI)
Multiple subscription management with scheduled updates
Lightweight (~10 MB installer) with low memory usage

Clash Verge Rev is a different project from the original Clash Verge. If you were using the old version, migrating to Rev is recommended to receive ongoing updates and security patches.

Step 1: Download the Installer

Visit our download page or GitHub Releases to get the latest version. Choose the package that matches your system:

Windows: Download the .msi installer (recommended) or _x64-setup.exe
macOS Intel: Download _x64.dmg
macOS Apple Silicon (M-series): Download _aarch64.dmg

Windows Installation Notes

If Windows Defender SmartScreen shows a warning during installation, click "More info" → "Run anyway". This happens because the app does not yet have a paid code-signing certificate — it is not malicious.

macOS Installation Notes

Mount the DMG and drag the app into Applications. On first launch, macOS may show "cannot be opened because the developer cannot be verified." To fix this, run the following command in Terminal:

sudo xattr -rd com.apple.quarantine /Applications/Clash\ Verge.app

After running the command, the app will open normally.

Step 2: Import a Subscription

Open Clash Verge Rev and click the Subscriptions tab in the left sidebar.

Click the New button in the top-right corner
In the dialog, select the Remote type
Paste your subscription URL (usually provided by your proxy service)
Enter a name for easy identification and set an auto-update interval (24 hours recommended)
Click Confirm and wait for the subscription to download
Click the Use button on the subscription card to activate it

If the subscription URL itself requires a proxy to be accessed, import a working config file manually first to establish a basic connection, then update the subscription.

Step 3: Choose a Proxy Mode

Go to Settings and toggle on System Proxy (or switch it directly from the home screen). Clash Verge Rev offers three proxy modes:

Rule Mode — Recommended: Routes traffic based on rules in your config. Direct connections for local/regional services; proxy for everything else.
Global Mode: All traffic is routed through the proxy. Useful for debugging.
Direct Mode: All traffic connects directly, effectively disabling the proxy.

For everyday use, stick with Rule Mode — it delivers the best balance of speed and proxy usage.

Step 4: Enable TUN Mode (Optional)

The default System Proxy mode works by setting system-level HTTP/SOCKS proxies, which only covers apps that respect those settings (browsers, most desktop apps). TUN mode creates a virtual network interface and captures traffic at the network layer, covering games, CLI tools, and any app that doesn't support proxy settings.

To enable TUN mode:

Go to Settings → Clash Settings
Find the TUN Mode toggle and enable it
Windows users will be prompted to install the virtual NIC driver (Wintun) — confirm the installation
Administrator privileges are required on first use; approve the permission prompt

With TUN mode enabled, all system traffic is processed by Clash. If you are using another VPN or proxy tool simultaneously, be careful to avoid routing loops.

Step 5: Select a Node

Click the Proxy tab in the left sidebar to view all nodes and policy groups.

PROXY group: This is typically the main exit point. Choose Auto Select to automatically use the lowest-latency node, or manually pick a specific one.
Click the speed-test icon next to any node to measure its latency individually.
Latency under 100 ms is excellent; above 300 ms may cause buffering when streaming video.

Step 6: Override Subscription Config (Advanced)

Overrides let you inject custom rules on top of your subscription without modifying it — for example, forcing a specific IP range to connect directly, or adding ad-blocking rules.

Go to Settings → Override, click New, select the JavaScript type, and write your script. Below is a simple example that prepends two direct-connection rules:

// Prepend custom direct-connection rules before subscription rules
function main(config) {
  const customRules = [
    "DOMAIN-SUFFIX,example.com,DIRECT",
    "IP-CIDR,192.168.0.0/16,DIRECT",
  ];

  if (config.rules) {
    config.rules = [...customRules, ...config.rules];
  }

  return config;
}

After saving, enable this override on the target subscription in the Subscriptions tab, then re-select the subscription to apply it.

Troubleshooting

Web pages are unreachable after opening Clash Verge Rev

Confirm that System Proxy is enabled (the status indicator in the top-left should be green). If it's on but pages still don't load, check whether your current node is reachable: go to the Proxy tab, run a speed test, and see if latency values are returned.

Subscription update fails with "Network Error"

Some subscription URLs require a proxy connection to be accessed. A quick fix: switch to Global Mode first, then click Update. Alternatively, copy the subscription URL into your browser (which is already proxied through Clash), download the config file, and import it as a Local subscription.

Network completely drops after enabling TUN mode

This is usually caused by a failed virtual NIC driver installation or an IP address conflict. Try: disable TUN mode → restart Clash Verge Rev → right-click and run as Administrator → re-enable TUN mode.

Summary

Clash Verge Rev is one of the most polished Clash clients available for Windows and macOS. With the six steps above, you have everything needed for everyday proxy use. To go further, check out:

Download Clash for Free – Get Started Now →

Clash Verge Rev — Complete Setup Guide for 2025