Favicon02

Codex 雲端怎麼用?環境設定與任務驗收教學

Codex 雲端讓專案任務在雲端執行。從本機、Remote 的差異開始,認識 Repo 與工作環境,完成環境設定,再用一項小修改練習交辦、檢查與保存成果。

想把一項網站修改交給 Codex,又希望電腦睡眠後工作能繼續,就可以了解雲端執行的方式。Codex 雲端(Codex Cloud)會在雲端工作空間處理專案任務:你先備妥專案檔案、工具與權限,再交代要修改的內容,它便能在那裡編輯檔案、執行指令。

這種方式適合把範圍明確的工作交出去,例如調查網站錯誤、修改一項功能,或整理專案說明。OpenAI 的Codex Cloud 說明指出,雲端任務能在你的電腦睡眠時繼續執行。

開始前先確認登入方式。官方方案表將 Codex Cloud 列在 Plus、Pro、Business、Enterprise 與 Edu;工作區另可能需要管理員開啟。Free、Go 或單用 API 金鑰登入的讀者,可先在支援的本機入口練習。(OpenAI 方案說明)

第一次使用,最容易混淆的是「從哪裡下指令」與「工作在哪裡執行」。接下來我會先說明雲端、本機及 Remote 的差異,再帶你建立環境,最後用一項小修改練習交辦與驗收。


Codex 雲端是什麼?

Codex 雲端(Codex Cloud)是在雲端工作空間執行專案任務的方式,讓 Codex 使用那個環境中的專案檔案、開發工具與服務權限,完成編輯、調查問題或執行指令等工作。使用者先準備環境並交代任務,Codex 再依需求操作工具、查看結果與接續修改,成果保留在對應的工作空間供人審閱。手機或桌面程式可以作為交辦和查看進度的入口,實際執行位置則在雲端,因此任務能在本機電腦睡眠後繼續處理。

例如,你把一項網站版面修改交給雲端任務,先讓環境取得專案與執行所需工具,再說明要改哪一頁、完成時應看到什麼。Codex 在雲端讀檔、修改並執行檢查,你之後回到任務查看差異和結果。這時指令從哪台裝置送出,和檔案在哪裡被修改,是兩個不同的問題。

Codex 雲端、本機與 Remote 差在哪裡?

使用方式 工作在哪裡執行 選擇時先看什麼
本機自己的電腦與專案資料夾檔案與所需工具是否都在這台電腦
Remote已連線的 Mac 或 Windows 電腦需要那台主機的檔案與工具,且能保持主機醒著、連網
Codex 雲端從已發布環境建立的雲端工作空間專案、工具與存取權是否已在雲端備妥

依 OpenAI 的環境說明,Local 與 Worktree 都在你的電腦執行;Worktree 只是把一份 Git 專案的修改分開放。選擇 Cloud 後,要另外在雲端備妥專案檔案、服務授權與執行工具。

如果你要從手機接著處理公司電腦裡的工作,先看Codex Remote 遠端連線教學。OpenAI 的Remote 說明要求連線主機保持醒著且上網,這與雲端任務的執行位置不同。

Codex 雲端由準備環境、交辦任務到取回成果的三個環節

使用 Codex 雲端前,先準備專案與環境

Codex 雲端的「環境」,可以理解成預先備好的工作場所:裡面有專案檔案、執行專案需要的工具,以及連接服務的權限。環境準備好之後,可以反覆拿來開始新任務,不必每次重新描述整套設定。

「任務」則是你這一次要它完成的工作。每項任務有自己的工作空間,甲任務修改的首頁會保存在甲的工作空間。要延續尚未做完的修改,就回到原來的任務接著處理。

按照 OpenAI 現行的建立流程,先選擇 GitHub 裡的 Repo。Repo 是 Repository 的簡稱,中文常稱「儲存庫」,除了放專案檔案,也保存修改紀錄。還沒有這個概念,可以先讀Repo 與 GitHub 入門,再拿一個練習專案開始。

送出設定前,把所需檔案放進雲端可用的 Repo 或工作空間,確認自己有權使用,也知道專案怎麼啟動、怎麼檢查。工具、權限或資料還有缺項時,先讓 Codex 說明需要補哪些設定。


建立第一個 Codex 雲端環境

準備好練習用 Repo 後,從 ChatGPT 網頁或桌面 App 建立環境。手機可以選擇已發布的環境開始任務,但建立新環境要使用網頁或桌面 App。下列選項名稱對應 OpenAI 的雲端環境設定說明。


