Clash Official Tutorial

Three Steps to Get Started with Clash

Regardless of the platform, getting started with Clash takes only three steps and less than 5 minutes.

01

Choose Platform, Download and Install

Select the recommended client for your operating system and complete the installation:

Windows — Clash Verge Rev (EXE)
macOS — Clash Verge Rev (DMG)
Android — FlClash (APK)
iOS — Shadowrocket (App Store)
Linux — Clash Verge Rev (DEB/RPM)
Go to Download Page
02

Paste Subscription, Import Nodes

Open the client, go to the "Subscription / Profiles" page, paste the subscription link provided by your proxy provider, and click "Import." The node list will download automatically.

Subscription links start with https:// and are provided by proxy providers. No manual server parameter entry is required.
03

Select Node, Enable Proxy

On the "Proxy" page, select a low-latency node and enable "System Proxy" (for general users) or "TUN Mode" (for developers / command-line tools).

Visit ip.sb; if it shows an IP from the node's country, the proxy is active.

Windows Tutorial

Recommended Client: Clash Verge Rev — Tauri-based with built-in Mihomo core, supporting TUN mode and system proxy.

1

Download and Install Clash Verge Rev

Go to the download page and download the Clash Verge Rev x64 EXE installer in the Windows section (most Windows 10/11 systems are x64). For ARM devices like Surface Pro X, please download the ARM64 version.

Download for Windows
SmartScreen Block: Click "More info" → "Run anyway." Clash Verge Rev is open-source, and its source code is public for auditing.
2

Import Subscription

Open Clash Verge Rev, click the "Profiles" menu on the left, paste your provider's subscription link in the top input box, and click "Import."

