Skip to content

高級

如果您每天都在使用 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,因此您可以在單獨的終端中運行以下命令來監視日誌消息的寫入:

bash
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 服務器:

bash
npx @modelcontextprotocol/inspector codex mcp-server

發送 tools/list 請求,您會看到有兩個工具可用:

codex - 運行 Codex 會話。接受與 Codex Config struct 匹配的配置參數。codex 工具接受以下屬性:

屬性類型描述
prompt(必需)string啟動 Codex 對話的初始用戶提示。
approval-policystring模型生成的 shell 命令的批准策略:untrustedon-failureon-requestnever
base-instructionsstring用於替代預設說明的指令集。
configobject將覆蓋 $CODEX_HOME/config.toml 中內容的單個配置設置
cwdstring會話的工作目錄。如果相對,針對服務器進程的當前目錄解析。
modelstring模型名稱的可選覆蓋(例如 o3o4-mini)。
profilestringconfig.toml 中的配置配置文件以指定預設選項。
sandboxstring沙箱模式:read-onlyworkspace-writedanger-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 服務器在構建遊戲時發出的事件列表。