雲端環境

你可以使用環境來控制 Codex 在雲端聊天中會安裝什麼、執行什麼。例如，你可以補充依賴、安裝 lint / formatter 等工具，以及設定環境變數。

在 Codex 設定 中設定環境。

Codex 雲端聊天的執行方式

當你提交一個提示詞時，會發生以下事情：

1. Codex 建立一個容器，並在你選定的分支或 commit SHA 上檢出儲存庫。
2. Codex 執行你的設定指令碼；如果恢復的是快取容器，還會額外執行可選的維護指令碼。
3. Codex 會應用你的網際網路存取設定。設定指令碼階段預設可聯網；智能體階段預設關閉網際網路存取，但你可以按需啟用受限存取或無限制存取。詳見智能體網際網路存取。
4. 智能體在終端迴圈中執行命令，編輯程式碼、執行檢查並嘗試驗證結果。如果儲存庫中包含 AGENTS.md，智能體會用它來定位專案特定的 lint 和測試命令。
5. 智能體完成後，會展示最終答覆以及它改動過檔案的 diff。你可以繼續追問，或直接開啟 pull request。

預設 universal 映象

Codex 智能體預設執行在名為 universal 的容器映象中，該映象預裝了常見語言、包管理器和開發工具。

在環境設定中，可以通過 Set package versions（設定包版本） 固定 Python、Node.js 以及其他執行時的版本。

codex-universal 為了速度和便利性預裝了常見語言，但你仍然可以通過設定指令碼向容器額外安裝所需軟體包。

環境變數與金鑰（Secrets）

環境變數（Environment variables） 會在聊天的整個生命週期內生效，包括設定指令碼階段和智能體執行階段。

金鑰（Secrets） 與環境變數類似，但有兩點不同：

• 它們會以額外加密層進行儲存，只會在聊天執行時解密。
• 它們只會提供給設定指令碼使用。出於安全原因，在智能體階段開始前，這些金鑰會被移除。

自動設定

對於使用常見包管理器的專案，例如 npm、yarn、pnpm、pip、pipenv 和 poetry，Codex 可以自動安裝依賴和工具。

手動設定

如果你的開發環境更復雜，也可以提供自定義設定指令碼。例如：

# Install type checker
pip install pyright

# Install dependencies
poetry install --with test
pnpm install

容器快取

為了加快新聊天和後續追問的啟動速度，Codex 會快取容器狀態，最長可保留 12 小時。

當環境進入快取狀態時：

• Codex 會克隆儲存庫並檢出預設分支。
• Codex 會執行設定指令碼，並把最終容器狀態快取下來。

當某個快取容器被恢復時：

• Codex 會檢出該聊天指定的分支。
• Codex 會執行維護指令碼（可選）。這在設定指令碼基於較早提交執行、而依賴需要更新時尤其有用。

如果你修改了設定指令碼、維護指令碼、環境變數或金鑰，Codex 會自動使快取失效。如果儲存庫變化導致現有快取狀態不再相容，可以在環境頁面點選 Reset cache（重置快取）。

網路存取與代理

在設定指令碼階段，環境預設可存取網際網路，以便安裝依賴。智能體階段的網路存取預設關閉，但你可以按需設定為受限存取或無限制存取。詳見智能體網際網路存取。

出於安全和濫用防護考慮，環境會執行在一個 HTTP/HTTPS 網路代理之後。所有向外的網際網路流量都會經過該代理。

來源：</zh-TW/docs/environments/cloud-environment> 更新時間：2026-04-30（UTC）