高级

如果您每天都在使用 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 服务器在构建游戏时发出的事件列表。