VS Code 1.146 Local harness 遷移應在官方預定於 2027 年 2 月移除前完成；先盤點並備份自訂項目，再以代表性任務驗證 Copilot harness、遠端工作區和實際執行結果，不能假設設定會自動轉換。若你透過 Remote SSH 開發，還要分別確認編輯器連線位置與 Agent Host 的執行環境。
仍在 VS Code 使用 Local harness 的開發者，應先核對現有會話和自訂整合；透過 Remote SSH 使用遠端 Mac 的工程師，需額外驗證工作區、Agent Host 和命令環境。負責團隊策略的管理者，則應在擴大使用前檢查企業設定、沙箱與權限。
最後更新於 2026 年 11 月 12 日；遷移時程與功能狀態核實自 VS Code 1.146 官方發布說明，相容性和團隊設定應再對照官方文件及你的實際工作區。
先看遷移時間軸：Local harness 與 Copilot harness 的差異
VS Code 1.146 的 Local harness 何時移除？ 官方發布說明將 Local harness 標記為棄用，並計畫在 2027 年 2 月移除。Copilot harness 已是新會話的預設選項，但這不代表既有會話、Hooks、MCP 伺服器或個人指令都已經遷移。請以官方遷移指南核對操作方式，並以實際專案測試結果決定是否可擴大切換。
| 選項或狀態 | 適用情況 | 遷移時要確認的事 |
|---|---|---|
| 現有 Local harness 會話 | 仍有舊會話、提示或工具依賴時，用來盤點與制定交接方式 | 不要把現有會話視為已自動轉成 Copilot harness；檢查歷史、草稿、工作區和權限 |
| 新建 Copilot harness 會話 | 用來測試預設的新會話流程與整合項目 | 確認 Session Target、帳戶、可用模型及工具；逐項測試命令和審批行為 |
| Remote SSH 工作區中的 Agent 工作 | 專案檔案和命令預期在遠端 Mac 執行時 | 分開確認編輯器連線、Agent Host、目標儲存庫、Shell 與專案測試結果 |
Harness 是 Agent 工作流程的執行與工具整合方式；模型是另一項選擇，執行位置則關係到命令和檔案實際落在哪個環境。這幾項不能互相代替：換成 Copilot harness，不等於更換模型，也不表示 Agent 已在你預期的遠端主機執行。VS Code 對 Agent harness 的定義可用來釐清這些角色。
遷移前盤點：記錄基線，再備份自訂配置
不要一開始就在主要專案直接切換。先挑一項可重複的小任務，例如讀取指定模組、修改單一測試，或執行專案既有的檢查命令；記下工作區位置、預期修改、使用工具、命令、審批要求與驗收方式。這份基線讓你能分辨差異來自 harness、模型選擇、執行位置，還是專案本身。
切換到 Copilot harness 後，自訂配置會自動遷移嗎？ 不要預設會。官方遷移指南提供遷移操作說明，但你仍須核對每項整合在目標工作流程中的相容性；「新會話使用 Copilot harness」本身不是配置轉換的證明。
遷移前逐項備份並整理：
- 提示檔、個人 Agent、指令，以及專案內使用的自訂規則。
- Hooks、MCP 伺服器和其他工具的定義、啟動方式與權限需求。
- 終端 Shell、環境變數、路徑及專案專用命令。
- 憑據的存放方式、授權範圍與審批設定；不要把密鑰直接複製到共用設定檔或紀錄中。
MCP 設定應依官方 MCP 配置文件逐項核對。尤其要確認伺服器啟動位置、所需憑據和可呼叫工具；設定文字仍在檔案中，不代表新會話一定能用相同權限成功啟動它。
遷移驗收要看任務結果，而不是只看會話有沒有啟動。若基線任務需要執行命令、修改檔案或取得核准，這些行為都應納入比較紀錄。
試遷新會話：確認 Copilot harness、模型與工具
建立新的 Agent 會話，在 Session Target 選擇 Copilot，並確認目前登入的帳戶、可用模型及所需工具。新會話預設採用 Copilot harness 是版本狀態；你仍應在介面中確認本次會話實際採用的目標，不要只憑設定推斷。
怎麼確認 VS Code 新會話正在使用 Copilot harness？ 在建立會話時檢查 Session Target 的選項與目前選取狀態，再確認會話可使用預期的工具。若畫面狀態、帳戶能力或團隊策略限制不一致，先釐清原因，不要把模型名稱當成 harness 狀態的替代證據。
接著使用先前記錄的基線任務重跑，並比較：
- Agent 讀取和修改的檔案，是否都在預期專案目錄內。
- Shell 命令是否在正確環境執行，輸出和結束狀態是否符合預期。
- 工具呼叫、Hooks 和 MCP 伺服器是否可用；需要批准的操作是否仍按團隊要求處理。
- 最終變更是否通過專案原有的測試、建置或檢查。
將差異記錄成「通過、需調整、尚未確認」，並保留可重現的任務與結果。模型或提示內容有變更時，也要在紀錄中分開標示，否則容易把模型回應差異誤判成 harness 相容問題。
Remote SSH 驗收：分辨遠端工作區與 Agent Host
Remote SSH 連上遠端主機，只能證明編輯器已建立遠端開發連線；不能單獨證明 Agent 的命令、工具或 Hooks 都在預期位置執行。請依Remote SSH 官方文件檢查遠端工作區，再按照Agent Host 概念說明辨認 Agent 工作所使用的主機環境。
在遠端 Mac 上執行基線任務時，按這個次序驗收：
- 確認 VS Code 開啟的是遠端 Mac 上的專案目錄，而不是本機副本或其他工作區。
- 從 Agent 實際使用的終端檢查目前目錄、Shell 和必要工具是否符合專案預期。
- 執行專案自己的建置或測試命令，查看輸出、產物位置和錯誤訊息。
- 核對工具、Hooks、MCP 伺服器及憑據是否在正確的主機環境可用，並按原有權限要求執行。
- 將結果與基線比對；若會話啟動成功，但命令在錯誤主機執行或專案測試失敗，遷移仍未通過。
遠端 Mac 工作區的實際表現取決於專案工具鏈和遠端設定，不能由 Remote SSH 連線成功推定。需要 macOS 專屬工具的任務，應以該專案的建置或測試結果驗收，而不是用「遠端已連上」作為完成條件。
團隊推廣：先處理策略與權限，再退出舊流程
單人試遷通過後，先選擇能代表團隊日常工作方式的專案、工具整合和執行環境進行小範圍推廣。檢查企業設定是否限制模型或工具、沙箱是否阻擋必要操作，以及審批流程是否符合團隊政策；VS Code 的企業 AI 設定文件可協助管理者核對相關控制項。
管理者應在全面推廣前檢查什麼？ 除了模型可用性，也要確認團隊策略是否允許預期的工具和執行方式、權限是否仍遵循最小必要原則，以及受管控的專案是否能按既有流程驗收。若策略改動使測試任務的權限或結果改變，先修正設定並重跑基線，再擴大使用範圍。
遷移結案前，整理仍依賴 Local harness 的會話、自訂工具和團隊文件，為需要延續的舊會話按官方交接路徑處理。轉移後檢查對話歷史、草稿、工作區與權限，並提醒團隊這不是可任意雙向切換的流程。官方移除時程或策略文件更新時，重新核對計畫；在此之前，不要把未驗收的舊配置留作正式工作流程的唯一依賴。
完成 VS Code 1.146 Local harness 遷移的判準，不是按下切換後會話能正常開啟，而是自訂整合經過盤點、遠端命令在正確工作區執行，且專案自身的驗收項目通過。若你已確認專案需要持續在線的 macOS 執行環境，卻不想讓 Linux 主機承擔無法執行的 macOS 工具鏈，也不希望自行購置與維護一台 Mac，可評估按需使用遠端 Mac；長期固定重負載或需要實體介面的工作，則應先比較自購設備等方案。你可先查看遠端 Mac 方案比較，再依實際工作區需求了解 VpsHold 遠端 Mac。