先選工具與你要交出去的權限範圍,再取得對應的設定片段和單次啟動指令。這個產生器把 Codex,Claude Code 及 Gemini CLI 的常見起點放在同一個可比較的介面,幫你避免把「可以寫檔」誤認成「不再詢問」,或把不同產品名稱相似的模式當成同一種保護。

它適合已經知道要用哪一套 AI 寫程式工具,只想先建立一個可回復的權限基線的人。你提供工具與權限偏好,頁面回傳可複製的設定檔內容或一次性指令,以及該選項的限制,風險提醒與官方文件入口。這不是安裝器,也不會替你修改電腦上的任何設定。

先用最小範圍開始

第一次在真實專案中使用時,先選「一般人工核准(建議起點)」或各工具的人工核准基線。先在有版本控制的非敏感專案完成一個小任務,例如修改一個檔案後跑既有測試,再檢查 diff。確認工作流後才評估是否允許網路或減少重複確認。

「完全存取」不是一般的效率選項。它可能取消沙盒或核准,也可能兩者都取消。即使某個工具允許寫入,仍可能受到管理員設定,既有 allow 與 deny 規則,工作目錄或作業系統權限限制。每個產品的保護範圍不同,不能把一套工具的模式名稱直接套到另一套工具。

產生器怎麼用

  1. 選擇 Codex,Claude Code 或 Gemini CLI。
  2. 選擇權限等級。若不確定,從「一般人工核准(建議起點)」開始。
  3. 閱讀畫面中的「要知道的事」與紅色警告,不只複製指令。
  4. 若要長期保存設定,先備份現有設定檔,再手動合併產生的片段。若只想測試,優先使用一次性啟動指令。
  5. 啟動後用一個無機密的小任務驗證實際提示,可寫範圍和網路行為。完成後重開終端機或改回原本設定。

產生器中的程式碼區可複製。它只輸出文字到你的剪貼簿;它沒有登入,API Key,遠端寫入或套用設定的功能。

範例:讓 Codex 在工作區寫檔並保留核准

在上方選 Codex,再選「一般人工核准(建議起點)」,頁面會產生這組基線:

sandbox_mode = "workspace-write"
approval_policy = "on-request"
approvals_reviewer = "user"

若只想試一次,可先開一個沒有機密的練習資料夾,在該資料夾的終端機執行頁面提供的指令:

codex --sandbox workspace-write --ask-for-approval on-request -c approvals_reviewer=user

這是產生器實際顯示的輸出,不是已在你電腦套用的設定。進入 CLI 後先用 /status 核對目前工作區與權限;若有既存設定或管理政策,應以生效狀態為準。可建立一份虛構三行筆記,再請 Codex 只在同資料夾新增 summary.md;完成時核對原檔不變且摘要符合原文,且沒有修改其他位置。測試結束後離開該次工作階段,正常啟動即可繼續使用原本設定。

若要長期存檔,先備份 ~/.codex/config.toml,逐項合併而非覆蓋整份檔案。已採用 permission profiles 的環境不能混入這組舊式 sandbox 設定;請用官方 profiles 文件選對應寫法。

套用前的核對清單

  • 確認目前所在的資料夾是你願意讓工具讀取或修改的專案,而不是家目錄,憑證目錄或混有客戶資料的工作區。
  • 先查看現有設定檔。不要以產生器片段覆蓋整個 TOML 或 JSON 檔案。
  • JSON 只能包含 JSON。Claude Code 與 Gemini CLI 的「完全存取」說明是註解文字與 CLI 指令,不可把註解貼入 JSON 設定檔。
  • 若使用 Codex,確認你採用的是舊式 sandbox_mode 還是較新的 permission profile。官方提醒不要混用這兩種寫法。
  • 若有公司裝置管理,集中設定或專案規則,先確認它們的優先順序。個人設定不一定是最後生效的設定。
  • 網路,額外可寫入資料夾,瀏覽器登入狀態與外部工具各自是獨立風險,不會因為選了某個「安全模式」自動變安全。

三種工具的關鍵差異

Codex:可寫入範圍和核准是兩個設定

