Cross-Platform • Visual Tutorials • Beginner Friendly

Clash Tutorial
Multi-Platform Step-by-Step Guide

Setup guides for Windows, macOS, Android, iOS, and Linux.
From installation to subscription import and enabling proxy, every step is explained in detail.

Windows macOS Android iOS Linux

Setup in 3 Easy Steps

Universal workflow for all platforms. Master this and you can configure any client in minutes.

01

Download & Install

Go to the download page and choose the recommended client for your platform. High-speed direct downloads, no VPN required.

02

Import Subscription

Copy the subscription URL provided by your service into "Profiles" or "Config". Click Update to pull nodes and rules automatically.

03

Enable Proxy & Surfing

Toggle "System Proxy" or "TUN Mode". All device traffic is immediately managed by smart routing—domestic traffic stays fast, foreign traffic goes through proxy.

The Clash client does not include server nodes. You must purchase service from a provider ("Airport") to get a subscription URL. The client is the engine; the link is the tunnel.The Clash client does not include server nodes. You must purchase service from a provider ("Airport") to get a subscription URL. The client is the engine; the link is the tunnel.

Windows Tutorial

Recommended: Clash Verge Rev • Supports Windows 10 / 11 • x64 & ARM64

1

Download Clash Verge Rev Installer

Go to the download page, click "Download x64 (Recommended)" in the Windows section, and save the .exe file. For ARM devices like Surface Pro X, choose "Download ARM64".

Go to Download Clash Verge Rev
2

The default installation is in the current user directory and doesn't require admin privileges. To install for all users, right-click and select "Run as Administrator".

Double-click the .exe file. If Windows shows a SmartScreen warning ("Windows protected your PC"), it's because the installer isn't code-signed by Microsoft yet—common for open-source apps. Click "More Info" then "Run anyway".

The default installation is in the current user directory and doesn't require admin privileges. To install for all users, right-click and select "Run as Administrator".
3

Launch App and Go to Profiles

The app will launch automatically. Click the "Profiles" tab on the left. Click the "New" (Import) button at the top right.

4

Import Subscription URL

Click "New", paste your Clash Subscription URL into the box, and click "Save". The profile will appear in the list. Click the Refresh icon to perform the first update.

Please ensure you paste a Clash format URL. If your provider offers multiple formats, choose the one labeled Clash / Mihomo.
5

System Proxy (Recommended)

Go to the "Proxies" tab. You will see all nodes and strategy groups. Click the "Speed Test" icon and choose a node with low latency.

Return to the dashboard (Home) and toggle one of the following proxy switches:

System Proxy (Recommended)

Only manages browsers and apps that support system proxy. Easiest to configure, perfect for light daily use.

TUN Mode (Recommended Global Proxy)

Creates a virtual network adapter at the system level to manage ALL traffic, including games and CLI tools.

6

Verify Connection

Open your browser and visit google.com. If it loads, the proxy is working. Real-time traffic data is also visible in the "Connections" tab.

Congratulations! Windows configuration complete. Enjoy a seamless network experience.
1

Download FlClash Installer

FlClash has a minimal and intuitive UI, making it the top choice for Clash beginners. Find FlClash in the Windows section of the download page and click "Download (x64)".

Go to Download FlClash
2

Install and Launch FlClash

Double-click the .exe and follow the prompts. If SmartScreen appears, click "More Info" → "Run anyway". FlClash will launch automatically.

3

Add Subscription Config

On the FlClash dashboard, click "Config" on the left, then click the "+" button. Select "Import from URL", paste your link, and confirm.

4

Start Proxy

Return to the main screen and toggle "Start". FlClash will manage system proxy. For full traffic capture, enable "TUN Mode" in settings.

Setup complete! FlClash features a minimal UI with consistent logic across mobile and desktop.

⭐ Featured Clash Verge Rev

Recommended: Clash Verge Rev (M-series) / ClashX Meta • Supports macOS 10.15+

1

Download DMG for Your Architecture

Go to "System Settings" → "Privacy & Security"

Go to Download Clash Verge Rev (macOS)
2

Install App (Handle Gatekeeper)

Double-click the .dmg and drag the Clash Verge Rev icon to your Applications folder. When first launching from Launchpad, macOS might say "Developer cannot be verified". Follow these steps:

① Go to "System Settings" → "Privacy & Security"
② Find the blocked app notice at the bottom and click "Open Anyway"
③ Click "Open" again in the subsequent confirmation box
This is a standard security warning for open-source apps not in the developer program. The source code is fully auditable on GitHub.
3

Import Subscription Link

Launch Clash Verge Rev, click "Profiles", click "New", paste your URL, and "Save". Click the Refresh icon to pull node data.

