How to Install Clash Verge Rev on macOS: Step-by-Step Guide 2026

What Is Clash Verge Rev on macOS?

Clash Verge Rev is an open-source graphical client for the Clash proxy stack. After the original Clash Verge project stopped receiving updates, the community fork continued development under the Rev name. On Mac, the app runs on the Mihomo core (formerly Clash.Meta) and supports mainstream protocols including Shadowsocks, VMess, VLESS, Trojan, and Hysteria2. If you are searching for Clash Verge Rev macOS install, Clash Verge Mac setup, or how to install Clash on Mac, this guide walks you from zero to a working proxy in one sitting.

macOS is the second-largest desktop platform for Clash users after Windows. Unlike a single-toggle VPN app, Clash Verge Rev gives you rule-based split routing, subscription sync, latency tests, and optional TUN capture—features that matter when you need domestic sites direct and international traffic proxied. The interface is similar across Windows and Mac, so users who follow our Windows setup guide will feel at home here, though macOS adds Gatekeeper prompts and network-extension permissions that Windows handles differently.

This tutorial covers both Intel and Apple Silicon (M1, M2, M3, M4) Macs. You do not need prior Clash experience; follow the steps in order and you can import a subscription and enable your first proxy within about ten minutes.

Step 0: Identify Intel vs Apple Silicon

Clash Verge Rev ships separate builds for each CPU architecture. Installing the wrong build wastes time or fails at launch, so confirm your chip before downloading.

1. Click the Apple menu in the top-left corner of the screen.
2. Choose About This Mac.
3. Read the line labeled Chip or Processor:

   • Apple M1 / M2 / M3 / M4 (or similar) → download the aarch64 or arm64 build
   • Intel Core (i5, i7, i9, etc.) → download the x86_64 or amd64 build

Apple Silicon Macs can run Intel builds through Rosetta 2, but the native arm64 build starts faster and uses less battery. Always prefer the architecture that matches your hardware.

System Requirements

Before you install, confirm that your Mac meets these baseline requirements:

Step 1: Download and Install on Mac

You can download the macOS disk image from this site’s download page instead of hunting for mirrors on GitHub. That keeps the file path simple and avoids broken release links.

1. Open the download page
   Visit our client download page and locate Clash Verge Rev under macOS. Apple Silicon Macs need the aarch64.dmg (or arm64.dmg) file. Intel Macs need x86_64.dmg (or amd64.dmg).
2. Mount the disk image
   Double-click the downloaded .dmg file. A Finder window opens showing the app icon and an Applications folder shortcut.
3. Drag to Applications
   Drag Clash Verge Rev into the Applications folder. Wait for the copy to finish, then eject the disk image.
4. First launch and Gatekeeper
   Open Applications and double-click Clash Verge Rev. If macOS shows “Clash Verge Rev cannot be opened because the developer cannot be verified,” do not panic—community builds are often unsigned. Right-click the app → Open → click Open again in the confirmation dialog. macOS remembers your choice for future launches.
5. Alternative: remove quarantine flag
   If the right-click method fails, open Terminal and run:

   xattr -cr /Applications/Clash\ Verge\ Rev.app

   Then launch the app normally from Applications.

On first run, Clash Verge Rev may download or update the Mihomo core automatically. Keep your network connected until that step completes. The app typically lives in the menu bar as well as the Dock—look for the Clash icon near the clock after launch.

Step 2: Import Your Subscription URL

Clash Verge Rev is built around remote profiles. Your VPN or proxy provider supplies a subscription URL (sometimes called a Clash link). The client fetches nodes and routing rules from that URL on a schedule you define.

Get your subscription link

Log in to your provider’s dashboard and copy the Clash subscription URL from the plan or setup page. It should start with https://. Store it somewhere safe—you will paste it into the client next.

Add a remote profile in the client

1. Open Clash Verge Rev and select Profiles in the left sidebar.
2. Click New in the top-right corner and choose Remote Profile.
3. Paste your subscription URL into the dialog and click Import. The client pulls the remote config and lists it under Profiles.
4. Click the imported profile once so it becomes active (highlighted). Only the selected profile drives live routing.

Enable automatic subscription updates

Providers rotate nodes and rules over time. Right-click the profile → Edit info → set Auto update to 720 minutes (12 hours) or shorter, then save. Your node list stays current without manual refreshes.

Optional: import a local config file

If the subscription URL is unreachable on your current network—a common issue on a fresh Mac with no proxy yet—download the .yaml config on another device or via mobile hotspot. In Profiles, choose New → Local Profile and select the file. Once you have connectivity, switch back to a remote profile for automatic updates.

Step 3: Choose a Proxy Node

After import, open the Proxies tab. You will see policy groups (for example Auto Select or Proxy) and individual servers underneath.

Many subscriptions ship an auto group that picks the lowest-latency node. You can also click Latency test (or the speed-test icon) and manually select a region that matches your use case—US streaming, EU browsing, Asia gaming, and so on.

Step 4: Turn On System Proxy

On the home screen, flip the System Proxy switch to ON. macOS network proxy settings are applied automatically, so Safari, Chrome, and most desktop apps that respect system proxy will route through Clash.

Test the setup by opening a browser and visiting google.com or a connectivity-check site your provider recommends. If the page loads, system proxy mode is working.

You can also open System Settings → Network → Wi‑Fi (or Ethernet) → Details → Proxies and confirm that HTTP and HTTPS proxy entries point to the local address Clash Verge Rev uses (typically 127.0.0.1 on a mixed port such as 7890).

Step 5: Enable TUN Mode (Recommended for Full Coverage)

