Codex CLI

一句话： Codex CLI 是 OpenAI 官方做的终端 Coding Agent，对标 Claude Code。Rust 实现 + Windows 原生沙箱 + 子代理 + MCP + Hooks，ChatGPT Plus/Pro/Team/Edu 已含使用额度。

2026-07 最新：稳定版 0.144.1（7-09）接入 GPT-5.6 家族（Sol/Terra/Luna）；新增 ACP 支持，可在 Devin Desktop / Zed 等 ACP 客户端里作为 Agent provider 运行；此前已作为公测 Agent provider 进入 JetBrains（经 GitHub Copilot，7-07）。

2026-09 更新：GPT-6 Astra 成为 Codex CLI 默认模型（v0.153.4，9-3 起），并在 /plugins 中按 OpenAI Curated / Workspace / Shared-with-me 分组、支持按线程追踪 rollout token 预算；详见 GPT-6 Astra 发布 与 AI 编程周报 2026-09-12。

2026-09 更新（v0.154.0，9-12 前后）：破坏性变更——codex mcp-server 入口已被移除，脚本 / 服务定义 / 编辑器集成里还在调它的必须先替换再升级；新增实验性 worktree 隔离（--worktree / /worktree，可为新建或分叉会话创建隔离 checkout 并浏览恢复）、任务进行中内联回答问题、Windows 共享后台 Codex server（含 daemon 生命周期命令与托管更新）；GPT-6 Astra 进入模型选择器并上架 Amazon Bedrock 目录。信任模型同时收紧：启动阶段在建立信任前不再执行工作区控制的 helper，macOS 沙箱阻断终端输入注入；Python SDK 新增 max / ultra 两档 reasoning effort，并注意 HookMetadata 已把 handler 包进 .root（hook.command → hook.root.command）。详见 AI 编程周报 2026-09-13。

2026-09-24 更新（v0.156.0 / v0.156.1，9-22 ~ 9-23）：GPT-6 Sol 与 GPT-6 Luna 随 OpenAI 官方发布同步进入 Codex。

• v0.156.0（9-22）：上线全屏界面（full-screen）交互形态；
• v0.156.1（9-23）：模型选择器加入 Sol 与 Luna，且限流回退提示默认建议切到 Luna——这条要重点看：如果你的任务在触发限流后被自动建议降级到 Luna，说明它本来就不该跑在 Luna 档上，请显式固定模型；
• 成本变化：Sol $2/$10、Luna $0.10/$0.50，均为较 GPT-5.6 对应型号促销价永久下调 50%；同日 OpenAI 还改了 prompt caching——调整 reasoning effort 或工具集不再使缓存失效，并上线 Prompt Caching Dashboard 与 miss Diagnostics。

接口约束：Sol / Luna 的 Chat Completions 仅在 reasoning_effort=none 时支持 function calling，存量代码若依赖工具调用请改走 Responses API。详见 双雄同日发布资讯。

2026-09-30 更新（DevDay 2026：Codex 全面上云，CLI 与审查同步大改）：OpenAI 于 2026-09-29 的 DevDay 2026 上把 Codex 从「本地终端工具」推进到「云端托管队列」，四项与本卡直接相关（官方开发者社区公告口径）：

• Codex Cloud：任务在云端运行，笔记本合盖也不中断，可跨设备访问，并提供可复用的开发环境——换机器不必重建依赖；
• Codex CLI 更新：新增双向语音、/agents 视图、prompt 编辑、会话恢复与 worktree 工作流（接 2026-09 的 --worktree 实验能力）；
• Code Review：把摘要、diff 与提问带进审查界面，自动评审可在云端跑；
• Codex Security Cloud：漏洞扫描 → 调查发现 → 去重 → 准备修复，可按计划扫描。

同场发布的 GPT-6.1 Sol（$2/$10，缓存输入 $0.10）也会进入 Codex；Astra Ultrafast 提速档官方称在 Codex 内最高快 8 倍，价格为标准费率 6 倍。GPT-6.1 Sol 的上线日期官方只写「coming soon」，未给确切日期——别按发布日去做容量规划。详见 DevDay 2026 全量盘点。

