在 OpenAI,我們採取縱深防禦(在新視窗中開啟)策略,保障智能代理的安全。我們在訓練和對齊方面的投入是這項工作的根基;除此之外,我們也在智能代理任務執行框架 Codex(在新視窗中開啟) 中實作各項功能,提供額外保護。在你的電腦上執行指令,是 Codex 最常見、也可能帶來風險的操作之一。因此,我們建立了 Codex 沙箱,讓 Codex 能在你現有的環境中工作,同時遵守由你掌控的檔案系統和網絡限制。
(在新視窗中開啟)沙箱(在新視窗中開啟)會限制程式執行期間可存取的資源。以整理相片的任務為例,你可以設定 Codex 沙箱,允許指令讀取和修改 ~/Pictures 中的檔案,同時封鎖網絡存取以防止上載。進行程式碼審查時,你可以允許存取網上文件,同時將原始碼檔案維持為唯讀。使用者透過 (在新視窗中開啟)權限設定檔(在新視窗中開啟)設定 Codex 沙箱,定義 Codex 工作階段的檔案系統和網絡限制。
本文會先介紹 Codex 沙箱預設設定背後的取捨,再說明沙箱的設計,以及任務執行框架如何利用沙箱執行指令。我們會示範終端使用者和企業如何按需要調整權限,以及開發人員如何在自己的工具中重用沙箱。最後,我們會探討這些限制在 macOS、Linux 和 Windows 上如何強制執行。
我們為 Codex 沙箱設定預設值時,理念是在採取保守限制的同時,仍讓它能完成實質工作。例如,當工作區根目錄是 Git 程式碼庫時,內置的 :workspace 權限設定檔會:
允許在工作區內寫入,同時讓
.git和.codex等目錄保持唯讀。這讓 Codex 能編輯原始碼,無須每次修改都請求許可,同時防止直接修改.codex/config.toml或.git/hooks下的 Git 掛鈎。允許廣泛讀取檔案系統,但受使用者現有的作業系統權限約束。編譯器、執行階段和建置工具都依賴程式碼庫以外的 SDK、程式庫及設定。若將讀取範圍限制在工作區內,許多日常工作流程就無法正常運作。代價是電腦上其他位置的敏感檔案也可能仍可讀取,例如包含 API 金鑰的設定檔。
停用網絡存取。這會封鎖直接上載至外部服務的操作,包括試圖將指令可讀取的資料外洩。這也會阻止下載相依套件等正當操作;這些操作需要額外的存取權限。
這些限制能防止一大類不當行為,但有害操作仍有可能發生。例如,智能代理可能將惡意程式碼注入本機已安裝的套件,例如 node_modules/prettier。這類修改可能不會出現在 git status 中,因為 Git 通常會忽略 node_modules。如果使用者的編輯器在儲存時執行該份 Prettier,只需儲存檔案,就可能在 Codex 沙箱以外執行惡意程式碼。這正是我們採取縱深防禦策略的原因:沙箱限制指令可存取的資源,而訓練和對齊則協助模型按照使用者的意圖運用這些存取權限。
如需了解如何在企業環境中調整沙箱權限,並結合其他保護措施,請參閱 Codex 安全實務指南(在新視窗中開啟)。
虛擬機器和容器(在新視窗中開啟)是兩種常用的沙箱機制,但 Codex 沙箱採取了不同做法。Codex 並非將運算移至獨立環境來實現隔離,而是利用各平台的沙箱功能,限制在使用者現有環境中執行的指令。
對許多開發人員來說,手提電腦就是為自己度身設定的開發環境,可以隨時按需要更改。要在 Docker 容器中重建這個環境,可能需要花一番工夫,而有些工作流程仍然依賴在主機上執行的工具。
例如,假設你在 Mac 上使用 Codex 開發 iOS 應用程式。如果你決定將 Codex 放在 Docker 內執行,以此作為沙箱隔離,Codex 就無法執行由原生 Mac 可執行檔組成的 iOS 建置工具鏈,也無法啟動 iPhone 模擬器來執行程式碼。以 Docker 為基礎的工作流程可以將建置和模擬器操作交由 Mac 主機執行,但這些操作會在容器沙箱以外進行,因此需要另設限制。對 Codex 而言,我們傾向保持簡單,因此大力投入各作業系統專屬的沙箱技術,讓 Codex 能在最適合當前任務的環境中執行。
任務執行框架透過 macOS、Windows 和 Linux 共用的 API,提供這些作業系統專屬的沙箱機制。這個 API 接受一條指令和一份權限設定檔。如果權限設定檔允許有限度的網絡存取,呼叫端就必須提供網絡代理伺服器,以強制執行這些限制:
這個函式會在沙箱中啟動處理程序,並傳回一個 Child 控制代碼,讓任務執行框架可用它等待處理程序完成。每個子處理程序都會繼承父處理程序的沙箱限制,因此這些限制會套用至由該指令啟動的整個處理程序樹,即使原始處理程序已結束、後代處理程序仍在執行,也不例外。
下圖展示這些部分如何配合運作,從設定到在沙箱內執行指令的整個流程。以下各節會說明每個階段。

