Apple Silicon Mac 安裝 ClashX，先確認版本與相容性
如果你使用的是 M1、M2、M3、M4 或更新款 Apple 晶片 Mac，安裝 ClashX 時最重要的第一步，是確認下載檔是否支援目前的處理器架構與 macOS 版本。名稱裡有「Mac」不代表一定適用於所有 Mac；發行頁面可能提供 Intel（x86_64）、Apple Silicon（arm64／aarch64）或通用版本。若有明確標示 Apple Silicon 或 arm64 的建置，通常應優先選它；若只有 Intel 版本，則要先確認該發行版本是否仍支援，以及是否需要 Rosetta，不要只因為安裝檔能下載就假設它適合長期使用。
下載前也要先釐清你要安裝的是哪個專案與版本。不同發行頁可能使用相似的 ClashX 名稱，但維護狀態、功能和安裝方式不一定相同。請從可信任的專案發行頁或官方文件所指向的來源取得安裝檔，閱讀版本說明中的系統需求、架構標示與簽章資訊。避免使用來路不明的重新打包檔，也不要因為搜尋結果排名靠前，就把第三方下載站當成官方來源。
還要確認自己手上是否已有可用的設定檔。ClashX 是用戶端，程式本身不會自動提供代理節點或訂閱服務；你需要有合法取得的 Clash 格式 YAML 設定檔，或服務提供者給你的訂閱連結。訂閱網址通常包含帳戶識別資訊，請勿貼在公開討論區、截圖或不可信任的線上檢查工具中。若目前只想測試安裝是否成功，可以先完成程式啟動與選單列確認，再匯入設定。
下載前的檢查清單：晶片、macOS 與來源
在開啟 DMG 前，先用幾分鐘核對下載來源與系統環境。Apple 選單中的「關於這台 Mac」可以確認晶片型號及 macOS 版本；若下載頁提供多個檔案，再把這些資訊與發行說明逐項比對。這能避免把設定檔問題、舊版相容性問題和安裝錯架構混在一起排查。
| 檢查項目 | 建議做法 | 容易忽略的地方 |
|---|---|---|
| 下載來源 | 由可信任的專案發行頁或官方文件提供的連結取得 | 檔名看起來相似，不代表發行者相同 |
| 處理器架構 | 優先選擇 arm64、aarch64 或 Apple Silicon 版本 | x86_64 通常代表 Intel 架構；是否能透過 Rosetta 執行，應以該版說明為準 |
| macOS 需求 | 查看最低系統版本與已知限制 | 較舊的安裝包可能無法符合目前系統的簽章或執行要求 |
| 既有網路工具 | 安裝測試時先暫停其他 VPN 或代理程式 | 多個工具同時修改系統代理，可能造成狀態混淆 |
| 設定資料 | 準備可用的 YAML 檔案或訂閱連結 | 訂閱連結可能含有可識別帳戶的資訊，請妥善保管 |
若下載頁沒有清楚標示架構，先查看發行說明、檔案名稱及專案文件，不要靠猜測選檔。若仍無法確認該版本是否支援 Apple Silicon，應先詢問發行者或改用文件明確標示相容的版本。這比先繞過 macOS 安全提示、安裝後再處理程式閃退更安全，也更容易定位問題。
下載 DMG 並將 ClashX 移至應用程式
確認安裝檔來源與系統需求後，再開始安裝。macOS 的 DMG 通常是磁碟映像，開啟後會在 Finder 顯示一個安裝視窗；常見方式是將 App 圖示拖到「應用程式」資料夾。不要把程式長期留在下載資料夾，也不要只從尚未退出的 DMG 中啟動，否則卸載映像或移動檔案後，程式捷徑可能失效。
- 等待瀏覽器完整下載安裝檔，核對檔名與發行頁提供的版本資訊，再開啟
.dmg。 - 在 Finder 顯示的視窗中，將 ClashX 拖曳到「應用程式」資料夾。若安裝包提供不同步驟，依該版本附帶的說明操作。
- 等待複製完成後，在 Finder 側邊欄退出已掛載的磁碟映像，再從「應用程式」資料夾啟動 ClashX。
- 留意螢幕右上方的選單列。ClashX 常以選單列圖示作為主要操作入口，啟動後未必會出現一般桌面 App 的大型主視窗。
如果 macOS 顯示「無法確認開發者」或類似警告，不要因此立即關閉 Gatekeeper，也不要在終端機執行網路上找到的繞過指令。先回到下載來源，確認發行者、版本與檔案是否符合預期；若專案提供簽章或雜湊資訊，可依其文件核對。只有在來源可信、檔案完整且你理解系統提示的前提下，才考慮使用 Finder 的控制鍵點按開啟，或依目前 macOS 顯示的安全性設定流程處理。不同系統版本的選項名稱可能不同，請以 Mac 上實際顯示的說明為準。
若這是公司或學校管理的 Mac，管理政策可能禁止執行未核准的 App，或限制修改系統網路設定。這種情況應先詢問 IT 管理員，不要自行移除管理設定。如果啟動時系統要求輸入管理員密碼，先確認提示由哪個程式提出、要授權什麼操作；若來源或用途不清楚，取消提示並重新檢查安裝檔。
首次開啟：匯入設定並啟用系統代理
看到選單列圖示後，先確認 ClashX 已正常啟動，再依序處理設定檔、節點與代理開關。ClashX 的選單文字會因版本而異，可能以設定檔、Profiles 或相近名稱呈現；不必拘泥於某一張舊版截圖，重點是找到管理設定檔與選擇目前使用設定的入口。
匯入訂閱或本機 YAML
若你使用遠端訂閱，從設定檔管理功能加入服務提供者給你的 HTTPS 訂閱連結，並為設定取一個容易辨識的名稱，再執行更新。若使用本機檔案，選擇匯入設定檔，挑選副檔名為 .yaml 或 .yml 的檔案。貼上網址時檢查前後是否有空格、換行或多餘字元；完成後確認 ClashX 已選取剛匯入的設定，而不只是將它新增到清單中。
更新完成後，看看選單或設定介面是否能顯示節點、代理群組或規則資訊。若清單空白，先確認訂閱是否仍有效、帳戶是否有權限存取，以及回傳內容是否為 Clash 可讀取的格式。訂閱更新失敗不一定代表安裝錯誤；網路暫時中斷、服務端限制或連結失效，都可能造成相似現象。不要將完整訂閱內容或包含憑證的錯誤畫面公開分享。
選擇節點與代理模式
設定載入後，依你使用的設定檔選擇合適的節點或策略群組。若設定檔包含規則模式，可先使用規則分流，讓流量依規則決定直連或代理；全域模式則可能將更多流量送往目前選定的代理出口，適合短時間對照特定連線，但不宜在不了解影響範圍時長期當成預設。模式與群組名稱由設定檔提供，不同服務商的選單內容不會完全一致。
接著在 ClashX 選單中啟用系統代理（部分版本可能以「Set as System Proxy」或近似名稱顯示）。此設定會讓遵循 macOS 系統代理設定的應用程式，將支援的 HTTP／HTTPS 請求交給本機代理處理；它不保證所有程式都會使用代理。若你有公司 VPN、其他網路過濾器或第二個代理工具，測試期間先避免同時啟用，以免多個工具互相覆寫系統設定。
檢查連線：由簡到難排除常見問題
不要只以「網站能不能開」判斷 ClashX 是否工作，因為瀏覽器可能有自己的代理擴充功能、快取或登入狀態。建議分成三層驗證：程式是否運作、設定是否載入、目標流量是否依預期經過代理。每次只改一個項目，記下改動前後的結果，會比同時更換節點、模式和設定檔更容易找出原因。
- 確認程式狀態：點選選單列的 ClashX 圖示，確認選單能正常開啟，且沒有顯示設定檔載入失敗或核心停止等狀態。
- 確認設定內容：核對目前選取的設定檔、節點或策略群組。若清單仍空白，先處理匯入或更新，不要急著更改 macOS 權限。
- 確認系統代理開關：檢查 ClashX 選單中的系統代理狀態，並確認 macOS 網路設定沒有被另一個工具立即改回。
- 做一次簡單測試：開啟一般網站，再測試一個依你的分流規則應走代理的目的地，觀察結果是否符合設定。若 ClashX 版本提供連線紀錄，可檢查請求是否出現，以及命中的策略是否合理。
- 逐項排查：若仍失敗，依序測試另一個可用節點、確認訂閱有效、檢查系統時間與網路狀態，並暫停其他 VPN 或代理工具。每次只變更一項，方便辨認真正原因。
若某些 App 可以連線、另一些不行，可能是該 App 不遵循 macOS 系統代理，或使用了不同的網路通道。這時先查看 ClashX 是否提供可用的連線紀錄，再確認目的地及策略，而不是直接認定節點失效。若請求根本沒有進入 ClashX，單純更換節點通常無法解決；若請求已出現在紀錄中但目的地或策略不符合預期，才應進一步檢查設定檔規則。
常見狀況也可以用下表快速定位。表中的判斷是排錯起點，不代表所有版本的提示文字都相同；遇到不明錯誤時，記下版本、macOS 版本與重現步驟，再查閱相應發行說明。
| 現象 | 優先檢查 | 處理方向 |
|---|---|---|
| 找不到主視窗 | 螢幕右上方選單列 | 點選 ClashX 圖示開啟功能選單 |
| 沒有節點或群組 | 目前設定檔及更新狀態 | 重新確認訂閱或匯入正確的 YAML |
| 瀏覽器仍無法連線 | 系統代理是否啟用、節點是否可用 | 先做單一網站測試，再檢查連線紀錄與策略 |
| 只有部分 App 失敗 | App 是否遵循系統代理 | 確認該程式的代理支援方式與實際連線路徑 |
| 啟動時遭安全性阻擋 | 來源、簽章、版本與管理政策 | 先驗證安裝檔，不要直接停用系統安全功能 |
常見問題
M 系列 Mac 一定要下載 arm64 版本嗎？
若發行頁提供確認支援 Apple Silicon 的 arm64 或 aarch64 版本，通常優先選擇該版本。若只提供 Intel 版，請先閱讀發行者對 Rosetta 與 macOS 相容性的說明；不要只憑檔名推斷一定能正常使用，也不要在不清楚來源時安裝其他網站提供的替代檔。
ClashX 開啟後沒有視窗，是不是沒有啟動？
不一定。ClashX 通常以選單列圖示作為主要操作入口，啟動後可能不會顯示大型主視窗。先查看螢幕右上方的選單列，點選圖示確認是否能看到設定檔與代理選項；如果圖示也沒有出現，再從「應用程式」資料夾重新啟動並留意系統提示。
系統代理已開啟，但部分程式仍然直連，該怎麼辦？
macOS 系統代理不會自動攔截每一種程式的所有網路流量。有些 App 使用自己的網路設定，或不支援系統 HTTP／HTTPS 代理。先查看 ClashX 的連線紀錄與該程式的代理選項；如果沒有相關請求，問題可能在程式是否採用系統代理，而不是節點或規則本身。
安裝 ClashX 就會自動取得節點嗎？
不會。ClashX 是用戶端，不會自動附帶可用節點或訂閱。你需要自行準備合法取得的訂閱連結或 Clash 格式設定檔，並留意訂閱網址可能含有私人帳戶資訊，不應公開分享。
若你比較過其他 Mac 代理工具，可能會發現有些版本不再更新、Apple Silicon 支援資訊不清楚，或不同平台的設定方式差異較大；選擇工具時，除了介面，也應確認維護狀態、系統相容性與設定匯入方式。ClashX 的選單列操作、設定檔管理與規則分流，能讓你把安裝、啟用和連線檢查拆成明確步驟；若你需要比較其他平台的 Clash 用戶端與可用版本，可以先查看下載頁的說明，再依自己的 Mac 架構與需求選擇。