先確認晶片與系統版本
ClashX 安裝前，第一步不是直接雙擊安裝檔，而是先確認 Mac 的處理器架構與 macOS 版本。Apple Silicon Mac 包括 M1、M2、M3、M4 及後續 Apple 系列晶片，通常應優先選擇標示為 Apple Silicon、arm64 或 Universal 的版本。若下載到只適用 Intel 的 x86_64 或 amd64 程式，macOS 可能會要求安裝 Rosetta 2，或在啟動、系統代理與網路擴充功能階段出現相容性問題。
確認方式是開啟左上角「蘋果選單」→「關於這台 Mac」。如果看到「晶片：Apple M1」或其他 M 系列名稱，就是 Apple Silicon；如果顯示「處理器：Intel」，則是 Intel Mac。也可以在「系統設定」→「一般」→「軟體更新」確認 macOS 是否已安裝最新的安全更新。ClashX 能否正常啟動，不只取決於安裝檔架構，也與目前 macOS 對舊版應用程式簽署、網路權限與系統代理 API 的支援有關。
| Mac 類型 | 優先選擇的安裝檔 | 可能遇到的情況 |
|---|---|---|
| M1、M2、M3、M4 | arm64 或 Apple Silicon | 通常不需要 Rosetta，啟動效率較好 |
| Apple Silicon，但只有 Intel 版本 | x86_64 或 Universal | 可能需要 Rosetta 2，部分功能相容性不一 |
| Intel Mac | x86_64 或 Universal | 不能直接使用只提供 arm64 的版本 |
取得並驗證 ClashX 安裝檔
請從可信任的發佈來源取得 ClashX。常見的 macOS 安裝形式是 .dmg 磁碟映像檔，也可能是壓縮後的 .app 應用程式。Apple Silicon Mac 應注意檔案名稱是否包含 arm64、AppleSilicon 或 universal。如果來源只提供一個檔案，仍建議閱讀版本說明，確認它是否包含 Apple Silicon 支援。
下載完成後，先查看檔案大小與副檔名，不要直接執行名稱相似但來源不明的應用程式。若發佈頁面提供 SHA-256 雜湊值，可以在「終端機」中執行以下指令，再將輸出結果與發佈者提供的值比對：
shasum -a 256 ~/Downloads/ClashX.dmg若檔名不同，請將指令中的檔名改成實際下載檔案。雜湊值不一致時，不應繼續安裝；常見原因包括下載中斷、檔案被替換，或使用了不相容的安裝包。請重新下載並避免使用來路不明的鏡像檔。
安裝檔格式與啟動位置
- DMG 映像檔：雙擊後通常會開啟一個 Finder 視窗，再將 ClashX 拖曳至「應用程式」資料夾。
- ZIP 壓縮檔：雙擊解壓縮後會得到
ClashX.app，仍應將它移至「應用程式」資料夾。 - 直接位於下載資料夾：不建議長期從「下載項目」啟動，因為之後更新、權限核准與刪除 DMG 時容易混淆。
固定安裝位置很重要。macOS 會根據應用程式的路徑、簽署資訊與系統權限記錄判斷是否允許網路功能。如果今天從 DMG 啟動，明天又從桌面複製一份啟動，系統可能把它們視為不同的應用程式，重複顯示安全性或鑰匙圈提示。
拖曳安裝與首次啟動
完成下載後，依照以下順序安裝 ClashX：
- 在 Finder 開啟「下載項目」，雙擊 ClashX 的
.dmg或.zip檔案。 - 若畫面出現 ClashX 圖示與「Applications」資料夾，將 ClashX 拖曳到「應用程式」。
- 等待複製完成，再退出左側 Finder 中的 DMG 磁碟映像檔。
- 開啟「應用程式」資料夾，從這裡第一次啟動 ClashX。
- 若程式在選單列出現圖示，表示用戶端已啟動；關閉視窗不一定等於結束程式。
首次啟動時，macOS 可能顯示「無法驗證開發者」或「無法開啟，因為無法確認開發者身分」。如果你已確認安裝檔來源可靠，可在 Finder 的「應用程式」中按住 Control 鍵點按 ClashX，選擇「開啟」，再於確認視窗按「開啟」。另一種處理方式是先嘗試正常啟動，接著進入「系統設定」→「隱私權與安全性」，在安全性區域查看是否出現遭阻擋的 ClashX，按下「仍要開啟」。
完成初次設定與系統代理
ClashX 啟動後通常會在 macOS 選單列顯示圖示。此時它只是用戶端正在執行，不代表已有可用節點，也不代表所有流量已經進入代理。你需要先匯入設定檔或訂閱，再選擇代理模式與節點，最後才啟用系統代理。
匯入設定檔或訂閱
在 ClashX 選單列圖示中尋找設定檔、Profiles 或類似的設定入口。如果服務提供者提供 Clash 格式訂閱，通常可以使用「從 URL 匯入」或「新增訂閱」加入；如果手上是 YAML 檔案，則可使用「從檔案匯入」或將檔案放入用戶端指定的設定檔資料夾。不同版本的 ClashX 選單名稱可能略有差異，請以目前畫面為準。
匯入後先選取該設定檔，再查看代理列表與策略組。能看到設定檔名稱，不代表 YAML 一定可正常執行。若設定使用 proxy-providers、rule-providers、Hysteria2、TUIC 或 mihomo 專用欄位，而目前 ClashX 綁定的是較舊核心，啟動時可能在日誌中出現解析錯誤。這種情況應向訂閱服務取得適用於目前核心的設定格式，或改用支援 mihomo 的 macOS 用戶端。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info上面只是常見的設定欄位示例，不是可以直接使用的完整訂閱。mixed-port 代表 HTTP 與 SOCKS 流量共用的本機代理連接埠，allow-lan: false 則表示不讓區域網路其他裝置連入。除非你清楚知道用途，否則不要隨意開啟區域網路存取，也不要把控制介面暴露到 0.0.0.0。
啟用系統代理並測試
- 在 ClashX 中選擇一個可用的策略組與節點。
- 先查看代理測試或延遲測試結果，確認節點不是全部逾時。
- 在選單列中啟用「Set as System Proxy」或同義的系統代理選項。
- 用瀏覽器開啟一般 HTTPS 網站，確認頁面可以載入。
- 測試完成後查看日誌，確認請求有被核心接收，而不是瀏覽器直接連線。
系統代理模式主要適用於會遵循 macOS 代理設定的瀏覽器與應用程式。部分遊戲、命令列程式、虛擬機器或自行建立網路連線的軟體，可能不讀取系統代理，因此即使瀏覽器正常，也不代表所有程式都會經過 ClashX。若你需要接管這類流量，必須確認目前版本是否支援 TUN 或其他網路延伸功能，並評估 macOS 權限與相容性。
| 測試項目 | 正常現象 | 異常時先檢查 |
|---|---|---|
| 選單列圖示 | ClashX 顯示正在執行 | 是否真的從「應用程式」啟動 |
| 設定檔 | 能看到節點與策略組 | YAML 格式與核心相容性 |
| 節點測試 | 至少一個節點回傳延遲 | 訂閱有效期、DNS、網路與節點狀態 |
| 系統代理 | 瀏覽器可透過代理開啟網站 | 本機連接埠與系統代理開關 |
權限問題與常見錯誤處理
在 Apple Silicon Mac 上，最常見的問題通常不是拖曳安裝本身，而是首次啟動、系統代理、網路延伸功能與舊核心之間的相容性。遇到錯誤時，建議一次只修改一個設定，並記錄修改前後的結果。
- 點擊後沒有反應：先從「應用程式」啟動，確認是否被 macOS 阻擋，再查看「隱私權與安全性」。如果程式立即結束，重新確認 arm64、Universal 或 Intel 架構是否選對。
- 系統代理無法啟用：先退出其他代理工具，避免多個程式同時修改 macOS 代理設定，再確認 ClashX 的本機代理連接埠沒有被其他程序占用。
- 瀏覽器可以使用，其他軟體不行：這通常是應用程式沒有遵循系統代理，不一定表示 ClashX 故障。需要時再研究 TUN 或該軟體自己的代理設定。
- 訂閱可以匯入但核心啟動失敗：查看日誌中的欄位名稱與錯誤行，特別留意 mihomo 專用欄位、未知協定與縮排錯誤。
- 更新後反覆要求鑰匙圈權限：確認是否每次都從同一個「應用程式」路徑啟動，並避免同時保留多份不同來源的 ClashX。
常見問題
Apple Silicon Mac 一定要安裝 arm64 版本嗎？
優先選擇 arm64 版本；如果發佈者提供 Universal 版本，也可以使用。只有 Intel 版本時，Apple Silicon 可能透過 Rosetta 2 執行，但實際相容性取決於用戶端與核心，不建議把它當作長期首選。
ClashX 安裝成功後，為什麼網路沒有經過代理？
安裝完成只代表應用程式存在，還需要匯入有效設定、選擇可用節點並啟用系統代理。請依序檢查設定檔、節點測試結果、代理連接埠與 macOS 的代理狀態。
是否需要一開始就啟用 TUN？
不需要。瀏覽器與多數遵循系統代理的軟體，可以先使用系統代理模式。只有在需要接管不讀取系統代理的程式時，才評估 TUN；啟用前應先確認 ClashX 版本、核心與目前 macOS 相容。
ClashX 可以直接使用所有 mihomo 訂閱嗎？
不一定。訂閱可能包含目前核心不認識的協定或設定欄位。若匯入後出現 YAML 解析錯誤、未知代理類型或核心無法啟動，請取得適用格式，或改用支援 mihomo 的用戶端。