症狀：普通終端可以登入遠端 Mac，但 Codex 主機列表是空的，或顯示已連線後檔案仍在本機。 最快解法：先驗證普通 SSH，再讓 Codex 接管遠端專案；依序檢查 SSH、主機發現、遠端 Codex、專案目錄與最小任務，不要一開始排查 AI 模型或 Xcode。

這篇適合只有 Windows、學校電腦或舊 Mac，卻需要 macOS 或 Xcode 課程環境的學生。你也可以用它處理「已拿到遠端 Mac 登入資料，卻不知道怎麼加入 Codex」以及「Codex 顯示連線成功，但命令仍在本機執行」這兩種情況。

最後更新於 2026 年 9 月 7 日；連線規則與操作前提核對自 OpenAI Remote connections 官方文件、Codex 使用說明 與 Apple Remote Login 文件。

Codex Remote SSH 連線遠端 Mac：先看執行條件

Remote Control 與 Remote SSH 不是同一項功能。前者偏向控制一個已開啟的工作環境；Remote SSH 則是透過 SSH 設定找到主機，再在遠端檔案系統與 Shell 中處理專案。官方文件說明，Codex 會從 SSH 設定發現可用的遠端主機，並在遠端環境執行工作。

因此，「我有 IP、帳號和密碼」不一定足以讓 Codex 自動列出主機。你需要一個可被 SSH 用戶端讀取的主機項目，包括主機別名、位置、使用者和認證設定。主機別名就像教室門牌；Codex 找的是門牌，不是你腦中記得的那組地址。

先把問題分成兩層：

  • 普通 SSH 失敗：Codex 尚未有資格接手，先處理網路、遠端登入或認證。
  • 普通 SSH 成功但 Codex 找不到：檢查 SSH 設定檔、Host 別名和登入環境。
  • Codex 找到但遠端命令失敗：檢查遠端是否安裝 Codex，以及登入 Shell 是否找得到命令。
  • 命令成功但檔案在本機：重新選擇遠端專案資料夾，並用測試檔確認執行位置。

普通 SSH 基礎驗證

你要從「實際執行 Codex 桌面應用的那台電腦」測試 SSH。若你在 Windows 上使用 Codex，就不要只在另一台電腦或瀏覽器中測試；測試地點不同，讀到的 SSH 設定和權限也可能不同。

在終端機執行你自己的主機別名，例如：

ssh class-mac

若尚未建立別名，也可以暫時使用服務提供者給你的主機位置與使用者名稱：

ssh your-user@your-mac-host

觀察結果後只做低風險處理：

  • 連線逾時：檢查主機是否在線、主機位置是否正確，以及學校或公司網路是否阻擋 SSH。預期結果是終端機能進入遠端 Shell；若仍逾時，不要先改 Codex 設定。
  • 連線被拒絕：請遠端 Mac 的管理者確認 Remote Login 已啟用。Apple 的 Remote Login 官方設定說明指出，這是讓其他電腦透過 SSH 登入 Mac 的必要功能。
  • 帳號錯誤：重新核對遠端 Mac 上的使用者名稱；它不一定等於你的電子郵件或本機 Windows 帳號。
  • 金鑰驗證失敗：確認你使用的是被允許的金鑰或正確認證方式，不要為了省事關閉主機指紋檢查，也不要開放不需要的連接埠。
停止條件很簡單：終端機沒有穩定進入遠端 Shell，就先不要進入 Codex 排錯。SSH 是教室入口，Codex 是教室裡的助教；入口尚未打開時，換助教沒有用。

SSH 主機發現與登入環境

普通 SSH 能登入後，檢查 Codex 是否能看到同一個主機。常見原因是終端機使用了一份 SSH 設定，而桌面應用讀取了另一份設定，或設定中只有零散連線資訊，沒有清楚的 Host 別名。

在本機 SSH 設定中，你通常會看到類似以下的結構；其中內容應替換成你獲得的真實資料：

Host class-mac
    HostName your-mac-host
    User your-user
    IdentityFile ~/.ssh/your-key

這段設定的重點不是背語法，而是讓 Codex 看見一個固定門牌 class-mac。設定完成後，再從同一台電腦執行：

