# ClashX Meta

{% hint style="danger" %}
ClashX Meta is complicated to set up. Please consider using [FlClash](https://docs.wannaflix.net/mac-os/flclash-recommended) instead.
{% endhint %}

Updated: March 29, 2026

{% hint style="info" %}

### ClashX.Meta version 1.4.31 and up (March 2026 release). 

ClashX.Meta **version 1.4.31 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.
{% endhint %}

## STEP 1: Download and install ClashX

{% hint style="success" %}

### Version: v1.4.31

[**Click here**](https://cdn-edge.wannaflix.net/clash/macos/ClashX.Meta.zip) **to download the app.** 

Alternative mirrors:

* Download on [Github](https://github.com/MetaCubeX/ClashX.Meta/releases) 
  {% endhint %}

### Install the Application

1. Double-click the `.zip` file. It will extract/unzip the application 
2. Double-click `ClashX Meta`

#### Allow ClashX.Meta to run on your Mac

If you encounter a warning stating that the app cannot be opened because **Apple cannot check it for malicious software**, follow these steps:

1. Go to **System Settings > Privacy & Security**.
2. Click **"Open Anyway"** next to the warning about ClashX.Meta.
3. Confirm by clicking **"Open"** in the subsequent dialog.

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2F8feydJj8zDpkBn9U4RRV%2FScreenshot%202025-05-02%20at%204.52.35%E2%80%AFPM.png?alt=media&#x26;token=c536ea9e-348c-445c-a972-250d8efc1bc2" alt="" width="264"><figcaption></figcaption></figure>

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2FGlj8DjIfGu2eUwTnOYPY%2FScreenshot%202025-05-02%20at%204.53.29%E2%80%AFPM.png?alt=media&#x26;token=86e7f73c-0575-48eb-8783-fd6d2f28b5cb" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}

### Source

<https://support.apple.com/guide/mac-help/apple-cant-check-app-for-malicious-software-mchleab3a043/mac>
{% endhint %}

### **Launch ClashX**

* Open `ClashX Meta`&#x20;
* 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.​

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2FdYvLlSL4TossAcnUMl5c%2F2025-05-03%2022.36.39.jpg?alt=media&#x26;token=8a749c77-4387-4213-beba-8c8842aa2de5" alt="" width="256"><figcaption></figcaption></figure>

You will find the ClashX.Meta icon (a big letter M) in the menu bar (top of the screen).

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2FkP1YcaQajrmjhbkpurnf%2FScreenshot%202025-05-02%20at%205.17.45%E2%80%AFPM.png?alt=media&#x26;token=918133f2-f954-44d0-ba2c-236bfc00f652" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}

## TIP

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.
{% endhint %}

{% hint style="info" %}

### App Icon

The app icon is a big M.

You will find the app in the menu bar at the top right of your screen.

![](https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2F1LI68dq9gryjaDCie2fN%2FScreenshot%202025-05-02%20at%205.13.02%E2%80%AFPM.png?alt=media\&token=85a38d96-009b-4e18-8478-cece22bf5fcb)
{% endhint %}

{% hint style="info" %}

## TIP: Launching ClashX.Meta

You can easily find **ClashX.Meta** again through **Spotlight Search:**

1. Press `⌘ + Space` to open **Spotlight**.
2. Type `ClashX Meta`.
3. 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.
{% endhint %}

## STEP 2: Import your config

### Copy the API

1. Login to your [client area](https://wannaflix.com/clientarea.php) dashboard
2. Select "ClashX Meta" in the dropdown for MacOS
3. Click "Copy API"

{% hint style="success" %}

### Different API types:

* **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]
  {% endhint %}

### Paste the API&#x20;

1. Open **ClashX Meta** by clicking on the icon at the top of your screen
2. Go to **Config > Remote Config > Manage**.
3. Click **Add**, paste your **subscription URL**, and name it.
4. Click **OK**, then select and **Update** the config.

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2F9Ep1oQtdSNSfTEiUugW8%2FScreenshot%202025-05-02%20at%205.33.49%E2%80%AFPM.png?alt=media&#x26;token=0f3c7480-d3e4-4224-9306-f68f01a2cc3d" alt="" width="375"><figcaption></figcaption></figure>

Your server list has now been downloaded to the app.

## STEP 3: Select a server and connect

### OPTION 1: Simple API

{% hint style="success" %}

### Recommended setup for new users

If you see a different setup that the screenshots, check that you got the correct config API from our website
{% endhint %}

1. Click on `Wannaflix`
2. Click `Benchmark` and then select a server with a number next to it
3. Make sure `Proxy Mode` is set to `Rule`, and select `Set as system proxy`

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2F0kj43bKrOItFhUIiFB3j%2Foie_93sx24FceRuv.png?alt=media&#x26;token=437883ac-cf32-430c-bf23-bdab60bd3eda" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2FTR0pdOL0MUBSAqp4TUu8%2FScreenshot%202025-05-02%20at%2010.28.08%E2%80%AFPM.png?alt=media&#x26;token=fe7e22da-b088-4e8a-8e99-42b062a3aafb" alt="" width="350"><figcaption></figcaption></figure>

### OPTION 2: Split-tunneling API - decide which server each site will go through

{% hint style="warning" %}

### Setup for advanced users

If you don't need split-tunneling, we recommend sticking to the Simple API setup above
{% endhint %}

1. Click on `Wannaflix`
2. Click `Benchmark` and then select a server with a number next to it
3. Make sure `Proxy Mode` is set to `Rule`, and select `Set as system proxy`

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2FXI1lkvddu2pHBEVw9jZt%2Foie_tP6cllkukg0q.png?alt=media&#x26;token=be5bdead-30f2-4da7-a101-28c92ba99c9c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2FBI51Mm99tzKHtaJhBWId%2FScreenshot%202025-05-02%20at%2010.39.24%E2%80%AFPM.png?alt=media&#x26;token=4d34515b-85cd-4034-87b1-61257ae0912e" alt="" width="290"><figcaption></figcaption></figure>

{% hint style="info" %}

### What are modes?

Rule - **Recommended.** Choose this option if you are in China. Websites go to different servers based on pre-configured rule sets.&#x20;

Global - All websites go through one Wannaflix server. Can cause Chinese sites to malfunction. Only choose this option if you are **NOT** in China.&#x20;

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).
{% endhint %}

{% hint style="success" %}

### Configure split tunneling (Optional)

1. You'll see a list of different groups(like `Wannaflix`,  `🍎 Apple`, or `📺 Netflix`)
2. Click on the **group** name (e.g., `📺 Netflix`)
3. Select the desired server from the list (e.g., 🇯🇵 Japan, 🇸🇬 Singapore, etc.)
4. &#x20;That service will now go through your selected server.&#x20;
   {% endhint %}

### You are now connected.

{% hint style="success" %}

### How to disconnect

Unselect "Set as system Proxy"&#x20;
{% endhint %}

{% hint style="danger" %}
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.
{% endhint %}

&#x20;                                     ***`END OF SETUP`***                                      &#x20;

***

## FYI \[IMPORTANT READ]

### If you want to play games with Clash or have all apps go through Clash, you need to use TUN Mode instead of System Proxy

1. Click the **ClashX Meta** icon in the menu bar.
2. Select **TUN Mode**.
3. Make sure **“Set as system proxy”** is **unchecked**, since TUN handles routing directly.

{% hint style="success" %}
When TUN mode is enabled, there is no need to enable system proxy.
{% endhint %}

<figure><img src="https://1304992641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lc04095R6CkPoB8xaCl%2Fuploads%2FMm79iCgpwNW3cRbYpPfF%2FScreenshot%202025-05-02%20at%2010.43.39%E2%80%AFPM.png?alt=media&#x26;token=4ce069c6-eb33-4e3e-850a-df8c264dec21" alt="" width="355"><figcaption></figcaption></figure>

## FAQ

### How can I update the server list?

Go to **Config > Remote Config > Update**

### How can I play games with ClashX?

You need to use Tun Mode (see above), and connect to a server that supports UDP.

### Netflix/other website is using another server to connect instead of the one I selected.

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.