4

Enable System Proxy or TUN Mode

Toggle "System Proxy" on the dashboard to start. macOS system proxy supports browsers, curl, and more. To manage all traffic, enable "TUN Mode" in settings and grant system permissions.

macOS setup complete! Toggle nodes anytime from the Clash Verge Rev menu bar icon.
1

Download ClashX Meta

ClashX Meta is a native macOS menu bar client maintained by the MetaCubeX team. Ultra-low memory usage and almost invisible in the background.

Go to Download ClashX Meta
2

Extract and Move to Applications

Extract the .zip and drag ClashX Meta.app to your Applications folder. Handle the Gatekeeper prompt on first launch (see step 2 of Clash Verge Rev guide).

3

Manage Config via Menu Bar

ClashX Meta will show a cat paw icon in the menu bar. Click icon → "Config" → "Remote Config" → "Manage". Click "Add", paste your URL, and save.

4

Enable System Proxy

Click the menu bar icon and select "Set as System Proxy". Proxy mode (Rule, Global, Direct) can be switched in the "Outbound Mode" menu.

Go to Download FlClash (macOS)
1

Download FlClash (macOS)

The macOS and Android versions of FlClash share the same UI—zero learning curve. Choose ARM64 for M-series chips and amd64 for Intel Macs.

Go to Download FlClash (macOS)
2

Install and Add Subscription

Installation is the same as Clash Verge Rev. In the dashboard, click "Config" → "+" → paste URL → Confirm.

3

Start Proxy

Back on the main screen, toggle "Start". FlClash automatically configures system proxy out of the box.

FlClash macOS setup complete! Identical interface to the Android version.

Download FlClash (Android)

Recommended: FlClash • Supports Android 7.0+ • Direct APK Install

1

Download FlClash APK

Almost all Android phones released after 2016 (Snapdragon, Dimensity, Kirin) are ARM64. Download the ARM64 version first. Use ARMv7 only for older devices.

Download FlClash (Android)
2

Enable "Allow Unknown Sources"

Since FlClash is an APK (not from Google Play), you must grant installation permission in phone settings:

① When downloading the APK, the system may say "This type of file can harm your device". Click "Download anyway".
② Tap the downloaded APK to install. If prompted with "Allow apps from this source", tap "Settings" → "Allow".
③ Paths vary by brand: Xiaomi/Redmi is "Security" → "Install unknown apps"; Huawei is "Settings" → "Apps" → "Special access".
3

Please ensure your phone can access the subscription URL (usually via a domestic CDN). If update fails, check if the link is complete.

Open FlClash after installation. The app will guide you through basic settings on first launch.

4

Add Subscription Config

Click "Config" in the bottom nav, then click "+" and select "Import from URL". Paste your Clash URL and confirm. Once the card shows the node count, import is successful.

Please ensure your phone can access the subscription URL (usually via a domestic CDN). If update fails, check if the link is complete.
5

Enable VPN Mode

Return to the dashboard and tap the large "Start" button. Tap "OK" on the "Connection Request" dialog to authorize VPN.

FlClash's VPN mode is equivalent to TUN mode. It manages traffic for all apps, including WeChat, YouTube, and TikTok, with no extra config.

Android setup complete! A VPN key icon in the status bar means the proxy is running.
1

Download ClashMeta for Android APK

ClashMeta for Android (CMFA) is the official Android client by MetaCubeX. It features more advanced controls and real-time logs. Priority download: ARM64 version.

Go to Download ClashMeta for Android
2

Install and Import Subscription

Same install as FlClash. Open CMFA, click "Profiles", select "New Profile" → "URL", paste your link, and save.

3

Switch Proxy Groups and Start

Go to "Proxies", choose low-latency nodes for each group, then return to Home and click "Stopped" to start. Authorize VPN to take effect.

CMFA setup complete! Manage nodes and view real-time logs with ease.

iOS Tutorial

Sign in to App Store on iPhone and skip payment methods

Prerequisite: Due to platform policies, iOS proxy clients are paid apps available only in the US App Store. Please complete the US Apple ID setup and top up below before installing.

Prerequisite: US Apple ID

iOS proxy apps are only available in the US App Store. You must have a US Apple ID. This can be done entirely from outside the US without a US phone number:

1

Open the Apple ID registration page and choose United States

Visit appleid.apple.com and click "Create Your Apple ID". Key Step: In the "Country/Region" dropdown, select United States.

2

Fill in your info and complete email verification

Enter your name and DOB. Use an email that has never been linked to an Apple ID. Complete registration using the 6-digit code sent to your email.

3

