Download & Install

Detailed installation guides and commands for Windows, Linux and macOS, covering package managers, standalone installers and common issues.

Official Download for Windows Official Download for Mac OS

Windows Download & Install

Recommended: x64
Install via WinGet

Windows 11 built‑in package manager

winget install ClashVergeRev.ClashVergeRev
  • If UI fails to open, try the package with fix_webview2.
  • Windows 7 is no longer supported. Please upgrade to Windows 10/11.
Install via Scoop

Suitable for users needing custom config directory or portable mode

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh -outfile 'install.ps1'
.\install.ps1 -ScoopDir 'D:\Scoop' -ScoopGlobalDir 'D:\ScoopGlobal'
scoop bucket add extras
scoop install extras/clash-verge-rev
  • Community‑maintained distribution; downstream issues may not be supported.
  • After installation you can adjust config directory and core version in settings.
If WebView2 is missing or cannot be installed, download the package with fix_webview2.

Platform Notes & Download Tips

We focus on stability, security and usability across the Clash ecosystem. All download links point to official release channels and are kept transparent and up‑to‑date with upstream versions. To avoid risks from repackaged binaries, verify signatures and hashes before installing—especially on Windows using built‑in tools or PowerShell scripts. For first‑time users, prefer UI installers or package managers and select the correct architecture: most Windows machines should use x64 rather than arm64. If the UI fails to display or the app crashes, it is often related to WebView2—restore system updates and reinstall WebView2, or use the build bundled with fix_webview2.

On Linux and macOS, choose the appropriate package format per distro: apt for .deb (Ubuntu/Debian), dnf/yum for .rpm (Fedora/RHEL); Arch/Manjaro users should prefer pacman from official repos, or AUR helpers (paru/yay) when dependencies are satisfied. Distro‑specific dependencies may cause first‑run errors—install missing libraries per prompts or consult FAQs. macOS 12+ is recommended for best compatibility; macOS 11 users can replace the core with a go124 build of Mihomo if needed. For production, prefer stable releases; beta builds are for testing features and fixes and may have edge‑case gaps.

After installation, import and update subscriptions in‑app and use rule mode with proxy groups for fine‑grained routing. Choose system proxy or TUN mode per scenario. To start TUN without admin privileges, use service mode and allow the verge‑mihomo core through the firewall. For UWP apps (e.g., Microsoft Store) blocked by loopback restrictions, use the UWP tool to enable loopback and save. When evaluating network experience, prioritize peak‑hour bandwidth and stability—streaming relies more on bandwidth than latency.

Linux Download & Install

Ubuntu / Debian (.deb)

Install the matching .deb build:

sudo apt install -y ./Clash.Verge_x.x.x-_xxx.deb
  • Ubuntu 24.04 可能需要额外依赖，请参考常见问题。
Fedora / RHEL (.rpm)

Install the matching .rpm build:

sudo dnf install ./Clash.Verge_x.x.x-_xxx.rpm
sudo yum localinstall ./Clash.Verge_x.x.x-_xxx.rpm
Arch / Manjaro

Official repository

sudo pacman -S archlinuxcn-keyring
sudo pacman -S clash-verge-rev
Not recommended to use archlinuxcn on Manjaro, SteamOS and other Arch derivatives.

AUR helper (choose one)

# paru
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/paru.git
cd paru
makepkg -si
paru -S clash-verge-rev-bin

# yay
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
yay -S clash-verge-rev-bin

macOS Download & Install

System support
  • macOS 12 and above supported.
  • macOS 11 users can replace the core with Mihomo built with go124.
Replace Mihomo core

Place the downloaded Mihomo binary here:

/applications/Clash Verge.app/Contents/MacOS/verge-mihomo
  • Prefer upgrading macOS for better compatibility and security.

Program Files Overview

Windows common files
resources/
  locales/
  clash-verge-service.exe
  Country.mmdb
  enableLoopback.exe
  geoip.dat
  geosite.dat
  install-service.exe
  sysproxy.exe
  uninstall-service.exe
clash-verge.exe
verge-mihomo.exe
verge-mihomo-alpha.exe
  • For service mode, install and start clash-verge-service first.
  • If UWP apps cannot proxy, run enableLoopback.
Download & releases
  • Released only via GitHub Releases—verify sources.
  • Prefer stable builds for production; use betas cautiously.
Go to official download

Security & FAQs

  • Verify signatures and hashes after downloading to avoid tampering.
  • If UI fails to open, check WebView2 or use a fix_webview2 build.
  • Linux dependencies vary by distro—install missing libraries per prompts.
  • Keep macOS up‑to‑date for best support and security.