OpenAI 公開 Codex 沙箱設計:直接在本機以作業系統機制限制,不靠 Docker

OpenAI 11 月 18 日發文說明 Codex 的沙箱做法:預設只能寫入專案目錄、網路預設關閉,並坦承 node_modules 這類被 Git 忽略的路徑是破口。

重點

  • OpenAI 在 11 月 18 日發表〈Inside the Codex sandbox〉,說明 Codex 如何限制 agent 執行的指令。
  • 做法是在 macOS、Linux、Windows 用作業系統層級的機制限制,而不是搬進 Docker 之類的容器。
  • 預設的 :workspace 設定只允許寫入專案目錄、.git 與 .codex 唯讀、網路關閉。
  • OpenAI 也示範了破口:被 Git 忽略的 node_modules/prettier 可能被 Codex 改動,之後在沙箱外被編輯器執行。
目錄(4 節)
  1. 發生什麼事
  2. 預設限制與設定
  3. 已知的破口
  4. 對你的影響

發生什麼事

OpenAI 在 11 月 18 日發表一篇技術文章〈Inside the Codex sandbox〉,說明 Codex 如何限制 AI 代理在使用者電腦上能做的事。本文撰寫時,OpenAI 官方頁面對我們的請求回傳 403,沒有辦法直接閱讀,以下內容根據媒體 StartupHub.ai 同日對該文的整理,細節以官方原文為準。

據該報導,Codex 不把工作搬進 Docker 等容器,而是讓指令留在使用者原本的機器上,用作業系統提供的機制在 macOS、Linux 與 Windows 上限制檔案與網路存取。報導指出,文章沒有點名具體使用哪些底層機制。

OpenAI 公開 Codex 沙箱設計,直接在本機以作業系統機制限制

預設限制與設定

依 StartupHub 的整理,預設的 :workspace 設定檔如下:

  • 可以寫入專案(repo)目錄,但 .git 與 .codex 唯讀。
  • 專案外可以廣泛讀取,讓編譯器、執行環境與 SDK 能正常運作。
  • 網路預設關閉,所以上傳資料會被擋,依賴套件下載也會失敗,要使用者開啟。

網路有三種選項:完全關閉、完全直連,或透過代理按網域規則放行,其中明確的拒絕規則優先於允許。文章還舉了一個開發者設定範例:在 :workspace 之上額外允許寫入 ~/build-cache、把 .vscode 與 .devcontainer 固定為唯讀、並禁止讀取 **/*.env 與機密檔。

在實作上,報導說 Codex 的執行框架以專屬函式取代一般的子行程啟動,並把權限設定與可選的網路代理一路傳到整個行程樹;exec_command 工具可以要求「用預設」「附加權限」或「提升權限」,由框架決定要詢問、自動審查或直接拒絕。同一套機制也用來處理檔案讀取與 MCP 伺服器的沙箱化。iOS 專案則留在 Mac 本機建置,因為 Docker 跑不了 iPhone 模擬器與相關工具鏈。

已知的破口

OpenAI 在文中展示了一個限制:Codex 可以改動 node_modules/prettier,而這個路徑常被 Git 忽略;如果使用者的編輯器存檔時會執行 Prettier,被改過的程式就會在沙箱之外執行。OpenAI 因此說,沙箱要搭配模型訓練與對齊,不能只靠限制。報導也指出,OpenAI 沒有公布繞過率、核准造成的摩擦或沙箱額外開銷等數字。

對你的影響

  • 如果你讓 Codex 或類似的代理在本機跑,預設設定通常夠用;真正要注意的是你自己放寬的項目,例如打開網路或給「提升權限」。
  • 專案內被 .gitignore 忽略的目錄(node_modules、建置輸出)不會在 Git 審查中看到變動,卻可能被編輯器或腳本執行。審查 agent 的成果時別只看 git diff。
  • 敏感檔案(.env 等)可以比照 OpenAI 的範例,用設定明確禁止讀取。