What Is Clash Verge Rev?

Clash Verge Rev is an open-source graphical proxy client built on the Mihomo kernel (formerly Clash Meta). Community-maintained and actively updated, it inherits the clean UI of the original Clash Verge while improving stability, protocol support, and day-to-day usability. For many Windows and macOS users, it is the default choice when they want Clash-level routing without editing YAML by hand.

Compared with running Mihomo from the command line, Clash Verge Rev gives you one-click subscription import, visual node and policy group selection, live traffic stats, and rule management through a desktop interface. That lowers the barrier for anyone who needs split routing — send foreign sites through a proxy while keeping domestic traffic direct — but does not want to maintain config files manually.

Kernel note: Clash Verge Rev bundles Mihomo by default. It supports Vmess, Trojan, VLESS, Shadowsocks, Hysteria2, TUIC, and other common protocols, and works with the vast majority of Clash-format subscription URLs on the market.

This tutorial walks through the full setup path: install the client, import a subscription from your provider, pick the right proxy mode, optionally enable TUN for apps that bypass system proxy, and troubleshoot the issues that show up most often on fresh installs.

Download and Install Clash Verge Rev

Before you start, confirm your OS version. Clash Verge Rev supports Windows 10/11 (64-bit) and macOS 11 Big Sur or later. Linux builds exist in some forks, but this guide focuses on the two desktop platforms most users run.

Windows installation

  1. Visit the official Clash download page and download the Windows installer (.exe or .msi, depending on the release channel).
  2. Double-click the installer. If User Account Control prompts you, click Yes to continue.
  3. Accept the default install path unless you have a reason to change it, then wait for setup to finish.
  4. Launch Clash Verge Rev from the desktop shortcut or Start menu.
  5. On first launch, allow the app through Windows Firewall when prompted — blocking network access will prevent the proxy from working.
SmartScreen warning: Some builds trigger "Windows protected your PC" because the binary is not signed with a commercial certificate. Click More info, then Run anyway. This is a common false positive for open-source releases, not necessarily a sign of malware — always download from trusted sources.

macOS installation

  1. Download the macOS .dmg package — pick the ARM64 build for Apple Silicon (M1/M2/M3/M4) or the x86_64 build for Intel Macs.
  2. Open the DMG and drag Clash Verge Rev into the Applications folder.
  3. On first open, macOS may block the app with "cannot verify developer." Go to System Settings → Privacy & Security and click Open Anyway.
  4. Grant network permissions when the system dialog appears so the client can bind local proxy ports.
On macOS, adding Clash Verge Rev under System Settings → Privacy & Security → Full Disk Access can prevent permission errors when the client writes logs or reads certain config paths. Not every user needs this, but it helps if you see repeated access-denied messages.

Add a Proxy Subscription

A subscription URL is the link your proxy provider gives you. It points to a remote config file listing servers, credentials, and routing rules. Clash Verge Rev accepts standard Clash YAML subscriptions and many Base64-encoded provider URLs.

  1. Open Clash Verge Rev and go to the Profiles tab (labeled 配置 in some localized builds).
  2. Click New in the top-right corner and choose URL as the import type.
  3. Paste your full subscription link into the URL field — no leading or trailing spaces.
  4. Enter a profile name you will recognize later (for example, Provider-A).
  5. Click Import and wait until the profile appears in the list with a success indicator.
  6. Click the profile to activate it as the current configuration.
Turn on Auto Update in the profile settings so the client refreshes node lists on a schedule (every 24 hours is a sensible default). Stale subscriptions are a frequent cause of "all nodes timeout" reports.

If your provider sends a single .yaml file instead of a URL, use New → Local and point the client at the saved file. The rest of the workflow — selecting nodes and enabling proxy — is identical.

Proxy Modes and Node Selection

After the profile loads, open the Proxies tab. You will see policy groups defined by your subscription — common names include PROXY, AUTO, 手动选择, or region-specific groups like HK / US.

  • GLOBAL — routes everything through the selected node. Useful for quick tests, not ideal for daily browsing.
  • URL-test / Auto — picks the lowest-latency node from a pool on a timer or on demand.
  • Select / Manual — you choose a specific server and keep it until you switch.
  • Load-balance — spreads connections across multiple nodes. Good for downloads; avoid for latency-sensitive apps.

