Tutorial

Clash Installation
& Configuration Tutorial

Step-by-step guide for Windows, macOS, Android, iOS, and Linux. 5 minutes from download to connection.

Quick Start Download Client First
5 Supported Platforms
5 min Complete Setup
8+ Client Tutorials
Free Open Source

3 Steps to Install, 5 Minutes to Connect

Separated client and core design—no complex setup needed. Download, import, and connect easily, even for beginners.

1

Download and Install Client

or Clash Verge Rev, and we recommend ClashMeta for Android for Android, Stash or Shadowrocket。

2

Paste Subscription Link

Get a Clash/YAML subscription link from your provider, paste it into 'Subscription Management', and nodes will sync automatically.

3

Pick Node, Start Proxy

Select the lowest latency node, switch to 'Rule' mode, and enable System Proxy or TUN mode for easy access to Netflix, YouTube, and GitHub.

Windows Tutorial

We recommend Clash Verge Rev or FlClash. Supports Windows 10/11 x64 and ARM64 with built-in Mihomo core.

Recommended Best for Beginners

Clash Verge Rev Setup Tutorial (Windows)

Modern Tauri + Vue architecture with the latest Mihomo core. The most recommended Clash alternative for Windows in 2026.

1

Download and Install Clash Verge Rev

x64 VersionDownload Page to get the Windows installer. Choose the version for your system (most users should pick the x64 version）。

Check system architecture: Right-click 'This PC' → 'Properties' → 'System Type'. Choose x64 for 64-bit systems, or ARM64 for Snapdragon laptops.
Download x64 Version Download ARM64 Version

installer, follow the prompts, and the client will open automatically..exe installer, follow the prompts, and the client will open automatically after installation.

2

Import Subscription Link

New'Subscription', then click 'New' 。

  1. Paste your subscription link into the 'URL' field
  2. Name the subscription (e.g., 'My Proxy')
  3. Click 'Save'; it will automatically download nodes
  4. Use'Use'
Enable 'Auto Update' (recommended every 24 hours) in subscription settings to keep node information current.
3

Select Proxy Mode and Node

menu to see all nodes and policy groups.'Proxy' menu to see all nodes and policy groups provided by your provider.

  • : Direct for local traffic, proxy for international traffic. Saves bandwidth.: Local traffic is direct, overseas uses the proxy. Bandwidth-efficient.
  • : All traffic goes through the proxy.: Forces all traffic through the proxy.
  • : Disable proxy temporarily.: Disables proxy temporarily.

speed test icon and select the lowest latency node (green). speed test icon and select the lowest latency node (green).

4

Enable System Proxy / TUN Mode

switch. Browser traffic will now go through the proxy.'System Proxy' switch. Browser traffic will then automatically use the proxy.

System Proxy Mode

Proxies browser and most apps. No admin rights needed. Best for daily use.

TUN Mode (Global Control)

Creates a virtual network card to take over all system traffic, including terminals and games. Requires administrator rights. Enable in 'Settings → TUN Mode'.

clash-verge-rev/clash-verge-rev — View official documentation and Release notes
Best for Beginners

FlClash Installation & Configuration Tutorial (Windows)

A minimalist cross-platform client built with Flutter. Intuitive interface, zero learning curve, perfect for beginners seeking simplicity.

1

Download and Install FlClash

x64 VersionDownload Page to get the FlClash Windows x64 installer, then double-click the .exe file to start the program after installation.

Download FlClash x64
2

Add Subscription and Enable Proxy

button to start the proxy.'Enable' button to start proxying.

chen08209/FlClash
Supports multiple kernel switching (Mihomo / Clash Premium), provides rich themes and visual rule editing. Configuration is basically the same as Clash Verge Rev; follow the steps above to import your subscription. Supports multiple kernel switching (Mihomo / Clash Premium) and features rich themes and visual rule editing. Configuration is mostly the same as Clash Verge Rev—follow the steps above to import your subscription.Go to Download

macOS Tutorial

Supports Apple Silicon (M1/M2/M3/M4) and Intel Mac. Clash Verge Rev is recommended, with FlClash and ClashX Meta as alternatives.

Recommended

Clash Verge Rev Installation & Configuration Tutorial (macOS)

Native support for both Apple Silicon and Intel architectures. Built-in Mihomo core and quick menu bar access make it the top choice for Mac users.

1

Download and Install (Choose Correct Architecture)

Choose x64.Apple M series, or pick x64 if it shows Intel is selected.

ARM64（M1/M2/M3/M4） x64（Intel Mac）

, drag the app into the 'Applications' folder..dmg, and drag the app into the 'Applications' folder.

If you see 'Cannot be opened because the developer cannot be verified' on first launch, go to If you see 'Cannot be opened because the developer cannot be verified' on first launch, go to , and click 'Open Anyway' at the bottom of the page. Or run in terminal:, and click 'Open Anyway' at the bottom of the page. Or run in Terminal: sudo xattr -rd com.apple.quarantine /Applications/Clash\ Verge.app
2

Import Subscription Link

then switch to the proxy page to select a node.'Subscription' → 'New' , paste your subscription link and save. The system will automatically download nodes. Right-click the subscription → 'Use', then switch to the proxy page to select a node.

3

Enable Proxy (System Proxy / TUN Mode)

, to proxy browser and most app traffic.'System Proxy', and browser traffic (along with most apps) will be proxied.

Enable virtual network card mode (requires admin password) for global transparent proxying.brew、git) or games that do not support system proxies, enable virtual network card mode in 'Settings → TUN Mode' (admin password required) for global transparent proxying.

