Codex Config Generator Logo

把設定變成一種自信的節奏

Codex CLI 設定產生器

📘 設定參考

把複雜的 config.toml 變得溫柔、清晰、可控。

依最新版官方設定參考選好範本、調整細節、一鍵帶走。你可以把注意力放在真正重要的工作流。

快速上手 即時預覽 一鍵下載

預設範本

挑一個最接近你需求的起點。

自訂設定

每一個欄位都為了你正在做的工作而存在。

🧭 預設執行設定（未使用 -p 指定設定檔時套用的參數）

選擇產生 config.toml 或管理端 requirements.toml。

user 由使用者審查；auto_review 交由 reviewer 子代理審查；guardian_subagent 為相容舊設定的值。

控制網路搜尋工具的模式。

Windows 沙盒的權限層級（elevated/unelevated）。

內建值為 :read-only、:workspace、:danger-full-access；不可與 sandbox_mode 或 sandbox_workspace_write 同時使用。

允許 shell 工具使用 login-shell 語意；官方預設為 true。

使用 approvals_reviewer = "auto_review" 時套用的本機審查政策。

允許顯示沙盒升級核准提示。

允許顯示 execpolicy 規則核准提示。

允許顯示 MCP elicitation 提示。

允許顯示 request_permissions 工具提示。

允許顯示技能腳本核准提示。勾選任何 granular 子項會自動切換核准策略。

🧠 模型與推理

填模型 ID，例如：gpt-5.6。

/review 專用覆寫模型（留空則沿用目前模型）。

使用 --oss 時的預設本地模型提供者。

模型可用的 tokens 上限。

觸發歷史壓縮的 token 門檻。

total 計算完整內容；body_after_prefix 只計算壓縮前綴之後的成長量。

Codex 進入 Plan 模式時使用的推理強度。

控制 GPT-5 Responses API 的回覆詳略度。

支援的模型可使用 none、friendly 或 pragmatic。

偏好的服務層級；亦可填模型 catalog 提供的 tier ID。

啟動時載入的自訂模型 catalog JSON 路徑。

📄 指令與提示

額外注入的 developer instructions（選填）。

保留欄位，建議使用 model_instructions_file 或 AGENTS.md。

用檔案覆寫內建指令（取代 AGENTS.md）。

用來覆寫歷史壓縮 prompt（選填）。

從檔案載入壓縮 prompt（實驗）。

🧱 Workspace Write Sandbox

workspace-write 模式額外可寫入的路徑。

在 workspace-write 沙盒中允許網路連線。

從可寫入路徑排除 $TMPDIR。

從可寫入路徑排除 /tmp。

原生 Windows 沙盒預設使用 private desktop；僅因相容性需求才停用。

🌐 沙盒網路 Proxy

輸出 [features.network_proxy] table；未設定 allow 規則時不允許外部目的地。

limited 套用目的地限制；full 開放所有 Proxy 流量。

每行一組 DOMAIN=allow|deny；deny 衝突時優先，* 代表所有公開主機。

每行一組 PATH=allow|deny。

允許較廣泛的 loopback 與 private network 連線。

公開 SOCKS5 proxy 支援。

允許 UDP over SOCKS5。

允許串接環境中的上游 Proxy。

高風險設定；允許 Proxy 監聽非 loopback 位址。

高風險設定；略過 Unix socket allow/deny 規則。

沙盒網路的 HTTP listener URL。

沙盒網路的 SOCKS5 listener URL。

🔐 登入與認證

限制為 ChatGPT 或 API 登入。

限制 ChatGPT 登入到指定 workspace。

覆寫 ChatGPT 登入流程使用的 Base URL。

覆寫內建 OpenAI 模型提供者的 API Base URL。

控制 CLI 儲存憑證位置；ephemeral 僅保留在目前行程記憶體。

MCP OAuth 憑證儲存位置。

OAuth 回呼使用的固定 port（選填）。

遠端開發環境使用的 OAuth 回呼 Base URL；Codex 會附加伺服器專屬 ID。

若由集中式更新管理可關閉。

🗄️ 執行狀態與路徑

明確設定時也會啟用純文字 TUI log。

代理工作與可恢復執行狀態的 SQLite 儲存位置。

空白 write_stdin 輪詢的最長等待毫秒數。

🧰 Shell 環境策略

啟用實驗性的 shell profile 繼承。

勾選後，原本會被排除的變數也會被納入。

只載入列出的環境變數，例如：PATH,HOME。

排除指定變數或通配符，例如：AWS_*,AZURE_*。

以 keyed table 形式設定環境變數 include/exclude 規則（新版 canonical 格式）。

強制注入或覆寫每次子行程的環境變數。

⚡ 功能開關

啟用 ChatGPT Apps/connectors 支援。

啟用 lifecycle hooks。

