跳到主要內容
maxstudioNews
AI 自動化DEV Community (Codex)約 10 分鐘

將 Codex CLI 整合為 osFoundry 工作代理的指南

這篇文章說明如何將 Codex CLI 設定為 osFoundry 桌面應用程式的 AI 工作代理。它詳細介紹了 Codex CLI 的執行流程、工具整合方式以及安全機制,例如沙盒和 Git 工作樹隔離。此設定利用使用者自己的 ChatGPT 登入,無需 OpenAI API 金鑰,讓 Codex 能在 osFoundry 的管理下執行任務、指令並操作檔案。

將 Codex CLI 整合為 osFoundry 工作代理的指南
圖片來源:DEV Community (Codex)

當設定完成後,osFoundry 桌面應用程式中的代理會以 cli:codex:agent 作為模型。當有工作分配給它時,應用程式會在你的 Mac 上啟動 codex exec,並使用你自己的 ChatGPT 登入資訊。執行過程會在你允許的特定資料夾中進行。

Codex 返回的內容,包括其推理、執行的指令和最終訊息,都會以行顯示在 osFoundry 的執行記錄中,整個過程不會涉及任何 OpenAI API 金鑰。

在登入方面,Codex CLI 會使用你自己的 ChatGPT 登入資訊(透過 codex login 儲存),而 osFoundry 則不會看到這些資訊。osFoundry 會從子程序環境中移除 CODEX_API_KEY、OPENAI_API_KEY 和 OPENAI_BASE_URL,以確保執行是透過你的訂閱進行。

模型呼叫會直接從 Codex 程序發送到 OpenAI,並將費用記錄為 0.0(因為是訂閱制,不計量)。Codex CLI 使用自己的 shell 和檔案編輯功能,在工作資料夾內操作。它也能透過 127.0.0.1 上的 MCP 回路橋接器,使用 osFoundry 自己的工具(例如 memory_search),但這僅限於 Git 工作樹隔離執行時。

執行過程中不會有任何人工審批,因為 exec 不是互動式的,且 approval_policy="never"。然而,透過橋接器進行的每次工具呼叫都會經過 orchestrator::execute_tool 及其政策控制。

輸出方面,Codex CLI 會為每個完成的項目在標準輸出(--json)中產生一個 JSON 事件。osFoundry 會將每個事件轉換為進度行或回應文字,並將標準錯誤的末尾儲存為錯誤訊息。你的檔案會在指定的資料夾或工作樹中讀取和寫入。你可以選擇 Code 介面中的儲存庫,或者你第一個允許的本地資料夾作為工作目錄。

設定:首先安裝 Codex CLI 並登入一次。osFoundry 會在 PATH、~/.codex/bin 以及 /Applications/Codex.app 內部尋找其執行檔(透過 cask 安裝時,執行檔會位於 Contents/Resources/codex,此處 which codex 無法找到)。

完成 codex login 後,開啟標頭中的鑰匙圖示(工具提示顯示「API Keys (BYOK)」),然後切換到「External AI (外部 AI)」分頁。

Codex 這一列會顯示「Installed」、一個「No live stream」標誌以及自主模型 ID。Codex 沒有聊天 ID,因此只會顯示一個 ID:Codex Installed No live stream Enabled cli:codex:agent (autonomous)。

osFoundry 工具要求 Codex 進行 Git 工作樹隔離(它以自己的沙盒換取 Git 安全性)。請將其指向一個 Git 儲存庫資料夾。例如,在「External AI」分頁中,你會看到 Claude Code 和 Codex。

如果你尚未登入,點擊「Sign in」按鈕會開啟一個終端機並執行 codex login。接著,點擊「Verify sign-in」來驗證登入。執行一個小型的完成測試,使用與實際執行相同的建構器:codex exec "Reply with the single word: ok" --json --skip-git-repo-check --ignore-user-config --ignore-rules -s read-only -c 'approval_policy="never"'。

--ignore-rules 僅在 codex exec --help 包含此選項時才會添加。osFoundry 會向執行檔查詢此選項,因為舊版本會拒絕該旗標並導致整個執行失敗。

為代理指定一個資料夾,在「Settings → Local Folders」中新增一個。如果你還希望 Codex 能夠存取 osFoundry 自己的工具,請將該資料夾轉換為 Git 儲存庫,並在 Code 介面中點擊「Enable for this workspace」。從此以後,每次執行都會有自己的分支和工作副本。

在 Studio 中開啟代理並設定「Model Preference」。選擇器會在「CLI agents」區段顯示 Codex,名稱為 cli:codex:agent(供應商為「External AI (subscription)」)。如果代理需要處理工作步驟,請將「Runtime Role」設定為 worker。