Codex 的 workspace-write 是讓沙盒可寫入工作區的範圍設定,不等於取消核准。產生器的 Codex 基線使用 approval_policy = "on-request",讓越過既定範圍的動作仍可要求確認。若只把 sandbox_mode 設為 danger-full-access,是移除沙盒,不會自動改掉核准政策;--dangerously-bypass-approvals-and-sandbox 才同時繞過兩者,僅應在另行加固的隔離環境中評估。

開啟 network_access 只是在 workspace-write 沙盒中開放網路,不會擴大可寫範圍。需要另一個資料夾時,先理解 --add-dir 或 writable_roots 的影響,再做最小增量。參考:OpenAI 核准與安全說明,沙盒說明 及 CLI 指令參考。

Claude Code:plan 可以探索,不是作業系統唯讀沙盒

Claude Code 的 plan 模式適合作為規劃起點,但不應寫成「所有事情都無法執行」。它能探索並提出操作;實際指令是否需要確認還會受到 session,分類器及受管理設定影響。想用人工核准基線時,選 default。acceptEdits 可以自動接受檔案修改,但 shell 指令和既有規則仍有各自的處理邊界。

Claude Code 沒有單一的「開網路」總開關。WebFetch,WebSearch 與 Bash sandbox 的外連網域及 allow 規則應分開核對。原生 Windows 不支援 Bash sandbox,且 Bash sandbox 不涵蓋檔案工具與 MCP。參考:權限模式,權限規則,設定檔 及 沙盒。

Gemini CLI:與 Antigravity CLI 分開看

Gemini CLI 的 defaultApprovalMode 決定核准模式。default 會在寫檔或執行 shell 指令前要求確認;auto_edit 只自動核准檔案編輯,shell 指令仍會詢問。Policy Engine 可做更細的規則,但也要另外檢查。產生器的 Gemini CLI 選項不等同於 Antigravity CLI 的設定。

Google 的公告指出免費方案與 Google One 使用者已自 2026-06-18 由 Gemini CLI 轉向 Antigravity CLI。若你使用的是 agy 或 Antigravity 介面,請不要複製本頁 Gemini CLI 的 gemini 指令。參考:設定檔,CLI 指令參考,沙盒 及 Policy Engine。

如何回復

長期設定前先把原檔複製到你可辨識的備份位置。若設定由 Git 管理,先看 diff 再提交。測試一次性指令後,關閉該終端機並用未帶參數的正常指令重新開啟。若你改了設定檔,回復備份或手動刪除剛加入的鍵值,再重新啟動工具。

遇到無法預期的自動核准時,先停下工作,查看命令列參數,有效設定來源及任何管理員規則。不要用更高權限模式來排除問題。遇到 JSON 解析錯誤時,先移除註解與尾端逗號,再以官方文件的完整格式核對。

限制與常見問題

產生器測試涵蓋哪些範圍?

已在瀏覽器測試 3 種工具與 5 種選項的切換,原始 HTML 預設輸出與剪貼簿往返,也檢查過 10 段 Codex TOML 與 16 段 JSON 範例可解析。這不等於每一段設定都已在你的作業系統,CLI 版本,公司政策或專案中執行成功。

為什麼同樣叫「完全存取」,三個工具的意思不同?

因為沙盒,核准,檔案工具,shell,網路與集中管理設定並不是同一層控制。名稱只能作為介面選擇,不能作為跨產品的安全保證。請逐一讀取產生器輸出的警告與該工具官方文件。

可以把 Claude Code 或 Gemini CLI 的註解直接貼進 settings.json 嗎?

不可以。JSON 不支援註解。頁面把「完全存取」的設定檔區塊顯示為說明,是要提醒它只能以命令列方式啟用,不是可貼入 JSON 的設定內容。

為什麼不提供 Cursor 或 GitHub Copilot?

第一版只涵蓋本頁逐項比對過官方文件與設定格式的三種 CLI。Cursor 的 CLI 參數官方說明不足,不能把類似產品的設定推定為正確。其他工具應在有可核對的一手文件與獨立審查後再加入。

查證範圍

本頁的設定與說明以 2026-11-08 可讀的一手文件為依據。工具版本與權限設計可能快速改變,預計以每月官方文件比對維護。使用前仍要以當日官方文件和你的實際版本為準。本頁提供比較與設定輔助,不代替資安政策,組織管理規則或隔離環境設計。