2026-09-28 更新（v0.157.0，9-25 发布，官方 Release Notes 已逐条核对）：官方仓库 tag rust-v0.157.0（commit 00c972e）于 2026-09-25 02:31 发布，是仓库当前 Latest。此前本站标注的「待核实」现已按官方 Release Notes 原文补齐，六项 New Features 如下：

• ① GPT-6 Sol / Luna 正式进入模型目录，并打通 Amazon Bedrock（#47332、#47347），附带旧模型的迁移提示——从旧版本升级时 CLI 会主动提示迁移，不是静默换模型。
• ② 全屏 transcript 默认开启（#47178），并支持 Shift-click 扩展文本选择（#47414）。上一版 v0.156.0 引入的全屏形态，这一版成为默认。
• ③ 后台 server 对符合条件的交互式会话自动启动（#47179），并在 server 设置不兼容时给出明确的恢复选项（#47318）——此前需要手动拉起。
• ④ 新增 f 快捷键：用于 fork 一个已在另一个应用里打开的会话，保留草稿与排队中的提示（#47185）。
• ⑤ /import 现在可用于 remote 会话与本地后台 server 会话（#47317）。
• ⑥ 终端渲染升级：Unicode 项目符号、复选框、对齐的公式与优化符号（#47191、#47322）。

Bug Fixes 里三条值得单独看：① 网络策略现在贯穿重定向与进行中的 HTTP / WebSocket 流量，策略变更撤销访问时会主动取消（#47389、#47407）——企业代理环境的行为一致性明显改善；② 已配置的代理现在对 realtime 连接与独立 web search 生效，包括搜索重定向（#47101、#47142、#47204）；③ 文件上传超时从 60 秒提到 5 分钟并加入瞬时失败重试（#47122、#47393）。

版本通道提示（2026-10-01 记载，已被下方 2026-10-07 一节取代）：0.159 已转正——rust-v0.159.2（commit ff6aec9，2026-09-29 23:57）是当时的官方仓库 Latest。0.160 已于 10-01 转正，当前 stable 请以下方 2026-10-07 更新为准；按通道选版，别按数字大小选版。

2026-10-01 更新（v0.159.0 / .1 / .2，官方 Releases 逐条核对）：0.159 转正 + 两处移除

三个版本连发，主线是「v0.159 从 alpha 通道转正」。此前本站写的「0.159 仍在 alpha」已过期，以本节为准。

• v0.159.0（2026-09-29 08:05）新增：
  • instant_interrupt（opt-in）：允许在模型响应或长时间 code-mode 调用进行中用新输入当场引导 Codex，不必等这一轮结束。
  • warnings viewer 关闭时清除已审阅的警告，按 k 可保留某条稍后再看。
  • 决定是否执行某个 plan 时可以滚动 transcript——不再需要凭记忆判断。
  • 原生 Mermaid 渲染支持更多 flowchart 边、标签与节点组。
  • app-server 客户端可从指定 item 起分页拉取 thread history。
• v0.159.1（2026-09-29 20:32）：backport GPT-6.1 Sol 到 Bedrock catalogs。
• v0.159.2（2026-09-29 23:57，2026-10-01 核对时的 Latest）：修复 Windows 上启动后台进程与沙箱命令时控制台窗口闪烁。

两处移除（破坏性，升级前必查）：

• 自动 follow-up 提示建议与 tui.prompt_suggestions 设置已被移除——配置里还写着的会被忽略，依赖该行为的脚本要改。
• 内置 plugin-creator 技能已被移除。

待核实：第三方发布汇总站（Havoptic）称 v0.159.1 起 Codex 默认模型改为 GPT-6.1 Sol……

2026-10-08 结案：官方已在 v0.161.0 的 Release Notes 中明确写 「GPT-6.1 Sol is now the default model in the bundled and Amazon Bedrock catalogs.」，该待核实项已由官方确认（详见下方 2026-10-08 更新一节）。本卡规格表的默认模型已相应改为 GPT-6.1 Sol（v0.161.0 起）；若你的流水线依赖 GPT-6 Astra，请显式固定模型后再升级。