1. 選擇 Cloud 與要使用的 Repo

登入 ChatGPT 帳號,在新任務選擇 Work in → Cloud,開啟 Select environment,再選 Create environment。若已經有可使用的環境,可以直接選它,不必重建。

如果設定裡另看到 Codex Cloud (Legacy),那是程式碼審查及 Linear、GitHub 等整合還在使用的舊版入口。本篇示範的是新版環境。新版目前不支援 GitLab 或自架 GitHub Enterprise Server;GitLab 測試版則依官方的舊版整合流程使用。(新版環境說明、GitLab 整合說明)

建立新環境時,選擇這次要處理的 GitHub Repo;畫面要求連接 GitHub,就完成帳號連接。核對選到的是練習專案,再按 Get started。這一步完成的標準,是 Codex 已開始檢查正確的專案。


2. 讓 Codex 準備工具,確認專案能執行

Codex 會查看專案、安裝需要的工具,並測試工作流程。遇到無法判斷的設定或缺少權限,它會詢問你;例如專案需要哪個版本的工具,或下載套件時缺少存取憑證。

這時可以直接要求:「請確認這個專案需要哪些工具,試著執行現有測試,並列出還沒完成的設定。」先處理失敗原因,確認有哪些檢查已執行、結果如何,再進下一步。


3. 發布 Codex 雲端環境,再開始任務

檢查設定報告、測試結果與相關檔案,處理剩下的問題,再保存變更並選 Publish。等到出現 Environment published,才表示這份環境已可供新任務使用;接著選 Start a new task,交代要做的工作。

這裡的 Publish 會保存供新任務使用的工作環境。網站上線另按專案的部署流程進行。未來如果要更新共用工具或設定,需要編輯環境並重新發布;已經存在的任務仍保留自己的狀態。

建立 Codex 雲端環境的四個階段:選擇專案、準備與測試、發布環境及開始任務
OpenAI 官方示範如何建立可重用的 Codex 雲端環境,再從其他裝置接續任務。 觀看 OpenAI 官方影片:Meet the all new Codex Cloud。


第一次交辦 Codex 雲端,先做一項看得出差異的小修改

假設你的練習 Repo 裡,已經有一個以 index.html 作為首頁的自我介紹網站。第一次可以只修改首頁文字,先不加會員、金流或資料庫;範圍小,才容易看懂 Codex 改了哪些地方。

下面是可以調整後使用的交辦範例。請先確認實際專案確實有這個檔案,再把名字與介紹換成自己的內容。

請修改這個專案的 index.html,把首頁標題改成「你好,我是小安」,並將介紹改成「我正在練習用 AI 做自己的網站」。

保留原本版面、按鈕功能與其他頁面。先說明預計修改哪個檔案,再完成修改;不要部署網站,也不要合併到主要分支。

完成後列出修改前後的文字、實際執行的檢查與結果。如果有檢查無法執行,請說明原因,並告訴我下一步怎麼確認。

分支(branch)是讓一組修改獨立發展的版本路線。把「不要合併到主要分支」寫清楚,是要先留下檢查空間,等確認修改結果後,再依專案流程決定是否合併與部署。

如果 Codex 雲端說找不到 index.html,先請它列出專案檔案,找出真正的首頁位置,再修改指令。不同架構的網站可能使用不同入口檔案,這次練習要沿用專案既有的首頁。

工作一多,交辦內容可以再拆成「要完成什麼、可以改哪裡、怎麼確認」。更多示例可接著看Codex 新手交辦技巧;固定的專案規則則可以整理進AGENTS.md,供後續任務參照。


Codex 雲端回覆完成後,檢查這三件事

收到完成訊息後,請確認檔案確實改對、必要檢查有結果,以及成果已保存到你能接手的位置。OpenAI 的任務說明也要求先檢視修改與測試,再決定是否提交或建立 PR。


1. 看檔案差異,確認只改了預定內容

開啟任務的檔案變更,對照修改前後的內容。以上面的練習為例,應該看到首頁標題與介紹換成指定文字;若連其他頁面、工具設定或大量檔案都改了,就請 Codex 說明原因,再決定要不要保留。

不熟程式碼也可以先問:「請用我看得懂的方式,逐項解釋這些修改會改變哪些畫面或行為。」請它指出說明對應的檔案與變更位置,方便你逐項確認。


2. 看測試結果,把沒驗證的部分分開

