Clash for Mac · Downloads

Clash Downloads & Architecture Guide

Choose the operating system where you’ll run the client, then download the build for your device’s architecture. On a Mac, use About This Mac to tell Apple silicon and Intel models apart.

Platform
Choose the target system, not the device you’re downloading on
Architecture
Check system details against the filename
Configuration
Import your subscription after installation

Choose a package by platform

macOS is shown by default. Switch platforms to view their downloads, then copy the current URL to share that platform’s download page.

macOS clients

If About This Mac lists an Apple silicon chip, choose arm64. For a Mac with an Intel processor, choose x64 or amd64.

macOS system requirements

DeviceWhat to look for
Apple siliconChoose macOS arm64. Some Intel apps run through Rosetta, but an app launching successfully doesn’t guarantee its helper processes or networking features will work.
IntelChoose macOS x64, amd64, or x86_64. For older Macs, also check the client’s minimum macOS version; matching the processor architecture isn’t enough.
Network permissionsFollow the client’s prompts to grant system proxy or helper service permissions. If your organization-managed Mac restricts installation or permissions, contact your device administrator.

Card badges show the app version listed in the release directory. If it differs from the version in the package filename, use the downloaded file to confirm the package version and architecture.

Before and after installation

Change one setting at a time. First confirm the app launches, then import your configuration and enable the proxy.

Identify the architecture and package format

x64, amd64, and x86_64 usually refer to the same desktop instruction set; arm64 refers to a different one. Even with a matching architecture, packages for different operating systems aren’t interchangeable: a Mac DMG can’t replace a Windows EXE, and an APK can’t be installed on a Mac as a regular desktop app.

Keep your configuration when switching clients

Back up your current local configuration, subscription source, and any rules you added yourself. Subscription URLs may contain account credentials; don’t share them in public logs or screenshots. Import a compatible configuration into the new client. You may need to set up ports, bypass lists, and launch options again.

Test before routing all traffic

On first launch, confirm your configuration appears in the list and can be enabled, then choose a rules mode. Test with an app that uses the system proxy and check its requests in the connection log. If you need to route traffic from apps that ignore the system proxy, test TUN separately.

Troubleshoot the step where the error occurs

If the app won’t open before you’ve imported a configuration, check the OS version, architecture, and startup message first. If it opens but doesn’t work, distinguish between a failed subscription import, an inactive configuration, and traffic that isn’t being routed. Quit other proxy or VPN apps before reproducing the issue to avoid multiple apps changing network settings at once.

Download FAQs

Should I download the Apple silicon or Intel version for my Mac?

Open About This Mac from the Apple menu. If it lists a Chip with an Apple M-series name, choose arm64. If it lists a Processor with an Intel name, choose x64 or amd64. Even when download links are listed by Mac model, check the downloaded filename: an x64 file is not a native Apple silicon build.

Do I need to re-import my subscription when switching Clash clients?

Usually, yes. Each client stores subscriptions and local settings separately, and installing a new client won’t import your old configuration automatically. Back up your configuration and subscription URL first, then import them into the new client and check your proxy groups, rules, and local ports. Quit the old client before testing to prevent both clients from changing system proxy settings at the same time.

Android says the package is incompatible. Should I try the universal version?

First check which app architectures your device supports and the Android version required by the client. If you’re unsure of the architecture and a universal build is available, try that. If an app with the same name is already installed, a different signing key may prevent an in-place update. Back up your configuration before uninstalling.

Should I choose DEB or RPM on Linux?

Choose DEB for Debian and Ubuntu-based distributions, and RPM for Fedora and other RPM-based distributions. Run uname -m to check your system architecture, then make sure your distribution meets the package’s dependencies. A matching package format alone doesn’t guarantee that the architecture or library versions are compatible.

Do I need to download Mihomo separately after installing a GUI client?

Usually not. GUI clients typically include a core or provide a way to manage it; use the client’s built-in update method where available. The standalone Mihomo package is for users managing configuration and processes themselves on servers, routers, or from the command line.