2026-10-07 更新（v0.160.0 / v0.160.1，官方 Releases 逐条核对）：0.160 转正，Windows 远程 MCP 环境变量修复

① v0.160.0（tag rust-v0.160.0，2026-10-01 20:19 UTC 发布） —— 四项 New Features，官方原文如下：

• Browse older tasks in the agent command center with a keyboard-accessible "Show more" action（#49106）——命令中心现在能键盘可达地翻更早的任务。
• Select transcript text and paste with middle-click in fullscreen mode on supported local Linux X11 terminals（#49112）——Linux X11 下全屏模式选中即用中键粘贴。
• Start sessions outside a project with workspace defaults when policy permits, and restore saved permissions when resuming（#49160）——可以在项目之外启动会话（按策略继承工作区默认值，恢复时还原已保存的权限）。
• Added opt-in Guardian review capabilities to retrieve earlier user instructions and include context from agent handoffs（#49036、#49057）——Guardian review 可选开启：能调取更早的用户指令，并把 agent 交接的上下文带进去。

Bug Fixes 里三条值得记：Windows 沙箱的 PowerShell 回退与长路径权限修复、后台 helper 不再弹出多余控制台窗口（#49019、#49058、#49098、#49164）；重连后未发出的排队消息在不确定提交解决后恢复发送，不再重复发送（#49105）；显式 provider 的模型目录不再包含不支持的捆绑模型，刷新失败后也不再复用旧条目（#49135）。

② v0.160.1（tag rust-v0.160.1，2026-10-05 18:29 UTC，当前官方 Latest） —— 一条 Bug Fix，但对跨平台团队很关键：

Preserve SYSTEMROOT, TEMP, and TMP when launching remote stdio MCP servers with explicitly configured remote environment variables, allowing Unix hosts to retain the Windows executor's startup environment.

即：用显式远程环境变量启动远程 stdio MCP server 时，SYSTEMROOT / TEMP / TMP 会被保留，Unix 主机因此能保住 Windows 执行器的启动环境。这是 #51121 从 0.160 分支的 backport。

版本通道提示（2026-10-07 更新，已被下方 2026-10-08 一节取代）：0.160.1 是当前 stable（Latest）——rust-v0.160.1（commit d27764b，2026-10-05）。上游已进入 0.161 / 0.162 alpha 通道。rust-v0.161.0 已于 2026-10-07 15:58 UTC 转正，详见下方 2026-10-08 更新。

2026-10-08 更新（v0.161.0，官方 Releases 逐条核对）：0.161 转正 + 默认模型切到 GPT-6.1 Sol（此前待核实项已由官方确认）

v0.161.0（tag rust-v0.161.0，2026-10-07 15:58 UTC 发布，当前官方 Latest）。这版有一条直接改变账单与输出风格的变更：

① 默认模型改为 GPT-6.1 Sol（官方口径，此前待核实项结案）。官方 Release Notes 原文：「GPT-6.1 Sol is now the default model in the bundled and Amazon Bedrock catalogs.」（#49318、#49339）

本站上一轮曾把「v0.159.1 起默认模型改为 GPT-6.1 Sol」标为待核实——因为该说法来自第三方汇总站（Havoptic），而 0.159.1 的官方条目只写了「Backport GPT-6.1 Sol Bedrock catalogs」。现在官方在 v0.161.0 里明确写了「is now the default model」，该项因此可以结案：升级到 0.161.0 后，未显式指定模型的会话跑的是 GPT-6.1 Sol。若你的流水线依赖旧默认模型，请显式固定模型后再升级。（官方只说「bundled 与 Bedrock catalogs」，其他 provider 的默认值本站未逐项核对。）

② Amazon Bedrock 新增 multi-agent V2 与 Ultra reasoning（#49345、#49813）；Bedrock Mantle 接受 AWS GovCloud 区域（对受监管行业的部署是个实质变化）。

③ /mcp login <name>：在活跃终端会话里直接登录 MCP 服务（#49290）——此前登录 MCP 要绕出会话操作。

