Step-by-Step Tutorials

Clash Client
Detailed User Guides

Full visual guides from installation to proxy usage. Covering Windows, macOS, Android, iOS, and Linux, we show you how to import subscriptions and enable proxies in under 5 minutes.

5 Platform Guides
3 Steps to Start
5min Finish Setup
Quick Start Windows macOS Android iOS Linux
Quick Start Windows macOS Android iOS Linux FAQ

Start with Clash in Three Steps

Whatever platform you use, getting started with Clash takes only three steps and less than 5 minutes.

01

Select Platform · Download & Install

Choose the recommended client for your OS and complete the installation:

  • Windows — Clash Verge Rev (EXE Installer)
  • macOS — Clash Verge Rev (DMG Installer)
  • Android — FlClash (Direct APK Install)
  • iOS — Shadowrocket or Stash (App Store)
  • Linux — Clash Verge Rev (DEB / RPM Package)
Go to Download Page
02

Paste Subscription · Import Nodes

Open the client and paste the subscription link provided by your service in the 'Subscription' or 'Profiles' page:

Subscription Link Example https://your-airport.com/api/v1/client/subscribe?token=xxx

Click 'Import' and wait for the node list to download automatically. No manual server parameter entry is required.

03

Select Node · Enable Proxy

Select a low-latency node on the 'Proxy' page, then enable proxy mode:

  • System Proxy — Proxies browsers and other apps, recommended for general users
  • TUN Mode — Takes over all traffic, recommended for developers

Visit ip.sb If your IP address has changed, the proxy is successfully active.

Recommended Clients by Platform

Windows
Clash Verge Rev
Main
macOS
Clash Verge Rev
Main
Android
FlClash
Main
iOS
Shadowrocket
Recommended for Beginners
Linux
Clash Verge Rev
Main

Windows User Guide

Recommended Client:Clash Verge Rev(Tauri framework, built-in Mihomo core, supports TUN mode and system proxy)

1

Download and Install Clash Verge Rev

Go to the download page and download from the Windows section Clash Verge Rev Windows x64 EXE Installer(Most Windows 10 / 11 PCs are x64). ARM devices like Surface Pro X should download the ARM64 version.

Download for Windows
If SmartScreen blocks the install: Click 'More info' → 'Run anyway'. This is a standard Windows warning for software without Microsoft signatures. Clash Verge Rev is open-source and trustworthy.
2

Import Subscription Link

After installation, open Clash Verge Rev, click 'Profiles' (订阅) in the left menu, paste the subscription link provided by your airport in the top input box, and click 'Import'.

