第一次在 Windows 11 安裝 Clash Verge Rev，建議先完成「選對安裝檔、安裝並啟動程式、確認核心狀態」三件事，再匯入設定或訂閱。安裝完成只代表桌面用戶端可以開啟，並不代表已有可用節點，也不代表 Windows 系統代理已啟用。以下依照一般安裝流程說明，介面文字可能因程式版本與語言設定略有不同。
下載前先確認版本與安裝條件
先確認下載項目是 Clash Verge Rev，而不是名稱相近的其他用戶端。前往本站用戶端下載頁，依 Windows 11 裝置的處理器架構選擇安裝檔。多數一般筆記型電腦和桌上型電腦使用 x64；採用 ARM 處理器的裝置則應確認下載頁是否提供 ARM64 版本。架構不相符時，安裝程式可能無法啟動，或出現不相容提示。
| 檢查項目 | 建議做法 | 容易出現的問題 |
|---|---|---|
| 應用程式名稱 | 確認下載項目標示為 Clash Verge Rev | 誤把相近名稱的用戶端當成同一個程式 |
| 處理器架構 | 一般 Intel／AMD 電腦選 x64；ARM 裝置依下載頁選 ARM64 | 安裝檔無法執行或提示架構不符 |
| 檔案來源 | 從可信任的下載入口取得，留意檔名與檔案類型 | 下載到廣告安裝器、網頁捷徑或不明修改版 |
| 磁碟與權限 | 保留足夠可用空間，使用有權安裝應用程式的 Windows 帳戶 | 安裝途中無法寫入目標資料夾 |
若不確定自己的處理器架構，可在 Windows 11 開啟「設定」→「系統」→「關於」，查看「系統類型」。若顯示 x64 型處理器，通常選擇 x64 安裝檔；若顯示 ARM 型處理器，應以下載頁提供的對應版本為準。不要只依照裝置品牌或外觀判斷架構。
取得安裝檔並完成安裝
下載前先關閉來路不明的下載頁面，不要以搜尋結果中的廣告按鈕作為檔案來源。下載完成後，可在瀏覽器的下載清單或 Windows「下載」資料夾找到檔案。若副檔名被隱藏，請從檔案內容或下載頁確認它是 Windows 安裝程式，而不是壓縮檔、文字檔或網頁文件。
- 選擇正確的 Windows 版本。在下載頁確認應用程式名稱與架構，再下載提供的 Windows 安裝檔。下載速度較慢時，先確認檔案大小仍在增加；不要重複開啟尚未下載完成的檔案。
- 檢查檔案來源。確認檔案是由預期的下載入口取得。若下載頁提供版本資訊、數位簽章或校驗值，可用來核對檔案；沒有公布校驗資訊時，不要自行猜測雜湊值或把不明安裝檔加入防毒軟體排除清單。
- 啟動安裝程式。在檔案上按兩下，依安裝精靈的提示閱讀授權與安裝位置選項。若程式詢問是否允許變更裝置，先確認發行者與檔案來源；只有在確認可信且安裝確實需要時才授權。
- 完成安裝並開啟程式。安裝精靈顯示完成後，使用桌面捷徑或開始功能表中的 Clash Verge Rev 啟動。若提供「立即啟動」選項，也可在安裝結束後直接開啟。
- 先確認主視窗可以正常載入。第一次啟動可能需要數秒建立使用者設定資料或載入介面。若畫面仍在載入，先等待一段時間並觀察是否出現錯誤訊息，不要連續點擊多個捷徑而開出多個執行個體。
Windows 安全性提示不一定代表檔案有問題，但也不應一律忽略。若出現「Windows 已保護您的電腦」之類的 SmartScreen 警告，先確認檔案確實來自可信任來源、名稱與版本符合預期，並查看可取得的發行者資訊。若來源無法確認，請取消執行並重新取得安裝檔；不要為了趕快安裝而關閉整體防毒或安全性功能。
第一次啟動後，依序確認程式與核心
先確認桌面程式正常，再處理設定和代理連線。Clash Verge Rev 提供操作介面，核心則負責讀取設定、監聽本機代理連接埠與處理連線。程式視窗能開啟，不等於核心已成功啟動；核心啟動成功，也不代表訂閱內容一定有效。
- 確認版本與視窗。檢查視窗標題或「關於」頁面，確認開啟的是 Clash Verge Rev。若畫面空白或立即關閉，先完整結束程式，再從開始功能表重新開啟一次。
- 查看核心狀態。在程式介面中尋找核心、執行狀態或日誌相關區域。不同版本的選單名稱與位置可能不同；重點是確認核心是否已下載或可用，以及啟動時有沒有解析錯誤或啟動失敗訊息。
- 確認設定來源。尚未匯入 Profile 時，清單沒有節點並不代表安裝失敗。若已有服務提供的 Clash／mihomo 相容訂閱，依目前介面的設定管理入口匯入，並確認更新成功後再切換為使用中的設定。
- 確認本機代理入口。設定載入後查看生效的代理連接埠與模式。常見範例連接埠是
7890，但實際數值以目前設定為準；不要把範例值當成每台電腦的固定預設值。 - 最後才測試系統代理。啟用程式提供的系統代理功能後，用會遵循 Windows 代理設定的應用程式發出新請求，再查看連線記錄是否進入核心。部分命令列工具、遊戲或自行管理代理的程式不會自動採用系統代理。
若需要先理解設定來源與切換方式，可參閱入門指南。匯入訂閱時請保護完整網址：訂閱連結可能含有存取權杖，不應貼到公開討論區、截圖或不可信任的線上轉換服務。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info上方是用來說明欄位關係的設定片段，不是完整訂閱，也不能單獨提供代理節點。mixed-port 是 HTTP 與 SOCKS 代理共用的入口；allow-lan: false 表示不向區域網路裝置開放；mode: rule 表示依規則分流。實際使用時應檢查用戶端最終套用的設定，而不只是複製片段到檔案中。
安裝或啟動卡住時的處理順序
遇到錯誤時，先記下發生階段與完整訊息，再選擇對應處理方式。下載失敗、安裝被阻擋、程式無法啟動和核心解析設定失敗是不同問題；反覆重裝通常無法修正訂閱格式錯誤或連接埠衝突。
| 現象 | 優先檢查 | 建議處理 |
|---|---|---|
| 安裝檔無法開啟 | 下載是否完成、檔案類型與處理器架構 | 重新確認下載項目，移除不完整檔案後再下載相符版本 |
| SmartScreen 或防毒軟體警告 | 檔案來源、發行者資訊與檔案名稱 | 來源無法確認時取消執行；不要直接關閉防護或加入排除 |
| 安裝精靈無法寫入資料夾 | 目前帳戶權限、安裝路徑與磁碟空間 | 改用有權限的帳戶，或選擇可寫入的位置 |
| 程式一閃即逝或視窗空白 | 是否已有另一個執行個體、啟動錯誤與必要執行元件提示 | 從工作管理員結束卡住的程序後重試，並依明確提示處理相依元件 |
| 程式能開啟但沒有節點 | 是否匯入設定、更新是否成功及目前啟用的 Profile | 檢查訂閱格式與更新記錄，不要把空白清單當成安裝損壞 |
| 啟動核心時提示連接埠占用 | 目前連接埠是否被其他代理或程式監聽 | 先確認占用程序，再決定停止重複程式或更換監聽連接埠 |
遇到安全性提示時不要盲目略過
如果 Windows 阻止執行，請先返回下載頁重新核對檔案來源、產品名稱與版本。數位簽章的顯示方式會依檔案和發行方式而異；沒有簽章資訊時，不應自行推論檔案必定安全或必定惡意。若檔案來自不明鏡像、下載後檔名異常，或防毒軟體明確偵測到威脅，停止安裝並重新取得可信任的檔案。
程式啟動但核心失敗時怎麼判斷
查看錯誤發生在核心取得、核心啟動，還是設定載入階段。若提示核心檔案缺失，依程式提供的核心管理方式檢查下載狀態與網路連線；若顯示 YAML 解析錯誤，則檢查目前啟用的設定是否完整、縮排是否正確，以及設定中使用的代理類型是否受目前核心支援。若顯示連接埠已被使用，先確認其他代理程式是否仍在執行，避免同時啟動多個用戶端。
提供錯誤畫面尋求協助時，請遮蔽訂閱網址、節點地址、密碼與其他憑證。描述問題時一併列出 Windows 版本、用戶端版本、錯誤發生階段和已嘗試的操作，比只說「裝不起來」更容易定位。
完成安裝後的基本使用與安全檢查
確認程式、核心與設定都正常後，再啟用日常使用所需的選項。先使用預設的本機代理方式測試一個新連線，確認策略群組選擇合理、規則能命中預期出口，再決定是否需要開機啟動、TUN 或區域網路共享。每次只改一項，發生問題時才容易回復。
- 系統代理：適合讓常見桌面應用程式使用本機代理入口。關閉程式或切換設定後，檢查 Windows 代理狀態是否符合預期。
- 開機啟動：確認設定與節點穩定後再開啟。若啟動後沒有網路，檢查核心是否自動啟動、Profile 是否有效，以及系統代理是否指向目前監聽的連接埠。
- TUN：只有在應用程式不遵循系統代理，且確實需要接管流量時再評估。留意權限提示、虛擬介面狀態及其他 VPN 或網路工具的衝突。
- 區域網路存取：除非要讓其他裝置連接本機代理，否則不要為了日常單機使用而開啟
allow-lan。開放後也要確認防火牆規則、監聽位址與網路環境。 - 更新與備份：保留安裝來源及必要的本機設定備份。備份可能含有節點憑證，應妥善保管；更新前確認設定可以重新取得，避免只依賴一份未驗證的本機檔案。
若瀏覽器仍無法連線，可先確認系統代理的位址與連接埠是否和核心設定一致，再查看連線記錄中的規則、策略和錯誤階段。若只有某個應用程式失敗，先檢查該程式是否使用自己的代理設定；不要僅因單一應用程式無法連線就反覆重裝用戶端。