ssh class-mac

如果這次能登入，卻仍沒有出現在 Codex 主機列表，請依官方 Remote connections 文件核對設定檔位置、主機發現方式與當前版本的介面名稱。不要直接把密碼寫入設定檔，也不要複製網路上不明來源的 SSH 設定。

遠端 Codex 與 PATH

SSH 登入成功，不表示遠端一定能啟動 Codex。你本機安裝的 Codex 和遠端 Mac 上的 Codex 是兩個不同環境，就像你在家裡有一本課本，不代表教室書桌上也有同一本。

Codex 需要透過 SSH 在遠端 Mac 啟動相關服務。因此，遠端 Mac 至少要符合以下條件：

  • 已依官方 Codex 使用說明完成安裝與必要的帳號授權。
  • 以 SSH 登入後，登入 Shell 能找到 Codex 命令。
  • 遠端使用者對課程專案目錄具有讀取與修改權限。
  • 遠端命令使用的環境，和你手動開啟互動式終端機時的環境一致或可預期。
你可以在遠端 Shell 中先做不會修改系統的檢查： 
command -v codex
pwd
echo "$PATH"

預期結果是 command -v codex 回傳命令位置，pwd 顯示遠端 Mac 的目錄，而不是 Windows 路徑。如果第一個命令沒有輸出，先修正遠端安裝或 PATH；不要反覆重建 Codex 主機項目。

若你是透過非互動式登入啟動服務，登入 Shell 可能沒有載入你平常使用的設定檔。此時應檢查官方安裝方式和遠端使用者的 Shell 設定，避免把整段系統設定貼到網路上求助，因為其中可能包含金鑰、權杖或私人路徑。

遠端專案目錄與執行位置

即使 Codex 顯示已連線，專案仍可能在本機執行。綠色狀態只代表某個連線建立，不等於目前工作目錄已切換。你必須從已連線的 SSH 主機選取遠端專案資料夾，再開始處理課程檔案。

用「本地書桌」和「遠端教室」理解最容易：

  • 本機編輯器看到的桌面、下載資料夾和 Windows 路徑，是本地書桌。
  • SSH 主機下的 /Users/... 或其他遠端路徑，是遠端教室的書桌。
  • 只有從遠端主機選取的資料夾，才應由遠端 Shell 讀取和修改。
先建立一個不含密碼、金鑰或私人資料的測試資料夾，然後請 Codex 完成三項驗收：

第一，建立測試檔。讓它在選定的遠端專案資料夾內建立一個可刪除的文字檔，檔名不要使用課程正式檔案。

第二，讀取位置。執行 pwd，並列出目前資料夾內容，確認路徑和檔案都屬於遠端 Mac。

第三，執行無破壞性命令。例如讀取作業系統名稱或列出專案檔案，不要一開始執行刪除、安裝系統套件或修改權限的命令。

如果測試檔只出現在本機、pwd 顯示 Windows 路徑，或命令輸出與遠端 Mac 不一致，就停止正式課程工作，重新選擇遠端資料夾。只有在檔案落在預期的遠端目錄後，才適合開啟正式課程倉庫。

最小任務與 Xcode 邊界

第一次不要讓 Codex 直接操作整份課程作業。請使用可以丟棄的範例專案，讓它先完成一個小而可回退的任務：

  • 先解釋目錄結構，不要求修改。
  • 再提出一處小修改，由你確認後才執行。
  • 查看差異，確認沒有碰到課程以外的檔案。
  • 執行專案自帶的檢查或測試。
  • 最後確認檔案仍保存在預期的遠端目錄。
第一次驗收時，不要授權刪除檔案、上傳憑證、修改系統目錄，或自動執行來源不明的命令。你要得到的不是「Codex 說完成」，而是以下四個可觀察結果：
  • 它讀到的是正確的遠端專案。
  • 修改可以用版本控制差異或備份回退。
  • 命令是在遠端 Mac 的 Shell 執行。
  • SSH 斷線後，檔案仍存在遠端預期目錄。
