Step-by-step Tutorial · Beginner-friendly · Multi-platform · 3 Minutes to Start

Clash Tutorial
Multi-platform Guide · Subscription Import

Full step-by-step guides for Windows, macOS, Android, iOS, and Linux. From installing the client to importing provider subscriptions and enabling TUN mode for global proxying, we explain everything without needing any programming skills. Complete your Clash configuration in 3 minutes.

Windows Tutorial

Clash Verge Rev · Windows 10 / 11 · System Proxy / TUN Global Proxy

Clash Verge Rev — Windows Featured Client
Mihomo Core TUN Mode Graphical Interface Subscription Management Windows 10 / 11

A modern Clash client based on the Tauri 2 framework, built-in with the high-performance Mihomo (formerly Clash Meta) core. Supports TUN global proxy, one-click subscription import, and rule-based split tunneling. It is currently the most actively maintained and feature-complete Clash alternative for Windows.

Go to Download Page for Installers
Download & Install Clash Verge Rev

Go to the Download Page, select Windows, and click "Download .exe (Win x64)" to get the installer.

  • Double-click the .exe installer and follow the prompts to complete installation.
  • If a Windows Defender SmartScreen prompt "Blocked unrecognized app" appears, click "More info" → "Run anyway" to install.
  • After installation, a Clash Verge Rev shortcut will appear on your desktop and Start menu.
Not sure which version to download?Most Windows PCs choose the x64 version. Only devices with Qualcomm Snapdragon (Snapdragon X series) ARM chips require ARM64.
Import Provider Subscription Link