The menu bar icon allows quick switching of proxy modes and status. Right-click for common functions without opening the main interface.
clash-verge-rev/clash-verge-rev — Official GitHub Repo
Best for Beginners

FlClash for macOS

Flutter cross-platform client with both ARM64 (M-chip) and AMD64 (Intel) versions. Clean interface and consistent operation with Windows/Android.

ARM64 (M-chip) AMD64（Intel）

After installation: Open → Add Config (paste subscription link) → Select Node → Start Proxy. Steps are identical to FlClash Windows.

chen08209/FlClash
Low Frequency Maintenance

ClashX Meta for macOS

Native macOS menu bar lightweight client with built-in Clash.Meta core. Easy to use, though currently in low frequency maintenance, it still works fine.

Download ZIP

Unzip and drag ClashX Meta.app to 'Applications'. Click menu icon → 'Config' → 'Remote Config' → paste subscription link and update. Then click 'Set as System Proxy' to enable.

MetaCubeX/ClashX.Meta

Android Tutorial

Supports Android 5.0+. Install APK directly without Google Play. ClashMeta for Android is recommended, with FlClash as a lightweight alternative.

Recommended Best for Beginners

ClashMeta for Android Installation & Configuration Tutorial

Built-in Mihomo core with VPN mode for global proxying. Fully compatible with subscription formats. Install APK directly without Google Play.

1

Download and Install APK

x64 VersionDownload Page to get the APK. If unsure of your architecture, download the Universal Version, and the system will automatically match it.

Universal (Recommended) ARM64-v8a ARMv7 (Older models)
Xiaomi MIUI: Settings → Privacy → Special Permissions → Install Unknown AppsDownload the APK and tap to install. If a security prompt appears, authorize your downloader (e.g., browser) to install from unknown sources.
Xiaomi MIUI: Settings → Privacy → Special Permissions → Install Unknown Apps
OPPO/OnePlus: Settings → Additional Settings → Security → Unknown Sources
Stock Android: Settings → Apps → Special App Access → Install Unknown Apps
2

Import Subscription Link

New Profile'Profiles', then choose 'New Profile'：

  1. Select type 「URL」
  2. Paste your subscription link
  3. Save'Save'
  4. icon to download nodes'Refresh' icon to download nodes