System proxy only affects applications that honor macOS proxy settings. Terminal tools, some games, and certain sandboxed apps ignore it. TUN mode creates a virtual network interface and captures outbound traffic at the OS layer—true full-system proxying on Mac, similar to Wintun on Windows.

How to enable TUN mode on macOS

1. Open Clash Verge Rev Settings
   Click Settings at the bottom of the sidebar and locate the Clash Core or TUN section.
2. Turn on TUN Mode
   Enable the TUN Mode switch. macOS prompts you to allow a network extension—click Allow and enter your Mac login password if asked.
3. Verify in System Settings
   Open System Settings → Privacy & Security (or Network Extensions on older macOS versions) and confirm Clash Verge Rev / Mihomo is listed and enabled.
4. Test from Terminal
   Open Terminal and run curl -I https://www.google.com or ping -c 3 8.8.8.8. A normal response indicates CLI traffic is also tunneled.

If you use another VPN client (corporate Cisco AnyConnect, personal WireGuard, etc.), disable it before enabling TUN—two tunnel drivers competing for routes is a frequent source of “connected but no internet” on Mac.

Step 6: Understand Rule-Based Routing

By default, Clash Verge Rev uses Rule mode: each connection is matched against a rule list that decides DIRECT, PROXY, or REJECT. This is the main reason power users choose Clash over single-toggle VPN apps on macOS.

Typical behavior in a well-maintained subscription:

• Domestic sites (local CDNs, regional services): DIRECT for lower latency
• International sites (search, video, social): routed through your proxy group
• Ad or tracker domains: REJECT when the ruleset includes blocking lists

Most providers bundle GEOIP and domain rules so you do not need to edit config.yaml on day one. If a site routes incorrectly, switch policy groups on the Proxies page or ask your provider to refresh the remote ruleset.

Developers on Mac often appreciate Rule mode because git, Docker, and IDE traffic can stay direct while browser and API calls to blocked services go through the tunnel—without forcing every packet abroad.

macOS-Specific Tips

Menu bar control

Clash Verge Rev can minimize to the menu bar. Enable Launch at Login under Settings so the client starts with macOS—useful on a MacBook you carry daily. From the menu bar icon you can toggle System Proxy or TUN without opening the full window.

Sleep, wake, and network changes

After your Mac wakes from sleep or switches Wi‑Fi networks, connections may stall until Clash refreshes routes. Toggle System Proxy or TUN off and on, or use Reload config in Profiles if pages stop loading.

Language and appearance

The UI supports multiple languages and dark themes. Under Settings → Appearance, pick Follow system to match macOS light/dark mode automatically.

Multiple profiles

If you use more than one provider, import each subscription as a separate profile and click to switch—no reinstall required.

Common Issues and Fixes on Mac

Issue 1: macOS blocks the app as “unidentified developer”

This is expected for many open-source Mac builds that are not notarized by Apple. Use the right-click → Open method described in Step 1, or run xattr -cr on the app bundle. Do not disable Gatekeeper globally unless you understand the security trade-off.

Issue 2: App crashes immediately on launch

You may have installed the wrong architecture build. Re-check About This Mac, download the matching aarch64 or x86_64 package, replace the app in Applications, and try again.

Issue 3: Subscription import fails with a network error

The subscription host may be unreachable before any proxy is running—a classic chicken-and-egg problem. Try these workarounds:

• Temporarily use a mobile hotspot, import successfully, then return to your usual network
• Download the config on another device that already has connectivity, then import the file locally
• Ask your provider for a backup URL or a direct download link

Issue 4: Speed drops after enabling the proxy

Throughput usually depends on node quality and routing mode:

• Run a latency test and switch to a faster server
• Confirm you are in Rule mode, not Global—Global sends all traffic abroad and feels slower for local sites
• Check whether your plan expired or bandwidth quota is exhausted
• On Wi‑Fi, move closer to the router or try Ethernet to rule out local network issues

Issue 5: TUN is on but Terminal or apps still fail

Common causes on macOS:

• Network extension permission was denied—reopen System Settings and allow Clash Verge Rev
• Another VPN or filter (Little Snitch profile, corporate MDM) conflicts with the virtual interface
• The selected node lacks UDP support, which breaks some DNS or gaming traffic

Issue 6: Concern about DNS leaks

With TUN enabled, Clash Verge Rev can hijack DNS queries and reduce leak risk. In Settings, confirm DNS hijacking is on and choose redir-host or fake-ip as appropriate. Upstream DNS over HTTPS (DoH) adds another layer when your provider supports it.

Why Download From This Site?

Third-party repacks of Clash Verge Rev sometimes bundle outdated cores or modified binaries. Our download page points to maintained builds and mirrors files for faster access:

• Trusted source: Installers align with official release channels without unknown repackaging
• Both Mac architectures: Clear labels for Apple Silicon and Intel so you pick the right .dmg the first time
• Stable downloads: Hosted on our CDN instead of scattered mirror links
• Cross-platform: Windows, macOS, Android, and Linux clients are available from the same hub

Visit the download page to grab the latest build for your Mac.

Many Mac VPN apps from the App Store offer a single connect button but hide routing rules—you cannot see which domains stay direct or which protocol is in use, and switching providers often means uninstalling and starting over. Browser extensions cover Safari or Chrome but leave Terminal, Steam, and App Store downloads untouched. Clash Verge Rev, backed by the Mihomo core, exposes rule-based split routing, subscription sync, latency tests, and optional TUN capture in one native desktop UI—on both Intel and Apple Silicon—so you keep control without juggling multiple tools. If you want that flexibility on macOS, start with a clean install from our download page.

Download Clash free for every platform →