沙盒為智慧體劃定可自主作業的範圍,讓你無須授予它對電腦的完整存取權。在 ChatGPT 桌面應用程式、Codex CLI 或 IDE 擴充功能中進行本機對話時,對話中的指令預設會在受限環境中執行。
這個環境決定智慧體可以自行執行哪些操作,例如可以修改哪些檔案,以及指令能否使用網路。只要任務在這些限制範圍內,智慧體就能繼續執行,無須停下來請你確認。需要超出範圍時,就會進入核准流程。
沙盒與核准是兩種相互配合的控制機制。沙盒界定技術上可執行的操作範圍,核准政策則決定智慧體何時必須先停下來要求核准,才能超出這個範圍。
沙盒限制哪些操作
除了內建的檔案操作,沙盒也會限制智慧體啟動的指令。智慧體執行 git、套件管理工具或測試執行器等工具時,這些指令也受相同的沙盒限制。
Codex 使用各作業系統的原生機制來強制執行限制。macOS、Linux、WSL2 和原生 Windows 的實作方式各有不同,但各用戶端採用相同的原則:為智慧體劃定明確的作業範圍,讓它能在範圍內自主執行例行任務。
為什麼需要沙盒
沙盒能減少反覆核准的負擔。在你已核准的範圍內,智慧體可以讀取檔案、進行編輯及執行專案的例行指令,無須每執行一個低風險指令都請你確認。
沙盒也讓你更清楚可以憑什麼信任智慧體執行任務。除了相信智慧體會依照你的意圖行事,你還可以依靠系統強制執行的限制。這樣一來,你更容易放心讓智慧體獨立作業,也能預期它何時會停下來尋求協助。
開始使用
預設權限模式會自動啟用沙盒。
先決條件
在 macOS 上,沙盒使用系統內建的 Seatbelt 框架,無須額外設定即可使用。
在 Windows 上,透過 PowerShell 執行 Codex 時,Codex 會使用原生的 Windows 沙盒。透過 WSL2 執行時,則會使用 Linux 沙盒。
在 Linux 和 WSL2 上,請先使用套件管理工具安裝 bubblewrap:
sudo apt install bubblewrapsudo dnf install bubblewrapCodex 會使用第一個找到的 bwrap 執行檔,搜尋順序由 PATH 決定。如果找不到 bwrap 執行檔,Codex 會改用隨附的輔助程式,但系統必須允許非特權使用者建立使用者命名空間,輔助程式才能運作。安裝發行版中提供 bwrap 的套件,可確保這項設定穩定運作。
如果缺少 bwrap,或輔助程式無法建立所需的使用者命名空間,Codex 會在啟動時顯示警告。如果發行版透過 AppArmor 限制建立使用者命名空間,建議載入 bwrap 的 AppArmor 設定檔,讓 bwrap 能繼續運作,無須在整個系統停用這項限制。
Ubuntu AppArmor 注意事項: 在 Ubuntu 25.04 上,從 Ubuntu 套件庫安裝 bubblewrap 後,應可直接使用,無須額外設定 AppArmor。bwrap-userns-restrict 設定檔隨 apparmor 套件提供,路徑為 /etc/apparmor.d/bwrap-userns-restrict。
在 Ubuntu 24.04 上,即使已安裝 bubblewrap,Codex 仍可能顯示警告,指出無法建立所需的使用者命名空間。請複製並載入下列額外設定檔:
sudo apt update
sudo apt install apparmor-profiles apparmor-utils
sudo install -m 0644 \
/usr/share/apparmor/extra-profiles/bwrap-userns-restrict \
/etc/apparmor.d/bwrap-userns-restrict
sudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrictapparmor_parser -r 會將設定檔載入核心,無須重新開機。你也可以重新載入所有 AppArmor 設定檔:
sudo systemctl reload apparmor.service如果沒有這個設定檔,或載入後仍無法解決問題,可以使用下列指令停用 AppArmor 對非特權使用者建立使用者命名空間的限制:
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0透過工作雲端存取本機電腦
當任務透過工作雲端存取本機電腦時,對話由 OpenAI 雲端協調。適用的沙盒限制取決於每個步驟的執行位置:
- 雲端執行: 工作雲端容器使用現有的工作雲端政策。桌面瀏覽器的網站規則不會自動套用到雲端瀏覽器。
- 本機執行: 在已連線的電腦上執行步驟時,須遵循該環境支援的本機執行要求。
對於可存取本機的「工作」模式和 dot,啟用受管理政策後,共用的雲端協調器會套用其支援的全域政策。工作雲端容器和 dot 雲端電腦各有自己的執行設定與要求。請分別測試本機與雲端執行,確認各環境適用哪些控制措施。某個環境的政策不會授予另一個環境的存取權。
同一項政策內,設定的優先順序由高至低為:特定作業系統的環境覆寫設定 → 適用於所有作業系統的環境覆寫設定 → 全域設定。即使優先順序較低的政策更具體,仍以優先順序較高的政策為準。本機執行時,MDM 和舊版受管理裝置要求優先於智慧體安全性設定,而智慧體安全性設定又優先於裝置上的系統要求檔案。
請參閱受管理的設定,瞭解各欄位的合併規則與執行階段限制,並在工作模式的本機安全性和工作模式的雲端安全性中確認實際生效的檔案與網路限制。
權限的運作方式
使用用戶端的權限控制項,即可變更 Codex 處理本機操作的方式。
核准機制決定 Codex 何時會在操作前暫停,沙盒則決定指令可以存取哪些檔案與網路資源。如果有不同的核准範圍可選,例如只核准一次或在整個工作階段內核准,請選擇能讓任務繼續執行的最小範圍。預設應將存取範圍限制在專案內。處理彼此無關的程式碼庫時,請使用不同的專案或工作樹,避免擴大存取範圍。
ChatGPT 工作會在受管理的隔離環境中執行程式碼與 shell 指令。可用功能取決於工作區政策及各工具的控制設定。如果有這項設定,請前往設定 > 資料控制 > 工作網路存取,管理程式碼與 shell 指令的網路存取權。開啟允許存取公用網際網路後,這些指令即可連上公用網際網路。關閉時,指令只能連線到受管理允許清單中列出的必要主機名稱。
網頁搜尋、外掛程式和遠端瀏覽器各有獨立的控制設定。目前執行的程式碼或 shell 指令結束,且「工作」模式重新整理執行環境後,變更才會生效。ChatGPT 網頁版不提供本機 Codex 沙盒或核准模式選擇器。
在 ChatGPT 桌面應用程式中,請使用撰寫工具下方的權限控制項。視你的設定而定,選單可能包含要求核准、適用於符合條件之核准要求的代我核准、完整存取權,以及具名或自訂的權限設定檔。
選擇一種模式即可試用這個文件範例。這不會變更你的 ChatGPT 或 Codex 權限。
Approve for me
Approve for me keeps the same workspace-write sandbox as Ask for approval, but eligible approval requests are routed through automatic review instead of showing a prompt for manual approval. More details about automatic review.
- Sandbox
workspace-write- Approvals policy
on-request- Reviewer
auto_review
在 CLI 中輸入
/permissions,即可開啟權限選擇器並變更目前使用的權限設定檔。
在 IDE 擴充功能中,請使用撰寫工具下方的權限控制項。視你的設定而定,選單可能包含要求核准、適用於符合條件之核准要求的代我核准、完整存取權,以及具名或自訂的權限設定檔。
設定預設值
若要在每次啟動時採用相同的行為,請在 config.toml 中設定預設值。基本設定說明設定檔的運作方式,設定參考則詳細列出 sandbox_mode、approval_policy、approvals_reviewer 和 sandbox_workspace_write.writable_roots 等設定鍵。透過這些設定,你可以決定智慧體預設能自主執行哪些操作、可以寫入哪些目錄、何時應暫停並要求核准,以及由誰審查符合條件的核准要求。
常見的沙盒模式如下:
read-only:智慧體可以檢視檔案,但必須取得核准才能編輯檔案或執行指令。workspace-write:智慧體可以讀取檔案、在工作區內編輯檔案,並在此範圍內執行例行的本機指令。這是本機作業的預設模式,可減少操作時的中斷。danger-full-access:智慧體執行時不受沙盒限制。這個模式會移除檔案系統與網路的存取限制,只有在你希望智慧體以完整存取權執行操作時才應使用。
常見的核准政策如下:
on-request:智慧體預設在沙盒內作業,需要超出範圍時會要求核准。never:智慧體不會停下來要求核准。
Codex 和 ChatGPT 工作已不再提供 untrusted 作為可選的核准政策。如果現有設定使用這個值,請參閱從已停用的 untrusted 核准政策遷移。
採用互動式核准時,你也可以透過 approvals_reviewer 選擇由誰審查核准要求:
user:向使用者顯示核准提示。這是預設值。auto_review:將符合條件的核准要求交給負責審查的智慧體(請參閱自動審查)。
完整存取權是指同時使用 sandbox_mode = "danger-full-access" 和 approval_policy = "never"。風險較低的本機自動化預設組合則是 sandbox_mode = "workspace-write" 搭配 approval_policy = "on-request",也可以使用對應的 CLI 旗標 --sandbox workspace-write --ask-for-approval on-request。接著,你可以保留 approvals_reviewer = "user" 以手動核准,或設定 approvals_reviewer = "auto_review" 以自動審查核准要求。
如果智慧體需要在多個目錄中作業,你可以指定可寫入的根目錄,擴大它能修改檔案的範圍,同時保留沙盒限制。如果需要擴大或縮小信任範圍,請調整預設的沙盒模式與核准政策,避免依賴一次性的例外。
如果工作流程需要特定例外,請使用規則。對於在沙盒外執行的指令,規則可依指令前綴決定要允許執行、要求核准或禁止執行。這通常比全面擴大存取範圍更合適。如需瞭解如何開啟 IDE 專屬設定,請參閱 Codex IDE 擴充功能設定。
即使可使用自動審查,沙盒的限制範圍也不會改變。對於觸及沙盒邊界而需要核准的要求,自動審查是 approvals_reviewer 的其中一個選項。這類要求包括提高沙盒權限、開放遭封鎖的網路存取,或執行會產生副作用且仍需核准的工具呼叫。沙盒內已允許的操作可直接執行,無須額外審查。如需瞭解審查智慧體的生命週期、觸發審查的事件類型、拒絕要求的含義與設定細節,請參閱自動審查。
各平台的詳細資訊請參閱對應的平台文件。如需瞭解原生 Windows 環境的設定方式、運作行為與疑難排解,請參閱 Windows。如需瞭解管理員要求,以及組織層級對沙盒與核准的限制,請參閱智慧體核准與安全性。