Codex CLI 常用配置实战：模型、推理强度与 Web Search 配置和验证

Codex CLI 常用配置实战模型、推理强度与 Web Search 配置和验证本文面向已经能正常使用 Codex CLI、希望固定日常开发行为的读者适用版本为Codex CLI 0.145.0最后核验日期为2026-07-28。重点解决模型选择、推理强度、Personality 和 Web Search 四类常用配置不重复首次连接流程。完成后你会得到一份可回退、保留安全边界的config.toml。示例中的medium只面向本文核验的 GPT-5.5 与 GPT-5.6 Sol、Terra、Luna 目录项不是所有模型的通用值。字段事实来自官方配置文档具体档位、默认值和 Personality 模板来自 OpenAIrust-v0.145.0标签中的内置models.json并通过codex debug models --bundled交叉验证。本文不使用模型回答作为配置事实依据Web Search 运行结果仍需读者在自己的可用环境中验证。修改前先备份配置已经能工作时先备份再调整。若新配置不符合预期可以直接恢复原文件。PowerShell$codexHomeif($env:CODEX_HOME){$env:CODEX_HOME}else{Join-Path$HOME.codex}Copy-Item(Join-Path$codexHomeconfig.toml)(Join-Path$codexHomeconfig.toml.daily-config.bak)恢复命令$codexHomeif($env:CODEX_HOME){$env:CODEX_HOME}else{Join-Path$HOME.codex}Copy-Item(Join-Path$codexHomeconfig.toml.daily-config.bak)(Join-Path$codexHomeconfig.toml)-ForceBash 或 Zshcodex_home${CODEX_HOME:-$HOME/.codex}cp$codex_home/config.toml$codex_home/config.toml.daily-config.bak恢复命令codex_home${CODEX_HOME:-$HOME/.codex}cp$codex_home/config.toml.daily-config.bak$codex_home/config.toml如果源文件还不存在应先完成首次配置不要把备份命令的报错当成 Codex 配置错误。合并这份日常配置把下面的顶层字段合并到当前实际生效的config.toml。不要覆盖文件中已经工作的其他字段或配置表。model YOUR_MODEL_ID model_reasoning_effort medium web_search cached approval_policy on-request sandbox_mode workspace-write # 仅当当前模型确实支持该 Personality 选项时启用 # personality pragmatic把YOUR_MODEL_ID替换为当前环境实际可选的模型 ID。本文核验的四个目录项都列出medium如果/model没有为你的模型列出该档位必须改成界面实际提供的值。主块不默认开启 Personality。这份配置保留了两项日常安全基线on-request让越过既有边界的操作仍有批准机会workspace-write将默认文件写入限制在工作区内。完整权限组合不在本文展开。为什么不能只看通用参数表Codex 配置存在三个不同的事实层级证据适合判断不适合判断官方通用配置参考字段名称、类型和通用说明某个具体模型当前有哪些档位Codex CLI 0.145.0 固定 SchemaTOML 结构能否被该版本接受当前模型一定接受某个推理值官方内置模型目录或codex debug models --bundled当前二进制附带的 0.145.0 模型快照与档位当前账号、Provider 或会话实际可选择哪些模型当前会话的/model当前环境实际提供的模型和推理强度选项未来版本是否保持不变0.145.0 Schema 将推理强度定义为模型公布的非空字符串。也就是说字符串通过 Schema 校验不代表当前模型一定支持当前 CLI 应通过/model同时确认模型与推理强度。0.145.0 模型目录对照OpenAIrust-v0.145.0标签中的codex-rs/models-manager/models.json列出以下内置模型能力本机codex debug models --bundled返回相同结果模型当前推理强度默认值GPT-5.5low、medium、high、xhighmediumGPT-5.6 Sollow、medium、high、xhigh、max、ultralowGPT-5.6 Terralow、medium、high、xhigh、max、ultramediumGPT-5.6 Lunalow、medium、high、xhigh、maxmedium这张表只是 Codex CLI 0.145.0 的内置模型快照不是所有 OpenAI API 模型的永久枚举。通用配置参考、API 模型指南和 CLI 内置目录属于不同产品层不能互相覆盖。截至 2026-07-28在线通用配置参考的model_reasoning_effort类型仍包含minimal且未列出max、ultra0.145.0 的上述四个内置目录项则都没有minimal部分 GPT-5.6 目录项提供max或ultra。这说明通用字段说明不能替代固定版本的模型目录。codex debug models --bundled只用于核对当前二进制自带的快照不能证明账号、第三方 Provider 或当前会话实际开放这些模型。判断当前实际可选项必须以交互界面的/model为准。ultra也不是单纯比max更高。0.145.0 目录说明它在最大推理之外还包含自动任务委派当前只有 Sol 和 Terra 列出。任务不适合拆分或需要更可预测的单线程过程时名称更高不代表更合适。medium 是候选起点不是统一默认值主配置采用model_reasoning_effort medium原因是本次核验的四个目录项都提供medium而 GPT-5.6 官方 API 指南把medium作为平衡质量与速度的起点。但它不是所有模型的默认值0.145.0 中 Sol 默认lowGPT-5.5、Terra 和 Luna 默认medium。实际使用时可以这样调整延迟敏感或边界清晰的小任务可以比较low与medium。只有代表性任务显示质量确有提升时再选择high或xhigh。max留给最困难的质量优先任务ultra还包含自动任务委派不能只理解为更高一级思考量。minimal、max、ultra等值仅在/model为当前模型真实列出时使用。比较效果时一次只改模型或推理强度中的一项。在交互界面输入/model/model同时用于选择模型和推理强度。界面列出的才是当前 CLI 可选值不要让模型通过回答文字“自报档位”。固定到 Codex CLI 0.145.0 时不要使用/reasoning该标签的 CLI 斜杠命令源码没有这个命令模型和推理强度都通过/model选择。通用斜杠命令页面列出的/reasoning可能对应其他 Codex 界面或更新版本不能反推到本文固定版本。Personality 改为条件配置固定 Schema 对personality只允许三种值none | friendly | pragmatic它不是可以任意填写的风格名称。本机 0.145.0 模型目录显示GPT-5.5 的指令模板包含 Personality 占位符friendly与pragmatic变量均为非空。GPT-5.6 Sol、Terra、Luna 的指令模板没有该占位符相应变量也为空。这个结论只适用于本次版本和目录不代表 GPT-5.6 永久不支持 Personality。正因为三个 5.6 目录项当前没有对应模板personality pragmatic不应成为 GPT-5.6 的通用起步默认。当前模型支持时可以取消主配置中的注释并通过/personality确认可选风格。需要自定义项目回答方式时把明确规则写进项目AGENTS.md需要用户级开发者指令时使用官方支持的developer_instructions。不要发明第四种 Personality 值。Web Search 显式使用 cachedweb_search cached当前官方配置提供四种模式模式行为cached使用 OpenAI 维护的搜索索引是普通本地会话的默认模式indexed仅在搜索索引门控允许时访问外部网页live获取近期网页内容与--search对应disabled移除 Web Search 工具普通本地会话默认使用cached如果启用--yolo或其他 full-access 沙箱设置官方文档说明默认值可能转为live。本文显式写入web_search cached因此不依赖这一默认差异。确实需要刚发布的版本说明或近期故障信息时再临时切换live。无论哪种模式网页内容都属于不可信外部输入关键结论仍需核对官方来源。Web Search 模式不等于 Shell 命令的网络权限。两者属于不同配置边界不能用搜索成功与否推断子进程是否能联网。检查实际生效值保存配置并重启 Codex。以下斜杠命令在 Codex 交互界面中输入不属于 PowerShell、CMD、Bash 或 Zsh 命令/model /personality通过/model检查当前模型与推理强度再检查可用 Personality。若界面与文件不同优先排查启动参数、Profile 或会话内临时覆盖。需要验证 Web Search 时可以在自己的可用环境中提出一个必须查询近期官方资料的任务观察客户端是否出现搜索工具活动以及可访问的来源链接。模型只说“已经联网”不能作为证据。如果希望在非交互运行中观察结构化事件下面这条 Codex CLI 命令可在 PowerShell、CMD、Bash 和 Zsh 中使用codex exec --ephemeral --json 使用 Web Search 查询当前 Codex CLI 的官方变更记录给出来源链接本文只核对了 0.145.0 帮助中--ephemeral和--json选项存在没有实际执行模型或 Web Search 请求。完成后的检查清单修改前已备份config.toml并知道恢复命令。model已替换为当前环境真实可选的 ID。/model中当前模型存在配置的medium或已改成实际列出的值。Personality 只在当前模型提供模板时启用。已显式设置cached需要实时内容时才临时切换live。保留on-request workspace-write安全基线。总结日常配置的关键不是参数多而是证据层级正确字段能被 Schema 解析、模型目录公布能力、当前会话实际选择三者需要分别确认。本文主块以本次四个目录项共同提供的medium作为候选起点显式固定cached保留安全基线并把 Personality 降为条件配置最终仍以当前模型的/model选项和代表性任务结果为准。FAQ为什么配置了 medium界面却没有按预期显示先用/model查看当前模型实际提供的推理档位再检查启动参数、Profile 或会话内临时覆盖。Schema 能解析字符串不代表具体模型一定接受该值。GPT-5.6 可以直接设置 personality “pragmatic” 吗0.145.0 的三个 GPT-5.6 目录项对应模板为空因此本文不把它作为通用默认。未来版本可能变化应以当时的/personality和模型目录为准。ultra 是否就是比 max 更强不是简单的强度加一。当前目录说明ultra包含自动任务委派且只有 Sol 和 Terra 列出是否适合取决于任务能否安全、有效地拆分。cached 和 live 应该怎样选择普通本地会话可显式使用cached只有任务明确依赖近期网页信息时再使用live。full-access 模式可能默认live但显式配置不受该差异影响。两种模式的结果都要视为不可信外部输入并回到官方来源复核。官方资料Codex config.toml 配置参考Codex Web Search 模式Codex 通用斜杠命令参考可用项随环境变化OpenAI GPT-5.6 指南Codex CLI 0.145.0 内置模型目录Codex CLI 0.145.0 斜杠命令源码Codex CLI 0.145.0--bundled命令源码Codex CLI 0.145.0 模型管理源码参考文档Codex CLI 参数会随版本更新。完整参数表、配置生成器、可复制配置示例和版本核验记录请参考Codex CLI 参数配置完整参考