① Click 'Profiles' in the left menu
② Paste subscription link (https://…) in the box
③ Click 'Import' and wait for the nodes to download
④ Click the profile card to set it as active
Once imported, a profile card will appear in the 'Profiles' page showing the node count, indicating success.
3

Select Node and Enable System Proxy

Click 'Proxy' in the left menu and select a low-latency node (click 'Speed Test' in the top right for real-time latency). After selecting, toggle the 'System Proxy' switch in the top right. It turns blue when enabled.

Verification:Open your browser and visit https://ip.sb. If the IP address matches your node's country/region, the proxy is active.
4

Advanced: Enable TUN Mode (Recommended for Developers)

To proxy traffic from command-line tools like git、npm、pip、curl , please enable TUN Mode. Find 'TUN Mode' in the Clash Verge Rev settings page and click to enable.

Note:Enabling TUN mode requires administrator privileges. On first use, Windows will show a UAC prompt; click 'Yes' to authorize. TUN mode and system proxy can be used together or independently.
PowerShell — Verify TUN mode is capturing traffic
PS> # Check current external IP (should show proxy node IP)
PS> curl -s https://ip.sb
104.xxx.xxx.xxx # Node IP - TUN mode is working!
PS> # Test git clone through proxy
PS> git clone https://github.com/clash-verge-rev/clash-verge-rev
Cloning into 'clash-verge-rev'... done.
5

Update Subscription

In the 'Profiles' page, click the refresh icon in the top right of the profile card to update manually. For auto-updates, click 'Edit' on the card and set an interval (e.g., 24 hours).

clash-verge-rev/clash-verge-rev — View Open Source Repository

macOS User Guide

Recommended Client:Clash Verge Rev(Native support for Apple Silicon M1/M2/M3 and Intel architectures)

1

Download Correct Architecture DMG

macOS version has two architectures; choose based on your Mac's chip:

Apple Silicon（M1 / M2 / M3） Download ARM64 version:clash-verge-rev-mac-arm64.dmg Macs released late 2020 or later; 'About This Mac → Chip' mentions 'Apple M'
Intel Processor Download x64 version:clash-verge-rev-mac-x64.dmg Macs released before 2020; 'About This Mac → Processor' mentions 'Intel'
Download for macOS
2

Install DMG and Bypass Gatekeeper

Double-click the .dmg file to mount, then drag the Clash Verge Rev icon into the Applications folder.

① Double-click .dmg file, drag icon to Applications
② If 'unverified developer' appears on first run, click 'OK' to close
③ Go to 'System Settings → Privacy & Security', find the Clash Verge Rev prompt, and click 'Open Anyway'
④ Double-click to open again; it will work normally from now on
Why 'Unverified Developer'?:Apple requires developers to pay for notarization. As open-source software, Clash Verge Rev bypassing this is normal. The code is public and secure.
3

Import Subscription Link

Open Clash Verge Rev, click 'Profiles' (订阅), paste the airport subscription link, and click 'Import'. Logic is identical to the Windows version.

Once successful, the profile card shows the node count; click it to activate the config.
4

Enable System Proxy

Select a node in 'Proxy', then toggle 'System Proxy'. macOS will automatically inject settings; Safari, Chrome, and Terminal (via HTTP proxy) will now use the proxy.

Menu Bar Shortcut:Clash Verge Rev has a menu bar icon for quick node switching and proxy toggling without opening the main app.
5

Advanced: Enable TUN Mode

Enable TUN mode in settings to proxy all terminal traffic (brew、npm、git). This requires administrator privileges; enter your password when the system prompt appears.

clash-verge-rev/clash-verge-rev

Android User Guide

Recommended Client:FlClash(Material You design, simple operation, recommended for beginners)

1

Download APK Package

Go to the download page and download FlClash APK from the Android section.Phones released after 2016 should download the ARM64-v8a version; only pre-2015 devices might need ARMv7.

Download for Android
Unsure about architecture?Download the ARM64 version first. If 'app not installed' appears, try the ARMv7 version.
2

Allow Installation from Unknown Sources

Since the APK is not from Google Play, Android blocks it by default. Click the APK file to see the prompt:

① Click APK, system says 'For security, installation from this source is blocked'
② Click 'Settings' → 'Allow from this source'
③ Go back and click 'Install Anyway' (recommend disabling this permission after install)
Setting paths vary by brand (e.g., Xiaomi in 'Security', Huawei in 'AppGallery'), but the logic remains the same.
3

Import Subscription Link

Open FlClash, click 'Profiles' in the bottom nav, click the '+' icon, select 'Import from URL', paste your subscription link, and confirm.

① Open FlClash, click 'Profiles' (配置) in the bottom bar
② Click '+' → 'Import from URL'
③ Paste subscription link, give it a name, and click 'Save'
④ Wait for the configuration to download, then click the profile card to activate.
Once activated, you will see the node list on the 'Proxy' page, indicating a successful import.
4

Enable VPN and Select Node

Select a node on the 'Proxy' page (or choose 'Auto-Select' to let FlClash optimize based on speed), then click the start button (play icon) in the bottom right to enable VPN mode. On first run, click 'OK' when the system 'VPN Connection Request' appears.

Android VPN ModeEquivalent to TUN mode on desktop, it takes over all mobile network traffic by default. The rule engine automatically splits domestic and overseas traffic; domestic apps remain direct and unaffected.
Alternative for Advanced Users: ClashMeta for Android

If you are an experienced Clash user looking for more advanced configuration options, choose ClashMeta for Android (by MetaCubeX), which deeply integrates the Mihomo core and supports all advanced settings. It's also available on our Android download page .

chen08209/FlClash

iOS User Guide

Recommended Client:Shadowrocket(Best for beginners, approx. $2.99) · Stash(Feature-rich, Mihomo compatible)

iOS Special Note

Due to Apple policy, Clash-compatible clients are not available in the China Mainland App Store and are paid apps. You need a US (or HK/TW/etc.) Apple ID to switch accounts in the App Store for purchase. Please complete the 'Register US Apple ID' steps below first.

1

Register US Apple ID (~10 mins, no credit card needed)

① Open appleid.apple.com in your browser and click 'Create Your Apple ID'
② Fill in your name and birth date, using an email address not yet registered with Apple
③ Select 'Country or Region' as United States
④ Set your password and verify your email to complete registration
⑤ Open iPhone App Store → Tap Profile Icon → Sign Out → Sign In with your new US ID
Purchasing without a US Credit Card:You can buy US App Store Gift Cards (iTunes Gift Cards) from major e-commerce platforms to top up your balance and purchase apps without a credit card.
2

Purchase Shadowrocket in the App Store

Search for 「Shadowrocket」 in the App Store with your US ID; it costs about $2.99. Once purchased, it's permanently yours even if you switch back to your original account later.

Shadowrocket Shadowrocket · Approx. $2.99 · Recommended for Beginners
Stash Feature-Rich · Mihomo Compatible · Advanced Recommended
3

Import Subscription in Shadowrocket

Open Shadowrocket, tap the '++' icon in the top right, set 'Type' to Subscribe, paste your subscription link in the 'URL' field, give it a name, and tap 'Done'.

① Open Shadowrocket, tap '+' in the top right
② Set Type to 'Subscribe', paste URL
③ Add a name, tap 'Done', and subscriptions download automatically
④ Return to Home, toggle 'Not Connected', authorize VPN, and start browsing
The Shadowrocket home switch will show 'Connected' and the VPN icon will appear in the status bar once active.
4

Advanced: Using Stash (Full Mihomo Feature Support)

If you use Stash, the import process is similar: Home → 'Profiles' → 'Add from URL'. Stash fully supports Mihomo formats, including Rule Providers and proxy group strategies, ideal for users migrating from desktop.

Shadowrocket / Stash are closed-source apps with no public repositories

Linux User Guide

Recommended Client:Clash Verge Rev(GUI Version) · or Mihomo Core CLI(Command-line Server Version)

1

Download and Install Clash Verge Rev

Choose the installer format based on your Linux distribution:

Ubuntu / Debian Systems Download .deb package → double-click to install or use terminal For Ubuntu 20.04+ · Debian 11+
Fedora / RHEL / openSUSE Systems Download .rpm package → double-click to install or use terminal For Fedora 36+ · RHEL 8+
Download for Linux
bash — Install Clash Verge Rev on Ubuntu/Debian
$ # Install the downloaded .deb package
$ sudo dpkg -i clash-verge-rev-linux-amd64.deb
$ # Or for Fedora/RHEL (.rpm)
$ sudo rpm -i clash-verge-rev-linux-x86_64.rpm
$ # Launch the application
$ clash-verge-rev
Clash Verge Rev started successfully
2

Import Subscription & Enable Proxy

Linux GUI operations are identical to Windows/macOS: paste link in 'Profiles', select node in 'Proxy', and enable 'System Proxy' or TUN mode.

Linux TUN Mode Note:Enabling TUN mode requires root privileges; Clash Verge Rev will automatically request sudo authorization. Some distros might need additional sysctl parameters; see the GitHub Wiki for details.
3

Servers / Headless Environments: Using Mihomo CLI

If running Clash on a headless server, use the Mihomo Core CLI version with a systemd service for auto-start on boot.

bash — Deploy Mihomo CLI on Linux Server
$ # Download and decompress Mihomo binary
$ wget https://clashlog.com/assets/clients/core/mihomo-linux-amd64.gz
$ gunzip mihomo-linux-amd64.gz
$ chmod +x mihomo-linux-amd64
$ sudo mv mihomo-linux-amd64 /usr/local/bin/mihomo
$ # Create config directory and place your config.yaml
$ mkdir -p ~/.config/mihomo
$ cp config.yaml ~/.config/mihomo/
$ # Start Mihomo
$ mihomo -d ~/.config/mihomo
INFO[2026-05-07] Mihomo started successfully
For more Mihomo CLI parameters (e.g., listening ports, external control API, DNS settings), refer to the MetaCubeX/mihomo repository documentation。
clash-verge-rev/clash-verge-rev MetaCubeX/mihomo

Common Usage FAQ

Solving the most frequent issues for beginners regarding proxy settings, subscriptions, and connection failures

How to tell if the proxy is active?

Once enabled, visit https://ip.sb or https://whatismyip.com in your browser. If the IP address matches the node's country (e.g., US, Japan, HK), the proxy is working.

If the IP is still domestic: ① Ensure the proxy switch (System Proxy or TUN) is on; ② Verify the node is active (check speed in 'Proxy'); ③ Try switching to a different node.

Browser works, but CLI tools like git / npm / pip fail to connect. What now?

This is aknown limitation of System Proxy mode: System Proxy only handles apps that read system proxy settings (like browsers). Most CLI tools bypass this and connect directly.

Solution 1 (Recommended):Enable TUN Mode in Clash Verge Rev / FlClash settings to take over all system traffic, allowing CLI tools to proxy automatically.

Solution 2:Temporarily set proxy environment variables in the terminal (Clash default port is 7890):

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890
Subscription import fails with 'Get Failed' or 'Network Error'.

Common causes and steps:

① Expired link:Log in to your airport's user center and get a fresh subscription link.

② Network blocked:The subscription server might be blocked. Try enabling a proxy another way before importing, or ask your provider for a different subscription domain.

③ Incomplete link:Ensure the link starts with https:// and has no extra spaces or line breaks.

④ Antivirus blocking:Temporarily disable Windows Defender or third-party antivirus and try again.

What is the difference between TUN mode and System Proxy? Which should I use?

System Proxy:Only proxies applications that support HTTP/HTTPS/SOCKS protocols (browsers, most GUI software). Terminal tools (git, npm, pip, curl) default tobypassing the proxy. Easy to configure with minimal system impact, suitable for daily use.

TUN Mode:Creates a virtual network card to take over all system TCP/UDP traffic. All apps and terminal tools pass through the Clash rule engine. More comprehensive coverage, ideal for developers and power users.

Recommendation:Use System Proxy for daily tasks; use TUN Mode for development or to ensure all CLI tools are proxied.

How do I update my node list manually or automatically?

Clash Verge Rev：In the 'Profiles' page, find your card and click the ' Refresh' icon for a manual update. For auto-updates, click 'Edit' and set an interval (e.g., 24 hours).

FlClash（Android）：In the 'Profiles' page, long-press or click the card and select 'Update'. You can also enable auto-updates in the edit menu.

Shadowrocket（iOS）：On the Home screen, tap your subscription and pull down to refresh, or tap 'Update' in the edit mode.

What if node latency is high or connections drop frequently?

① Test speed and switch nodes:Click 'Speed Test' on the 'Proxy' page and choose a node with latency under 100ms.

② Use Auto-Select:Choose the 'URLTest' strategy in your proxy group; Clash will automatically switch to the lowest-latency node.

③ Change region:Performance varies by region; try nearby locations like Hong Kong, Japan, or Singapore.

④ Try Hysteria 2 nodes:Some providers offer Hysteria 2, which is QUIC-based and performs much better than TCP in high-packet-loss environments.

Clash Verge Rev vs. FlClash: Which one should I choose?

Clash Verge Rev：A Tauri-based desktop client with a polished UI. It supports all advanced Mihomo features (TUN, scripts, Rule Providers), ideal for power users.

FlClash：A Flutter-based cross-platform client with Material You design. It's simpler and more intuitive, perfect for beginners who want ease of use.

Recommendation:Both are great for beginners, but FlClash is easier to start with. Power users should pick Clash Verge Rev. Both use the same subscription format, making it easy to switch.

What are 'Rule', 'Global', and 'Direct' modes?

Rule Mode:The default and recommended mode. It intelligently splits traffic: domestic sites stay direct (fast), overseas traffic is proxied, and ads are blocked.

Global Mode:All traffic goes through the proxy. This adds unnecessary latency and may break domestic services like banking or local payments. Not recommended for daily use.。

Direct Mode:All traffic connects directly without proxying. Useful for temporarily disabling the proxy without closing the app.

Still have issues? Join the community discussion or submit an issue on GitHub.

Go to GitHub Issues

Haven't downloaded the client yet?

Visit our download page, pick your OS, and get set up in under 5 minutes.

Download for Free Now Explore Features
Windows macOS Android iOS Linux