④ Daybreak 改为显式 opt-in：需 --enable cli_daybreak 或 features.cli_daybreak=true，单独写 daybreak=true 不够；默认隐藏控件与指示、/daybreak 不可用、且不自动做 Cyber 路由（即使是对已保存的 Daybreak 线程）。opt-in 路由还要求可用的 ChatGPT 登录、OpenAI provider 与受支持的模型/计划。另有 codex exec --cyber-access-program 与 TS SDK 的 cyberAccessProgram 可按轮次选择 Cyber 访问计划（#49856、#49858、#49859、#49861、#49939、#51207）。

⑤ 三条与权限/持久化相关的修复值得记：已批准的文件系统提权现在可授予更宽的写权限，同时保留被拒的读与网络限制，且后台任务沿用发起轮次的权限（#49353、#49880）；显式启动权限在终端重连与新会话后保留，隐式客户端设置不再覆盖服务端或已保存线程的 web search 设置（#49809、#49799）；线程恢复会包含最新已提交的历史，且启动阶段更早检测可恢复的 SQLite 损坏并把损坏库备份下来（#49599、#49701）——对把 Codex 跑在 CI 里的团队，这一条减少了一类「会话莫名丢历史」的事故。

⑥ 另有：重试与 WebSocket→HTTP 回退现在遵循服务端的 retry 指引，过载时减少过早失败（#49441）；文档更新认证说明，改为考虑 keyring 存储而非暗示凭据总在 auth.json（#49361）。

版本通道提示（2026-10-08 更新，已被下方 2026-10-09 一节取代）：0.161.0 是当前 stable（Latest）——rust-v0.161.0（2026-10-07 15:58 UTC）。上游 0.162 alpha 通道仍在推进（rust-v0.162.0-alpha.18 于 2026-10-07 02:04 发布，早于 0.161.0 转正）。跑生产的团队应钉在 stable 0.161.x，不要追 alpha；按通道选版，别按数字大小选版。升级 0.161.0 前请确认你的默认模型依赖——默认模型已变为 GPT-6.1 Sol。

2026-10-09 更新（v0.162.0，官方 Release Notes 逐条核对）：0.162 转正 —— 托管 worktree、命令中心固定任务、CRLF 保留

v0.162.0（tag rust-v0.162.0，2026-10-08 18:55 UTC 发布，当前官方 Latest / stable）。六项 New Features，官方原文要点如下：

① 托管 Git worktree 的创建与列举工具（#50148）——在开启 worktrees 特性后，可从受信任的本地项目直接创建 / 列出托管 worktree。这与 v0.154.0 引入的实验性 worktree 隔离（--worktree / /worktree）是同一条线的延续：从「手动开一个隔离 checkout」走向「由 agent 自己管理隔离工作区」。多任务并行改同一仓库的团队值得关注。

② 命令中心（agent Command Center）任务置顶（#51500）——p 键固定任务，受服务端支持时归入共享的 Pinned 分组。任务多起来之后，这是最直接的一类可用性改进。

③ transcript 块导航与复制（#50434、#50215、#50209）——/copy 现在可以导航并复制 transcript 中的块；Ctrl+Insert 复制选区；新增 tui.mouse_scroll_speed 可调鼠标滚轮速度。

④ URL 可点击化（#51439、#51449、#51450、#51451、#51452、#51458）——审批头、提问、MCP 提示、警告、横幅、验证提示里的链接现在可点击，换行折行的链接也支持。此前这类链接只能手抄。

⑤ 自定义 Responses 兼容 provider 可配置联网与远程压缩能力（#50459）——自建 / 第三方兼容 provider 现在能显式声明是否具备 live web access 与 remote compaction。接了自有网关的团队，这两项此前大概是不可用的。

⑥ Code Mode 下可选的排序式工具搜索（#51126、#51209）与流式 JS helper。

Bug Fixes 里四条与工程实践强相关，值得单独记：