當工作傳遞給它時,指令會如下所示。如果沒有工作樹,Codex 會保持自己的沙盒:codex exec "<system prompt> User: <task>" --json --skip-git-repo-check --ignore-user-config --ignore-rules -C /path/to/folder -s workspace-write -c 'approval_policy="never"'。

如果使用工作樹,沙盒旗標會被替換,並連接橋接器:codex exec "<system prompt> User: <task>" --json --skip-git-repo-check --ignore-user-config --ignore-rules -C /path/to/worktree --dangerously-bypass-approvals-and-sandbox -c 'mcp_servers.osfoundry.url="http://127.0.0.1:<port>/mcp"' -c 'mcp_servers.osfoundry.http_headers={Authorization="Bearer <per-run token>"}'。

Codex 沒有用於添加系統提示詞的旗標,因此 osFoundry 會將代理的系統提示詞放在對話之前,並以空行分隔。之前的對話輪次則會以 User: / Assistant: 的形式作為轉錄內容。

一個執行範例:以下是 Codex 寫入的事件行,以及 osFoundry 根據這些事件顯示的行。文字僅供說明,但事件類型和行格式與程式碼的映射方式相同。

$ codex exec … --json

{"type":"item.completed","item":{"type":"reasoning","text":"Check what the tests cover first."}}

{"type":"item.completed","item":{"type":"mcp_tool_call","server":"osfoundry","tool":"memory_search"}}

{"type":"item.completed","item":{"type":"command_execution","command":"npm test"}}

{"type":"item.completed","item":{"type":"file_change","path":"src/date.ts","change":"edit"}}

{"type":"item.completed","item":{"type":"agent_message","text":"Fixed the off-by-one in parseRange; 42 tests pass."}}

{"type":"turn.completed","usage":{"input_tokens":…,"cached_input_tokens":…,"output_tokens":…}}

osFoundry 執行記錄:

Thinking: Check what the tests cover first.

Using memory_search…

Using shell,npm test

Edited src/date.ts

Fixed the off-by-one in parseRange; 42 tests pass.

Codex 會以 server 和 tool 這兩個欄位來命名橋接工具,因此顯示的行會是 memory_search,而沒有 mcp__osfoundry__ 前綴。回應會以完整的 agent_message 元素形式傳回,而不是單獨的 token。

進度行會隨著 Codex 的工作進展而逐一顯示。每個訊息的文字只有在 Codex 完成該訊息後才會出現。Token 計數來自 turn.completed,其中 input_tokens 不包含快取部分,因此 osFoundry 會重新加總 cached_input_tokens 以取得完整的上下文大小。

限制:目前沒有 cli:codex 的聊天模式。Codex 的設定中沒有關閉其 shell 工具的開關,因此即使是透過 Codex 進行的「無工具完成」,仍然會是一個帶有 shell 的代理。osFoundry 會拒絕聊天 ID,而不是默默執行,並顯示訊息:「codex has no tool-less chat mode,use 'cli:codex:agent' for an autonomous run instead.」。

-s 是一個檔案系統和指令的沙盒。workspace-write 限制了 Codex 可以寫入的位置及其指令可以執行的操作。它不限制模型可以呼叫哪些工具,Codex 也沒有類似 --disallowedTools 的功能。因此,當你將 Codex 添加到頻道時,「Add agent」頁面會指出在此環境中無法強制執行工具範圍。

osFoundry 的工具需要工作樹。在非互動式執行中,除非同時省略審批和沙盒,否則 Codex 會取消所有 MCP 工具呼叫。按工具審批模式、信任專案和 approval_policy="never" 仍然會導致取消。因此,應用程式只進行一次交換:僅當 Git 隔離取代 Codex 的作業系統沙盒時,才會放棄該沙盒。

如果沒有工作樹,執行會保持 -s workspace-write,橋接器不會連接,執行記錄中也會顯示這一點。

你自己的 Codex 設定會被排除在外。--ignore-user-config 會忽略 ~/.codex/config.toml,因此你為自己設定的 MCP 伺服器不會加入 osFoundry 的執行中。認證仍然會從 CODEX_HOME 載入。--ignore-rules 也會排除 execpolicy.rules 檔案。

每次執行都有一個即時時間限制:自主執行為 1,800 秒,登入測試為 300 秒。當時間耗盡時,子程序會被丟棄並終止。

下一步:將代理指向一個小型 Git 儲存庫,為工作區啟用程式碼代理,並給它一個既需要 shell 指令又需要 osFoundry 記憶體功能的任務。這樣你就能在同一個執行中看到「Using shell」和「Using memory_search…」出現。Studio 的代理頁面會顯示「Model Preference」的位置,桌面版本則可在下載頁面找到。

Share

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

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

Newsletter

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

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

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