如拆解 Codex 智能代理迴圈一文所述,Codex 任務執行框架負責執行模型產生的工具呼叫。對於編程任務,最常用的是 Shell 工具,其執行指令的方式,與使用者在 Bash 等互動式 Shell 中操作相若。這裏會以一次性 (在新視窗中開啟)exec_command(在新視窗中開啟) Shell 工具(在新視窗中開啟)為例,說明任務執行框架如何利用沙箱實現所需的保護。
以下簡化範例展示 Codex 任務執行框架在不使用沙箱的情況下,如何處理 exec_command 工具呼叫:
若要將指令置於沙箱中,任務執行框架會以 spawn_command_under_sandbox() 取代對 subprocess.Popen() 的呼叫。任務執行框架會提供權限設定檔,並在需要時提供網絡代理伺服器:
exec_command 工具也讓模型能為個別指令請求不同權限,但是否批准由任務執行框架決定:
指定 use_default 時,任務執行框架會使用該回合的預設沙箱設定。with_additional_permissions 會請求在沙箱內擴大存取權限,而 require_escalated 則會請求在沙箱外執行。執行指令前,任務執行框架會根據使用者的偏好設定評估請求。(例如,Codex 可能直接詢問使用者,也可能將請求轉交自動審查(在新視窗中開啟)。)如果執行獲授權,Codex 會將適當的 permission_profile 和 network_proxy,連同原始 ExecCommandToolCall 中的指令引數,一併傳給 perform_exec_command_with_sandboxing()。
Shell 工具是 spawn_command_under_sandbox() 的主要使用者,而任務執行框架也會在讀取和修改本機檔案等操作中重用其沙箱基礎設施。重用範圍不只限於任務執行框架:codex sandbox 指令讓你能將沙箱內的指令執行功能整合到自己的工具中,下文會再作介紹。接下來,我們會看看如何定義權限設定檔。
具名權限設定檔讓你能在不同專案中重用相同的檔案系統和網絡限制。你可以在 config.toml 的 [permissions] 下定義自己的設定檔。例如,以下會定義一份名為 dev 的設定檔,擴充(在新視窗中開啟)內置的 :workspace 設定檔:
dev 設定檔會加入對 ~/build-cache 的寫入權限,並對工作區中的檔案施加額外限制。檔案系統項目可以授予唯讀權限(read)、讀寫權限(write),或完全封鎖存取(deny)。
:workspace_roots 表格讓你能為相對於專案工作區根目錄的路徑定義規則。預設情況下,Codex CLI 將其工作目錄作為唯一的工作區根目錄,而 ChatGPT 桌面應用程式則使用專案的原始碼資料夾。Codex 會將每條規則套用至所有根目錄,因此 dev 中的 .vscode 項目,會將每個根目錄下的 .vscode 目錄設為唯讀。
除了自身的規則,dev 也會從 :workspace 繼承以下保護措施:
設定 Codex 沙箱的網絡時,大致有三種選擇:
停用所有網絡存取(
:workspace設定檔的預設值)啟用完整、直接的網絡存取(
:danger-full-access設定檔的預設值)限制網絡存取只能經由代理伺服器,由它根據權限設定檔決定哪些請求可以通過
若要讓 dev 直接存取網絡,請在 config.toml 的最上層設定 permissions.dev.network.enabled = true。停用網絡代理伺服器時,這項設定會授予完整的網絡存取權限。
若要將 dev 限制於一組網域,請啟用網絡代理伺服器並設定其網域規則:
網域規則支援確切名稱和萬用字元模式,而明確的拒絕規則優先於允許規則。對其他網域的請求需要批准,否則會被封鎖,詳見下文的網絡代理伺服器一節。
個別使用者可以設定適用於所有專案的預設值,再針對特定的受信任專案覆寫這些設定。企業管理員也可能希望為使用者設定預設值,並限制使用者可更改哪些設定。Codex 透過分層設定和受管理要求,同時支援這兩種需求。
如設定優先次序(在新視窗中開啟)所述,Codex 會合併多個 config.toml 檔案中的設定。表格會遞迴合併;若數值衝突,則以優先次序較高的來源為準。陣列則會整個替換。
這就是權限設定檔使用表格來定義檔案系統路徑和網絡網域的原因。團隊可以在自己的設定中加入或覆寫個別項目,並自動繼承機構基礎設定中所有其他項目的變更:
管理員也可以透過 requirements.toml 提供受管理要求(在新視窗中開啟),限制使用者可選擇的設定。這些要求可以來自多個來源,包括系統檔案和雲端提供的政策。常見用途是指定 allowed_permission_profiles,限制企業使用者可選取的權限設定檔。例如,管理員可以指定以下雲端要求:
雲端要求的優先次序高於 /etc/codex/requirements.toml 中的系統要求檔案,因此該檔案中的項目不能覆寫上文明確設定的 ":danger-full-access" = false。不指定 :workspace,就能讓另一個要求層提供該項目。若設定檔的項目為 false,或未出現在最終合併的表格中,該設定檔便不可用。
這種分工讓機構能強制執行限制,同時讓使用者在限制範圍內調整設定。產生的權限設定檔可由任務執行框架使用,也可直接套用至指令,下文會加以說明。
Codex CLI 提供 sandbox 指令,方便你按照 Codex 設定中定義的權限設定檔執行任意指令。這通常用於測試設定檔,確保沙箱能阻止其設計上要封鎖的行為。
例如,以下指令會嘗試設定 VS Code,讓它在儲存時執行惡意的自動格式化工具。假設 .vscode 已存在,上文定義的 dev 設定檔應會阻止這次寫入,因為該目錄為唯讀(codex sandbox 預設將 cwd 視為工作區根目錄):
實際上,在 macOS 上,這項操作會失敗並顯示:
透過 codex sandbox 指令,你可以在智能代理工作階段以外獨立使用 Codex 的沙箱機制。你可以使用相同的設定語言和各平台專屬的強制執行機制,限制由自己工具啟動的指令。
對於在 config.toml 中設定的 stdio MCP 伺服器,Codex 任務執行框架不會嘗試將啟動該伺服器的指令置於沙箱中。Codex 無法可靠地推斷該伺服器需要哪些檔案或網絡服務,因此套用預設沙箱設定檔,可能會令原本有效的設定無法運作。
例如,若要設定 @modelcontextprotocol/server-memory(在新視窗中開啟) MCP 伺服器供 Codex 使用,標準做法如下:
由於這條 npx 指令不在沙箱中執行,它能以執行 Codex 的使用者所擁有的相同權限寫入檔案和發出網絡請求,權限過於寬鬆。為收緊權限,我們可以定義名為 memory-mcp 的權限設定檔,再以 codex sandbox --permission-profile memory-mcp 包裝原有的 npx 指令,限制伺服器可寫入的位置,並阻止它存取網絡:
啟動伺服器前,先建立其資料目錄,並將指定版本的套件加入 npm 快取。這樣,npx --offline 就能在停用網絡存取的設定檔下啟動伺服器:
套件快取完成後,Codex 就能在沒有網絡存取的情況下啟動記憶伺服器,並將寫入範圍限制在 npm 快取和伺服器的資料目錄。
沙箱實作會將權限設定檔轉換為由作業系統強制執行的限制。網絡代理伺服器的核心請求處理和政策邏輯由三大作業系統共用,而代理伺服器的設定及與沙箱的整合方式則因作業系統而異。我們會先探討共用代理伺服器,再介紹 macOS、Linux 和 Windows 的實作。
為強制執行權限設定檔中的網絡限制,任務執行框架會啟動網絡代理伺服器,並設定沙箱,允許連接至該代理伺服器,同時封鎖直接連接至外部主機。代理伺服器會按照設定檔中的網域規則檢查每個請求,以決定是否轉送。
在 Codex 程式碼庫中,網絡代理伺服器實作於 codex-network-proxy(在新視窗中開啟) crate。任務執行框架將它當作程式庫使用,但也可以將其建置為獨立 CLI(在新視窗中開啟)。啟用後,codex-network-proxy 預設會同時啟動 HTTP 代理伺服器和 SOCKS5 代理伺服器。這些代理伺服器的位址會透過環境變數,傳給沙箱啟動的處理程序。除了注入 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY 等標準環境變數,系統也會注入多個常見的應用程式專用環境變數(在新視窗中開啟),例如 PIP_PROXY。不過,並非所有程式都會遵循這些環境變數。如果程式嘗試直接連接至外部主機,作業系統的沙箱限制就會將其封鎖,下文各平台的章節會詳細說明。
網絡代理伺服器負責實施權限設定檔中定義的網絡限制。例如,前文的 dev 設定檔允許對 *.openai.com 發出請求,並明確拒絕對 evil.example 發出請求。當請求的目標網域不符合任何允許或拒絕規則時,代理伺服器可以暫停該請求,並交由任務執行框架審批。與 Shell 指令範例一樣,Codex 可能直接詢問使用者,也可能將請求轉交自動審查(在新視窗中開啟)。收到決定後,代理伺服器會允許請求繼續,或以錯誤回應拒絕請求。
這裏的先後次序很重要,因為即使只是 DNS 查詢,也可能洩漏編碼在主機名稱中的資訊。因此,代理伺服器只會在確定請求獲允許或批准後,才解析請求中的主機名稱。請注意,範圍過廣的萬用字元規則,或允許存取 DNS 服務,仍可能讓資料透過 DNS 外洩。
在 macOS 上,Codex 使用 Seatbelt(在新視窗中開啟),這是 Apple 由核心強制執行的沙箱機制。Seatbelt 政策以沙箱設定檔語言(Sandbox Profile Language,SBPL)編寫。這是一種以 Scheme 為基礎、用於表達沙箱限制的語言。Codex 透過 macOS 的 /usr/bin/sandbox-exec 指令呼叫 Seatbelt。與 codex sandbox 一樣,它先接受描述沙箱的選項,後面再接要執行的指令:
PROFILE 是一個 SBPL 字串,內含用於設定沙箱的項目。例如,以下 SBPL 片段會讓 /dev/null 和 /dev/zero 在沙箱政策下可供讀寫:
當呼叫沙箱時一併啟用網絡代理伺服器,系統會將如下規則注入設定檔,把連線限制於適當的本機連接埠:
Codex 的基礎設定檔以 (deny default) 開始,因此除非明確允許,否則對外連線仍會被封鎖。
最後,SBPL 可以包含使用 (param) 的預留位置:
這些預留位置會由傳給 sandbox-exec 的 -Dkey=value 選項填入。
為實作自己的沙箱 API,Codex 從一份基礎政策(在新視窗中開啟)開始,建立傳給 (在新視窗中開啟)sandbox-exec 的引數清單,再利用 permission_profile 和其他情境資訊加以調整,產生完整的 Seatbelt 設定檔。產生的設定檔及隨附的 -D 引數,會設定由 Seatbelt 強制執行的限制;網絡代理伺服器則會強制執行額外的網絡規則。完整引數清單組合好後,呼叫 sandbox-exec 就很直接。
要產生正確的 SBPL 並不容易,因為 Apple 沒有提供供第三方使用的語言文件。事實上,man sandbox-exec 寫明 The sandbox-exec command is DEPRECATED(透過 man 3 sandbox_init 記錄的 sandbox_init() 程式庫函式亦已棄用)。儘管有棄用警告,macOS 仍在 /usr/share/sandbox 中隨附 Seatbelt 設定檔,而包括 Google Chrome 和 Chromium 在內(在新視窗中開啟)的第三方軟件,也仍然依賴 Seatbelt。因此,我們計劃在可見的將來繼續使用 Seatbelt。
為在 Linux 上建立沙箱,Codex 結合使用 bubblewrap(在新視窗中開啟)(bwrap)和 seccomp-bpf(在新視窗中開啟)。前者是建立隔離環境的命令列工具,後者則是用於篩選系統呼叫的 Linux 核心機制。名為 codex-linux-sandbox 的內部輔助程式負責協調設定。與 macOS 上的 sandbox-exec 一樣,它先接受沙箱設定,後面再接要執行的指令:
當需要隔離檔案系統或透過代理伺服器路由時,codex-linux-sandbox 會呼叫 bwrap,建立初始沙箱環境。然後,bwrap 會在沙箱內啟動 codex-linux-sandbox --apply-seccomp-then-exec。這次第二輪呼叫會使用 seccomp-bpf,先套用額外限制,再執行使用者的指令。
為建立初始沙箱環境,Codex 使用 bubblewrap,在獨立的掛載命名空間中建立檔案系統視圖,反映權限設定檔中的檔案系統規則。由於這是沙箱實作的核心,Codex 會隨附自己的 bwrap 副本,以備使用者尚未安裝。不過,若在 PATH 中找到相容版本,Codex 會優先使用已安裝的相容版本 (在新視窗中開啟)bwrap(在新視窗中開啟)。實際觀察發現,某些 Linux 發行版預設會停用使用者命名空間的存取(在新視窗中開啟),但會為系統的 bwrap 設置例外。
與 sandbox-exec 一樣,bwrap 先接受沙箱設定,後面再接要在沙箱內執行的指令。bwrap 不使用 SBPL 這類自訂設定語言,而是透過個別旗標進行設定。Codex 使用以下選項建立檔案系統視圖:
--bind:指定可寫入的檔案或目錄--ro-bind:指定唯讀的檔案或目錄--perms 000 --tmpfs DIR --remount-ro DIR:拒絕存取DIR--perms 000 --ro-bind-data FD FILE:拒絕存取FILE(其中FD是指向/dev/null的已開啟檔案描述符)
為透過這些選項套用拒絕存取的 glob 模式,Codex 會在啟動每條指令前,將模式展開為具體路徑。之後新增的匹配路徑,不會自動加入該指令的沙箱限制。
Codex 也會指定 --unshare-ipc 和 --unshare-pid 等選項,防止沙箱存取主機上的其他類型資源,因此 bubblewrap 的作用不只限於檔案可見性。
使用 bubblewrap 時,只要網絡功能已停用,或連線必須經過網絡代理伺服器,Codex 就會傳入 --unshare-net,為沙箱建立新的網絡命名空間。然後,我們會使用 seccomp-bpf,對指令可用的網絡系統呼叫和通訊端家族施加額外限制。
具體而言,我們使用 seccompiler crate(在新視窗中開啟),根據所需的篩選條件動態編譯 BPF 程式(在新視窗中開啟),並將其套用至沙箱內的啟動器處理程序,讓整個處理程序樹繼承這些限制。因此,bwrap 不會直接執行使用者的指令,而是執行 codex-linux-sandbox 啟動器,先傳入啟動器本身的設定引數,再接上使用者的指令:
為在不提升權限的情況下套用 seccomp 篩選器,啟動器會設定 Linux 的 no_new_privs 旗標(在新視窗中開啟)。子處理程序會繼承這個旗標,防止它們在執行另一個程式時(例如 setuid 可執行檔)取得額外權限。
seccomp 篩選器的內容取決於網絡設定。停用網絡存取時,我們會封鎖多項與網絡相關的系統呼叫,例如 connect(2) 和 bind(2)。不過,當沙箱啟用網絡代理伺服器時,我們會允許 IP 通訊端,以便連接至 codex-linux-sandbox 建立的 TCP 監聽器;但預設會封鎖建立獨立 Unix 網域通訊端,因為它們可能意外開放對主機資源的存取。
當沙箱設定需要使用網絡代理伺服器時,Codex 任務執行框架會建立一個代理伺服器實例,供同一 Codex 對話串中多次呼叫 codex-linux-sandbox 時重用。每個沙箱都需要一種方式,從其隔離的網絡命名空間連接至該共用代理伺服器。Codex 會在該命名空間內提供回送 TCP 監聽器,並安排沙箱外的處理程序接受其連線,再轉送至代理伺服器。
下圖以一個代理伺服器端點說明這項設定,最後一張圖則展示其中一條經過該端點的連線。啟動 bubblewrap 前,codex-linux-sandbox 會建立一對 Unix 通訊端作為控制通道,並將自身分叉。子處理程序會執行 run_host_bridge(),並等待透過該通道接收監聽器的檔案描述符:
在此例中,父處理程序使用 exec,將其程式映像替換為 bwrap。這會設定沙箱,並在沙箱內啟動 codex-linux-sandbox --apply-seccomp-then-exec,同時傳遞控制通道的檔案描述符(FD):
在沙箱的網絡命名空間內,第二次呼叫的 codex-linux-sandbox 會建立回送 TCP 監聽器,並透過通訊端傳送其檔案描述符。監聽器仍與沙箱的網絡命名空間關聯,因此留在沙箱外的子處理程序能接受沙箱內程式的連線,同時在主機的網絡命名空間中建立上游連線。傳遞完成後,兩個處理程序都會關閉各自的控制通道描述符,而沙箱內的處理程序也會關閉其持有的監聽器副本。
TCP 監聽器準備就緒後,沙箱內的處理程序會設定適當的 HTTP_PROXY(在新視窗中開啟) 及相關環境變數值,使其指向該監聽器。接着,它會先套用 seccomp,再分叉並執行使用者的指令:
沙箱外的處理程序會保持監聽器開啟。每接受一個連線,它就會連接至已設定的代理伺服器,並雙向轉送資料。
這套額外機制讓指令擁有自己的網絡命名空間,包括獨立的回送介面。在 macOS 上,Seatbelt 允許指令直接連接至主機回送介面上的指定連接埠。在 Linux 上,指令則連接至其隔離命名空間內的監聽器,再由沙箱外的處理程序將這些連線轉送至已設定的代理伺服器。透過傳遞描述符,這種連線方式無須讓指令存取主機的網絡命名空間。
今年較早前,我們實作了 Windows 沙箱,並撰文介紹我們在 Windows 上的沙箱開發工作。此後,Microsoft 推出了名為 MXC 的程式庫,以及 Windows 作業系統內用於隔離處理程序的新功能。我們目前正以採用 MXC 程式庫的沙箱取代現有沙箱。
MXC(Microsoft eXecution Container)是 Microsoft 推出的沙箱化程式碼執行系統(在新視窗中開啟),支援 Windows、Linux 和 macOS 上的多種隔離後端。Codex 在相容的 Windows 裝置上支援以 MXC 為基礎的沙箱,利用原生處理程序隔離功能,限制在使用者現有環境內執行的指令。
我們正逐步改用 MXC,以提升安全性和易用性,同時解決現有 Windows 沙箱的幾項限制:
設定沙箱需要提升權限或管理員權限
ACL 檢查和設定操作耗用資源且速度緩慢
沙箱設定狀態會持續保留在主機上,包括
ACL
防火牆規則
沙箱使用者
控制平面檔案
MXC 提供一套 JSON 設定結構定義(在新視窗中開啟)。Codex 使用 MXC SDK(在新視窗中開啟),按照該結構定義建立執行請求,其中包含指令、工作目錄、環境和權限。這些權限涵蓋檔案系統和網絡存取,以及桌面和剪貼簿等 Windows 資源。
Codex 對幾項控制措施採用固定設定,以兼顧相容性和安全性。它允許讀取登錄,並保留 PowerShell 啟動時所需的 Win32k 和桌面存取權限。剪貼簿存取、輸入注入,以及桌面和系統設定控制功能均會停用。最後,MXC 也不得以修改主機檔案系統權限作為後備方案。
Codex 會將權限設定檔中的檔案系統和網絡規則轉換為 MXC 設定。以先前的 dev 設定檔為例,並假設:
C:\、D:\和Z:\是電腦上僅有的本機磁碟機。工作區根目錄和工作目錄均為
C:\work\demo。使用者的主目錄是
D:\Users\dev,因此~/build-cache會解析為D:\Users\dev\build-cache。拒絕存取的 glob 模式只會匹配
C:\work\demo\config\dev.env和C:\work\demo\config\prod.env。
相應的 MXC 設定將包括:
MXC 的檔案系統政策預設會拒絕存取。因此,Codex 會為本機磁碟機根目錄加入唯讀授權,以提供此設定檔所允許的廣泛讀取權限。這些授權會遞迴套用,但仍受使用者現有的作業系統權限約束。
有一點需要注意:磁碟機根目錄的可寫入授權不會遞迴套用,因此 Codex 會將授權範圍擴展至磁碟機現有的直接子項目。
較具體的路徑會覆寫上層路徑的授權,因此即使 C:\ 為唯讀,其下的 C:\work\demo 仍可設為可寫入,而 C:\work\demo\.git 則維持唯讀。
當不同的路徑寫法或符號連結/接合點別名指向同一路徑時,MXC 會採用較嚴格的權限:拒絕存取優先於唯讀,而唯讀優先於讀寫。
MXC 只接受具體的拒絕存取路徑,因此 Codex 會在啟動前,將拒絕存取的 glob 模式展開為匹配的檔案和目錄。指令執行期間,新增且匹配 glob 模式的路徑不會自動加入。
*.openai.com 等網域規則,由前述共用的 Codex 網絡代理伺服器強制執行。Codex 在沙箱外執行該代理伺服器,並透過前文提及的相同標準 *_PROXY 環境變數,將其位址傳給指令。MXC 會封鎖直接對外連線,但允許主機回送連線,包括對代理伺服器的存取。其他本機服務仍可連接。
在 macOS、Linux 和 Windows 上,任務執行框架均使用相同的沙箱 API,按照權限設定檔啟動指令。各平台專屬的實作會處理套用這些限制所需的設定。
編寫和執行程式碼,讓智能代理能靈活解決軟件開發以外的問題。Codex 沙箱讓它們能在使用者現有環境中運用這項能力,同時明確限制檔案系統和網絡存取。沙箱是任務執行框架內可重用的基礎元件,而 codex sandbox 指令則讓你自行建立的工具也能使用它。
隨着智能代理承擔更多任務,我們希望讓沙箱技術能實際應用於更多工具和環境。這意味着要讓權限設定更容易,並在作業系統推出更完善的保護機制時加以運用。我們的目標是擴展智能代理的能力,同時讓人們掌控它們可存取的資源。


