ClashX Meta
Setup takes about 8 mins
Last updated
Was this helpful?
Setup takes about 8 mins
Last updated
Was this helpful?
Updated: May 1, 2025
ClashX.Meta version 1.4.12 and up supports all major protocols, and works with all our servers. It also supports the TUN engine for capturing all app traffic.
ClashX.Meta is a continuation of the previous app, ClashX Pro. ClashX Pro is no longer updated, so we recommend switching to ClashX.Meta or OneClick instead.
Double-click the .zip
file. It will extract/unzip the application
Double-click ClashX Meta
If you encounter a warning stating that the app cannot be opened because Apple cannot check it for malicious software, follow these steps:
Go to System Settings > Privacy & Security.
Click "Open Anyway" next to the warning about ClashX.Meta.
Confirm by clicking "Open" in the subsequent dialog.
Open ClashX Meta
Upon first launch, the app may prompt you to install a helper tool to manage system proxy settings. Click "Install" and provide your administrator password when prompted.โ
You will find the ClashX.Meta icon (a big letter M) in the menu bar (top of the screen).
If ClashX.Meta runs without any error but you donโt see the icon in the menu bar, itโs likely because your menu bar is too full.
Try quitting a few other apps to free up space โ the icon should then appear automatically.
The app icon is a big M.
You will find the app in the menu bar at the top right of your screen.
You can easily find ClashX.Meta again through Spotlight Search:
Press โ + Space
to open Spotlight.
Type ClashX Meta
.
Selecting the app from the search results and pressing Enter
to launch it.
This is a quick way to reopen it without navigating through your folders.
Select "ClashX Meta" in the dropdown for MacOS
Click "Copy API"
Simple API: One proxy group, easy to set up, suitable for basic use. Recommended for new users.
Split-tunneling API: Supports multiple proxy groups and service-based routing for advanced control.
Subconverter API: A technical tool for advanced users to convert and customize subscription configs across different formats (Clash, Surge, etc.). [Only if you know what it is]
Open ClashX Meta by clicking on the icon at the top of your screen
Go to Config > Remote Config > Manage.
Click Add, paste your subscription URL, and name it.
Click OK, then select and Update the config.
Your server list has now been downloaded to the app.
If you see a different setup that the screenshots, check that you got the correct config API from our website
Click on Wannaflix
Click Benchmark
and then select a server with a number next to it
Make sure Proxy Mode
is set to Rule
, and select Set as system proxy
If you don't need split-tunneling, we recommend sticking to the Simple API setup above
Click on Wannaflix
Click Benchmark
and then select a server with a number next to it
Make sure Proxy Mode
is set to Rule
, and select Set as system proxy
Rule - Recommended. Choose this option if you are in China. Websites go to different servers based on pre-configured rule sets.
Global - All websites go through one Wannaflix server. Can cause Chinese sites to malfunction. Only choose this option if you are NOT in China.
Direct - Don't enable. (Disables the VPN).
NOTE: If you are using the SIMPLE API, Rule mode does split tunneling for Chinese and foreign sites automatically (Chinese sites connect directly, not through the VPN, and overseas sites go through the VPN).
You'll see a list of different groups(like Wannaflix
, ๐ Apple
, or ๐บ Netflix
)
Click on the group name (e.g., ๐บ Netflix
)
Select the desired server from the list (e.g., ๐ฏ๐ต Japan, ๐ธ๐ฌ Singapore, etc.)
That service will now go through your selected server.
Make sure to turn the "System Proxy" switch OFF before quiting the app or you won't have any internet if you do so (i.e. it doubles as a kill-switch).
To fix it, restart the app and turn the "System Proxy" switch OFF and then quit the app.
END OF SETUP
Click the ClashX Meta icon in the menu bar.
Select TUN Mode.
Make sure โSet as system proxyโ is unchecked, since TUN handles routing directly.
When TUN mode is enabled, there is no need to enable system proxy.
Go to Config > Remote Config > Update
You need to use Tun Mode (see above), and connect to a server that supports UDP.
You have probably selected "Rule" mode and the Netflix website is being redirected to another server based on the Netflix rule set. Select the server you want under "Netflix" in the server list.
Login to your dashboard