當設定完成後,osFoundry 桌面應用程式中的代理會以 cli:codex:agent 作為模型。當有工作分配給它時,應用程式會在你的 Mac 上啟動 codex exec,並使用你自己的 ChatGPT 登入資訊。執行過程會在你允許的特定資料夾中進行。
Codex 返回的內容,包括其推理、執行的指令和最終訊息,都會以行顯示在 osFoundry 的執行記錄中,整個過程不會涉及任何 OpenAI API 金鑰。
這篇文章說明如何將 Codex CLI 設定為 osFoundry 桌面應用程式的 AI 工作代理。它詳細介紹了 Codex CLI 的執行流程、工具整合方式以及安全機制,例如沙盒和 Git 工作樹隔離。此設定利用使用者自己的 ChatGPT 登入,無需 OpenAI API 金鑰,讓 Codex 能在 osFoundry 的管理下執行任務、指令並操作檔案。

當設定完成後,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」的位置,桌面版本則可在下載頁面找到。
覺得值得一看?分享給朋友。
以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Codex) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。
43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。