Codex CLI 在 9 月 9 日和 9 月 17 日连发两个版本:0.154.0 和 0.155.0。两周里加的东西不少,官方更新记录按 PR 编号列了上百条。这篇挑出对日常使用有影响的部分,按「装、用、避坑」整理。
先升级:
npm install -g @openai/[email protected]
codex --version
codex doctor
codex doctor 是 Windows 上的诊断命令,覆盖启动、连接和性能问题,0.155 起还会显示更新器设置。
一、/voice:在终端里用语音指挥 Codex
0.155 加了实验性的语音对话。原理是 WebRTC,终端里显示实时转写,有麦克风控制和静音快捷键。
开启方式:
codex
/experimental # 打开实验功能面板,勾选 voice
/voice # 进入语音模式
几个已知边界:
- 只在「支持的构建」上可用。macOS 发布包内置了签名的语音资源,Windows 的原生语音组件目前只在 CI 里构建,用户包不含。
- 语音走的是套餐额度,和文字对话同一个池。
- 静音快捷键可配置。
如果你在 ChatGPT 桌面版里用 Codex,语音早在 8 月就有了,见语音上桌面版。CLI 这次是补齐。
二、--worktree:让每个任务在隔离的检出里跑
0.154 加的,实验性。作用是给新会话或分叉会话创建一个独立的 git worktree,Codex 在里面改代码,不碰你当前分支。
codex --worktree # 新会话在隔离检出里启动
/worktree # 会话内创建
codex exec --worktree "..." # 非交互模式也支持
管理的 worktree 可以在 Agents 总览里浏览和恢复。0.155 补了三个操作:隐藏、归档、删除任务,删除干净的托管 worktree 会要求确认。快捷键:右方向键打开任务,Esc 回到输入框。
适用场景:同时跑两三个改动互不干扰,或者让 Codex 试一个激进重构,不满意直接删 worktree。
三、边干活边答题
0.154 起,Codex 在执行中提问时,你可以直接选建议项或输入自定义回答,不用打断它,草稿也不会丢。以前的做法是等它停下来,或者按 Esc 打断再补一句。
配合 0.155 的状态行改动一起看:状态行现在流式显示推理摘要,任务完成后显示完成时间戳。你能更早看出它在往哪个方向走。
四、/plugins:插件市场进了 CLI
codex
/plugins # 打开插件浏览器,按来源分组
Tab 切换来源,打开插件看详情,安装或卸载,空格切换已装插件的启用状态。装完要新开会话才生效。
要接自己团队的插件源:
codex plugin marketplace add owner/repo
codex plugin marketplace add ./local-marketplace-root
codex plugin marketplace list
0.154 还修了一个老问题:已打开的会话现在能检测到新装的插件工具,外部升级或回滚插件后会刷新 Skill 和钩子。
插件、Skill、MCP 的概念区别和 ChatGPT 侧的用法见插件使用指南。
五、Touch ID 验证 MCP 请求
0.155 起,支持的 Mac 上,本地 TUI 会话里的 MCP 请求可以用 Touch ID 做用户验证,签名走 Secure Enclave。MCP 工具续接调用也支持。
这是给「Codex 要调外部系统做动作」的场景加一道人工确认,比在终端里敲 y 更难被脚本绕过。
同版本还有一批安全修复:阻止了从受限 WSL 沙箱逃逸到 Windows 进程的路径,加固了代理 shell 快照防止凭据暴露,切换账号时会作废之前身份的远程控制会话和模型目录缓存。
六、守护进程和 Windows 后台服务
0.154 起 Windows 上多个会话共用一个后台 Codex 服务,有守护进程生命周期命令。0.155 加了:
codex app-server daemon update # 手动触发更新
更新计划可配置,守护进程重启后已保存的线程和活动目标会恢复。
七、其他值得知道的小改动
| 项目 | 版本 | 说明 |
|---|
| GPT-6 Astra 进模型选择器 | 0.154 | 含 Bedrock 目录;保存的默认模型被覆盖时会警告 |
| Vim R 替换模式 | 0.154 | 支持撤销和点重复 |
| /copy 增强 | 0.154 / 0.155 | 富文本应用里保留格式,可复制状态输出或单个会话字段,选择器含已完成的评论 |
| 压缩失败保留提示 | 0.155 | 回合前压缩失败时不再丢你刚输入的内容 |
| MCP OAuth 过期提示 | 0.155 | 凭据过期时准确报告并给重连指引 |
| Guardian 审核 | 0.155 | 自动审批审查保留完整动作和授权证据,审查上限提到 200,000 字节 |
| HTTP 配额错误 | 0.155 | 和速率限制区分开报错 |
桌面版 26.908(9 月 11 日)也加了 Quick Chat:macOS 按 Option+Space,Windows 按 Win+Alt+P 从浮动 Pets 控件发起快速对话,@ 加上下文,$ 选 Skill。Windows 同时按两个 Alt 键截当前窗口做 Appshot。
八、两个必须处理的模型变更
- gpt-5.3-codex-spark 已于 9 月 14 日下线。 桌面版、CLI、IDE 插件都移除了。配置和脚本里还选它的要改,想要速度用 Fast 模式。
- GPT-5.5 将于 10 月 14 日退出 Codex。 用 ChatGPT 账号登录的迁到 gpt-5.6-sol。检查 ~/.codex/config.toml、工作区默认、自定义智能体、定时任务和脚本。API 不受影响。背景见 GPT-5.5 退役。
九、Plus 和 Pro 用户的额度注意点
帮助中心写明 Codex 包含在所有 ChatGPT 套餐里,含 Free 和 Go,用量上限按套餐。Plus 的 Codex 走 5 小时滚动窗口加周上限,Pro $100 是 Plus 的 5 倍。
0.155 里几个功能会比以前更快消耗额度:语音对话按时长算,worktree 并行跑多个任务等于多份消耗,Guardian 审查本身也占用量。碰到上限的处理见用量达到上限怎么办。
Codex 不单独售卖,额度跟着 ChatGPT 套餐走,见 Codex 需要充值吗。各套餐当前价格与到账时效以套餐页实时展示为准。PayForChat 是独立第三方代充值服务,与 OpenAI 没有从属关系。
什么情况下可以先不升
- 你在生产环境用固定版本。 0.155 的语音和 worktree 都是实验性,等下一个稳定点再升。
- 你用 IDE 插件为主。 这两版的大部分改动在 CLI 和桌面版,IDE 插件不支持插件市场。
- Windows 上依赖 /sandbox-add-read-dir。 0.155 移除了这个命令,先看替代方案。
FAQ
Q: /voice 为什么找不到?
A: 先在 /experimental 里开启。Windows 用户包目前不含原生语音组件,macOS 可用。
Q: worktree 里的改动怎么合回主分支?
A: 它就是普通的 git worktree,在里面提交后按常规流程合并。删除托管 worktree 前确认已经合并或不需要。
Q: 免费账号能用 0.155 的新功能吗?
A: Codex 对 Free 和 Go 开放,功能一样,区别在用量上限。
Q: Touch ID 验证是强制的吗?
A: 不是,只在支持的 Mac 上的本地 TUI 会话里可用,是给 MCP 请求加的一道确认。
Q: 升级后模型默认变了?
A: 0.154 起保存的默认模型被覆盖时会警告。检查 config.toml 里的 model 字段,别再指向 gpt-5.5 或 gpt-5.3-codex-spark。
Q: 代充的 Plus 账号登录 Codex CLI 有区别吗?
A: 没有。用 ChatGPT 账号登录即可,额度按 Plus 算。
参考来源
更新记录
- 2026-09-18:首次发布。功能清单引自官方更新记录 0.154.0 与 0.155.0 条目,实验性功能以 /experimental 面板实际显示为准。