Setup
Install Clash Verge on macOS and Fix the “Damaged” Error
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.
Install and clear the quarantine flag
- Open the dmg and drag Clash Verge into Applications;
- 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.
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.
Windows 64-bit installer · v2.5.1 · free & open source