Clash Verge logo Clash VergeOpen-source cross-platform proxy client

Setup

Install Clash Verge on macOS and Fix the “Damaged” Error

Published · Updated · 2 min read

The first thing nearly every Mac user hits after downloading Clash Verge is the same message: “Clash Verge.app is damaged and can't be opened.” The file isn't damaged. It's Gatekeeper blocking an app that hasn't paid for Apple notarization, and one command clears it.

Pick the right image

  • aarch64.dmg — Apple Silicon (every M1 through M4 Mac);
  • x64.dmg — Intel Macs (pre-2020 machines).

Apple menu → "About This Mac": if the Chip line says Apple, take aarch64. Installing the wrong one won't error out — it will silently run through Rosetta and waste performance.

Only download the dmg from GitHub Releases or this site's direct links
Only download the dmg from GitHub Releases or this site's direct links

Install and clear the quarantine flag

  1. Open the dmg and drag Clash Verge into Applications;
  2. If launching shows the "damaged" dialog, open Terminal and run:
sudo xattr -r -d com.apple.quarantine "/Applications/Clash Verge.app"

Type your login password (nothing echoes) and press Return. The command only removes the quarantine attribute macOS stamps on downloaded files — it changes nothing else on the system.

Note

Some macOS versions show "cannot verify the developer" instead. In that case just go to System Settings → Privacy & Security and click "Open Anyway" at the bottom — no Terminal needed.

TUN mode needs an extra approval

Enabling TUN mode on macOS triggers a network-extension prompt. Follow it to System Settings → Privacy & Security and allow it. If the approval entry never shows up, restart the app and toggle TUN again.

Upgrading

Just drag the new version into Applications over the old one. Profiles and settings live in ~/Library/Application Support and survive. To sync them across machines, see the WebDAV backup guide.

Don't have Clash Verge yet?

Windows 64-bit installer · v2.5.1 · free & open source

Download v2.5.1