Windows 沙盒

若 Codex 無法完成 elevated 沙盒設定，最常見原因 如下：

• Windows UAC 或系統管理員提示遭到拒絕，
• 電腦不允許建立本機使用者或群組，
• 電腦不允許變更防火牆規則，
• 電腦封鎖沙盒使用者所需的登入權限，
• 或其他企業原則封鎖部分設定流程。

可嘗試的做法：

1. 請再次嘗試設定 elevated 沙盒；若環境允許， 請核准系統管理員提示。
2. 若公司的筆記型電腦封鎖這項操作，請詢問 IT 團隊，確認該電腦 是否允許經系統管理員核准的設定，包括建立本機使用者或群組、設定防火牆， 以及授予沙盒使用者所需的登入權限。
3. 若預設設定仍然失敗，請使用 unelevated 沙盒， 以便在調查問題期間繼續工作。

這表示 Codex 無法在你的電腦上完成防護較強的 elevated 沙盒 設定。

• Codex 仍可在沙盒模式下執行。
• 此模式仍會套用以 ACL 為基礎的檔案系統界限，但不會使用 elevated 的獨立沙盒使用者界限，且網路 隔離較弱。
• 這是實用的備援方案，但不是企業長期使用的首選 組態。

若你使用受管理的企業筆記型電腦，最佳的長期解決方式通常是請 IT 團隊協助， 讓 elevated 沙盒正常運作。

若沙盒中的指令執行失敗並顯示錯誤 1385，表示 Windows 拒絕沙盒使用者使用 啟動指令所需的登入類型。

實際上，這通常表示 Codex 已成功建立沙盒使用者， 但 Windows 原則仍阻止這些使用者在沙盒中 執行指令。

處理方式：

1. 請詢問 IT 團隊，裝置原則是否已將必要的登入權限 授予 Codex 所建立的沙盒使用者。
2. 若問題只影響部分電腦或團隊， 請比較群組原則或 OU 是否存在差異。
3. 如果需要立即繼續工作，請暫時使用 unelevated 沙盒，等待 原則問題調查完成。
4. 請傳送 CODEX_HOME/.sandbox/sandbox.log，並附上 Windows 版本以及 失敗情況的簡短說明。

Codex 可能會警告某些資料夾允許 Everyone 寫入。

如果看到此警告，表示這些資料夾的 Windows 權限設定過於寬鬆， 導致沙盒無法完整保護這些資料夾。

處理方式：

1. 檢查 Codex 在警告中列出的資料夾。
2. 若這項變更適合您的環境，請移除 Everyone 對這些資料夾的 寫入權限。
3. 修正這些權限後，請重新啟動 Codex 或再次執行沙盒設定。

如果不確定如何變更這些權限，請向 IT 團隊尋求協助。

部分 Codex 對話會刻意在沒有對外網路存取權的情況下執行， 具體取決於所使用的權限模式。

如果任務因無法連上網路而失敗：

1. 檢查該任務原本是否應在網路停用的情況下執行。
2. 如果原本預期可以存取網路，請重新啟動 Codex 並再試一次。
3. 如果問題持續發生，請收集沙盒記錄，讓團隊檢查 這台電腦的沙盒是否處於設定不完整或故障狀態。

以下變更可能導致這種情況：

• 移動程式碼庫或工作區，
• 變更電腦權限，
• 變更 Windows 原則，
• 或進行其他系統組態變更。

可嘗試以下做法：

1. 重新啟動 Codex。
2. 再次嘗試設定 elevated 沙盒。
3. 若問題仍未解決，請使用 unelevated 沙盒作為 暫時的備用方案。
4. 收集沙盒記錄以供審查。

如果問題仍未解決，請傳送：

• CODEX_HOME/.sandbox/sandbox.log

一併提供以下資訊也會很有幫助：

• 您嘗試執行之操作的簡短說明，
• 是 elevated 沙盒失敗，還是使用了 unelevated 沙盒，
• App 中顯示的任何錯誤訊息，
• 是否看到 1385，或其他 Windows 或 PowerShell 錯誤，
• 以及您使用的是 Windows 11 還是 Windows 10。

請勿傳送：

• CODEX_HOME/.sandbox-secrets/ 的內容

系統可能缺少部分原生相依項目所需的 C++ 開發工具：

• Visual Studio Build Tools（C++ 工作負載）
• Microsoft Visual C++ Redistributable (x64)
• 使用 winget 時，請執行 winget install --id Microsoft.VisualStudio.2022.BuildTools -e

安裝完成後，請完全關閉 VS Code，再重新啟動。