Install Clash Verge Rev on macOS (Intel and Apple Silicon)

Clash Verge Rev brings the full Clash Meta experience to the Mac: an open-source desktop client with the mihomo core built in, available for both Intel and Apple Silicon machines. The install itself is a standard drag-to-Applications affair — the only speed bumps are choosing the right dmg for your chip and getting past macOS's security prompts on first launch.

This guide walks through all of it in order: identifying your chip, installing from the dmg, dealing with the "damaged" or "unverified developer" warnings, granting the permissions the app asks for, and connecting your first subscription.

Intel or Apple Silicon: pick the right dmg

Click the Apple menu → About This Mac. If you see a Chip line with "Apple M…" your Mac is Apple Silicon and needs the aarch64 dmg; if you see an Intel Processor line, take the x64 dmg. Both builds of Clash Verge Rev 2.5.2 are in the download center's macOS section.

Getting this right matters more in one direction: an Apple Silicon Mac can usually run the Intel build through Rosetta 2 with some overhead, but an Intel Mac cannot run the aarch64 build at all. If macOS offers to install Rosetta when you open the app, you took the Intel build on an M-series machine: fetch the native one instead. The background is covered in the Intel vs Apple Silicon guide.

Install from the dmg

1. Open the downloaded .dmg file.
2. Drag the app icon into the Applications folder shortcut in the same window.
3. Eject the disk image, then launch the app from Applications.

That copy step matters: an app launched straight from the mounted image disappears the moment you eject it. Once running, expect to find it in the menu bar rather than the Dock — that icon is where you switch the proxy on and off day to day.

Fix the "damaged" and "unverified developer" warnings

On first launch, macOS may claim the app "is damaged and can't be opened" or that the developer "cannot be verified". The app is fine — this is Gatekeeper reacting to the quarantine flag macOS attaches to software distributed outside the App Store without notarization. Three reliable fixes:

1. Through System Settings: open System Settings → Privacy & Security, scroll to the message about the blocked app, click Open Anyway and confirm.
2. Through Terminal: remove the quarantine attribute directly:

   xattr -dr com.apple.quarantine "/Applications/Clash Verge.app"

   Adjust the path if the app name on your system differs, then launch again.
3. Through Finder: right-click the app and choose Open from the context menu, then confirm. On several macOS versions this counts as explicit consent and permanently exempts that copy of the app.

The prompt is tied to the quarantine flag, not to the app's health, so it is a one-time event per download rather than a permanent state. Replace the app with a freshly downloaded dmg later and the flag comes back with it — the same fix applies.

If it still refuses to open, work through the dedicated "app is damaged" troubleshooting article — and double-check you did not grab the wrong chip's build.

Grant the permissions it asks for

The first time you flip on the system proxy or TUN mode, macOS will ask for administrator authorization so the app can install its helper components and change network settings. Enter your password and approve — without this, the switches simply will not take effect. The exact sequence of prompts varies a little across macOS versions, so approve what appears rather than hunting for a fixed list.

The two switches ask for different things, which is worth knowing when one works and the other does not. The system proxy only writes an entry into your network settings, so apps that read it follow along and the rest carry on directly. TUN mode installs a privileged helper and creates a virtual network interface that captures traffic at the network layer, including from programs that ignore proxy settings entirely — a bigger ask, hence the password.

Dismiss the dialog and the toggle flips itself back off; switch it on again to bring the prompt back. If the prompt stops appearing while the switch still refuses to stay on, quit the app from the menu bar and start it again.

Import a subscription and connect

1. Copy the subscription URL from your provider's dashboard.
2. In the Profiles page, paste the URL and import it, then select the new profile. Details for every client are in the subscription import guide.
3. In Proxies, run a latency test and pick a node.
4. Enable System Proxy in the settings, then confirm a previously blocked site loads.

Updating and uninstalling

To update, download the newer dmg and drag the app into Applications again, replacing the old copy — your profiles and settings live in your user folder and survive the swap. Quit the running app first, since macOS will not overwrite an application that is still open, and expect the Gatekeeper prompt once more for the new copy. To uninstall, turn off the system proxy first so your network settings are left clean, quit the app from the tray icon, then move it from Applications to the Trash.