Codex 配置文档

Codex配置/使用

请先更新 Codex Cli 客户端, 更新命令 npm update -g @openai/codex

模型切换

使用 /model 命令可切换模型

推理等级选择 high(高) : 适合大多数场景,兼顾速度和质量。xhigh(超高) :适合更复杂的思考场景,速度较慢不适合简单任务。

手动配置模型

最新的模型可能不在Codex模型默认列表中,

修改配置文件:~/.codex/config.toml

model = "gpt-5.6-terra"
model_reasoning_effort = "high"

远程压缩

如果经常遇到上下文被压缩导致的错误,或者上下文丢失

修改配置文件:~/.codex/config.toml

关闭远程压缩:把name = "OpenAI" 改成name = "ylscode" 可以关闭自动远程压缩

启用远程压缩:把name = "ylscode" 改成name = "OpenAI" 可以启用自动远程压缩


1M上下文配置

当上下文超过 270K Token 时,使用阶梯计价为正常的两倍,详情可查看官方 api 计价文档
开启1M下文后会导致模型注意力严重下降,结果可能会变得非常差,除非你有特殊需求,否则不要修改上下文配置。

打开config.toml 配置文件,删除以下配置,保持上下文配置默认即可

model_context_window
model_auto_compact_token_limit

Agents / Multiple agents

最新Codex 0.115.0 及以上版本 默认开启 多Agent功能,触发时消耗Token更多!

请不要随意调整默认的Agent数量,更多 agent 并不会带来更好的结果,反而可能会冲突,导致结果更差。

更多使用请查看官方文档多Agent


goal 命令(目标模式)

Goal 模式 是 Codex CLI 在 v0.128.0 版本中加入的实验性特性,提供一种新的交互范式,允许你为Codex设定一个持久目标(persistent objective)。

开启方式:

修改配置文件:~/.codex/config.toml

[features]
goals = true