ClashX is a powerful, rule-based proxy client for macOS, supporting modern protocols such as VLESS, VMess, Shadowsocks, and Trojan. This guide covers installation, adding subscriptions, selecting rule modes, enabling system proxy, and troubleshooting.
ClashX provides a clean macOS interface on top of the Clash core. It enables smart, rule-based routing with policy groups, so you can proxy foreign/blocked sites while keeping domestic traffic direct, and switch nodes per group with minimal friction.
Tip: Prefer official sources for integrity; if macOS warns about an unidentified developer, allow the app after verifying source.
The easiest way to manage nodes is via a subscription URL provided by your service. ClashX will fetch and update nodes automatically.
You can also import single nodes (VLESS/VMess/SS/Trojan), but subscriptions are more convenient.
ClashX uses rule providers and policy groups to decide which traffic goes via proxy or direct. Common strategies:
Select policy groups (e.g., “Proxy”, “Media”, “Game”) and assign nodes as needed. Many subscriptions ship with sensible defaults.
Verify your route by visiting What’s My IP.
Profile download failed: Check the subscription URL; ensure your network can reach it; the link may be expired.
Browser not using proxy: Confirm “System Proxy” is enabled; ensure the browser uses system proxy; restart the browser.
DNS leaks: Use rule mode with proper DNS or enable DoH in the browser. Test with DNS Leak Test.
Streaming stutters: Use media-optimized policy groups; try alternative nodes closer to the streaming CDN.
Use our smart proxy finder to scan and recommend fast, available routes for your region.
Launch a Scan