在手机和平板上
iPhone / iPad：要求 iOS 15 或更高版本，使用 App Store 下载，具体上架情况取决于账号地区。
打开 Clash Mi App Store 页面 ↗Android：要求 Android 8 或更高版本。官方手册推荐 android_arm.apk；专用架构包按设备实际情况选择。
下载 Android APK ↗Clash Mi 中文使用手册核验于 2026.09.16
A FIELD GUIDE FOR YOUR FIRST CONNECTION
Clash Mi，
从这里开始。
安装、配置、连接。
把第一次使用，拆成容易理解的几件小事。
先建立一个概念
Clash Mi 是开源的 Mihomo 图形客户端。它负责使用你的配置管理连接；配置来源、节点服务与客户端是不同的环节。
01
先把客户端安装好。
下面的入口均来自维护者公开的下载说明。手机、平板和电脑需要不同的软件包，不要只看文件名中的 Clash Mi 就直接安装。
在桌面设备上
Windows：Windows 10+，发行文件为 x64。
Mac：macOS 12+，支持 Intel 和 Apple Silicon。
Linux：amd64，下载页列出的最低内核版本为 6。
02
读懂你的第一份配置。
Clash Mi 接收 Clash 格式的 YAML 配置。扩展名通常为 .yaml 或 .yml，但仅有正确扩展名还不够，内容也必须符合对应格式。
- 配置链接
- 一个可供客户端读取配置的地址。它通常由你使用的服务提供方给出；应确认地址仍然有效。
- 我的配置
- 应用里管理配置的入口。进入后点击加号，再选择「添加配置链接」，将地址添加到列表中。
- 格式匹配
- 非 Clash 格式的 sing-box 或 v2ray 订阅不能直接当成 Clash YAML 使用。获取链接时应选择与客户端兼容的格式。
03
让配置真正开始工作。
返回首页
确认所需配置已经添加，再使用首页的连接开关。需要系统授权时，阅读提示并完成必要授权。
进入面板
从菜单打开面板，查看代理选择与连接状态。Clash Mi 内置 zashboard，熟悉 Web 面板的用户可以继续使用这种方式。
按现象排查
配置报错先检查配置；开关已打开却没有流量，再检查 TUN 与代理策略。不要把每种连接问题都归因于安装失败。
04
第一次使用时的六个疑问。
第一次打开 Clash Mi，先做哪件事？
先准备有效的 Clash 配置链接。下载只是安装客户端；如果没有可用配置，打开连接开关也无法凭空获得代理节点。
配置链接应粘贴到哪个位置？
按照官方手册，进入「我的配置」，点击右上角加号，再选择「添加配置链接」。添加完成后返回首页进行连接，界面名称以当前应用版本为准。
看到 YAML 行号错误，需要重新安装吗？
不一定。官方 FAQ 建议检查错误信息中的 yaml:line 等提示，先修正配置或重新更新配置，再尝试连接。配置内容错误与安装程序本身是不同问题。
订阅地址能发到公开讨论区让别人看吗？
不建议。地址可能带有用于识别账号的凭据。排查时先遮盖订阅令牌、账号和节点口令；公开完整地址可能让其他人使用或获取你的配置。
面板入口在哪里，secret 又是什么？
官方手册将 Web 管理入口放在菜单「面板」中。面板访问所用的 secret 可在核心设置中找到，它不是订阅链接，应作为访问凭据保管。
已有 TestFlight 版，还能并行装商店版吗？
官方手册说明 App Store 版与 TestFlight 版不能同时安装，安装另一渠道的版本会覆盖原有版本。切换渠道前，先确认你的配置能够恢复。
把这份手册当作起点。
本页提炼常见上手流程；应用更新后，菜单名称和支持范围可能变化。遇到未覆盖的情形，继续查阅维护者文档。