Enable 'Auto Update' in profile settings to keep node information current automatically.
3

Select Node and Start VPN

tab, click node names in policy groups for latency tests (long press for batch testing).'Proxy' tab, then tap a node name in the policy group for a latency test (long press for batch testing).

button. Confirm the system VPN request. Once status shows 'Running', all traffic will be proxied according to rules.'Start' button. Confirm the system VPN request. Once status shows 'Running', all traffic will be proxied according to rules.

: Direct for local traffic, proxy for international traffic. Saves bandwidth.

Direct access for local sites, proxy for overseas. Saves data and is faster.

: All traffic goes through the proxy.

Forces all traffic through the proxy. Use for testing or special needs.

MetaCubeX/ClashMetaForAndroid — Official GitHub Repo

FlClash for Android

Android version of the Flutter cross-platform client. Identical interface to Windows/macOS. Available in ARM64 and ARMv7 versions.

ARM64 ARMv7

After installation: Open → Add Profile (paste subscription link) → Select Node → Click Start and authorize VPN.

chen08209/FlClash
, some older low-end models use ARMv7 (32-bit). Unsure which architecture your phone uses? Download the Universal Version and the system will automatically match the best installer. Most mainstream Android devices released after 2016 use ARM64-v8a architecture, while some older low-end models use ARMv7 (32-bit).

iOS / iPadOS Tutorial

iOS proxy apps must be purchased from the App Store and are paid apps. Requires a non-mainland China Apple ID. This page provides guides for Stash, Shadowrocket, and Quantumult X.

Prerequisite: Prepare a Non-Mainland Apple ID

iOS proxy apps are not available in the mainland China App Store due to compliance. Use a US or Hong Kong Apple ID to purchase.

1

Register a US or HK Apple ID

, use a local address (e.g., Oregon for no sales tax in the US), and verify email to complete registration.appleid.apple.com and click 'Create your Apple ID'. Set the country or region to 'United States' or or 'Hong Kong', then use a local address (e.g., Oregon for no sales tax in the US) and verify your email to complete registration.

2

Switch Accounts in App Store

Open App Store → tap profile icon → scroll to bottom → 'Sign Out' → Sign in with your US/HK Apple ID to search and buy apps.

3

Purchase Gift Cards for Payment

US accounts support iTunes/App Store Gift Cards to add balance. After purchase, you can switch back to your local Apple ID; installed apps will remain and can be updated.

S
Recommended

Stash Tutorial (iOS / iPadOS)

The most feature-complete iOS Clash-compatible client. Supports full Clash rule syntax and Mihomo extension protocols (VLESS / Hysteria 2 / Reality) with a beautiful dashboard.

1

Buy and Download Stash from App Store

or click the link below. Price is approx $3.99 (US Store).「Stash」 or click the link below directly; price is approx $3.99 (US Store).

Buy on App Store
2

Add Subscription Config

, paste the subscription link, and select the config after download.'Config' tab, then select 'Download from URL', paste the provider subscription link, and select the config once downloaded.

Stash fully supports Clash YAML subscriptions. Direct import of airport-provided Clash links is supported.
3

Select Node and Start VPN

button. Authorize VPN on first use, then tap to toggle proxy status.'Proxy' tab to view policy groups and select the lowest latency node. Return to the home page and click the top-right 'Connect' button. Authorize VPN on first use, then click to toggle the proxy.

Best for Beginners

Shadowrocket Tutorial (iOS)

The most widely used proxy client on iOS. Extremely simple operation with full support for Clash rule imports. Best for beginners.

1

Purchase Shadowrocket

(commonly known as 'Little Rocket'). Price is approx $2.99 (US Store).「Shadowrocket」 (commonly known as 'Little Rocket'); price is approx $2.99 (US Store).

Buy on App Store
2

Import Subscription

, paste your subscription link, and tap 'Done'. Nodes will download automatically.「+」, set type to 'Subscribe', paste the provider subscription link, and tap 'Done'. The app will download all nodes automatically.