Click the "Profiles" menu on the left
Paste the subscription link (https://…) in the input box and click "Import"
Wait for the node list to download, then click the card to set it as the current configuration
The subscription card displaying the number of nodes indicates a successful import.
3

Select Node and Enable System Proxy

Click the "Proxy" menu on the left, click "Ping" in the top right to get real-time latency, select a low-latency node, then click the "System Proxy" toggle (it turns blue when enabled).

4

Advanced: Enable TUN Mode

If you need command-line tools like git, npm, or curl to use the proxy, enable TUN Mode on the settings page. A UAC prompt will appear; click "Yes."

PowerShell — Verify TUN Mode
PS> # 查看当前出口 IP
PS> curl -s https://ip.sb
104.xxx.xxx.xxx # 节点 IP,TUN 已生效
5

Update Subscription

On the "Profiles" page, click the refresh icon in the top right of the card to update manually; or click "Edit" to enable auto-update and set an interval (24 hours recommended).

macOS Tutorial

Recommended Client: Clash Verge Rev — Native support for both Apple Silicon M-series and Intel architectures.

1

Select the Correct DMG Architecture

Apple Silicon(M1 / M2 / M3 / M4) Download clash-verge-rev-mac-arm64.dmg For Macs released after late 2020; "About This Mac → Chip" contains "M"
Intel 处理器 Download clash-verge-rev-mac-x64.dmg For Macs released before 2020; "About This Mac → Processor" contains "Intel"
Download for macOS
2

Install and Bypass Gatekeeper

Double-click the .dmg and drag the icon to the Applications folder.

If it says "developer cannot be verified" on first launch, click "OK" to close
Go to "System Settings → Privacy & Security," find the blocked prompt, and click "Open Anyway"
Double-click to open again; no need to repeat this later
This is a standard Apple Gatekeeper block for non-notarized developers. Clash Verge Rev is open-source, safe, and trustworthy.
3

Import Subscription and Enable Proxy

Operation is identical to the Windows version: paste link in "Profiles" to import, select node in "Proxy," and toggle "System Proxy" in the top right.

Menu Bar Icon: Clash Verge Rev stays in the macOS menu bar for quick node switching and proxy toggling without opening the full interface.
4

Advanced: TUN Mode

Enable TUN Mode in settings to handle all traffic from terminal tools like brew, npm, and git. A system authorization dialog will appear on first use; enter your password to confirm.

Android Tutorial

Recommended Client: FlClash — Material You design, one-click subscription import, the top choice for beginners.

1

Download FlClash APK

Go to the download page and download the FlClash APK in the Android section. For phones released after 2016, download the ARM64 version; ARMv7 is only for older models.

Download for Android
2

Allow Installation from Unknown Sources

Click the APK file; the system may prompt that it's blocked
Go to "Settings → Security" and allow "Apps from this source"
Return and click "Install anyway"; it's recommended to disable this permission after installation
Paths vary by brand but logic is the same: Xiaomi is in "Security Settings," Huawei is in "App Settings."
3

Import Subscription

Open FlClash, click "Config" in the bottom bar
Click "+" in the top right → "Import from URL"
Paste subscription link, enter a name, and click "Save"
Wait for configuration to download, then click the card to activate
4

Enable VPN and Select Node

Select a node on the "Proxy" page, and click the start button in the bottom bar to enable VPN mode. A "VPN Connection Request" will appear on first launch; click "OK."

Android VPN mode is equivalent to desktop TUN mode, automatically splitting traffic so local apps remain unaffected.
Alternative for Advanced Users

Users with Clash experience who need advanced configuration can choose ClashMeta for Android (by MetaCubeX), featuring deep Mihomo core integration. Also available on the Android download page.

iOS Tutorial

Recommended Clients: Shadowrocket (Best for beginners, $2.99) · Stash (Full Mihomo compatibility)

iOS Special Note: Due to Apple policies, Clash-compatible clients are not available on the China mainland App Store and are paid apps. You'll need a US or HK region Apple ID.
1

Register a US Apple ID (Approx. 10 mins, Free)

Open appleid.apple.com in your browser and click "Create Your Apple ID"
Fill in the info, and select United States for "Country or Region"
Complete email verification to finish registration
iPhone App Store → Avatar in top right → Sign Out → Sign in with US ID
No US credit card required; you can buy US App Store gift cards from online retailers to top up and purchase.
3

Import Subscription in Shadowrocket

Open Shadowrocket, click "+" in the top right
Select Type "Subscribe" and paste your subscription link into the URL field
Enter a remark, click "Done," and the subscription will download automatically
Return to the home screen, toggle the "Not Connected" switch, and authorize the VPN to start using
When the home screen switch shows "Connected" and the VPN icon appears in the status bar, the proxy is active.

Linux Tutorial

Recommended Clients: Clash Verge Rev (GUI Desktop) · or Mihomo CLI (Server / No Desktop Environment)

1

Download and Install Clash Verge Rev

Ubuntu / Debian 系 Download .deb package and install via double-click or terminal For Ubuntu 20.04+ · Debian 11+
Fedora / RHEL / openSUSE Download .rpm package and install via double-click or terminal For Fedora 36+ · RHEL 8+
Download for Linux
bash — Install DEB package
$ sudo dpkg -i clash-verge-rev-linux-amd64.deb
$ # RPM(Fedora/RHEL)
$ sudo rpm -i clash-verge-rev-linux-x86_64.rpm
2

Import Subscription and Enable Proxy

The operation of the Linux GUI version is identical to Windows/macOS: paste the link into the "Profiles" page to import, select a node on the "Proxy" page, and enable "System Proxy" or TUN mode.

TUN Mode: Root privileges are required for the first launch; Clash Verge Rev will automatically request sudo authorization.
3

Server / No Desktop Environment: Mihomo CLI

On servers without a GUI, use the Mihomo core CLI with systemd for auto-start on boot.

bash — Deploy Mihomo CLI
$ # 下载并解压
$ wget /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
$ # 配置并启动
$ mkdir -p ~/.config/mihomo && cp config.yaml ~/.config/mihomo/
$ mihomo -d ~/.config/mihomo
INFO Mihomo started successfully
FAQ
Covering proxy configuration, subscription import, connection failure, and other common issues for beginners.
How do I know if the proxy is active?

After enabling the proxy, visit ip.sb or whatismyip.com. If it shows an IP from the node's country (USA, Japan, HK, etc.), the proxy is successful.

If the IP is still local: 1. Check if the proxy switch is on; 2. Check if the selected node is available; 3. Try switching to a different node.

Browser can access Google, but git / npm / pip cannot connect?

This is a known limitation of System Proxy mode; command-line tools do not read system proxy settings by default.

Solution: Enable TUN Mode to handle all traffic, or execute temporarily in the terminal: export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890

Subscription import failed, showing "Fetch Failed" or "Network Error"?

1. Subscription link expired: Log in to your provider's user center to get a new one.

2. Subscription server is blocked: Use another proxy to import first, or contact your provider to change the subscription domain.

3. Incomplete link: Ensure the link starts with https:// and has no extra spaces.

What's the difference between TUN Mode and System Proxy? Which should I use?

System Proxy: Only handles applications that support HTTP/SOCKS (like browsers). Easy to configure, suitable for general daily use.

TUN Mode: Handles all OS traffic via a virtual network card. All apps and command-line tools use the proxy. Recommended for developers.

What if node latency is high or it disconnects frequently?

1. Click "Ping" on the "Proxy" page and select a node with latency below 100ms.

2. Select the "URLTest (Auto Select)" policy in the proxy group; Clash will automatically switch to the lowest-latency node.

3. Try switching to nearby nodes like Hong Kong, Japan, or Singapore.

What's the difference between "Rule" and "Global" modes?

Rule Mode: The default Clash mode. Local websites connect directly, overseas sites use the proxy, and ads are blocked. Best experience, recommended for daily use.

Global Mode: All traffic goes through the proxy, including local traffic. This increases latency and may affect local services. Not recommended for daily use.

Haven't downloaded the client yet?

Go to the download page, select your OS, and complete setup in 5 minutes to experience smart split-proxying.

Download for Free Now