Sign in to App Store on iPhone and skip payment methods

Open App Store, tap your avatar, and scroll to the bottom to "Sign Out" (Sign out of App Store ONLY, not iCloud). Sign in with your US ID. When prompted for payment, select "None". Use an Oregon billing address (0% tax) to skip.

4

Purchase Gift Card & Top Up

Buy a US App Store Gift Card from a third-party platform and redeem it in the App Store to add balance. Apps are one-time purchases for life.

1

Buy Stash on App Store

Ensure you are in the US App Store, search for "Stash" or use the link below to buy. Stash has a beautiful UI and full Clash/Surge format support—the best iOS experience.

Buy Stash on App Store
2

Add Subscription Config

Stash supports Clash-format subscriptions. If your service provides multiple formats, choose Clash or Universal/General for compatibility.

3

Select Nodes and Enable VPN

Choose nodes in "Policy" or "Proxy", then toggle "Connect" on the Home screen. Tap "Allow" on the VPN authorization prompt.

Stash setup complete! A VPN indicator in the status bar means you're connected.
1

Buy and Download Shadowrocket

Shadowrocket is one of the most widely used proxy clients on the iOS platform. It costs about $3. It has excellent protocol compatibility, supporting Shadowsocks, VMess, Trojan, VLESS, and other major protocols with an intuitive interface.

Buy Stash on App Store
2

Import Subscription (One-Click)

Open Shadowrocket, tap the "+" icon at the top right, select "Subscribe", and paste your subscription URL. Tap "Done". Shadowrocket will automatically parse the nodes and display them in the main list.

Shadowrocket supports Clash-format subscriptions. If your service provides multiple formats, choose Clash or Universal/General for compatibility.
3

Select Node and Connect

Choose a low-latency node from the list (tap the "Speed Test" button for batch testing), then toggle the "Connection" switch at the top. Proxying starts immediately after VPN authorization.

Shadowrocket setup complete! Switch nodes instantly from the clean interface.
1

Buy and Download Quantumult X

Quantumult X is the most feature-rich iOS proxy client, supporting script rewriting, complex rules, and media unlocking. Highly favored by advanced users and developers, it has a steeper learning curve than other clients.

Buy Quantumult X on App Store
2

Add Subscription

Open Quantumult X, tap the "Pinwheel icon" at the bottom right to enter settings. Go to "Nodes" → "Subscriptions" → "+", paste your URL, and save. Tap Refresh to pull node data.

3

Enable Proxy

Return to the Home screen and toggle the Connection switch in the center. After granting VPN permissions, the proxy takes effect. Quantumult X supports fine-grained routing for individual apps under the "Policy" tab.

Quantumult X setup complete! Advanced rules offer granular control for every app.

Linux Tutorial

Recommended: Clash Verge Rev (Desktop) / Mihomo Core (Server) • Supports Debian / Ubuntu / RHEL

1

Copy

Clash Verge Rev provides .deb (for Debian/Ubuntu/Mint) and .rpm (for Fedora/RHEL/openSUSE) packages, covering both x86_64 and ARM64 architectures.

Download Clash Verge Rev (Linux)
2

Install Package

For Ubuntu / Debian systems, run the following in the terminal:

bash 
# Install .deb package (Debian / Ubuntu)
sudo dpkg -i clash-verge-rev-linux-amd64.deb

# If dependency errors occur, run:
sudo apt --fix-broken install

For RHEL / Fedora systems using .rpm:

bash 
# Install .rpm package (Fedora / RHEL)
sudo rpm -i clash-verge-rev-linux-x86_64.rpm
3

Launch and Import Subscription

Once installed, launch clash-verge-rev from your app menu or terminal. The operations are identical to the Windows version: click "Profiles" → "New" → paste URL → Save and Refresh.

4

Enable System Proxy or TUN Mode

Copy

Linux Desktop setup complete! Clash Verge Rev provides the most complete GUI experience for Linux.
1

Download Mihomo Core Binary

Mihomo is the core engine of Clash. It has no GUI and is ideal for VPS servers, OpenWRT routers, or advanced custom deployments. It supports all Linux architectures: amd64, arm64, armv7, mips, etc.

Download Mihomo Core
2

Download, Extract, and Grant Permissions

bash 
# Download mihomo binary for Linux amd64
wget https://clashspeed.com/assets/clients/core/mihomo-linux-amd64.gz

# Decompress and grant execute permission
gunzip mihomo-linux-amd64.gz
chmod +x mihomo-linux-amd64

# Move to system PATH
sudo mv mihomo-linux-amd64 /usr/local/bin/mihomo
3

Prepare Config File (config.yaml)

