文章 / 觀點與方法
5 minAI 工具應用

EPERM: operation not permitted, open:Codex 寫不進第二個資料夾

Codex 寫入另一個資料夾出現 EPERM?以 Windows CLI 的實際失敗與修復,確認 permission profile 的可寫根目錄與驗收方式。

Aaron Huang資深品牌經理

審閱:Aaron Huang · 2026-11-17

EPERM: operation not permitted, open '…\reports\summary.txt'。如果同一段程式能在 Codex 的工作資料夾產出檔案,改存到旁邊的報表資料夾卻失敗,先檢查第二個資料夾是否在可寫範圍內。本文處理 Windows 原生 Codex CLI 的這個情況;一般 PowerShell 也寫不進去時,先處理 Windows 檔案權限。

原因:旁邊的資料夾沒有自動算進工作區

在我們重現的情況,:workspace 允許寫入主要工作區,卻拒絕寫入其外的另一個資料夾。替相同 profile 增加那一個工作區根目錄後,同一段程式便能完成寫入,其他未加入的資料夾仍被拒絕。

這只是一種 EPERM 原因。先用下面的對照確認,別只憑錯誤代碼就放寬整台電腦的存取。

1. 先確定檔案路徑與目前範圍

在一般 PowerShell 執行 codex --version,本例使用 0.169.0。在 Codex 對話用 /status 核對主要工作資料夾與目前權限;需要追查設定來源時用 /debug-config。這兩個互動指令的說明見官方指令表。

例如程式在 C:/work/sales,輸出放在 C:/work/reports,兩者是相鄰資料夾。程式成功讀到報表資料夾,不表示它也有寫入權限;把輸出位置寫成絕對路徑,也不會新增授權。

2. 把第二個資料夾加入目前使用的 permission profile

以下是新版 permission profiles 的設定。若你使用的設定已有 sandbox_mode 或 [sandbox_workspace_write],先沿用既有權限教學辨認設定系統,不要把兩套欄位直接疊在一起。

在實際載入的 config.toml 加入或調整自己的 profile,將路徑換成真正的報表資料夾。default_permissions 是頂層欄位,要放在第一個 [表格] 前面;若已有該欄位,修改原值即可。

default_permissions = "sales-reports"

[permissions.sales-reports]
extends = ":workspace"

[permissions.sales-reports.workspace_roots]
"C:/work/reports" = true

extends 保留工作區 profile 的基礎規則,workspace_roots 再加入報表資料夾。重新啟動 CLI,確認使用的是這個 profile,而不是啟動參數指定的另一套設定。profile 的載入與選取規則以官方 Permissions 文件為準。

3. 用同一個寫入動作驗收

先保留原本失敗的程式與輸出位置,再試一次。成功的標準是:指定的報表檔真的產生、內容正確,而且主要工作區也仍能寫入。

若想先把模型因素排除,可以在該專案的 PowerShell 直接測同一段程式。以下假設原本的程式是 write-report.cjs,第一個參數是輸出資料夾:

codex sandbox --permission-profile sales-reports --cd "C:/work/sales" -- node "C:/work/sales/write-report.cjs" "C:/work/reports"

在 0.169.0 的原生 Windows CLI,指令是 codex sandbox,不再加一個 windows。部分官方範例仍列出 codex sandbox windows;請先以本機 codex sandbox --help 核對語法。這個直接執行程式的檢查不會呼叫模型。

我們用三筆訂單 120、80、50 產出報表::workspace 在第二個資料夾得到 EPERM;加入那個根目錄後寫出 Sales total: 250。同一個新 profile 寫入另一個未加入的相鄰資料夾,仍得到 EPERM。

還是失敗時,依錯誤分流

  • 一般 PowerShell 也寫不進去:先查 Windows 權限、檔案是否被占用與目的地是否唯讀;Codex profile 不會替 Windows 帳號取得系統管理員權限。
  • ENOENT: no such file or directory:先確認輸出資料夾已存在。加入根目錄不會替程式建立它需要的子目錄。
  • 錯誤提到 windows,或找不到程式:查看本機 sandbox 的 help,移除不適用的舊式平台子命令,並確認執行檔完整路徑。
  • 設定改了,實際仍是另一個模式:核對啟動旗標、設定層級與管理政策;沿用權限模式不可用的診斷。

如果要同時處理兩個 repo,CLI 另有 --add-dir,用法見官方旗標。本次實測採用 profile 的 workspace_roots;它也能清楚記下重複工作需要的資料夾。

我們測了什麼

2026-11-16,Windows 原生 PowerShell、Codex CLI 0.169.0、Node.js,使用獨立設定與三筆合成訂單。 直接用 Codex command sandbox 跑同一支報表程式,驗證工作區可寫、第二個資料夾修復前後,以及未加入資料夾仍被拒絕。 沒有跑模型對話;App、WSL、UNC 路徑、受管理電腦與不同 Windows 沙箱實作未測。 官方 Permissions 與 Developer commands 查閱日:2026-11-16。