程式碼要在 Mac 上執行，但手邊只有 Windows 電腦，Claude Code Desktop 又找不到遠端專案。
最快解法：Windows 版 Claude Desktop 可用 SSH 連線遠端 Mac；Claude Code 和專案工具在遠端 Mac 執行，但 SSH 不會顯示 Mac 桌面。若課程要求操作 Xcode 視窗或查看模擬器，還要另外準備圖形桌面連線方式。官方 Desktop 文件說明了 SSH 遠端工作流程與主機條件。
適合只有 Windows 電腦、想在 macOS 專案上使用 Claude Code 的學生與初學者。
正在完成 Swift 或 iOS 課程的人，可按本文步驟確認遠端程式是否真的在 Mac 執行。
若需求是觀看 Mac 螢幕或操作 Xcode，應先確認圖形桌面存取方式，而不是只設定 SSH。
最後更新於 2026 年 10 月 13 日；資料核對自 Claude Code Desktop 官方 SSH 文件、Claude Desktop 系統需求說明，以及 Apple 遠端登入與螢幕共享指南。
[ SECTION_01 ] 連線前先分清楚 SSH 與遠端桌面
SSH 可以把遠端主機的終端機和專案帶進工作流程。它適合讓 Claude Code 讀取遠端檔案、編輯程式碼、執行指令；它不是螢幕分享，連上 SSH 並不會出現 Mac 桌面。
Windows 上的 Claude Code Desktop 能連 Mac 嗎？
可以。Claude Desktop 在 Windows 上作為操作介面，SSH 連線則通往遠端 macOS 主機；官方文件亦列出遠端 macOS 或 Linux 主機的條件。這不代表所有 Windows 電腦或所有遠端主機都能直接連線，仍須符合 Desktop 版本要求、SSH 設定與主機存取權限。Claude Desktop 系統需求與功能說明可供安裝前核對。
第一次設定時，先用以下方式判斷：
- 適配度高：SSH 工作流程。課程要讀寫程式碼、執行終端機指令，且不要求查看圖形介面。
- 適配度高：遠端桌面工作流程。作業要點選 Xcode、檢查視窗或觀看模擬器；但這不能只靠 SSH 完成。
- 適配度低：只有 Windows 本機環境。若課程明確要求 macOS 專用工具，Windows 本機不能取代遠端 Mac 上的執行環境。
以上適配度是按操作需求判斷，不是連線速度或效能測試。Apple 的遠端 Mac 螢幕共享說明可協助確認圖形桌面與 SSH 的用途差異。
[ SECTION_02 ] 先備妥遠端主機與課程資料夾
SSH 主機可以想成一台放在別處、透過網路操作的電腦。開始前，學生需要取得有效主機位址、SSH 使用者帳號，以及獲准存取的課程專案資料夾；資料中心主機和學校電腦的管理規則可能不同，應先向管理員確認是否准許遠端連線。
在遠端 Mac 上，主機管理者須啟用遠端登入，並授權相應使用者。Apple 的遠端登入設定說明列出 macOS 的相關設定。若是學校提供的設備或帳號，請遵守學校政策，不要為了連線而繞過管理限制。
Windows 端也要有 SSH 用戶端。可以在 PowerShell 輸入 ssh -V 檢查是否能呼叫 SSH；若系統沒有可用用戶端，依照Windows OpenSSH 安裝與首次連線文件確認安裝方式。
連線欄位要準備哪些資料？
通常先核對主機位址、使用者名稱和連接埠；若採用金鑰驗證，還需要指定身分檔案，或沿用現有 SSH 設定。SSH 常見預設連接埠是 22，但主機管理者可能另有指定，應以實際提供的資料為準。Microsoft 的 OpenSSH 文件也提供連線設定參考。
[ SECTION_03 ] 在 Desktop 新增 SSH 主機
Claude Code Desktop 連線遠端 Mac 時，Desktop 是本機的操作介面，SSH 則負責接通遠端主機。不同版本的欄位名稱或畫面可能略有變化；應以目前安裝版本顯示的選項和官方 SSH 工作流程為準，不要照搬其他版本的螢幕截圖。
- 開啟 Claude Desktop，找到新增或連線至遠端環境的選項，再選擇 SSH 連線。
- 填入管理者提供的主機位址、使用者名稱和連接埠。沒有特別指定時，才考慮使用預設的 22。
- 若畫面提供 SSH 設定檔選項，可選擇既有設定；否則依介面要求填入身分檔案位置或其他驗證資料。
- 發起連線，按畫面提示完成驗證。官方流程說明，首次連線可能會在遠端安裝 Claude Code；因此遠端帳號必須具有所需的存取權，並能完成安裝與執行條件。
- 若連線失敗，先回頭核對位址、帳號、連接埠、金鑰路徑和主機端遠端登入設定，不要把錯誤訊息中的敏感資料貼到公開討論區。
SSH 私鑰可以把它想成門禁鑰匙：持有者可能因此取得主機存取權。不要把私鑰、帳號密碼或驗證憑證交給其他人，也不要貼進 Claude 的提示詞。需要他人協助時，應提供遮去敏感內容的錯誤訊息，並依主機管理者的安全規則處理。
[ SECTION_04 ] 驗證專案與指令確實在遠端執行
連線成功後，Desktop 介面仍在 Windows 電腦上，但程式檔案與指令可以位於遠端 Mac。要避免改錯資料夾，先選擇遠端主機上的課程專案目錄，再用無破壞性的檢查確認目前位置和檔案內容。
Claude Code 連上後，程式碼會在哪裡執行？
在 SSH 遠端工作流程中，Claude Code 操作的是已連線主機上的專案；終端機指令也由遠端環境執行。Desktop 視窗出現在 Windows 螢幕上，並不表示程式檔案或命令就在 Windows 本機。可對照官方遠端 SSH 說明確認這項執行邊界。
第一次驗收可以這樣做：
- 在 Desktop 連線後，選取遠端 Mac 上的課程專案資料夾。
- 請 Claude Code 列出目前資料夾中的檔案，並說明專案入口檔的位置；先檢查，不要一開始就要求大量修改。
- 在終端機查看目前路徑，並確認顯示的是遠端主機上的課程目錄。
- 請 Claude Code 做一項範圍很小的課堂修改，例如調整一段文字或補上一個簡單函式。
- 查看 Git 差異，逐項確認新增、刪除或修改的內容，再自行判斷是否符合課程要求。Git 差異檢查文件說明如何查看工作目錄中的修改。
- 若課程要驗收 Xcode 工具鏈，可在遠端終端機確認工具是否存在；Apple 的Xcode 命令列工具參考說明命令列工具與相關使用方式。
提醒：終端機能執行建置指令，不等於能看到 Xcode 視窗或模擬器畫面。若課程需要圖形介面驗收，請在提交作業前確認另有可用的螢幕共享或遠端桌面連線方式。
[ SECTION_05 ] 按課程驗收要求決定下一步
SSH 連線能直接操作 Xcode 嗎？
不能把 SSH 當成 Xcode 圖形介面。它能提供命令列工作流程，也可能讓遠端工具執行命令列建置；但點選 Xcode 視窗、查看畫布或操作模擬器，屬於圖形桌面需求。Apple 的 Xcode 命令列工具說明與螢幕共享指南，分別對應這兩類工作。
在開始正式課程前，可逐項勾選：
- [ ] 已確認課程或學校允許使用遠端 Mac 與 SSH。
- [ ] 已取得可用的主機位址、使用者帳號、連接埠及必要驗證方式。
- [ ] Claude Code Desktop 已連線至遠端主機，並開啟正確的課程資料夾。
- [ ] 已確認檔案檢查和測試指令是在遠端 Mac 的專案目錄執行。
- [ ] 已檢查 Claude Code 的程式差異，並自行確認修改符合課程要求。
- [ ] 若作業要操作 Xcode 視窗或查看模擬器，已另行確認圖形桌面存取方式。
若前幾項已完成，而且課程只要求程式碼操作和終端機驗證，可繼續使用 SSH 工作流程。若作業要求在 Xcode 中操作介面，應先取得圖形桌面存取權限；沒有這項條件時，SSH 不能代替完整的桌面驗收。
Windows 本機環境的優點是無須遠端連線，但遇到 macOS 專用工具時會受限；自行購買 Mac 可直接操作桌面，卻需要承擔購置與維護成本；SSH 遠端 Mac 則免去購買整台設備的前期支出，但會依賴網路、帳號權限和遠端主機可用性。若想先了解 NOVAKVM 的服務資訊與不同使用地區的頁面，可從 NOVAKVM 遠端 Mac 資訊查看；若已確認課程需要 macOS，再參考 NOVAKVM 遠端 Mac 連線與使用資訊，核對連線方式與課程驗收需求後，判斷是否適合租用。若需要長期高負載使用或實體介面，則應先評估自有 Mac 等其他方案。