3

Select Node and Start Proxy

for latency tests, pick the lowest latency node. Toggle the top switch and authorize VPN.'Connectivity Test' for latency testing, then pick the lowest latency node. Toggle the top switch and authorize VPN to start.

for direct local access and overseas proxying.'Global Routing → Config' to enable rule-based shunting for local/overseas traffic.

Industry-leading rule customization with HTTP rewrite and JavaScript injection support. Compatible with Clash rule sets. Long-press share icon → 'Subscription' → 'Add' → paste link. App Store price approx $7.99 (US Store). Industry-leading rule customization with support for HTTP rewrite and JavaScript injection. Fully compatible with Clash rule sets. To import: long-press the share icon in the bottom-right of the config screen → 'Subscription' → 'Add' → paste link. App Store price approx $7.99 (US Store).App Store Link

Linux Tutorial

Supports Ubuntu / Debian / Fedora / CentOS. Options include a GUI client (deb/rpm) or the command-line Mihomo core.

Recommended

Clash Verge Rev Installation & Configuration Tutorial (Linux)

Graphical Clash client in deb and rpm formats, covering major distributions. Supports AMD64 and ARM64 with built-in Mihomo core.

1

Download Package

Choose the package based on your distribution and architecture:

AMD64 (.deb) ARM64 (.deb) x86_64 (.rpm)
2

Install via Terminal

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

# Fedora / CentOS / RHEL (.rpm)
sudo rpm -ivh clash-verge-rev-linux-x86_64.rpm

Open the client.「Clash Verge」 or run clash-verge in terminal to start the client.

3

Import Subscription and Enable Proxy

Operation is identical to Windows / macOS: Click 'Subscription' on the left → 'New' → Paste subscription link → Save → Right-click 'Use'. Switch to the proxy page, select a node, and toggle the 'System Proxy' switch.

environment variables, or enable TUN mode.https_proxy environment variables, or enable TUN mode.
clash-verge-rev/clash-verge-rev — Official GitHub Repo

Linux Command Line Installation of Mihomo Core (Server / Advanced Users)

Server users or CLI-preferring developers can install the Mihomo core binary directly. Example for Ubuntu / Debian AMD64:

bash 
# Download Mihomo core binary
wget -O mihomo.deb https://clashchinasite.com/assets/clients/core/mihomo-linux-amd64.deb

# Install via dpkg
sudo dpkg -i mihomo.deb

# Enable and start Mihomo as a system service
sudo systemctl enable mihomo
sudo systemctl start mihomo

# Verify service status
sudo systemctl status mihomo
. For a visual Web dashboard, use it with /etc/mihomo/config.yaml. For a visual Web dashboard, use it with MetaCubeXD.
Best for Beginners

FlClash for Linux

Linux version of the Flutter cross-platform GUI client. Identical interface to Windows/macOS, perfect for desktop users to get started without CLI config.

AMD64 (.deb)

, then open the app → Add Profile (paste subscription link) → Select Node → Start Proxy.sudo dpkg -i flclash-linux-amd64.deb, then open the app → Add Profile (paste subscription link) → Select Node → Start Proxy.

chen08209/FlClash

Clash Frequently Asked Questions (FAQ)

Quick lookup for common questions about subscription import, proxy modes, latency tests, and errors.

Common causes and troubleshooting steps:

1. : Ensure the provider provides a Clash (YAML) format link, not V2Ray or SS format.: Ensure the provider offers a Clash (YAML) format link, not V2Ray or Shadowsocks (SS).
2. : The subscription server may be overseas and inaccessible without an initial proxy. Try importing after enabling a proxy by other means, or ask your provider for a local access address.: The subscription server may be overseas and inaccessible without an initial proxy. Try importing after enabling a proxy by other means, or ask your provider for a local access address.
3. : Re-copy the latest link from your provider's dashboard; old links may expire due to plan changes.: Re-copy the latest link from your provider's dashboard; old links may expire due to plan changes.
4. : Update your client to the latest version and try again. : Update your client to the latest version and try again.
System Proxy Mode: Uses OS settings; only proxies apps supporting HTTP/SOCKS5 (browsers, most desktop apps). Terminals and games usually don't go through it. Simple setup, no admin rights needed.

