Codex CLI 設定產生器

預設範本

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

自訂設定

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

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

產出檔案類型

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

指令核准策略

沙盒模式

預設 Profile

等同於啟動時指定 --profile。

已完成 Windows/WSL 設定

僅 Windows 使用：完成 WSL 與 CLI 設定後再勾選。

網路搜尋模式

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

Windows 沙盒模式

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

🧠 模型與推理

模型提供者

模型名稱

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

Review 模型

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

OSS Provider

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

Context Window

模型可用的 tokens 上限。

自動壓縮門檻

觸發歷史壓縮的 token 門檻。

推理摘要

推理強度

回覆詳略

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

強制啟用推理摘要

對未知模型強制送出推理摘要 metadata。

📄 指令與提示

Developer Instructions

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

Instructions（保留欄位）

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

Model Instructions File

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

Compact Prompt

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

Compact Prompt File（實驗）

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

🧱 Workspace Write Sandbox

Writable Roots (逗號分隔)

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

允許網路存取

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

排除 $TMPDIR

從可寫入路徑排除 $TMPDIR。

排除 /tmp

從可寫入路徑排除 /tmp。

🔐 登入與認證

強制登入方式

限制為 ChatGPT 或 API 登入。

ChatGPT Workspace ID

限制 ChatGPT 登入到指定 workspace。

ChatGPT Base URL

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

CLI Credentials Store

控制 CLI 儲存憑證位置。

MCP OAuth Store

MCP OAuth 憑證儲存位置。

MCP OAuth Callback Port

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

啟動時檢查更新

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

🧰 Shell 環境策略

繼承方式

使用使用者 Shell Profile

啟用實驗性的 shell profile 繼承。

忽略內建排除規則

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

僅包含 (以逗號分隔)

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

排除 (以逗號分隔)

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

環境變數覆寫 (KEY=VALUE)

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

🧪 Legacy / 相容性設定

include_apply_patch_tool

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

experimental_use_freeform_apply_patch

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

experimental_use_unified_exec_tool

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

Zsh 路徑 (zsh_path)

指定用於 shell 執行的 zsh 路徑。

suppress_unstable_features_warning

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

🧾 歷史與輸出

History 保存

控制是否寫入 history.jsonl。

History 最大大小

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

Tool Output Token Limit

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

Citation 開啟工具

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

隱藏推理摘要

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

顯示原始推理內容

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

🔔 通知與介面

Notify Command (逗號分隔)

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

啟用 /feedback

允許送出 feedback。

關閉貼上爆量偵測

停用 TUI 的 burst paste 偵測。

TUI 通知

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

通知事件 (逗號分隔)

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

TUI 動畫

歡迎畫面與 loading 動畫。

Alternate Screen

控制 TUI 是否使用 alternate screen。

顯示導覽提示

顯示新手工具提示。

Scroll Events / Tick

TUI2 的 wheel event 密度。

Scroll Wheel Lines

每個 wheel notch 滾動行數。

Trackpad Lines

Trackpad 基礎行數。

Trackpad Accel Events

多少 events 觸發加速。

Trackpad Accel Max

最大加速倍率。

Scroll Mode

auto/wheel/trackpad 模式。

Wheel Tick Detect Max (ms)

auto 模式 wheel tick 偵測門檻。

Wheel Like Max (ms)

auto 模式 fallback duration。

反向滾動

反轉滑鼠滾動方向。

🧭 專案設定

Root Markers (逗號分隔)

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

Project Doc Max Bytes

讀取 AGENTS.md 的最大 bytes。

Fallback Filenames (逗號分隔)

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

🧭 專案信任清單

⚠️ Notice 設定

hide_full_access_warning

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

hide_world_writable_warning

Windows world-writable 警告已確認。

hide_rate_limit_model_nudge

不再提示切換 rate limit 模型。

hide_gpt5_1_migration_prompt

GPT-5.1 migration prompt 已確認。

hide_gpt-5.1-codex-max_migration_prompt

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

model_migrations (KEY=VALUE)

模型遷移對照表。

🧩 Skills 覆寫

📡 OpenTelemetry

Environment

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

Log Exporter

OpenTelemetry logs exporter。

Trace Exporter

OpenTelemetry trace exporter。

Export raw prompts

允許輸出原始 user prompt。

🧩 模型提供者清單

📝 設定檔清單

🔌 MCP Servers 清單

🏢 requirements.toml 管理端約束

Allowed Approval Policies

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

Allowed Approval Reviewers

限制 approvals_reviewer 可用值。

Allowed Sandbox Modes

限制 sandbox_mode 可用值。

Allowed Web Search Modes

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

Guardian Policy Config

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

experimental_network.enabled

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

HTTP Port

experimental_network HTTP listener port。

SOCKS Port

experimental_network SOCKS5 listener port。

Network Domains (DOMAIN=allow|deny)

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

Allowed Domains

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

Denied Domains

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

managed_allowed_domains_only

僅保留管理端允許規則。

allow_local_binding

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

Managed Hooks Dir

macOS/Linux 管理端 hook scripts 目錄。

Windows Managed Hooks Dir

Windows 管理端 hook scripts 目錄。

Filesystem Deny Read

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

產出結果

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