For everyday use, keep the client in Rule mode and toggle System Proxy on. Rule mode applies your subscription's split-routing logic: domestic sites and LAN addresses go direct, foreign or blocked destinations use the proxy. That balance keeps local services fast while still unlocking the sites you need through the tunnel.

Mode Best for Traffic behavior
Rule + System Proxy Daily browsing (recommended) Per-rule direct or proxy routing
Global Temporary full proxy All matched traffic through proxy
Direct Pause proxy without quitting Everything connects directly
Script Advanced customization JavaScript overrides in supported builds

Click the latency test icon next to a policy group to refresh ping numbers, then pick a node in a region close to your target service. A Hong Kong node helps for Asia-Pacific sites; a US West node is often better for American services. Latency in the client is an estimate — always verify with the actual site or app you care about.

Enable TUN Mode (Full Traffic Capture)

System proxy only affects applications that respect OS proxy settings — mainly browsers and a handful of desktop apps. Games, terminal tools, and some Electron apps open raw sockets and ignore the proxy entirely. TUN mode solves that by creating a virtual network adapter so Mihomo can capture TCP and UDP at the interface level.

  1. Open the Settings tab.
  2. Find the TUN Mode switch and turn it on.
  3. Approve the administrator privilege prompt (Windows UAC or macOS password).
  4. When TUN is active, the tray icon usually changes color and the dashboard shows the virtual adapter as running.
LAN devices: TUN mode can route local network traffic through the tunnel if rules are too broad. Add direct rules for private ranges before enabling TUN, or pause TUN when you need printers, NAS shares, or LAN multiplayer on the same subnet.

You do not need TUN for basic web browsing. Enable it when a specific program still fails after system proxy is on — or when you follow a gaming guide that requires full-stack capture. For deeper TUN and policy group tuning aimed at games, see our Clash game acceleration tutorial.

Troubleshooting Common Issues

Most first-week problems fall into a small set of patterns. Work through the sections below before reinstalling or switching clients.

Subscription import fails

Check four things: the URL was copied completely with no line breaks; your account with the provider is still active; your current network can reach the subscription host; and the link returns a valid config when opened in a browser. Corporate or school networks sometimes block provider domains — try importing from a different network or using a mobile hotspot briefly.

All nodes show timeout

Run a fresh latency test from the Proxies tab. If every node fails, the subscription may be expired or the profile failed to update — manually refresh the profile or request a new link from your provider. Also confirm you activated the correct profile; an empty local profile looks like "no working nodes" even when the subscription itself is fine.

Sites still load without proxy

Verify that System Proxy is enabled and the mode is set to Rule, not Direct. Some sites match a DIRECT rule in your config. Switch to Global mode temporarily to test whether routing is the issue. If Global works, add or adjust rules in the profile's Merge / Override section rather than leaving Global on permanently. 

# Example: keep private networks and local domains direct
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
DOMAIN-SUFFIX,local,DIRECT

Windows crashes or "missing runtime"

Install the latest Microsoft Visual C++ Redistributable (x64) from Microsoft's official site. Many Mihomo-based GUI crashes on Windows trace back to a missing VC++ runtime rather than the proxy config itself. Restart the client after installation.

macOS "damaged" or permission errors

Re-download the correct architecture (ARM vs Intel). Remove quarantine attributes if you sideloaded the app: open Terminal and run xattr -cr /Applications/Clash\ Verge\ Rev.app, then reopen from Applications. Grant network and, if needed, Full Disk Access as described in the install section.

Compared with all-in-one VPN apps that tunnel every app through one server — often slowing domestic sites — Clash Verge Rev keeps routing transparent and rule-driven. Browser-only extensions cannot proxy games or CLI tools at all. Command-line Mihomo offers the same kernel power but no visual node picker or subscription manager. Clash Verge Rev sits in the practical middle: Mihomo-grade protocols and rules, plus a GUI that gets beginners connected in minutes and still scales when you add TUN, overrides, and custom policy groups later.

Download Clash free for every platform →