跳到主要內容
maxstudioNews
產品DEV Community (Codex)約 5 分鐘

OpenAI Codex CLI 大幅更新:全新介面、平行代理與工作樹管理指南

OpenAI 的 Codex CLI 近期進行了重大更新,引入了全螢幕終端介面、提升可讀性,並強化了平行工作管理能力。這次更新將 Codex CLI 從單純的聊天迴圈轉變為多個代理執行緒的監管者,但使用者需注意 /fork 指令並非自動建立獨立工作樹,需手動確認檔案系統隔離。文章提供了首次使用更新版 CLI 的檢查清單,幫助開發者有效利用新功能並避免常見錯誤。

OpenAI Codex CLI 大幅更新:全新介面、平行代理與工作樹管理指南
圖片來源:DEV Community (Codex)

OpenAI 宣布 Codex CLI 進行了「重大更新」,主要亮點包括全螢幕終端介面、提升可讀性,以及在不離開終端機的情況下管理「平行工作」的能力。這次更新並非單一版本,而是從 0.156.0 到 0.160.0 的一系列建置,於 9 月 22 日至 10 月 1 日期間發布。

了解您擁有的版本至關重要,因為它決定了您實際看到的功能。此外,一個關鍵的標題短語「/fork 到工作樹」很容易被誤讀,可能導致混亂的程式碼簽出。

以下是按您會注意到的內容分組的更新日誌:

0.156.0 (9 月 22 日):透過 /tui 提供可選的全螢幕使用者介面(支援文字搜尋、滑鼠選取、右鍵複製);語音功能預設開啟(F8);/usage 分析儀表板;可從代理指令中心啟動工作樹會話,且工作樹支援預設開啟;終端機中可渲染 Mermaid 圖表和方程式;新增 --no-daemon 選項。

0.157.0 (9 月 25 日):全螢幕文字記錄預設開啟;符合條件的會話自動啟動背景伺服器;GPT-6 Sol 和 Luna 加入模型目錄。

0.159.0 (9 月 29 日):可選擇啟用 instant_interrupt,讓新輸入能在回應中途引導;精簡的歡迎畫面;在可寫入根目錄下,預設保護 .aws 目錄。

0.159.1 (9 月 29 日):GPT-6.1 Sol 成為捆綁目錄中的預設模型。

0.160.0 (10 月 1 日):代理指令中心新增「顯示更多」歷史記錄;允許時可進行無專案會話;未發送的排隊訊息在重新連線後會恢復,不會重複發送。

社群轉發的公告指出兩項改善使用者體驗的修復。舊的歷史記錄現在可以在您捲動時載入,超越終端機本身的捲動限制。此外,編輯器會固定在底部,因此在長時間會話期間,您不再需要捲動到底部才能輸入。一位評論者稱舊行為是個錯誤。

在這次更新之前,Codex CLI 本質上是終端機中的一個聊天迴圈。現在它更接近於多個代理執行緒的監管者:代理指令中心(OpenAI 公告稱其為 /agents 視圖)列出您的會話,您可以按狀態篩選它們,並從中啟動工作樹會話。子代理執行緒是您使用 /agent 或 /subagents 切換進入的內容,根據目前的指令參考。

Codex Workshop 指出,公告和文件在這裡使用了不同的名稱,因此請輸入 / 並檢查您的建置實際提供了什麼。

引導與排隊:當 Codex 正在工作時,按下 Enter 鍵可以在當前回合中注入指令。按下 Tab 鍵可以為下一個回合排隊一個後續指令。在編輯器為空時,連續按兩次 Escape 鍵可以編輯您的最後一條訊息,並從該點分叉聊天。

正如新聞報導所轉述,公告稱您可以「/fork 一個對話到一個具有相同上下文和獨立簽出的工作樹中」。這聽起來像是 /fork 總是提供檔案系統隔離。然而,OpenAI 自己的指令參考對 /fork 的描述更為狹窄。它將當前聊天複製到一個新的聊天中,並帶有新的 ID,同時保留原始文字記錄。

真正建立獨立簽出的是「工作樹會話」。根據 0.156.0 的說明,您可以從代理指令中心啟動一個,並且工作樹支援預設開啟。如果您分叉一個聊天,而兩個執行緒都繼續寫入同一個目錄,那麼您將有兩個代理編輯一個工作樹。您所假設的隔離並不存在。

因此,在讓第二個代理寫入任何內容之前,請務必檢查:git worktree list(第二個會話應該有自己的路徑)以及在每個 Codex 會話中執行 /status(檢查可寫入根目錄指向您預期的路徑)。Codex Workshop 引用 OpenAI 的工作樹指南,補充了兩點注意事項。

受管理的 worktrees 位於 $CODEX_HOME/worktrees 下,處於分離的 HEAD 狀態。並且,被忽略的檔案(例如 .env)不會自動複製到其中。Git 的一般規則也仍然適用:一個分支一次只能在一個工作樹中簽出。

首次會話檢查清單:

升級:執行 npm install -g @openai/codex@latest,或者如果您需要確切的 10 月 1 日建置,請指定 @openai/codex@0.160.0。當您安裝的版本支援自我更新時,codex update 也能運作。

健康檢查:執行 codex doctor --summary 以檢查安裝、配置、驗證、Git 和終端機。

以合理的權限開始:文件建議使用 codex --sandbox workspace-write --ask-for-approval on-request 進行低摩擦的本地工作。在隔離的虛擬機之外,請避免使用 --yolo。

確認會話:執行 /status 以查看活動模型、審批策略、可寫入根目錄和上下文使用情況。如果 GPT-6.1 Sol 不是您預期的模型,請使用 /model 切換。

刻意平行化:將第二個任務作為工作樹會話啟動,然後使用 git worktree list 進行驗證。Codex Workshop 還警告說,審批提示可能來自您未查看的執行緒,因此在批准之前請閱讀是哪個執行緒在請求。

限制並行:Codex Workshop 記錄了一個您可以設定的每個專案限制:在 .codex/config.toml 中設定 [agents] max_concurrent_threads_per_session = 4。

注意費用:子代理會各自執行模型和工具工作,因此平行會話會使用更多代幣。使用 /usage(在 0.156.0 中新增)來查看代幣活動。

以審查結束每個執行緒:在合併平行執行緒產生的任何內容之前,執行 /diff,然後執行 /review。

緊急出口:如果全螢幕使用者介面與您的 tmux 或 SSH 設定衝突,/tui 會為您的下次啟動選擇使用者介面模式,而 --no-alt-screen 會在單次運行中關閉替代螢幕模式。

終端機程式碼代理正在轉變為協調者。全螢幕使用者介面是可見的部分。真正的變化是一個終端機現在可以監管多個執行緒,每個執行緒都有自己的上下文、權限,甚至可能是自己的簽出。這使得「這個代理正在寫入哪個目錄?」成為您必須刻意回答的問題。在同時運行兩個代理之前,請檢查 git worktree list 並查看 /status 中的可寫入根目錄。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Codex) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。