上手教程
第一次使用，也能从容开始。
从安装到系统级流量接管，每个步骤都保持清楚、可逆。
安装与首次启动
安全下载、安装到应用程序，并完成 macOS 首次运行确认。
开始教程 →导入配置
通过订阅地址、配置文件或 URL Scheme 添加你的配置。
开始教程 →开启 Enhanced Mode
让所有应用的 TCP/UDP 流量按照规则处理。
开始教程 →从 ClashX 迁移
备份旧配置、避免双客户端冲突，并在 ClashFX 中重新验证。
开始教程 →让指定 App 直连
确认真实进程名，并用 PROCESS-NAME 规则减少误代理。
开始教程 →TUN 断网排查
按层定位 DNS、权限、节点、端口或其他网络工具冲突。
开始教程 →国内 App 直连
使用 cn-apps-direct 一键绕过常用国内应用，并参与维护公共规则。
阅读全文 →教程 01
安装与首次启动
整个过程约需两分钟。建议始终从官方 GitHub 仓库下载。
- 下载最新版本打开官方 Releases 页面，选择最新 Stable 版本下载。
- 移动到应用程序打开安装包，将 ClashFX 拖动到“应用程序”文件夹。
- 确认首次运行从“应用程序”打开 ClashFX，并按 macOS 安全提示确认。
- 找到菜单栏图标ClashFX 在菜单栏运行，点击图标即可打开主要功能。
教程 02
导入你的配置
ClashFX 是代理客户端，不提供节点或订阅。请使用你合法获得的配置地址。
- 复制订阅地址从你的服务提供方复制完整订阅 URL，不要公开分享该地址。
- 打开配置菜单点击菜单栏中的 ClashFX 图标，进入“配置”并选择导入。
- 粘贴并命名粘贴订阅地址，为配置设置便于识别的名称，然后确认。
- 选择并更新在配置列表中选中刚导入的项目，检查节点与规则是否加载成功。
教程 03
开启 Enhanced Mode
TUN 模式会接管系统流量。首次开启需要管理员权限，之后可随时关闭。
开启前请确认当前配置有效，避免因规则或 DNS 配置错误导致暂时无法联网。
- 确认配置已启用先选择可用配置和节点，确保普通系统代理模式连接正常。
- 打开 Enhanced Mode点击菜单栏图标，找到“Enhanced Mode”并选择启用。
- 授予管理员权限首次使用时按系统提示输入管理员凭据，以创建 TUN 网络接口。
- 检查连接状态访问常用网站确认规则生效；遇到问题时可先关闭 Enhanced Mode 恢复网络。
教程 04
从 ClashX 迁移
ClashFX 使用 mihomo 内核。大多数 Clash YAML 配置可以复用，但部分旧内核专有字段可能需要调整。
不要同时运行 ClashX 与 ClashFX。两者都可能修改系统代理，叠加运行会让排错变得困难。
- 记录当前配置保存订阅地址、自定义规则和正在使用的节点组。订阅地址是敏感信息，不要放入截图或 Issue。
- 完整退出 ClashX先关闭系统代理和 TUN，再退出旧客户端。若安装过网络扩展，确认它不再运行。
- 在 ClashFX 重新导入优先通过“配置 → 远程配置管理”重新添加订阅，或把备份的 YAML 放入 ClashFX 官方配置目录
~/.config/clashfx。 - 分阶段验证先只开系统代理测试，再开启 Enhanced Mode。这样能区分配置问题和 TUN 问题。
参考：ClashFX 官方 README、mihomo 配置兼容性说明。第三方文章对配置目录存在不一致描述，本文以官方仓库的
~/.config/clashfx 为准。
教程 05
让指定 App 直连
进程规则适合微信、钉钉等在 TUN 下需要保持本地网络出口的应用。它依赖进程识别，因此主要用于 Enhanced Mode。
- PROCESS-NAME,WeChat,DIRECT- 找到真实可执行文件名运行
ls /Applications/应用名.app/Contents/MacOS/。使用输出名称，不要使用 Bundle ID。 - 生成 PROCESS-NAME 规则格式为
PROCESS-NAME,进程名,DIRECT。也可前往本站“工具”页面生成。 - 把具体规则放在前面mihomo 从上到下匹配，首个命中的规则生效；
MATCH应保持在末尾。 - 优先使用内置开关常见国内应用可直接启用“Enhanced Mode → 国内 App 直连”，规则列表会每 24 小时更新。
- 立即关闭 Enhanced Mode同时取消系统代理。若网络仍未恢复，检查 Wi‑Fi、路由器或其他 VPN；必要时重启 macOS 清理残留路由。
- 只验证系统代理选择已知可用节点，只开启“设置为系统代理”。失败时优先更新订阅、切换节点并查看配置错误。
- 检查 DNS 与权限系统代理正常而 TUN 失败时，检查管理员授权、DNS 配置、浏览器安全 DNS 和旧网络扩展冲突。
- 收集脱敏诊断使用“帮助 → 发送反馈”生成预填 Issue。提交前移除订阅 URL、节点地址、本机用户名与公网 IP。
参考：ClashFX Issue #75、官方发行说明、mihomo TUN/DNS 文档。