Recommendation for daily use: Use: Creates a virtual network card to take over all system traffic, including terminals, games, and apps without native proxy support. Achieves true global transparent proxying but requires admin/root privileges to start.

Recommendation for daily use: Use ; enable TUN mode for terminal acceleration or gaming latency reduction. ; enable TUN mode for gaming or terminal acceleration.
: Diverts traffic automatically. Local sites go direct for speed, overseas sites go through proxy. Best for most daily scenarios, saves bandwidth and data.: Diverts traffic automatically based on rules: local sites go direct for speed, overseas go through proxy. Best for most daily scenarios, saves bandwidth and data.

: All traffic goes through the proxy.: Forces all traffic through a proxy node. Suitable for special needs (e.g., testing nodes, accessing corporate intranets). Consumes more provider data.

: Disable proxy temporarily.: Disables all proxying; traffic goes direct, same as not using a proxy. Best for temporary needs (can also be achieved via the 'DIRECT' policy group in Rule Mode).
Common fixes for high latency or timeouts:

1. : Servers vary in location and load. Run batch latency tests and pick the lowest (usually : Servers vary in location and load. Run batch latency tests in the proxy panel and pick the lowest (usually < 150ms）的节点
2. : Manually refresh the subscription; expired nodes will show as timed out.: Manually refresh the subscription; expired nodes will show as timed out.
3. : Ensure your local network is fine. ISPs sometimes QoS certain ports; try switching Wi-Fi or cellular data.: Ensure your local network is fine. ISPs sometimes QoS certain ports; try switching Wi-Fi or cellular data.
4. : If your provider offers multiple protocols (Shadowsocks, VMess, Trojan, Hysteria2), try Hysteria2 or other UDP-based protocols for better performance in high packet loss environments. : If your provider offers multiple protocols (Shadowsocks, VMess, Trojan, Hysteria2), try Hysteria2 or other UDP-based protocols for better performance in high loss environments.
Clash Meta (now Mihomo) is a community open-source fork of the Clash core. Compared to the original, it adds support for next-gen protocols like VLESS Reality, Hysteria 2, and TUIC. It features better DNS resolution, rule matching performance, and anti-detection mechanisms, with continuous updates.

Modern clients (Clash Verge Rev, ClashMeta for Android, etc.) come with the Mihomo core built-in. Average users don't need to distinguish—using recommended clients gives you all Mihomo features automatically.
This is a limitation of System Proxy mode—it only affects apps supporting HTTP/SOCKS5. Games and Steam often don't support these protocols.

Note: TUN mode requires administrator / root privileges; a system prompt will appear for authorization. (Clash Verge Rev → Settings → TUN Mode → Enable). TUN mode creates a virtual network card to handle all system traffic, ensuring games, Steam, and terminals are proxied.

Note: TUN mode requires administrator / root privileges; a system prompt will appear for authorization.
Clash Verge Rev: On the 'Subscription' page, click the 'More' icon → 'Edit'. Set the update interval (recommend 1440 mins / 24 hours). The subscription will refresh periodically.

ClashMeta for Android: Long press profile → 'Edit' → enable 'Auto Update' and set frequency.

Stash / Shadowrocket Auto-update requires an internet connection. Setting it to every 12-24 hours ensures your node list stays current.

Auto-update requires an internet connection. Setting it to every 12-24 hours ensures your node list stays current.

Haven't downloaded the client yet?

Go to the download page for the latest Clash clients for all platforms. All packages are hosted directly on this site for fast access without GitHub.

Go to Download Page GitHub Repo