Quick Start
Set up in 5 minutes with these three simple steps
Choose the version for your OS and install
Paste your provider link to fetch nodes
Select a mode and turn on the proxy
Download & Install
Recommended clients and installation steps for each platform
We recommend Windows x64 for most PCs. Use ARM64 for Surface or Snapdragon devices.
Go to DownloadsDouble-click the .exe file and follow the prompts to complete the installation. A shortcut will appear on your desktop.
The main interface will open upon launch. You can also find the Clash icon in the system tray for quick access.
Windows Defender or antivirus software may flag the app. Clash Verge Rev is open-source; you can safely add it to your whitelist.
Choose ARM64 DMG for Apple Silicon (M1–M4) or x64 DMG for Intel processors. Check this in 'About This Mac' if unsure.
Double-click the .dmg file and drag the icon to your Applications folder.
If you see a 'Developer cannot be verified' warning, go to System Settings → Privacy & Security and click 'Open Anyway'.
Click 'Allow' when the system requests network access on first launch.
Select ARM64-v8a for most modern phones (2016+). Use ARMv7 for very old devices.
Enable 'Allow installation from unknown sources' in Security settings, or grant permission when prompted by your browser.
Tap the APK to install and allow the VPN permission request on first launch.
iOS clients are paid apps. A non-Mainland Apple ID (US/HK) is required to purchase them.
Visit appleid.apple.com, create a new ID, set the region to United States, and verify your email.
Open the App Store → Tap your profile icon → Scroll to the bottom and 'Sign Out' → Sign in with your new US ID.
We recommend Stash (full Mihomo support) or Shadowrocket ($2.99). Use US gift cards to add balance.
Use DEB for Ubuntu/Debian, RPM for Fedora/RHEL, or the Mihomo CLI for headless environments.
Search for 'Clash Verge' in your app launcher or run clash-verge-rev in the terminal.
Import Config
Import your provider subscription into the client
Log in to your provider's site and copy the subscription URL (starts with https://).
Go to 'Profiles' → Click 'New' → Choose 'Remote' → Paste the link and save.
The config will download automatically. Click 'Use' on the profile card to activate it.
Go to 'Proxy' to see all available nodes. Tap a node name to switch. We recommend nodes with lower latency.
Proxy Modes
Differences between Rule, Global, and Direct modes
Splits traffic based on rules: local traffic stays direct, blocked sites use the proxy. Best for daily use.
All traffic goes through the proxy, including local sites. Good for troubleshooting.
All traffic connects directly. This effectively bypasses the proxy for testing.
TUN Transparent Proxy
Route all app traffic through the proxy automatically
TUN Mode uses a virtual network card to capture all traffic, including UDP and apps that don't follow system proxy settings (like games and CLI tools).
TUN mode requires admin/root access. Click 'Yes' when Clash Verge Rev requests elevated permissions.
Go to 'Settings' → 'Clash Core' → Enable 'TUN Mode'. A virtual card named Meta will appear.
We recommend keeping 'System Proxy' on to ensure all applications route correctly.
If your internet disconnects after enabling TUN, check for conflicts with other VPN software or try restarting the toggle.
Custom Rules
Force specific sites to use proxy or connect directly
Clash uses YAML for configuration. Rules under the rules: field are matched from top to bottom.
DOMAIN-SUFFIX
Match domain suffix (including subdomains)
DOMAIN
Exact domain match
DOMAIN-KEYWORD
Domain contains keyword
IP-CIDR
Match IP range
GEOIP
Match by GEOIP location (e.g., GEOIP,CN,DIRECT)
MATCH
Final fallback rule
Edit the YAML directly in Clash Verge Rev or use the 'Merge' feature to append rules without modifying the original subscription.
Multi-Profile
Manage multiple providers and switch with one click
Clash Verge Rev allows you to import multiple subscriptions and switch between them easily—perfect if you use more than one provider.
Simply repeat the import steps for each link. Each will appear as an independent card in the Profiles page.
Click 'Use' on any card to switch. The active profile will be highlighted.
Enable 'Auto-Update' in the profile settings. We recommend a 24-hour interval.
FAQ
Solutions to common issues