跳转到正文

配置 1M 上下文

下面的配置会让 Codex 按约 1M 管理上下文,并在接近上限前自动压缩历史。

使用前确认

客户端配置不能突破模型或上游的真实限制。长上下文会增加 token 消耗,只为支持 1M 上下文的模型配置。

方法一:复制 Prompt 让 AI 配置

把下面这段话复制给能够操作本机文件的可信 AI 工具:

text
请帮我把当前 Codex CLI 配置为 1M 上下文:

1. 不得读取、输出或修改 auth.json、API Key 和历史会话。
2. 先备份 ~/.codex/config.toml 和 ~/.codex/models_cache.json。
3. 复制 models_cache.json 为 ~/.codex/models.json,在 models[] 中找到当前模型,只把 context_window 和 max_context_window 改为 1000000,保留 effective_context_window_percent = 95,其他字段不变。
4. 在 config.toml 根级设置 model_catalog_json 为 models.json 的绝对路径,同时设置 model_context_window = 1000000、model_auto_compact_token_limit = 950000。
5. 校验 JSON 和 TOML,完全重启 Codex 并创建新会话;运行 /status,确认 Context window 显示 1M。
6. 完成后告诉我修改了哪些文件以及如何回滚,不要通过超长付费请求测试。

方法二:手动配置

1. 退出并备份

完全退出 Codex App 和 Codex CLI,然后备份:

text
~/.codex/config.toml
~/.codex/models_cache.json

Windows 对应目录为 %USERPROFILE%\.codex\

2. 创建自定义模型目录

复制完整的 models_cache.json,新文件命名为:

text
~/.codex/models.json

不要直接修改 models_cache.json,它可能在 Codex 更新时被覆盖。

models[] 中按 slug 找到当前使用的模型,只修改下面三个字段:

json
{
  "slug": "gpt-5.6-sol",
  "context_window": 1000000,
  "max_context_window": 1000000,
  "effective_context_window_percent": 95
}

上面只是需要修改的字段,不是完整文件。models.json 必须保留原有顶层结构、其他模型和目标模型的全部其他字段。

3. 修改 config.toml

config.toml 根级加入以下配置。必须放在 [model_providers.xxx][features] 等配置表之前。

macOS / Linux:

toml
model_catalog_json = "/Users/你的用户名/.codex/models.json"
model_context_window = 1000000
model_auto_compact_token_limit = 950000

Windows 建议使用正斜杠:

toml
model_catalog_json = "C:/Users/你的用户名/.codex/models.json"
model_context_window = 1000000
model_auto_compact_token_limit = 950000

请使用英文半角引号,不要复制成弯引号 “ ”

查看是否生效

  1. 完全退出并重新启动 Codex。
  2. 创建一个新会话。
  3. 输入 /status
  4. 看到 Context window: 100% left (0 used / 1M),说明配置已经生效。

Codex 状态中显示 1M 上下文

不需要发送接近 1M 的超长内容进行测试。

如何回滚

  1. 恢复备份的 config.toml
  2. 删除或移走自建的 models.json
  3. 完全重启 Codex,并创建新会话确认恢复默认窗口。

需要更多帮助?请联系支持团队。