啟用 Goals 功能。

啟用 Memories 功能。

快照你的 shell 環境，加速重複命令。

啟用多代理協作工具。

啟用 personality 選擇控制。

啟用遠端 Plugin catalog。

Legacy web_search toggle，建議改用上層 web_search。

Legacy cached web search toggle。

Legacy live web search toggle。

啟用預設的 shell 工具。

使用統一的 PTY exec 工具。

支援時壓縮串流 request body。

允許 skill 補裝缺少的 MCP dependencies。

啟用模型 catalog service tier 選擇。

回合執行時避免機器進入睡眠。

允許 apply_patch 自由格式輸入。

apply_patch 串流事件。

啟用登入引導提示。

啟用瀏覽器自動化工具。

允許外部瀏覽器自動化。

允許完整 CDP 存取。

啟用 Chronicle 功能。

Code Mode 緩衝執行。

僅使用 Code Mode。

啟用 Codex git commit 工具。

啟用 Codex hooks。

啟用協作功能。

啟用協作模式。

啟用電腦操作工具。

並行推理摘要。

啟用 Connectors。

預設模式要求使用者輸入。

延遲執行器。

延遲工具世界狀態。

Windows 提權沙盒。

啟用實驗性 Windows 沙盒。

啟用 Fanout。

啟用 MCP Apps。

執行權限核准。

記錄已執行工具呼叫中繼資料。

執行器能力探索。

實驗性 Windows 沙盒。

外部代理記憶體匯入。

外部設定遷移。

Guardian 自動核准。

Guardian v2。

保留原始圖片細節。

啟用圖片生成。

圖片縮放提示。

ImageGen Next。

內建瀏覽器面板。

應用程式內更新。

項目 ID。

JavaScript REPL。

僅工具模式 JS REPL。

本機 thread store 壓縮。

MCP 2026-07-28 規格。

記憶體工具。

Mentions v2。

多代理模式。

Plugin hooks。

Plugin 分享。

啟用 Plugins。

即時語音對話。

推薦 Plugins。

遠端壓縮 v2。

遠端控制。

遠端模型。

request_permissions 工具。

request_permissions 工具（新）。

request_rule 工具。

縮放所有圖片。

尊重系統 Proxy 設定。

Responses WebSocket。

Responses WebSocket v2。

執行時期指標。

搜尋工具。

機密認證儲存。

Shell zsh fork。

Skill 環境變數依賴提示。

Skill 搜尋。

SQLite 狀態儲存。

獨立 Web Search。

Steer 功能。

Telepathy 功能。

終端機縮放重排。

終端機視覺化指令。

工具呼叫 MCP 引導。

工具搜尋。

工具搜尋一律延遲 MCP 工具。

工具建議。

TUI App Server。

不可用工具佔位。

復原功能。

Unified exec zsh fork。

使用代理身分。

使用舊版 Landlock。

Linux 沙盒使用 bwrap。

檢視圖片工具。

工作區依賴。

工作區擁有者用量提示。

🧠 Memories

允許將新對話列入 Memory 產生來源。

在後續工作階段注入既有 Memories。

使用 MCP、網路搜尋或工具搜尋的對話不產生 Memory。

全域彙整保留的近期原始 Memories 上限。

超過指定天數未使用的 Memory 可排除。

納入 Memory 產生的對話最長天數。

逐對話 Memory 擷取所使用的模型。

全域 Memory 彙整所使用的模型。

透過 extension tool surface 暴露專用 memory 工具。

🤝 多代理設定

是否啟用多代理工具（預設 true）。

每個 session 可同時開啟的代理執行緒上限（取代舊版 max_threads）。

代理可繼續產生子代理的最大深度。

代理回合被中斷時，加入模型可見的訊息。

spawn 未指定模型時使用的預設模型。

spawn 未指定時使用的預設推理強度。

🧪 實驗性與提示設定

舊版開關，建議改用 [features].unified_exec。

隱藏不穩定功能的警告提示。

🧾 歷史與輸出

控制是否寫入 history.jsonl。

限制歷史檔案大小（bytes）。

工具輸出寫入 history 的 token 上限。

用於開啟引用檔案的編輯器。

隱藏推理事件（TUI 與 exec）。

當模型有輸出原始推理時顯示。

🔔 通知與介面

通知指令與參數，會收到 JSON payload。

允許送出 feedback。

控制此機器或 Profile 是否送出 Analytics。

停用 TUI 的 burst paste 偵測。

選擇 true/false 或指定事件清單。

當 TUI 通知模式為 list 時使用。

歡迎畫面與 loading 動畫。

控制 TUI 是否使用 alternate screen。

顯示新手工具提示。

可選 auto、osc9 或 bel。

僅終端未聚焦時通知，或一律通知。