Codex Remote SSH 能否執行 Xcode 專案，取決於專案需要哪一層能力。若只是遠端 Mac 上的命令列建置、測試或檔案修改，方向上可行；若需要 Xcode 圖形介面、模擬器畫面、簽署憑證或實體 iPhone，還要確認遠端的 macOS、Xcode、權限與顯示連線條件。Apple 也分別說明了[從電腦遠端建置 macOS 專案](https://developer.apple.com/documentation/technologyoverviews/building-your-macos-game-remotely-from-your-pc)與[Xcode 自動化測試](https://developer.apple.com/library/archive/documentation/DeveloperTools/Conceptual/testing_with_xcode/chapters/08-automation.html)，所以不要把「能 SSH」直接等同於「所有 Xcode 工作流程都能完成」。

去留判斷條件

完成最小任務後，用下面的分支決定是否繼續使用遠端 Mac：

  • 若課程明確要求 macOS、Xcode 或 iOS 建置，且你每週都要使用：保留遠端 Mac，並把專案保存、帳號權限和斷線後恢復流程固定下來。
  • 若只有少量 macOS 指令需求，主要寫 Python、網頁或一般程式：採用雙軌方式，本機負責編輯與一般練習，課程需要 macOS 時再使用遠端環境。
  • 若普通 SSH 尚未穩定，或每次都找不到遠端 Codex：先回到 SSH 基礎，不要購買更長期方案，也不要把問題歸因於 AI 模型。
  • 若課程需要實體 iPhone、持續的圖形介面或本地 USB 裝置：先確認遠端方案是否符合課程要求；若不符合，回退到可直接接觸硬體的本機 Mac 或學校設備。
如果你需要的是 Windows 連線遠端 Mac 的首次設定，可先參考 [Windows 11 遠端連線 Mac 的入門環境](https://macgpu.com/zh-Hant/index.html)。若你打算讓 AI 工具長期讀寫課程專案，則應優先整理權限、專案保存位置與斷線後驗收，而不是只看能否登入。

常見連線問題

Codex 為什麼找不到 SSH 主機？ 普通終端可以登入，只能證明某個 SSH 用戶端設定可用。Codex 仍需要讀取正確的 SSH 設定檔與 Host 別名；請核對設定檔位置、別名、使用者和認證方式，確認 ssh 別名 在同一台執行 Codex 的電腦上成功。

遠端 Mac 需要先安裝 Codex 嗎？ 需要把遠端 Mac 當作獨立環境處理。本機裝好 Codex 不會自動把命令安裝到遠端；遠端必須完成官方要求的安裝與授權，且登入 Shell 的 PATH 能找到命令，Codex 才可能在遠端啟動服務。

Codex 已連線，但專案仍在本地怎麼辦？ 重新從 SSH 主機選擇遠端資料夾，並用測試檔、pwd 和無破壞性命令確認位置。若輸出仍是本機路徑，代表工作區沒有真正切換；不要在這個狀態下開啟正式課程倉庫。

Codex Remote SSH 可以跑 Xcode 專案嗎？ 能否完成取決於工作內容。命令列建置、測試和檔案操作可在具備相應工具的遠端 Mac 上進行；模擬器、簽署、實體裝置和圖形介面則需要額外的顯示、權限與硬體條件，不能只用 SSH 成功作為保證。

從測試環境轉成長期方案

Windows 或舊 Mac 的現有方案，常見限制是沒有完整 macOS、學校電腦不准安裝必要軟體，以及本機睡眠、儲存空間或權限會中斷課程；另外，遠端 SSH 仍依賴穩定網路，斷線時也需要你重新確認工作目錄。若改買本機 Mac，前期支出和維護成本又可能超出學生只為一門課試用的需求。

當你已用最小任務確認遠端 Mac 確實能讀取專案、執行命令並保存檔案，租用一台可持續登入的真實 Mac，通常比在受限的學校電腦上反覆繞過安裝限制更合適。你可以先查看 MACGPU 的遠端 Mac 方案，再依課程需要決定短期租用、雙軌學習，或投入本機 Mac；如果需要的是臨時算力、測試環境或 macOS 專案工作區，這種先驗收、後延長的方式會比一開始承諾長期使用更穩妥。