A subscription link is a unique URL from your provider containing all node information. Clash Verge Rev uses this link to automatically download and sync the node list.

  1. Open Clash Verge Rev and click the "Profiles" icon in the left sidebar.
  2. Click the "New" button in the top right and select "Remote」。
  3. In the "URL" input box, paste the Clash subscription link provided by your provider (usually starting with https://).
  4. You can fill in a remark name (such as the provider's name), and click "OK」。
  5. Wait for the download to complete, and the node list will load automatically.
Where can I find the subscription link?Log in to your provider's official website backend, find the "Clash Subscription Link" in "My Subscriptions" or "Usage Instructions" and copy it. Different provider interfaces vary slightly, usually marked as "Clash" or "Mihomo" configuration.
Select Proxy Node

Once the subscription is loaded, you need to select an available node to start proxying.

  1. Click the "Proxies" icon on the left to see all nodes and policy groups.
  2. Click the "Speed Test All" button to perform a latency test on the nodes; lower numbers indicate faster speeds.
  3. In "GLOBAL" or the corresponding policy group, select a node with low latency (ideally under 150ms) and marked in green.
  4. You can also choose the "Auto Select" policy, and Clash will automatically switch to the optimal node.
Enable System Proxy (Recommended for daily use)

Go back to the main interface (Home), find the "System Proxy" switch and click to enable. Once the switch turns green, network traffic from your browser and most apps will automatically be proxied and intelligently split through Clash.

  • System Proxy is suitable for daily browsing, with low resource consumption and simple configuration.
  • If you need to proxy command-line tools (such as git, npm, pip) or games, please use the TUN Mode。
Launch on Startup:Enter "Settings" on the left → Enable "Start on Boot." Next time you boot up, Clash Verge Rev will automatically run and restore the system proxy without manual intervention.
Enable TUN Mode (Global Proxy, Recommended for Developers)

TUN mode captures all TCP/UDP traffic by creating a virtual network card at the system network layer, achieving true global proxying. Whether it is a browser, command-line tool (npm install, git clone, pip), or game client, it will pass through Clash.

  1. Find the "TUN Mode" switch on the main interface and click to enable.
  2. When enabled for the first time, the system will pop up a UAC permission request (to install the virtual network card driver); click "Yes" to allow.
  3. Wait for the driver installation to complete. When the TUN switch turns green, it means the global proxy is in effect.
Note:Enabling both TUN mode and System Proxy simultaneously may lead to duplicate traffic proxying; it is recommended to choose one. General users can use System Proxy, while developers or those requiring full proxying can enable TUN mode.
Migrating from Clash for Windows (CFW):After downloading and installing Clash Verge Rev, just re-paste your subscription link to import. The original subscription link and YAML configuration file are fully compatible, making migration very easy.

macOS Tutorial

Clash Verge Rev · Apple Silicon (M1/M2/M3/M4) / Intel Mac · TUN Enhanced Mode

Clash Verge Rev — macOS Featured Client
Apple Silicon Native M1 / M2 / M3 / M4 TUN Enhanced Mode macOS 11+

Native ARM64 macOS client deeply optimized for Apple Silicon, providing excellent performance and battery life without Rosetta translation. Intel Mac users can just download the x64 version, with identical functionality.

Go to Download Page for macOS Installer
Install Clash Verge Rev

Get the Download Page file from the .dmg (choose arm64 for Apple Silicon Mac, x64 for Intel Mac).

  1. Double-click the .dmg file to mount the disk image and wait for the installation window to pop up.
  2. Drag the Clash Verge Rev icon into the Applications folder.
  3. After dragging, eject (unmount) the disk image and open the app from Launchpad or the Applications folder.
Bypass macOS Security Verification (Must-read for first launch)

On first launch, macOS Gatekeeper may pop up "Cannot be opened... because it is from an unidentified developer." This is normal; solve it in either of the following ways:

  • Method 1 (Recommended):Open "System Settings」→「Privacy & Security," find the prompt for the app at the bottom of the page, and click "Open Anyway」。
  • Method 2:Find the app in Finder, right-click the icon → "Open" → Click "OpenOpen" again in the pop-up window. This only needs to be done once.
This security prompt is only because the app hasn't passed Apple's notarization process and does not mean the app contains malicious code. Clash Verge Rev is a fully open-source project with its source code on GitHub for anyone to audit.
Import Provider Subscription Link

Operation steps are identical to Windows:

  1. Open Clash Verge Rev and click the left "Profiles" icon.
  2. Click "NewNew" → Select "Remote」。
  3. Paste the provider's Clash subscription URL, fill in a name, and click "OK」。
  4. Wait for the node list to download and click the configuration to set it as the active profile.
Select Node & Enable Proxy

Click the "Proxies" to test node latency and choose a suitable node. Then:

  • System Proxy:Enable the "System Proxy" switch on the main interface. macOS will pop up an authorization request (requires admin password); after allowing it, Clash can take over the system network settings.
  • TUN Enhanced Mode (Global Proxy):Enable "TUN Mode" → Admin password required for the first time to install the virtual network card driver → Once installed, the switch turns green, and all traffic passes through Clash.
macOS Menu Bar Icon:Clash Verge Rev can display a status icon in the top-right menu bar, making it easy to quickly switch proxy modes and check connection status without opening the full interface every time.
Not sure if your Mac is Apple Silicon or Intel? Click the Apple menu in the top left → "About This Mac." If the processor field shows "Apple MM1/M2/M3/M4," it's Apple Silicon; if it shows "IntelIntel," it's an Intel Mac.

Android Tutorial

ClashMeta for Android · APK Installation · VPN Global Proxy · Rule Split Tunneling

ClashMeta for Android — Android Featured Client
VPN Mode Rule-based Split Tunneling Real-time Traffic Stats Android 5.0+

Official Android Clash client maintained by the MetaCubeX team, based on the Mihomo core. Supports VPN global proxy and rule-based split tunneling, compatible with mainstream provider subscription formats, with a clean Material Design UI.

Get Android APK on Download Page
Download & Install APK

Go to the Download Page and download the ClashMeta for Android arm64-v8a.apk version (suitable for the vast majority of phones released after 2016).

  1. Open phone "Settings」→「Security" (names vary by brand, such as Xiaomi being "Special app access" → "Install unknown apps").
  2. Find your browser or file manager and enable the "Allow apps from this source" permission.
  3. Find the downloaded .apk file in the file manager and click to install.
  4. After installation, you can disable the "Install from unknown sources" permission (for safety).
Architecture Selection:Almost all phones after 2016 are arm64-v8a; choose "Universal" if unsure, which is compatible with all architectures but has a slightly larger file size.
Import Provider Subscription Link
  1. OpenClashMeta for Android and click the "Profiles」（Profiles）。
  2. Click the "+" button in the bottom navigation bar, then select "URLURL" (Import from link).
  3. Paste the Clash subscription link provided by your provider, fill in a name, and click "OK」。
  4. Wait for the download to complete. In the profile list, click the profile to make it active (a checkmark will appear on the right).
Select Proxy Node
  1. Click the "ProxiesProxies" tab at the bottom to see all available nodes and policy groups.
  2. Click "Latency Test icon or the speed test icon next to a single node to test latency.
  3. Select the node with the lowest latency in the policy group (usually "GLOBAL" or "Auto Select").
Start VPN Proxy
  1. Return to the main interface and click the "Stopped" switch (shield icon) in the center to start.
  2. Android system will pop up a "Connection request" prompt; click "OK」。
  3. OK." After the status changes to "Running," a VPN icon will appear in the notification bar, and all app traffic will be split-tunneled by Clash rules.
Clash uses the native Android VPN interface, so it does not require root access and can be used on any Android phone. Real-time traffic stats in the notification bar help you monitor your proxy status and data usage at any time.
Beginner Tip:If the ClashMeta for Android interface is too complex for you, try FlClash—the interface is cleaner and more intuitive, also based on the Mihomo core with full functionality, and specially suited for first-time proxy configuration.Download FlClash

iOS / iPadOS Tutorial

Stash · Shadowrocket · App Store Paid Apps · Subscription Import · iOS Proxy Config

iOS Notes: and require a paid App Store applicationspaid App Store appsnon-Mainland China Apple IDnon-Mainland China Apple ID (e.g., US region) for searching and purchasing. They cannot be found with a Mainland China ID. See the registration guide on the 。
Stash ⭐ Featured

Fully compatible with Clash YAML configuration, supports TUN mode for true global proxying, with powerful rule-based split tunneling and a beautiful UI—the top choice for iOS.

Shadowrocket Recommended for Beginners

Simple and intuitive, one-click subscription import, compatible with Clash YAML config—one of the most downloaded proxy tools for iPhone / iPad.

Purchase & Install Client (Requires non-Mainland ID)
  1. If you don't have a US Apple ID, follow the registration guide on the download page to create one for free.
  2. OpenApp Store and click the "Account" icon at the bottom right → Scroll to the bottom and "Sign Out" → Sign in with your US Apple ID.
  3. Search for "StashStash" or "ShadowrocketShadowrocket," purchase and install. Supports gift cards or international credit cards.
  4. Buy once, use forever on all your devices with no subscription fees.
You can switch back to your original Apple ID after installation; the apps will continue to work and receive updates. Only new purchases require switching back to the US account.
Stash — Import Clash Subscription Link
  1. OpenStash and click the bottom "ProfilesSettings" tab.
  2. Click the "+」→「Import from URL」。
  3. Paste the Clash subscription link provided by your provider (YAML format) and click "Continue」。
  4. Stash will automatically download and parse the configuration, loading all nodes and policy groups.
  5. Click the profile name to set it as active.
Shadowrocket — Import Subscription Link
  1. OpenShadowrocket and click the "+" icon in the top right.+」。
  2. Select Type as "SubscribeSubscribe".
  3. Paste the Clash subscription link into the URL field, give it a name, and click "Done」。
  4. The node list will sync automatically; select a node manually or use an auto-selection policy.
Start Proxy Connection

Click the connection switch on the Dashboard in Stash or Shadowrocket.

  1. iOS will prompt "Add VPN Configurations," click "Allow」。
  2. and verify with Face IDorTouch ID interface, Apple's official VPN tunnel, which is secure, stable, and requires no jailbreak.
  3. A "VPNVPN" icon will appear in the status bar, indicating a successful connection.
iOS proxy clients use the Network ExtensionPacketTunnel

Linux Tutorial

Clash Verge Rev · DEB / RPM Installation · TUN Mode · Mihomo CLI Core

Clash Verge Rev — Linux Graphical Client
DEB / RPM Packages AMD64 / ARM64 TUN Mode Ubuntu / Debian / Fedora

Supports mainstream distributions like Ubuntu, Debian, and Fedora with DEB and RPM formats. Built-in Mihomo core and TUN mode support make it the best GUI client for Linux desktop users. Advanced users can use the Mihomo CLI core directly.

Get Linux Installers on Download Page
Install Graphical Client

Choose the package format for your distribution to install Clash Verge Rev:

Ubuntu / Debian (using .deb):

bash — Ubuntu / Debian
# Install via dpkg
$ sudo dpkg -i clash-verge-rev-linux-amd64.deb
Selecting previously unselected package clash-verge-rev.
Setting up clash-verge-rev ... done.
# Fix missing dependencies if any
$ sudo apt-get install -f

Fedora / RHEL / CentOS (using .rpm):

bash — Fedora / RHEL
# Install via dnf (recommended)
$ sudo dnf install clash-verge-rev-linux-x86_64.rpm
# Or via rpm
$ sudo rpm -i clash-verge-rev-linux-x86_64.rpm
Launch & Import Subscription

Launch Clash Verge Rev from the application menu or terminal after installation:

bash
$ clash-verge-rev

Operation is identical to the Windows version: Click "Profiles」→「New」→「RemoteProfiles," paste the subscription link, and confirm.

Enable Proxy (System Proxy / TUN Mode)
  • System Proxy:Enable "System Proxy" on the Dashboard; Clash will automatically set GNOME/KDE system proxy settings.
  • TUN Mode (Global Proxy):Enable "TUN Mode"; you'll need to enter your sudo password on the first run to install the virtual network card.
Advanced: Mihomo CLI Core (Server / Side-router)

To use Clash on a server or side-router, run the Mihomo (Clash Meta) core directly without a GUI:

bash — Mihomo CLI
# Create config directory
$ sudo mkdir -p /etc/mihomo
# Copy your config.yaml to /etc/mihomo/
$ sudo cp config.yaml /etc/mihomo/
# Run Mihomo core
$ mihomo -d /etc/mihomo
INFO[0000] Mihomo v1.x started, config loaded
# Enable as systemd service (auto-start on boot)
$ sudo systemctl enable --now mihomo
Manage nodes and rules via a Web DashboardWeb Dashboard (e.g., Yacd or MetaCubeXD) in your browser; the access address is usually http://127.0.0.1:9090。

Three Steps to Configure Clash

The core configuration process is identical across all platforms. Master these three steps to go from zero to connected in 5 minutes.

Install Client

Download the installer for your platform and open the client after installation.

Import Subscription Link

Paste the provider's Clash subscription URL on the "Profiles" page to sync nodes.

Enable Proxy

Select a node, enable System Proxy or TUN mode, and Clash rule-based split tunneling will take effect immediately.

Download Client Now

TutorialsFAQ

Subscription import failure, node timeouts, TUN mode issues, updates... find answers to the most common Clash questions here.

What if I get "Download Failed" or "Connection Timeout" after importing a subscription?
The subscription link itself is an overseas URL, and since Clash isn't running a proxy yet, it can't download it directly.Solutions:

· Method 1:If you have other temporary proxies (such as a mobile hotspot with a proxy), use it to complete the first subscription download, after which you can update via Clash itself.
· Method 2:Enable "Bypass System Proxy" in Clash Verge Rev settings, or set a proxy manually for the subscription URL before use. or use "System Proxy," manually set the proxy before the subscription URL.
· Method 3:Download the YAML config file directly from your provider's site and import it manually as a "Local File."
All node latency tests show "timeout"; can't connect to any node?
Follow these troubleshooting steps:

1. Confirm the subscription was imported successfully and the node list is not empty.
2. Check if the current profile is your provider's subscription (not an empty one).
3. Try updating the subscription: Click the refresh button on the Profiles page to pull the latest info.
4. Check your local network connection (test if your phone can connect).
5. If all nodes timeout, it's likely the provider's nodes are blocked or your plan has expired; contact provider support.
System Proxy is on, but the browser still doesn't use the proxy for overseas sites?
Troubleshoot in this order:

· Confirm Proxy Mode:Ensure the "Proxy Mode" in Clash Verge Rev is set to "Rule" or "Global," not "Direct."
· Browser Settings:Some browsers (like Firefox) have independent proxy settings; ensure it's set to "Use system proxy." Chrome / Edge usually follow the system proxy automatically.
· Switch Modes:Switch from "Rule" to "Global" for testing—if Global works, it's a rule configuration issue.
· Re-apply Proxy:Turn System Proxy off and on again, or restart the client.
How to update a subscription link (new nodes from provider)?
Just refresh the subscription; no need to re-import.Operations for each client:

· Clash Verge Rev：Go to "Profiles," find your subscription, and click the "Refresh" icon (circular arrow) and wait for the download to complete. You can also enable "Auto Update" in settings.
· ClashMeta for Android：Long-press or pull down to refresh in "Profiles," then select "Update".」。
· Stash / Shadowrocket：Pull down in the profile list or click the update button.
Can TUN mode and System Proxy be on at the same time? What's the difference?
It's recommended to only use one at a time to avoid duplicate proxying or conflicts.

· System Proxy:Works via system settings; only apps that recognize system proxies (browsers, some apps) will use it. CLI tools and games might not.
· TUN Mode:Creates a virtual network card at the network layer, ensuring capture all TCP/UDP trafficall apps (browsers, CLI tools like npm/pip/git, games) go through the proxy

Which to choose:Daily users should use "System Proxy" for lower resource usage; developers needing CLI or game proxying should choose "TUN Mode."
Clash Verge Rev won't open after installation, prompting missing DLL files?
Usually caused by a missing Visual C++ Redistributable. Solutions:

1. Search for "Visual C++ RedistributableVisual C++ Redistributable" on the Microsoft website, and download/install the latest x64 version.
2. Check for and install all Windows Updates, which often include necessary runtimes.
3. Restart your computer and try opening Clash Verge Rev again.

If the issue persists, try re-downloading the installer or searching the error message on GitHub IssuesGitHub Issues.
How to share the Clash proxy with other devices on the LAN?
Use the "LAN Proxy Sharing" feature to let other devices connected to the same router use your computer's proxy.

Steps for Clash Verge Rev:
1. In "Settings" → "Proxy," enable "Allow LAN Connections".（Allow LAN）」。
2. Check the Clash HTTP port (default 78907890") and your computer's LAN IP (e.g., 192.168.1.10).192.168.1.x）。
3. Set the proxy server on other devices (phones, tablets) to your computer's IP and the port to 7890.7890。

Note:This method is for temporary use; for long-term LAN-wide proxying, consider configuring a transparent proxy on your router.

Clash / Mihomo Fully Open Source · 50,000+ GitHub Stars

The Clash core (Mihomo) code is fully open-source on GitHub, audited by global developers with no backdoors or telemetry. Contributions are welcome.

50k+ GitHub Stars
500+ Contributors
5M+ Total Downloads
View Source on GitHub