> For the complete documentation index, see [llms.txt](https://shadowrocket-wiki.gitbook.io/shadowrocket/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shadowrocket-wiki.gitbook.io/shadowrocket/mac/clashx-mac.md).

# ClashX Mac 教程

## ClashX Mac 使用教程

本教程介绍 ClashX macOS 客户端下载安装、订阅配置、节点连接以及常见问题解决方法。

***

## ClashX Mac下载

[点击下载客户端](https://github.com/ClashX-Pro/ClashX/releases/download/1.138.0/ClashX.dmg)

### 什么是 ClashX？

ClashX 是 macOS 平台上的 Clash 图形化客户端。

基于 Clash 核心运行，支持规则分流、订阅管理、节点选择以及系统代理功能。

主要功能：

* 支持订阅链接
* 自动更新配置
* 节点管理
* 延迟测速
* 规则分流
* 系统代理

***

## ClashX Mac 安装教程

### 下载 ClashX

下载 macOS 版本客户端。

安装步骤：

1. 打开下载的安装包
2. 将 ClashX 拖入：

```
Applications
```

3. 打开 ClashX

首次启动可能出现：

```
无法验证开发者
```

或者：

```
无法打开应用
```

解决方法：

进入：

```
系统设置
 ↓
隐私与安全性
```

点击：

```
仍然打开
```

***

## ClashX Mac 使用教程

### 打开 ClashX

启动后：

ClashX 会显示在顶部菜单栏。

点击顶部：

```
猫咪图标
```

即可打开功能菜单。

***

## 添加订阅配置

### 提前准备订阅地址

复制你的订阅链接：

```
你的订阅地址
```

***

### 添加托管配置

点击菜单栏 ClashX 图标：

进入：

```
配置
 ↓
托管配置
 ↓
管理
```

点击：

```
添加
```

填写：

#### URL

粘贴订阅地址：

```
你的订阅链接
```

#### Config Name

填写备注：

例如：

```
我的订阅
```

点击：

```
确定
```

***

## 更新订阅配置

进入：

```
配置
 ↓
托管配置
 ↓
管理
```

选择刚刚添加的订阅。

点击：

```
更新
```

等待更新时间刷新。

更新成功后：

配置文件会自动加载。

***

## 选择节点

点击顶部菜单：

```
代理
```

选择需要使用的节点。

建议：

先进行延迟测试。

参考：

| 延迟        | 状态 |
| --------- | -- |
| <100ms    | 优秀 |
| 100-200ms | 良好 |
| 200-500ms | 一般 |
| >500ms    | 较慢 |

***

## 开启系统代理

选择节点后。

点击：

ClashX 菜单：

```
设置为系统代理
```

开启成功后：

macOS 系统网络会经过 ClashX。

测试：

打开浏览器访问网站。

如果可以正常访问：

说明配置成功。

***

## ClashX 模式设置

### 规则模式（推荐）

进入：

```
出站模式
```

选择：

```
规则判断
```

效果：

* 国内网站直连
* 海外网站代理

适合日常使用。

***

### 全局模式

所有流量通过代理：

```
Global
```

适合测试。

***

### 直连模式

关闭代理：

```
Direct
```

***

## ClashX 节点测速

打开：

```
代理
```

选择：

```
延迟测试
```

根据延迟选择速度较快节点。

***

## ClashX Mac 常见问题

### 1. ClashX 无法连接

检查：

* 订阅是否有效
* 套餐是否正常
* 节点是否可用

解决：

1. 更新订阅
2. 更换节点
3. 重启 ClashX

***

### 2. 已开启代理但是无法访问

检查：

#### 出站模式

确认：

```
规则判断
```

#### 节点状态

确认节点后面有：

```
ms
```

表示测速正常。

#### 系统时间

确保：

```
macOS 时间正确
```

TLS 连接需要准确时间。

***

### 3. 浏览器无法访问

检查：

* 系统代理是否开启
* 浏览器是否安装代理插件
* 是否存在网络限制

建议：

关闭浏览器代理插件后重新测试。

***

### 4. ClashX 无法打开

如果提示：

```
Apple无法检查是否包含恶意软件
```

解决：

进入：

```
系统设置
 ↓
隐私与安全性
```

允许打开。

***

### 5. 网络环境问题

如果无法连接：

尝试：

* 切换 WiFi
* 使用手机热点
* 重启路由器

***

## 推荐设置

### 开机启动

打开：

```
ClashX
 ↓
设置
```

开启：

```
开机启动
```

***

### 自动更新订阅

建议：

定期更新托管配置。

保持节点最新。

***

## 图文教程

<figure><img src="/files/9vLh0TBxhdCXkMumeymq" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/iB9So9lDm4zCZu3LOUTz" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yk0flIl8RKAjDrISo1ds" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ABQgmD21nHDNzqixwwql" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/kPHDnIjSL3a9Sr2p3kq2" alt=""><figcaption></figcaption></figure>

***

## 总结

ClashX 是 macOS 平台常用的 Clash 客户端。

通过：

* 添加订阅
* 更新配置
* 选择节点
* 开启系统代理

即可完成基础配置。

建议：

* 定期更新订阅
* 使用低延迟节点
* 保持系统时间准确
* 使用稳定客户端版本


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://shadowrocket-wiki.gitbook.io/shadowrocket/mac/clashx-mac.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