查看它實際執行了什麼檢查、結果是成功還是失敗。有些專案原本沒有自動測試,這時應列明已檢查的部分、實際結果,以及尚未驗證的項目。

OpenAI 的目前限制列明,雲端環境尚不支援電腦與瀏覽器操作。因此,這次網頁練習還要由你用瀏覽器開啟成果,確認文字、版面與原本按鈕正常。


3. 保存成果,再決定是否提出 PR

檢查完成後,再保存需要的檔案或提交修改。Commit 是把一組變更記錄成可追溯的版本;Pull Request,簡稱 PR,則是提出一份修改請求,讓你或協作者先審閱,再決定是否合併。

是否合併及何時部署,要依專案的發布規則決定。如果專案原本設有自動部署,合併後可能觸發上線,這也是合併前要確認的影響。

Codex 雲端的重要成果請另行保存,方便日後接續使用。依OpenAI 保存狀態說明,預設可恢復的虛擬機狀態期限,是最後啟動一輪或恢復任務後最多七天。這項期限適用於執行環境狀態,與 GitHub 檔案的保存分開管理。

Codex 雲端成果驗收的三項證據:檔案差異、測試結果與保存成果


Codex 雲端卡住時,先辨認缺了什麼

最常見的困惑,是本機能做,換到雲端卻不能做。先查看任務卡在哪一步,再對照環境裡有沒有檔案、工具與存取權,通常比反覆送出相同指令更有幫助。

  • 沒有可選的環境:先確認是否已建立並發布,或是否取得共用環境的使用權。公司工作區還可能需要管理員開放權限。
  • 找不到本機檔案:將需要的檔案放進雲端可用的 Repo 或工作空間,再提供對應位置。
  • 缺少工具或測試失敗:請 Codex 說明失敗指令與原因,修好後重跑相關檢查。若是共用環境缺工具,修正設定並重新發布,讓新任務取得更新。
  • 連不到某個服務:網路需允許該網域,服務本身也需完成帳號授權,請分別檢查這兩項設定。

要在 Codex 雲端使用個人 skills,需另外準備雲端可取得的規則;官方說明可使用放在 Repo 裡的 skills。若工作依賴特定工具,也把工具備妥後,再依相同流程執行。

找不到功能或遇到用量限制時,先核對登入帳號、工作區權限與畫面顯示的可用額度,確認目前帳號能使用哪些功能。


從一項能檢查的雲端工作開始

Codex 雲端的入門重點,是先備妥環境,再交代一項能清楚驗收的任務。第一次先改兩段首頁文字,確認檔案差異、檢查結果與保存位置,會比直接要求建立整個網站更容易掌握。

等這次練習完成,再增加下一個功能。如果還想了解 Codex 在其他工作裡能怎麼用,可以接著閱讀Codex 完整介紹,依工作檔案與工具的位置,選擇適合的執行方式。

重點整理

Codex 雲端需要 GitHub 嗎?

依 OpenAI 現行的建立流程,新環境要選擇 GitHub Repo,必要時連接 GitHub 帳號。請先把任務需要的檔案放入雲端可用的位置;若已有你能使用的已發布環境,可以直接選它開始任務。

Codex 雲端與 Remote 一樣嗎?

Codex 雲端在雲端工作空間執行;Remote 則讓你從其他裝置接續已連線電腦上的工作,那台電腦須保持醒著且連網。選擇時先確認任務需要的檔案和工具放在哪裡。

電腦睡眠後,Codex 雲端還會繼續工作嗎?

可以。OpenAI 說明指出,雲端任務可在你的電腦睡眠時繼續執行。所需檔案與服務要先在雲端備妥;執行中若等待補充資訊或權限,則由你回到任務提供,再接續處理。

Codex 雲端是免費的嗎?

Codex Cloud 列在 Plus、Pro、Business、Enterprise 與 Edu 的方案功能。Free/Go 或單用 API 金鑰登入時,請使用支援的本機入口。工作區的可用環境、權限與額度,依登入後顯示的內容為準。(OpenAI 方案說明)

發布環境後,網站就會公開上線嗎?

發布雲端環境是保存供新任務使用的專案與工具,網站上線另按專案的部署流程進行。若專案設定合併後自動部署,則應在合併修改前確認上線影響。

Frank Chiu
Frank Chiu

SEO/GEO 顧問、行銷顧問。協助本地企業與跨國企業導入 SEO、GEO 跟行銷方案,包括:雀巢、凱基銀行、大人學、居家先生、IKEA、vocus 等。

訂閱電子報