Mihomo runs via a YAML configuration file. Download your subscription as a config file:

bash 
# Create config directory
mkdir -p ~/.config/mihomo

# Download config from subscription URL (replace with your actual URL)
curl -o ~/.config/mihomo/config.yaml "YOUR_SUBSCRIPTION_URL"
4

Start Mihomo and Set Auto-Start

bash 
# Run mihomo with config
mihomo -f ~/.config/mihomo/config.yaml

# Or enable as systemd service for auto-start
sudo systemctl enable --now mihomo
Mihomo listens on ports 7890 (HTTP) and 7891 (SOCKS) by default. Use with a Web Dashboard like metacubexd for a GUI.
Mihomo Core deployed! Ideal for servers, routers, and headless environments.
Core Concepts

System Proxy vs TUN Mode: Which to Choose?

Both proxy modes have their own use cases. Choose based on your needs.

System Proxy

Lightweight • Simple Config
  • Only affects apps that support system proxy
  • Browsers and tools like curl use proxy automatically
  • No extra permissions needed, ready to use
  • Cannot manage games, native apps, or UDP traffic

Best for: Daily web browsing / Light use

TUN Mode

Global • Manage All Traffic
  • Creates a virtual network adapter at the system level
  • Manages ALL TCP / UDP traffic
  • Covers games, command-line tools, and all native apps
  • Achieves true transparent global proxy

Best for: Global proxy / Gaming / Dev environment

Rule Mode vs Global Mode

Routing Strategy
  • Rule Mode (Recommended): Domestic traffic stays fast, foreign traffic uses proxy
  • Global Mode: All traffic goes through the proxy node
  • Direct Mode: Proxy disabled, all traffic is direct

Daily Recommendation: "Rule Mode" for best speed and access balance.

FAQ

Common Questions & Troubleshooting

A compilation of the most common issues and solutions during user configuration.

Why can't I access foreign sites after installing the client?

The Clash client is a rule engine and does not include any server nodes. After installation, you also need to:

  1. Purchase service from a provider ("Airport") to get a subscription link
  2. Import the link into the client and update
  3. Enable System Proxy or TUN Mode

If you have a subscription but still can't connect, check: ① Is the proxy switch on? ② Has the subscription expired? ③ Do latency tests pass (not timeout)? ④ Is it blocked by antivirus or firewall?

macOS shows "Developer cannot be verified", how to handle it?

This is Apple's Gatekeeper blocking open-source software that hasn't joined the developer program. All Clash clients are open-source and safe to use:

  1. Go to "System Settings" → "Privacy & Security"
  2. Find "'xxx' was blocked because it is not from an identified developer" in the middle of the page
  3. Click the "Open Anyway" button
  4. Click "Open" again in the confirmation dialog

This only needs to be done once. You can launch the app normally afterwards.

Android shows "App is incompatible with this device"?

This is usually due to a CPU architecture mismatch. Solution:

  • If you downloaded ARM64 but your phone is an older 32-bit model, use ARMv7
  • If unsure of architecture, download the Universal version (larger file size)
  • Go to Settings → About Phone → Processor to check your chip architecture
Subscription update failed, how to fix it?

Common causes and solutions:

  • Link Expired: Log in to your provider dashboard and copy the latest URL
  • Link Truncated: Subscription URLs are long; ensure you copy the entire link (paste to notepad to check)
  • Network Issues: Some subscription domains fluctuate in mainland China; try again later or switch network
  • Format Mismatch: Ensure you are using a Clash / Mihomo format link, not SS or V2Ray specific links
Latency test shows timeout, nodes won't connect?

A timeout means the client cannot connect to that node. Troubleshooting steps:

  • Switch Nodes: Most providers offer multiple nodes; switch to a low-latency one (usually < 200ms)
  • Update Subscription: Node addresses may change; click Refresh to pull the latest list
  • Check Local Network: Some networks (like corporate WiFi) block proxy ports; test with a mobile hotspot
  • Contact Support: If all nodes timeout, it's likely a server-side issue; contact your provider
How to register a US Apple ID? Do I need a US phone number?

No US phone number required. See the registration steps in the iOS tutorial's "Prerequisite" section. Key points:

  • Select United States as the country/region during registration at appleid.apple.com
  • Use an email address never linked to an Apple ID (Gmail / Outlook recommended)
  • Choose None as the payment method when first logging in to the App Store
  • Enter any valid US address (Oregon recommended for 0% sales tax)
  • Add balance using US Gift Cards (available from 3rd party vendors) to purchase apps

Haven't downloaded the client yet?

High-speed direct downloads from our server. Get installers without a VPN.

Download Now More Tutorials