• ⭐ apply_patch 现在默认保留既有 CRLF 行尾，不需要 opt-in（#51203）——Windows 或 .gitattributes 强制 CRLF 的仓库，此前打补丁可能被悄悄换成 LF，在整库 diff 上制造噪声。这一条直接消灭一类「改了一行、diff 显示整文件重写」的事故。
• Linux 沙箱启动修复：多个 denied 文件时能正常启动、拒绝可写的沙箱构造可执行文件、ripgrep 配置不再削弱 deny-glob 掩码（#50059、#51211、#51407、#51527）。
• Windows 10 恢复普通盘符文件访问，且 Windows 沙箱临时目录权限与子进程环境对齐（#51511、#51512）。
• 对可重试的 Responses / WebSocket 失败遵循服务端 Retry-After（#50418、#51440）——与 0.161 的「遵循服务端 retry 指引」同向，进一步减少过载时过早失败。

Chores 里一条值得运维记：Windows 版本发布了带签名的 PowerShell 安装器（#51158）；另外旧版本不会再覆盖新版本的下载目标与安装器别名（#51186、#51425）。

版本通道提示（2026-10-09 更新，已被下方 2026-10-10 一节取代）：0.162.0 是当前 stable（Latest）——rust-v0.162.0（2026-10-08 18:55 UTC）。上游已进入 0.163 alpha（rust-v0.163.0-alpha.2 于 2026-10-09 01:47 UTC 发布）。跑生产的团队钉在 stable 0.162.x，不要追 alpha；按通道选版，别按数字大小选版。升级前请确认你的默认模型依赖——自 0.161.0 起默认模型为 GPT-6.1 Sol，若流水线依赖 GPT-6 Astra 请显式固定模型。

2026-10-10 更新（v0.162.1，官方 Release Notes 逐条核对）：0.162 的当日热修 + Codex 进入微软 MXC 已支持名单

v0.162.1（tag rust-v0.162.1，2026-10-09 19:44 UTC 发布，当前官方 Latest / stable）。这是一个只有两条 Bug Fix 的补丁，但两条都落在「能不能正常启动与正常交互」上：

• 「Fixed a TUI crash when asynchronous questions contain multiple lines, preserving line breaks and complete hyperlink destinations.」（#51866）——异步提问里含多行内容时 TUI 会崩。Codex 在长任务里经常边跑边问，问题文本带代码块或换行是常态；同时保留换行与完整超链接目标这点对「问句里带文档链接」的场景很关键（此前可能被截断成半个 URL）。
• 「Fixed startup failures caused by differences between a running background server's feature settings and CLI defaults. Compatibility checks now apply only to explicit command-line feature overrides.」（#52648）——后台常驻 server 的特性设置与 CLI 默认值不一致会导致启动失败。修法是兼容性检查只对「命令行显式传的 feature 覆盖」生效，不再拿后台 server 的状态去卡 CLI 启动。用常驻 server / IDE 集成的团队遇到「莫名其妙起不来」，多半就是这条。

版本通道提示（2026-10-10 更新）：0.162.1 是当前 stable（Latest）——rust-v0.162.1（2026-10-09 19:44 UTC）。上游 0.163 alpha 仍在推进（rust-v0.163.0-alpha.4 于 2026-10-09 13:21 UTC 发布）。跑生产的团队应钉在 stable 0.162.x，不要追 alpha；按通道选版，别按数字大小选版。升级前请确认你的默认模型依赖——自 0.161.0 起默认模型为 GPT-6.1 Sol，若流水线依赖 GPT-6 Astra 请显式固定模型。

同一周的另一条：Codex 被微软列为「已支持 MXC」的 agent 之一。 微软在 2026-10-07 的 Windows Developer Blog 公告中宣布 Microsoft Execution Containers（MXC）正式 GA，并把 OpenAI Codex 与 GitHub Copilot、OpenClaw、Replit、LM Studio、Unsloth AI 一并列为已经支持 MXC 的 agent（Claude Code、Manus、Perplexity 等在「即将支持」名单）。

