Codex CLI 通过配置文件进行定制。本节介绍配置文件的结构、各类配置选项以及如何根据你的需求进行调整。配置文件位置Codex 的配置文件位于用户主目录下的~/.codex/config.toml~/.codex/config.toml如果文件不存在你需要手动创建。Codex 首次启动时会创建一个默认配置文件。修改配置后需要重启 Codex 才能生效。配置文件结构一个完整的配置文件可能包含以下部分图Codex CLI 配置结构完整配置示例# ~/.codex/config.toml# 基础设置[model]default o4-mini # 默认使用的模型# TUI 设置[tui]alternate_screen auto # 替代屏幕模式auto/always/never# 技能配置[skills]enabled true# 特性开关[features]js_repl false # 是否启用 JavaScript REPL# MCP 服务器配置[mcp_servers]# 通知设置[notify]enabled false模型配置Codex 支持多种模型你可以根据任务需求选择配置项类型说明model.defaultstring默认使用的模型model.reasoning_effortstring推理强度low/medium/high可用模型Codex CLI 可用的模型包括o4-mini- 快速高效适合简单任务o4-mini-high- o4-mini 的高推理版本o3- 强大的推理能力o3-pro- o3 的专业版本不同的模型有不同的速度和价格选择合适的模型可以优化使用体验和成本。TUI 配置终端用户界面的相关设置配置项类型说明默认值tui.alternate_screenstring替代屏幕模式auto/always/neverautotui.widthnumber终端宽度0自动tui.heightnumber终端高度0自动替代屏幕模式说明auto- 自动检测在 Zellij 等终端多路复用器中自动禁用always- 始终使用替代屏幕默认体验never- 从不使用替代屏幕保留滚动历史运行时覆盖你可以在运行时通过命令行参数覆盖这些设置命令行覆盖配置# 禁用替代屏幕模式codex --no-alt-screen技能配置技能Skills是 Codex 的扩展机制允许你自定义工作流程配置项类型说明skills.enabledboolean是否启用技能系统skills.directorystring技能文件目录自定义技能目录配置技能目录[skills]enabled truedirectory ~/my-codex-skillsMCP 服务器配置MCPModel Context Protocol服务器允许 Codex 与外部工具和服务集成配置 MCP 服务器[mcp_servers.docs]command npxargs [-y, modelcontextprotocol/server-filesystem, ./docs]# 工具权限配置[mcp_servers.docs.tools.search]approval_mode approveMCP 工具权限你可以为每个 MCP 服务器的工具单独设置权限approve- 自动批准无需询问deny- 自动拒绝ask- 每次执行前询问默认配置 MCP 服务器时要小心确保只启用你信任的工具。特性开关启用或禁用 Codex 的特定功能配置项类型说明features.js_replboolean启用 JavaScript REPLfeatures.js_repl_tools_onlyboolean限制为仅 js_repl 工具JavaScript REPL 配置启用 JavaScript REPL[features]js_repl true你还可以指定 Node.js 路径指定 Node.js 路径js_repl_node_path /usr/local/bin/node通知配置Codex 可以在任务完成时发送通知配置项类型说明notify.enabledboolean启用通知配置通知钩子你可以通过环境变量配置自定义的通知脚本CODEX_NOTIFY_HOOK/path/to/your/notify-script.shSQLite 状态数据库Codex 使用 SQLite 存储内部状态环境变量说明默认值CODEX_SQLITE_HOMESQLite 数据库目录与 CODEX_HOME 相同配置 SQLite 目录export CODEX_SQLITE_HOME/path/to/sqlitecodex日志配置Codex 使用 Rust 的 env_logger你可以配置日志级别配置日志输出# 查看日志tail -f ~/.codex/log/codex-tui.log# 设置日志级别RUST_LOGcodex_coreinfo,codex_tuiinfo,codex_rmcp_clientinfo codex日志级别说明error只显示错误warn显示警告和错误info显示一般信息、警告和错误debug显示调试信息trace显示详细跟踪信息默认情况下TUI 模式的日志级别是 info非交互模式exec的默认级别是 error。计划模式配置配置 Codex 在计划模式下的行为配置计划模式# 设置计划模式的默认推理强度# 可选值low/medium/high/noneplan_mode_reasoning_effort medium常见配置示例基本配置最小配置# 使用默认设置# Codex 已经提供了合理的默认值高性能配置性能优化配置[model]default o4-mini[tui]alternate_screen always[features]js_repl true开发者配置开发者配置[model]default o4-minireasoning_effort high[tui]alternate_screen never[skills]enabled truedirectory ~/codex-skills