Clash Verge Rev Complete Installation & Configuration Guide (Windows / macOS / Linux)

Preface

Clash Verge Rev is currently the most actively maintained Clash desktop client. Built on the Tauri framework, it is lightweight, performs well, and natively supports Windows, macOS, and Linux platforms. It features the built-in Mihomo (formerly Clash.Meta) core and supports all mainstream functions such as TUN mode, multi-subscription management, and rule-based split tunneling.

Target Audience

Windows / macOS / Linux desktop users. Suitable for both beginners and advanced users.

1Download and Install the Client

Windows Installation

Go to the Clash Download Page, click on the Windows tab, and download the "x64 Installer (.exe)".
Double-click to run the .exe installer. If a "Windows protected your PC" prompt appears, click "More info" → "Run anyway".
Follow the prompts to complete the installation. Once a shortcut is generated on the desktop, double-click to open it.

ARM64 Devices

For ARM architecture computers such as Surface Pro X and Snapdragon X Elite, please download the ARM64 Installer for better performance.

macOS Installation

Download the .dmg file for your architecture: aarch64 for Apple Silicon (M-series) or x64 for Intel Macs.
Open the .dmg file and drag the application into the /Applications folder.
If prompted with "File is damaged" upon the first launch, run the following in the terminal:

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

Linux Installation

Choose the installer format based on your distribution:

# Debian / Ubuntu (.deb)
sudo apt install ./clash-verge-rev_*.deb

# Fedora / openSUSE (.rpm)
sudo rpm -i clash-verge-rev_*.rpm

# 通用（AppImage，无需安装）
chmod +x clash-verge-rev_*.AppImage
./clash-verge-rev_*.AppImage

2Importing Subscription Link

Open Clash Verge Rev, click "Profiles" on the left menu to enter the subscription management page.

Click the "+" button at the top right and select "New".
Paste the Clash subscription link obtained from your service provider into the "Subscription URL" field.
Fill in the "Name" field (e.g., "My Provider") and click "Save".
After saving, the subscription entry will appear in the list. Click the "Update" icon on the right to pull the nodes.
Once updated successfully, the number of nodes will be displayed at the top right of the subscription entry.

Subscription update failed?

The initial update requires network connectivity. If the update fails, temporarily select an available node, turn on the proxy, and then update again. Alternatively, manually download the .yaml configuration file and click "Import Local File".

3Select Node and Enable Proxy

Click "Proxies" on the left menu and expand your subscription strategy group.
Click the "Speed Test" (lightning icon) in the node list and wait for the results.
Select a node with low latency (generally < 100ms). Asia-Pacific nodes are usually the fastest.
Return to the Home page and turn on the "System Proxy" switch (it will turn blue).

Visit google.com or ipinfo.io to verify if the proxy is active.

4Select Proxy Mode

You can switch between three proxy modes at the top of the Home page:

Rule Mode Recommended

Domestic traffic connects directly, while blocked websites go through the proxy. Fast and saves traffic; the first choice for daily use.

Global Mode

All traffic goes through the proxy. Used temporarily for troubleshooting; not recommended for long-term use.

Direct Mode

Turns off the proxy, equivalent to not using a proxy tool.

Advanced: Enable TUN Mode

System proxy can only intercept HTTP/HTTPS traffic. Games, command-line tools (git, npm), and other traffic that don't follow system proxies require TUN Mode.

Left menu → "Settings" → find "TUN Mode".
Turn on the TUN switch. The system may pop up a permission request; click "Allow".
Windows requires installing a virtual network card driver upon the first launch. The client will automatically pop up an installation wizard.
Once enabled, the taskbar icon will change to the TUN mode logo, and all traffic will be taken over.

Important Notes

Under TUN mode, manually turn off TUN before closing the client to avoid network disconnection.
If you cannot access the internet after enabling TUN, turn off TUN, restart the client, and check if the driver is installed correctly.

FAQ

Still no nodes after updating the subscription?

Confirm the subscription link is in "Clash" format (YAML), not SS / V2Ray format. You can open the subscription link directly in your browser to see if the content starts with proxies:.

Proxy doesn't close automatically after closing the client?

Turn on the "Close system proxy on exit" option in the client settings; or manually close it in the system proxy settings (Windows: Settings → Network & internet → Proxy).

macOS system proxy switch is grayed out and cannot be clicked?

Go to "System Settings → Privacy & Security → Accessibility," add Clash Verge to the allowed list, and try again.