ClashX 是一个以Clash为内核的MAC系统翻墙工具.

A rule based proxy For Mac base on Clash. 原作者删库。

ClashX 旨在提供一个简单轻量化的代理客户端。使用教程

注意

• ClashX / ClashX Pro 只是一个代理工具，不提供任何代理服务器。如果服务器不可用或与服务器续费有关的问题，请与您的提供商联系。
• ClashX / ClashX Pro 目前并没有创建官网。凡是声称是 ClashX / ClashX Pro 官网的一定是骗子。

Features

• HTTP/HTTPS and SOCKS protocol
• Surge like configuration
• GeoIP rule support
• Support Vmess/Shadowsocks/Socks5/Trojan
• Support for Netfilter TCP redirect

Install

ClashX Pro With enhanced mode and other clash premium feature

ClashX Pro版本，支持增强模式以及更多Clash Premium Core特性。

You can download from Release page

Build

Download deps

bash install_dependency.sh

• Build and run.

Config

The default configuration directory is $HOME/.config/clash

The default name of the configuration file is config.yaml. You can use your custom config name and switch config in menu Config section.

Checkout SS-Rule-Snippet for Clash for more detail.

Advance Config

修改代理端口号

1. 在菜单栏->配置->更多设置中修改对应端口号

Change your status menu icon

Place your icon file in the ~/.config/clash/menuImage.png then restart ClashX

Change default system ignore list.

• Change by menu -> Config -> Setting -> Bypass proxy settings for these Hosts & Domains

URL Schemes.

Using url scheme to reload current config.

clash://update-config

Get process name

You can add the follow config in your config file, and set your proxy mode to rule. Then open the log via help menu in ClashX.

script:
  code: |
    def main(ctx, metadata):
      # Log ProcessName
      ctx.log('Process Name: ' + ctx.resolve_process_name(metadata))
      return 'DIRECT'

FAQ

• Q: How to get shell command with external IP?
  A: Click the clashX menu icon and then press Option-Command-C

关闭ClashX的通知

1. 在系统设置中关闭 clashx 的推送权限
2. 在菜单栏->配置->更多设置中选中减少通知

Note：强烈不推荐这么做，这可能导致clashx的很多重要错误提醒无法显示。

全局快捷键

• 在菜单栏配置->更多配置中，自定义对应功能的快捷键。（需要1.116.1之后的版本）
• 使用AppleScript设置, 详情点击 全局快捷键

from  https://github.com/bannedbook/ClashX

Make sure have python3 and golang installed in your computer.

Install Golang

brew install golang

or download from https://golang.org

Using url scheme to import remote config.

clash://install-config?url=http%3A%2F%2Fexample.com&name=example

----------------------------------------------------------------------

Clash X

clashx.tech

 

ClashX

English | 简体中文

⚠️ Notice

This project is based on code originally created by yichengchen. I discovered that the original version was not compatible with macOS 26 (Sequoia), so I modified the code to make it work on macOS 26. The source code was forked from bannedbook/ClashX. The git history was lost because I accidentally deleted the .git folder when recreating the project after encountering some issues.

---

🌐 Official Website

Official Website: https://clashx.tech

• 📥 Download Latest Version
• 📖 Documentation & Tutorial
• ❓ FAQ
• 🚀 Next-Gen Client: ClashFX — A modern macOS proxy client with advanced features

---

🚀 Need Advanced Features? Try ClashFX

ClashX focuses on a simple, lightweight, and compatible macOS proxy experience. If you need more advanced capabilities, we recommend migrating to ClashFX, our next-generation macOS client built around the mihomo core.

ClashFX includes advanced features such as:

• Enhanced Mode (TUN) for system-wide TCP/UDP traffic capture
• Support for newer proxy protocols and mihomo core capabilities
• Rule-based routing with domain, IP-CIDR, GeoIP, and process matching
• Fake-IP DNS mode and gVisor userspace network stack
• Built-in dashboard and a more complete modern macOS experience

Download ClashFX from GitHub Releases or the official website: https://clashfx.com.

---

A rule-based proxy client for macOS based on Clash.

ClashX aims to provide a simple and lightweight proxy client with an intuitive interface.

⚠️ Notice

• Official Website: Please visit the official website at clashx.tech.
• ClashX / ClashX Pro is only a proxy tool and does not provide any proxy servers. For server-related issues or renewals, please contact your service provider.

✨ Features

• HTTP/HTTPS and SOCKS protocol support
• Surge-like configuration
• GeoIP rule support
• Support for Vmess/Shadowsocks/Socks5/Trojan protocols
• Netfilter TCP redirect support
• macOS 10.14+ compatibility
• macOS 15+ (Sequoia) support with compatibility fixes

📥 Installation

Download ClashX from the Releases page.

For Enhanced Mode (TUN), newer protocol support, and other advanced capabilities, use ClashFX.

🔨 Build from Source

Prerequisites

• macOS 10.14 or later
• Xcode 15.0+
• Python 3
• Golang 1.21+

Build Steps

1. Install Golang

   brew install golang
   # or download from https://golang.org

2. Install dependencies

   bash install_dependency.sh

3. Open and build

   open ClashX.xcworkspace
   # Build in Xcode (Cmd+R)

⚙️ Configuration

Default Paths

The default configuration directory is $HOME/.config/clash

The default configuration file name is config.yaml. You can use custom config names and switch between them in the Config menu.

For more details, check out SS-Rule-Snippet for Clash.

🔧 Advanced Configuration

Change Proxy Port

Go to Menu Bar → Config → More Settings and modify the corresponding port numbers.

Customize Status Menu Icon

Place your icon file at ~/.config/clash/menuImage.png, then restart ClashX.

Change Default System Ignore List

Navigate to Menu → Config → Settings → Bypass proxy settings for these Hosts & Domains.

URL Schemes

• Import remote config:

  clash://install-config?url=http%3A%2F%2Fexample.com&name=example
  

• Reload current config:

  clash://update-config
  

Get Process Name

Add the following to your config file and set proxy mode to rule. View logs via the Help menu:

script:
  code: |
    def main(ctx, metadata):
      # Log ProcessName
      ctx.log('Process Name: ' + ctx.resolve_process_name(metadata))
      return 'DIRECT'

Disable Notifications

1. Go to System Settings and disable ClashX notification permissions
2. Enable "Reduce Notifications" in Menu Bar → Config → More Settings

Note: Not recommended as you may miss important error notifications.

Global Shortcuts

• Customize shortcuts in Menu Bar → Config → More Settings (requires v1.116.1+)
• Or use AppleScript - see Shortcuts Guide

❓ FAQ

Q: How to get shell commands with external IP? A: Click the ClashX menu icon and press Option-Command-C

from https://github.com/clashx-pro/clashx