Composer 啟動時進入 Vim normal mode。

以適合複製終端文字的 raw scrollback 模式啟動。

Syntax highlighting theme 名稱。

有順序的狀態列項目；空陣列可隱藏 footer。

終端視窗或分頁標題項目；空陣列可清除標題。

模型提示狀態；通常由 Codex 自行管理。

Will 本機設定使用的欄位；官方設定參考目前未列出。

🧭 專案設定

向上搜尋專案根目錄的檔名清單。

讀取 AGENTS.md 的最大 bytes。

找不到 AGENTS.md 時會嘗試的檔名。

🧭 專案信任清單
⚠️ Notice 設定

完整權限警告提示已確認。

Windows world-writable 警告已確認。

不再提示切換 rate limit 模型。

GPT-5.1 migration prompt 已確認。

gpt-5.1-codex-max migration prompt 已確認。

已退出 Codex 管理的 fast defaults。

模型遷移對照表。

🧩 Skills 覆寫

回合是否接收自動 skills instructions 區塊。

是否啟用內建 skills。

📡 OpenTelemetry

事件環境標籤（例如：dev、prod）。

OpenTelemetry logs exporter。

OpenTelemetry trace exporter。

OpenTelemetry metrics exporter；官方預設為 statsig。

允許輸出原始 user prompt。

附加到每個匯出 trace span 的屬性。

upsert 到 W3C tracestate members 的欄位。

🧩 Apps 與工具建議

每行一組 connector:<id> 或 plugin:<id>。

禁止建議安裝的 connector 或 plugin。

🧩 模型提供者清單
🔌 MCP Servers 清單
🧰 其他官方或實驗性 TOML

用於目前未提供專用控制項的根部鍵值；內容會放在第一個 table 之前。

用於目前未提供專用控制項的官方設定，例如 hooks 與 TUI keymap。不要重複宣告上方已管理的 table。

🛡️ 權限設定檔 (permissions)
🧩 Plugins 與 Marketplaces
🎙️ Realtime 與 Audio

即時語音傳輸方式：webrtc 或 websocket。

conversational 或 transcription。

v1 / v2 / v3。

即時語音使用的聲音。

本機即時語音麥克風裝置偏好。

本機即時語音喇叭裝置偏好。

🛠️ Tools 進階設定

啟用 update_plan 工具。

啟用 request_user_input 工具。

web_search 工具的回應內容大小。

web_search 工具允許的網域。

web_search 位置：城市。

web_search 位置：國家。

web_search 位置：地區。

web_search 位置：時區。

🧪 實驗性與其他設定

注入 <apps_instructions> developer 區塊。

注入 <collaboration_mode> developer 區塊。

注入 <environment_context> user 區塊。

注入 <permissions instructions> developer 區塊。

host-owned Codex Apps MCP 請求轉送的 product SKU。

實驗性：從遠端服務取得 thread-scoped config。

實驗性：thread store 實作（目前僅 local）。

Orchestrator 擁有的 MCP 功能設定。

Orchestrator 擁有的 Skills 功能設定。

允許以不同 Codex 版本重播 lockfile。

寫入有效 session config lock 檔案的目錄。

作為權威有效 config 重播的 lockfile。

儲存從 model catalog 解析的欄位。

相容性保留欄位（no-op）。

相容性保留欄位（no-op）。

相容性保留欄位（no-op）。

不透明 desktop 設定，與 config.toml 一起儲存。

🏢 requirements.toml 管理端約束

限制可用的 approval_policy；granular 代表允許 granular 形式。

限制 approvals_reviewer 可用值。

限制 sandbox_mode 可用值。

限制 web_search 可用值；disabled 永遠允許。

管理端自動審查政策，優先於本機 auto_review.policy。

啟用管理端沙盒網路要求。

experimental_network HTTP listener port。

experimental_network SOCKS5 listener port。

管理端 domain policy；deny 衝突時優先。

List-shaped allow rules；不要與 domains 同時使用。

List-shaped deny rules；不要與 domains 同時使用。

僅保留管理端允許規則。

允許較廣泛的 local/private network access。

macOS/Linux 管理端 hook scripts 目錄。

Windows 管理端 hook scripts 目錄。

管理端 filesystem read denial；每行或逗號分隔。

管理端預設權限設定檔（需 Codex 0.138.0+）。

設為 false 可停用 Appshots。

設為 false 可停用裝置遠端控制。

允許的權限設定檔 allowlist；省略或 false 表示拒絕。

管理端新 thread 預設模型。

管理端新 thread 預設推理強度。

管理端新 thread 預設 service tier。

依主機套用不同 sandbox 要求；每行一組 [[remote_sandbox_config]]。

產出結果

即時預覽與下載，流程不用停。依檔案類型儲存為 config.toml 或 requirements.toml。