高級
如果您每天都在使用 Codex,只是需要更多的控制權,本頁面收集了您最可能需要的調整:在配置中調整預設值、通過模型上下文協議支持添加額外工具,以及使用codex exec編寫完整的運行腳本。跳轉到您需要的部分並繼續構建。
配置快速入門
大多數日常調整都在 config.toml 中進行:設置批准和沙箱預設、固定模型預設值,並添加 MCP 服務器啟動程序。配置指南介紹了每個選項,並為常見設置提供了複製粘貼示例。
跟踪/詳細日誌
由於 Codex 是用 Rust 編寫的,它遵守 RUST_LOG 環境變量來配置其日誌記錄行為。
TUI 預設為 RUST_LOG=codex_core=info,codex_tui=info,codex_rmcp_client=info,日誌消息被寫入 ~/.codex/log/codex-tui.log,因此您可以在單獨的終端中運行以下命令來監視日誌消息的寫入:
tail -F ~/.codex/log/codex-tui.log相比之下,非交互模式(codex exec)預設為 RUST_LOG=error,但消息是內聯打印的,因此無需監視單獨的文件。
有關配置選項的更多信息,請參閱 Rust 文檔中的 RUST_LOG。
模型上下文協議(MCP)
Codex CLI 和 IDE 擴展是一個 MCP 客戶端,這意味著它可以配置為連接到 MCP 服務器。有關更多信息,請參考配置文檔。
將 Codex 用作 MCP 服務器
Codex CLI 也可以通過 codex mcp-server 作為 MCP _服務器_運行。例如,您可以使用 codex mcp-server 在 OpenAI Agents SDK 之類的多智能體框架中使 Codex 可用作工具。使用 codex mcp 分別在您的配置中添加/列出/獲取/刪除 MCP 服務器啟動程序。
Codex MCP 服務器快速入門
您可以使用模型上下文協議檢查器啟動 Codex MCP 服務器:
npx @modelcontextprotocol/inspector codex mcp-server發送 tools/list 請求,您會看到有兩個工具可用:
codex - 運行 Codex 會話。接受與 Codex Config struct 匹配的配置參數。codex 工具接受以下屬性:
| 屬性 | 類型 | 描述 |
|---|---|---|
prompt(必需) | string | 啟動 Codex 對話的初始用戶提示。 |
approval-policy | string | 模型生成的 shell 命令的批准策略:untrusted、on-failure、on-request、never。 |
base-instructions | string | 用於替代預設說明的指令集。 |
config | object | 將覆蓋 $CODEX_HOME/config.toml 中內容的單個配置設置。 |
cwd | string | 會話的工作目錄。如果相對,針對服務器進程的當前目錄解析。 |
model | string | 模型名稱的可選覆蓋(例如 o3、o4-mini)。 |
profile | string | config.toml 中的配置配置文件以指定預設選項。 |
sandbox | string | 沙箱模式:read-only、workspace-write 或 danger-full-access。 |
codex-reply - 通過提供對話 ID 和提示來繼續 Codex 會話。codex-reply 工具接受以下屬性:
| 屬性 | 類型 | 描述 |
|---|---|---|
prompt(必需) | string | 繼續 Codex 對話的下一個用戶提示。 |
conversationId(必需) | string | 要繼續的對話的 ID。 |
嘗試它
TIP
Codex 通常需要幾分鐘才能運行。為此,將 MCP 檢查器的請求和總超時時間調整為 600000ms(10 分鐘),在 ⛭ 配置下。
使用 MCP 檢查器和 codex mcp-server 通過以下設置構建一個簡單的 tic-tac-toe 遊戲:
approval-policy: never
prompt: 使用 HTML、JavaScript 和 CSS 實現一個簡單的 tic-tac-toe 遊戲。在名為 index.html 的單個文件中編寫遊戲。
sandbox: workspace-write
單擊"運行工具",您應該會看到 Codex MCP 服務器在構建遊戲時發出的事件列表。