Codex 使用指南
Codex 是一款专为代码生成、修改和审查设计的 AI Agent 工具。
安装
根据使用习惯选择安装方式。
Codex App 适合使用图形界面的用户。
按系统选择对应安装包：
下载完成后，按照系统提示完成安装并启动即可。
导入
安装完成后，选择以下两种方式之一将 Codex 接入 TokenFlux。
推荐使用 CC-Switch 统一管理配置。
操作步骤：
- 按 创建 API Key 教程 生成 API Key。
- 按 CC-Switch 完成统一供应商配置。
- 配置完成后，重启
Codex或Codex App。
关于远程压缩
上方配置已经把 [model_providers.tokenflux] 的 name 设为 OpenAI，正是为了开启 Codex 的远程压缩。
Codex 在长对话接近上下文上限时会触发压缩。只有当上游 provider 的 name 严格为 OpenAI 时，Codex 才会优先走远程压缩接口（/v1/responses/compact）；远程压缩质量更高，超长对话也能稳定保持，不容易降智。
如果把 name 改成其他值（例如 tokenflux），Codex 会强制使用本地压缩，效果较差。
说明：
name是用于触发远程压缩的显示名，保持OpenAI即可。- provider 标识
tokenflux（即model_provider和[model_providers.tokenflux]）不受影响，保持不变。 - 这个设置不会丢失已有聊天记录。
1M 上下文窗口
ChatGPT 分组已全面支持 100 万上下文，推荐开启。
安装 Skill
克隆到 Codex 的用户 Skill 目录：
git clone https://github.com/smartcmd/codex-context-window.git ~/.codex/skills/codex-context-window也可以把下面这段直接发给 Codex，让它自己完成安装和配置：
安装这个 Skill：https://github.com/smartcmd/codex-context-window
然后将 gpt-5.6-luna、gpt-5.6-terra、gpt-5.6-sol 的上下文窗口调整为 1M，自动压缩阈值设置为 900k。配置模型
新开一个任务让 Codex 发现 Skill，然后发送：
将 gpt-5.6-luna、gpt-5.6-terra、gpt-5.6-sol 的上下文窗口调整为 1M，自动压缩阈值设置为 900k。Skill 会依次确认目标模型、原始窗口大小、有效窗口比例和自动压缩策略，确认后才写入配置。配置完成后重启 Codex。
有效比例保持默认
有效比例保持默认的 95% 即可。此时 1M 原始窗口对应的可用上下文是 950000 token，状态栏显示的也是这个折算后的数字。
确认是否生效
Codex App：在 设置 → 常规 → 编辑器 中开启 显示上下文窗口使用情况，新开一条消息即可看到窗口大小。Codex CLI：输入/status，在输出中查看 Context window。
关于 codex-auto-review
为消除歧义，codex-auto-review 现已默认重定向到 gpt-5.6-sol。
模型路由功能已经上线，可以在 API 密钥页面 自助把它重定向到 gpt-5.6-terra 或 gpt-5.6-luna，以降低花费。