管理 Agent 聯網許可權

你是 Codex 聯網許可權設定顧問，幫我按最小化原則決定一個雲端任務該不該聯網、怎麼開才安全。

【角色】
你清楚聯網的兩個階段（setup 準備階段和 agent 執行階段）許可權差異、為什麼 POST 比 GET 更危險、新手該怎麼保守地開、常見的聯網踩坑。

【輸入】
- 任務為什麼需要聯網（裝依賴 / 調 API / 抓資料）：___
- 是隻讀取還是要寫外部狀態：___
- 涉及哪些域名 / 服務：___
- 是否處理敏感資料：___

【工作流程】
1. 判斷聯網是必需還是能用快取 / 本地替代
2. 區分 setup 階段和 agent 階段各自該開多少
3. 按只讀優先、POST 嚴格審批的原則定許可權
4. 給域名白名單和用完收回的建議

【輸出規範】
▌一、是否真需要聯網 + 能否替代
▌二、兩階段的許可權分配
▌三、域名白名單 + 讀寫許可權建議
▌四、風險提醒 + 用完怎麼收回

【硬約束】
- 聯網預設關閉，能用本地或快取就不開
- POST 等寫請求必須明確審批，不預設放行
- 只放行必要域名，不開放全網
- 處理敏感資料時警惕儲存庫內容或 token 外洩
- 不確定的許可權機制標註需查官方文件

Codex 預設會限制 agent 階段的網路訪問。官方這樣設計，是為了降低 prompt injection、程式碼或金鑰外傳、惡意依賴下載、許可證汙染等風險。

新手要先記住一句話：聯網許可權不是“越開越方便”，而是“任務確實需要時才開，且只開到剛好夠用”。

先理解兩個階段

在 Codex cloud 裡，環境通常有兩個階段：

• setup 階段：可以聯網安裝依賴。
• agent 階段：預設不聯網，除非你給環境開啟 agent internet access。

這能解決一個常見矛盾：專案構建需要下載依賴，但 agent 實際改程式碼時不一定需要訪問網際網路。把兩個階段分開，新手更容易控制風險。

在 Codex app、CLI、IDE extension 裡，預設 workspace-write sandbox 也會關閉命令的網路訪問。需要時可以在設定裡顯式開啟，但不要把它當作預設設定。

什麼時候應該開

可以考慮開啟：

• 任務必須讀取外部 issue、API 文件或遠端資源。
• 測試需要訪問明確的內網或測試環境。
• cloud agent 階段確實需要拉取 setup 後才知道的資源。

不建議開啟：

• 只是讓 Codex 閱讀本地專案。
• 只是修本地測試失敗。
• 只是需要安裝依賴，setup 階段已經能完成。
• 你要處理包含金鑰、客戶資料或未公開程式碼的儲存庫。

新手應該怎麼開

優先按環境單獨設定，不要做全域放開。官方文件裡，Codex cloud 支援 domain allowlist 和 allowed HTTP methods。

推薦順序：

1. 先保持 Off，看任務是否真的失敗。
2. 如果只是依賴下載，優先放在 setup 階段解決。
3. 如果 agent 階段必須聯網，從空 allowlist 或 Common dependencies 開始。
4. 只加任務需要的域名。
5. HTTP methods 優先限制在 GET、HEAD、OPTIONS。
6. 任務完成後審查 work log、diff 和測試結果。

本地 Codex 如果確實要讓 workspace-write 命令聯網，可以顯式設定：

[sandbox_workspace_write]
network_access = true

這不是新手預設設定。只有在你理解風險、信任儲存庫、並且知道要訪問什麼網路資源時再開。

為什麼 POST 更危險

很多外傳動作依賴寫入型請求，例如 POST、PUT、PATCH、DELETE。官方建議把 allowed HTTP methods 限制在 GET、HEAD、OPTIONS，就是為了減少 agent 把本地資訊傳送出去的機會。

這不能消除所有風險，但能減少一類常見事故。

新手常見坑

• 看到依賴安裝失敗，就直接給 agent 階段開全網。
• 用 All unrestricted 解決一次問題，然後忘記關。
• 把 GitHub issue、README、網頁內容當成可信指令。
• 只看任務是否完成，不看 work log 裡訪問過哪些 URL。
• 允許寫入型 HTTP methods，卻沒有明確理由。
• 在含有 secrets 的儲存庫裡開啟高許可權聯網。

怎麼判斷設定正確

成功標準：

• setup 階段能安裝依賴。
• agent 階段只訪問你允許的域名。
• 不需要聯網的任務仍然能在離線 agent 階段完成。
• 被阻止的請求能在記錄裡看見原因。
• 任務完成後 diff 可審查、測試可復現。
• 沒有把網路許可權作為永久預設值。

如果你不知道該允許哪個域名，先不要放開全網。讓 Codex 報出缺失資源，再按記錄逐個加。

複查清單

• 是否真的需要 agent 階段聯網，而不是 setup 階段聯網。
• 是否只允許了任務所需域名，而不是 All unrestricted。
• 是否限制了寫入型 HTTP methods。
• 是否檢查了 work log、diff、測試結果和異常訪問記錄。
• 是否在任務結束後把臨時網路許可權恢復到預設狀態。

接下來去哪

官方資料

• OpenAI Codex: Agent internet access
• OpenAI Codex: Agent approvals and security