Skip to main content
Codex 在会话接近上下文限制时,可以自动压缩历史,也可以通过 /compact 手动触发。 Remote Compaction V2 使用正常的 Responses 请求流程完成远程压缩,不再依赖旧的独立 /responses/compact 接口。Codex 会在请求中使用 compaction 相关协议字段,并根据服务端返回的压缩结果重建后续会话历史。你不需要调用任何单独的压缩接口,配置好客户端即可。

推荐配置:启用 Remote Compaction V2

建议使用较新的 Codex 版本(新版已默认启用 V2),并检查 ~/.codex/config.toml 中是否显式关闭了 V2。 如果存在以下配置:
请改为:
如果原文件中没有 [features] 段,可以添加该段;如果已经存在,则只修改对应配置项,避免重复定义。 修改后,完全退出并重新启动 Codex。
这个开关是协议开关,与模型选择无关:压缩时使用的是你 config.toml 里 model = "..." 配置的同一个模型(本站 Codex 模型为 gpt-5.6-sol),不存在单独的”压缩模型”,也不需要为压缩额外配置模型。

为什么必须检查这个配置?

旧版远程压缩路径会请求独立的 /responses/compact 接口,该接口已被 OpenAI 官方退役并返回 HTTP 404。 Codex 的相关实现区分以下路径:

常见错误

服务端兼容性说明

开启客户端 V2 并不意味着任意 OpenAI 兼容接口都能完成 Codex 上下文压缩——服务端需要正确处理 Codex 发出的 Responses 请求、压缩相关协议字段及相应返回结果。本站已完成 Remote Compaction V2 的服务端适配,开启 V2 后即可正常使用。

参考