MXC 是策略驱动的执行层：开发者用一份 JSON 策略声明 agent 能碰哪些文件、网络与桌面资源，由 Windows 在运行时强制执行，策略本身在 agent 之外——也就是说 Codex 在 Windows 上运行时，越权动作会被操作系统拦下，而不是靠 Codex 自己自觉。详见 MXC GA 资讯 与 Agent 沙箱。

两点必须说清楚，别误读：① 「已支持」是微软单方面的集成状态，Codex 自己的官方文档未给出启用开关、默认后端与版本门槛，本站未实测；② MXC 的 MicroVM 后端目前仍是 experimental，且 Session container 仅 Windows 11 可用——macOS / Linux 用户拿不到等价的能力。

2026-10-11 更新（官方 Release Notes：快速转向 GA、Composer predictions beta、Ultrafast 进入 Sol）

这一批不来自 GitHub Releases，而来自 OpenAI 官方 Release Notes——Codex 的三条更新分散在 10-08 与 10-09 两天，与 API 侧同批：

① Faster steering in Codex（2026-10-08，GA）。官方原文："We're rolling out faster steering in Codex in the ChatGPT desktop app. When you send a follow-up to steer a running task, Codex can respond to your changes sooner." 用法：「Use steering to correct an approach, add missing information, or change direction while Codex works.」 关键开关在 Settings → General → Follow-up behavior——它决定你发的后续消息是立即转向当前运行还是排队等下一轮。长任务团队请上线前统一这个设置，否则同一句「改个方向」在不同机器上的行为不一样。

② Composer predictions in Codex（2026-10-09，beta）。官方原文：Codex 会根据当前线程的对话建议你的下一条消息（"suggest your next message based on the conversation in your current Codex thread"），按 Tab 采纳后再编辑才发送（"Accepting a suggestion doesn't send it automatically."）。限定条件是 18 岁以上的个人 ChatGPT Pro 用户、最新 Codex 桌面端，支持 GPT-6 Astra 与 GPT-6.1 Sol 的本地与 SSH 线程，默认开启（可在 General settings → Show predictions 关闭）。

计费边界要看清：官方明说 「During the beta, generating predictions doesn't count toward Codex usage limits or consume credits. Messages you send, including accepted predictions, follow normal Codex usage limits and billing.」——生成预测免费，但你发出去的消息照常计费。别把「预测不花钱」理解成「多轮交互不要钱」。

③ Ultrafast 档进入 GPT-6.1 Sol（2026-10-08，API 侧，Codex 同享）。自 v0.161.0 起 Codex 默认模型已是 GPT-6.1 Sol，本次该模型拿到了 Ultrafast 服务档（service_tier: "ultrafast"，6 倍标准价，且首次支持美国与欧盟数据驻留）。价格倍数来自第三方转引，本站未直接核对官方定价页——预算以官方定价页为准。用法判断：Ultrafast 买的是输出 token 之间的间隔，不是更强的推理，只该花在「有人正在等」的交互路径。详见 OpenAI 十月三连更资讯 与 GPT-6 Sol 模型卡。

版本通道提示（2026-10-11 复核）：0.162.1 仍是当前 stable（Latest）——rust-v0.162.1（2026-10-09 19:44 UTC），与上一轮核对一致，本轮无新 stable 版本。上游 0.163 alpha 通道仍在推进。跑生产的团队钉在 stable 0.162.x，不要追 alpha；按通道选版，别按数字大小选版。

2026-09 更新（桌面端接本地权重，09-09 ~ 09-10）：Codex 桌面端打通 Ollama 本地权重，可以跑完全离线的 open-weights 编码循环——代码与提示词不出本机，推理也发生在本地。这是「只认 OpenAI 一家模型」这个长期限制首次被打破，对有数据不出域要求的团队是结构性变化。注意：该能力目前限于桌面端，CLI 仍是 OpenAI 原生路径；待核实：官方未提供完整的支持模型清单与性能对照，实际效果请以本地硬件与模型尺寸为准。详见 AI 编程周报 2026-09-18。

形态和 Claude Code 几乎一样，差异主要在模型选择。喜欢 GPT 的人选它，喜欢 Claude 的留 Claude Code。