更新日志
Codex CLI 最近一批稳定版(0.149 → 0.160.1)的新特性、行为变更与重要修复,整理自 GitHub Releases。
作者 David更新于 第 22 篇(共 22 篇)
Codex CLI 的变更记录已经不写在仓库的 CHANGELOG.md 里——那个文件只有一句指向 GitHub Releases 的说明(偶尔在 Unreleased 小节里补记一两条修复)。本页整理最近的稳定版,只挑对 CLI 日常使用有影响的条目;某个版本完整的 PR 列表请看对应的发布页。
本手册基准版本:v0.160.1(2026-10-05 发布)。稳定版之间还夹着大量 rust-v0.x.y-alpha.N 预发布版本,本页不收录。查看本机版本用 codex --version,升级用 codex update(见安装、登录与升级)。
标记约定:🆕 新特性;⚠️ 行为变更(可能影响你现有的用法);其余为修复与体验优化。
v0.159.x–v0.160.1(2026-09-29 至 10-05)
- 🆕 默认模型更新为 GPT-6.1 Sol:v0.159.1 起随附模型目录及 Amazon Bedrock Mantle / Runtime 目录把 GPT-6.1 Sol 设为默认模型。具体可用项仍受账号套餐、工作区策略与提供方影响,请以
/model选择器为准(见模型与推理)。 - 🆕 v0.159.0 增加可选的
instant_interrupt,允许新输入在模型回复或长时间 code-mode 调用期间即时引导 Codex;默认关闭。该版还更新了新会话欢迎界面、允许在计划确认期间滚动对话,并改进 Markdown / Mermaid 原生呈现。 - ⚠️ v0.159.0 移除 TUI 自动后续提示及其
tui.prompt_suggestions设置,也移除了随附的plugin-creator技能;依赖该技能的流程需改为自建技能或插件。 - 🆕 v0.160.0 的代理总览可以键盘分页浏览更早的任务;符合策略时,可在项目外按工作区默认设置启动会话,并在恢复时还原已保存的权限。Guardian 审查可选择取回较早的用户指令及 agent 交接上下文。
- 修复项:v0.159.x 加固 Windows 子进程/MCP 启动、审批拒绝规则与
.aws目录保护;改善 TLS 代理环境。v0.160.0 修复 Windows 沙箱 PowerShell 回退与长路径权限处理,并修正子代理在执行环境启动期间丢失环境配置的问题。 - v0.160.1 为远程 stdio MCP 服务器保留
SYSTEMROOT、TEMP、TMP,修复在 Unix 主机上连接 Windows executor 时丢失启动环境变量的问题。
完整变更见 v0.159.0、v0.159.1、v0.160.0 与 v0.160.1。
GPT-6 Sol 与 GPT-6 Luna
2026-09-22 起,GPT-6 Sol 与 GPT-6 Luna 逐步向 Codex 推出,token 价格低于对应的 GPT-5.6 模型。CLI 分两步收录:
| 版本 | 事件 |
|---|---|
| 0.156.1 | 热修复:模型选择器加入 GPT-6 Sol 与 GPT-6 Luna,选用旧模型时提示迁移,触发限流时的换模型提示改为推荐 GPT-6 Luna |
| 0.157.0 | 主线版本收录;Amazon Bedrock 目录加入这两个模型,GPT-6 Sol 成为 Bedrock 的默认模型 |
GPT-6-Astra 的上线过程
GPT-6-Astra 是分几个热修复版本逐步放出的:
| 版本 | 事件 |
|---|---|
| 0.153.1 | 可以通过 API 配置使用 GPT-6-Astra,但不改变默认模型,也不出现在模型选择器里 |
| 0.153.2 | Fast 档的说明文字更正为“2x speed, increased usage”(此前误写为 1.5x;只改文案,不影响请求) |
| 0.153.3 | Amazon Bedrock 的模型选择器加入 GPT-6-Astra(Mantle 与 Runtime 的 global、US 路由) |
| 0.153.4 | 修复 Astra 在内置模型选择器里不显示的问题,并在没有显式配置模型时成为内置默认模型 |
| 0.154.0 | 正式出现在模型选择器与 Amazon Bedrock 目录中 |
模型的选择与配置见模型与推理。
v0.158.0(2026-09-28)
- 🆕 全屏对话记录支持松开鼠标即复制:选中一段对话记录后松开按键,选区就复制到剪贴板,由新配置
tui.copy_on_select控制(auto、always、never)。默认的auto只在已知会把原生复制快捷键转交给程序的终端里关闭,即 Ghostty 1.2 及以上、macOS 上的 Kitty、Windows Terminal 与 Windows 上的 VS Code,在 tmux、Zellij 与识别不出的终端里一律开启;对话记录视图以及恢复、分叉会话时的预览同样适用。复制出来的选区保留 Markdown 格式,粗体、链接、标题、列表、引用块与表格都还原成 Markdown,只选中代码时仍按原文复制;剪贴板操作改到后台进行,系统剪贴板卡住时界面不再跟着卡住(见斜杠命令)。 - 🆕 全屏模式下没有选区时,右键把剪贴板里的文本粘贴进输入框,由新配置
tui.right_click_paste控制:默认的auto在 Windows 与 Linux 上开启(WSL 中判断不出是否为 VS Code 终端时除外),on连 macOS 也开启,off把右键完全留给终端;SSH 会话与识别出的 VS Code 终端里一律不启用。有选区时右键仍是复制。 - 🆕
codex mcp add --oauth-client-secret:对接要求预注册 OAuth 客户端密钥的 MCP 服务器,必须同时给出--url与--oauth-client-id。密钥保存在服务器配置的oauth.client_secret中,换取与刷新 token 时使用,不会出现在授权链接与保存的 token 记录里(见 MCP 集成)。 - 🆕 MCP 服务器新增两项配置:
startup_readiness = "catalog"允许启动阶段先用有效的缓存工具目录,不必等实时连接建立(调用工具仍要等连接就绪),默认"connection";tool_input_schema_max_bytes调整工具输入 schema 的压缩阈值(默认 5000 字节),调大能保留更多参数说明,Code Mode 另有features.code_mode.tool_input_schema_max_bytes。 - 🆕
codex exec-server的 WebSocket 监听可以要求 bearer token 鉴权,参数与codex app-server的--ws-auth一组相同(capability token 或签名的 JWT),不能与--remote或转发同时使用;app server 连接执行端时也能带上 bearer token(environment/add的authBearerToken,或environments.toml的auth_bearer_token)。另有--linux-sandbox-pid-namespace inherit,让沙箱沿用调用方的 PID 命名空间与/proc,只适合专用环境(见 SDK 与 App Server)。 - 🆕 图像生成可以明确要求透明背景(抠图、去背景时使用),编辑图片时也能引用对话中以文件形式出现的图片。
- 🆕
otel.log_agent_responses与otel.log_guardian_assessments(默认关闭):把主代理与子代理的最终回答、自动审批审查的评估结果导出到 OTLP 日志(需要配置 OTLP 日志导出器),单条上限 64 KiB。 - 🆕 推理强度快捷键
Alt+.、Shift+Up能一路调到max(ultra仍要在选择器里选);在另一个应用中打开、这里只能只读查看的对话里,除了Esc也可以按←回到代理总览,草稿保留;/ps的命令预览显示多行命令,换行显示为↵。 - ⚠️ 终端输入审批默认开启:功能开关
write_stdin_approval转为稳定并默认开启。模型向一个仍在运行的终端会话写入输入时,如果这个终端当初是在沙箱外或带着额外权限启动的,或者启动之后权限设置发生了变化,这次输入要先经过审批(交给你或自动审批审查);按当前权限启动的终端不受影响,只在运行时授予的内部权限(如插件指标用到的文件系统授权)也不会触发(见沙箱、审批与安全)。 - ⚠️
tui.whimsy改为tui.effects.starfield的别名:v0.156.0 起不再生效的旧设置重新控制星空动画,同一层配置里两者都写时以tui.effects.starfield为准。配置别名改在合并各层配置之前统一换算。 - ⚠️ 移除功能开关
features.guardianv2.thread_context:自动审批审查一律使用线程自身的上下文,配置里(包括 profile)残留这一项会被忽略,并提示删除。 - ⚠️ 随附目录删去
gpt-5.4,Amazon Bedrock 目录删去openai.gpt-5.4,设置里仍是它们时提示迁移到 GPT-6 Sol。Bedrock 的 GovCloud 端点(主机名形如bedrock-mantle.us-gov-*.api.aws)改用单独的默认目录,只有 GPT-5.6 Terra 与 GPT-5.6 Luna,默认 GPT-5.6 Terra(见模型与推理)。 - ⚠️ ChatGPT 登录的本地回调地址由
localhost改为127.0.0.1(端口仍是 1455,见安装、登录与升级)。 - 全屏模式下不再显示启动提示,输入框上方也不再轮换显示使用提示(那里只留给额度提醒);改为一轮工作超过 30 秒时在工作状态下方随机显示一条提示,成功完成的轮次偶尔也会在回复后显示一条(从第三轮起,每次启动最多两次),
tui.show_tooltips = false可以关闭。新会话的标题改为紧凑样式加一句随机问候语(见斜杠命令)。 - 登录引导界面按
c复制浏览器登录链接,也可以直接用鼠标选中链接与设备码;修复连接本机守护进程时不会自动打开浏览器登录的问题。 - 自动启动后台服务时,如果 Windows 上的启动器(如
cargo run)不允许后台进程脱离它继续运行,改用内嵌服务并给出警告,不再无法打开;Windows 上以管道方式启动的子进程也不再弹出控制台窗口。 - Windows 沙箱:修复 Windows 10 上普通本地路径打不开、已保存的沙箱账户凭据被系统拒绝,以及权限策略过大、超出命令行长度限制时的启动失败。
- Linux 沙箱在可写目录相互嵌套时(如只读的
.codex下面还有可写目录)能正常启动,元数据仍受保护;Linux 与 macOS 上,.git指向另一个可写根目录里的 Git 目录时,这个目录同样保持只读。macOS 上的补丁权限检查能识别/tmp与/private/tmp这类系统路径别名,不再为已经授权的位置多弹审批;全局按文件名拒绝的规则(如/**/.env)不再阻止移动或删除它们的上层目录。 - 自动审批审查进行期间收到你的新消息(比如只是问一句进度)时,改为按最新的授权依据重新审查,不再直接中止待审的操作。
- Mermaid 流程图支持带引号的标签以及标签里的
&(如A["Review & confirm"]);渲染不了的图会在源码上方说明原因(语法不支持、超出尺寸限制或终端太窄)。 - 服务端返回
Retry-After时按它的时间重试;使用 Flex 服务档位时容量不足(flex_unavailable)会直接结束本轮并提示Flex capacity unavailable.,不再重试;上传文件遇到 HTTP 502、504 也会重试。 - 命令完成事件包含订阅开始之前就已产生的输出;进程根本没能启动时,同样发出命令开始与失败事件(退出码
-1),客户端不再漏掉这类失败。 /feedback在你同意上传日志时,附带 TUI 客户端最近 1 MiB 的日志,以及所选会话从上游 rollout 继承的历史;SQLite 诊断日志写入失败时给出警告,提示提交日志或运行codex doctor。info 级别的日志不再记录 WebSocket 响应头与工具调用参数的预览。- shell 快照遵循
shell_environment_policy:被排除的变量不再进入快照,重放时也不会覆盖set指定的值。 - 支持 ChatGPT Pro Max 套餐,界面上的套餐名改为 Pro、Pro (More)、Pro (Max),分别对应
prolite、pro、promax(见模型与推理)。 - 网络策略的管控扩展到历史笔记、图像生成与 ChatGPT 后端请求。
- 多代理 V2 新增
features.multi_agent_v2.disable_direct_message,关闭 agent 之间直接发消息的工具(派生子代理与结果回传不受影响);它依赖仍在开发中的 agent 留言板,目前只在试用留言板时用得上(见子代理)。 - App server:
thread/revert不再接受临时(ephemeral)线程;插件摘要去掉extensions字段;错误信息新增flexUnavailable,套餐类型新增promax。
v0.157.x
v0.157.0(2026-09-25)
- 🆕 GPT-6 Sol(
gpt-6-sol)与 GPT-6 Luna(gpt-6-luna)进入主线版本;Amazon Bedrock 目录加入openai.gpt-6-sol与openai.gpt-6-luna(Bedrock Runtime 另有global.、us.开头的路由),GPT-6 Sol 成为 Bedrock 的默认模型与兜底模型(见模型与推理)。 - 🆕 对话正在另一个应用中打开、这里只能只读查看时,按
f可以分叉出一个可编辑的副本继续工作,草稿与排队的提示词一并带过去。 - 🆕
/import在远程会话和连接本机守护进程的会话中也能用了,导入通过所连接的 app server 执行。 - 🆕 Markdown 列表的项目符号显示为
•,任务列表的勾选框显示为☐、☑(设tui.rendering.lists = false恢复原样);公式渲染支持aligned对齐、\boxed、求和上下限以及\underset、\overset等优化问题常用的写法。 - 🆕
auto_review.extra_policy给自动审批审查追加一段策略文本,托管的guardian_extra_policy优先;自动审批审查默认改用线程自身的上下文(guardianv2.thread_context默认开启)。 - ⚠️ 全屏对话记录默认开启:
tui.fullscreen_transcript的默认值改为true,界面由 Codex 接管对话记录的滚动、选择与搜索。想继续用终端自己的回滚记录,在/tui里选 Scrollback,或把它设为false;--no-alt-screen与tui.alternate_screen = "never"仍然优先。全屏模式下按住Shift单击可以扩展已有的选区(见斜杠命令)。 - ⚠️ 自动启动后台服务默认开启:
daemon_auto_start转为稳定功能并移出/experimental,符合条件的交互式启动(包括恢复与分叉会话)会自动拉起共享的本机 app-server 守护进程。带了--oss、--profile、大多数-c配置覆盖或--strict-config等参数时,本次改用内嵌服务并给出提示;守护进程的共享功能设置与本次启动不兼容时,会让你选择这次不用守护进程、按新设置重启它,或者取消(见 SDK 与 App Server)。 - ⚠️ 随附模型目录里的
gpt-5.6-sol去掉了 Ultrafast 服务档位,对应的/ultrafast命令随之消失,只剩 Fast。 - 语音对话在切换线程时不再中断,回到原线程即可继续;代理总览里正在通话的任务带有
voice标记,?打开的快捷键提示里也列出了语音开关。 - 一轮结束时,提问框里还没发送的回答会追加回主输入框,不会丢失,也不打断正在进行的
Ctrl+R历史搜索。 - tmux 中把
mouse设为关闭时,Codex 不再捕获鼠标;通过 SSH 使用 macOS 自带的 Terminal.app、且tui.alternate_screen = "auto"时,自动改用终端原生的回滚记录。 - 语音对话的实时连接与独立的网页搜索(包括搜索结果的重定向)会遵循配置的代理;上传文件遇到暂时性错误时自动重试,上传超时从 60 秒放宽到 5 分钟。
- 网络限制对重定向以及进行中的 HTTP、WebSocket 流量持续生效,策略变化撤销访问权限时会取消相应请求;托管的
application.network要求也覆盖 app server、AWS 认证与遥测等请求。 - MCP:Unix 上的本地 stdio 服务器只继承标准输入、输出与错误三个文件描述符;OAuth 授权端点只接受
http与https(见 MCP 集成)。 codex doctor会列出完整性检查失败的 SQLite 数据库路径,并按检查结果给路径与 URL 上色。- 原生 Windows 沙箱令牌的默认访问权限只授予当前登录会话;Linux 沙箱能遮蔽经由上层目录挂载暴露出来的守护进程套接字,不再因此拒绝启动。
- App server:新增
account/gatewayOAuth/read、account/gatewayOAuth/login、account/gatewayOAuth/cancel方法与account/gatewayOAuth/changed通知,客户端在initialize中声明explicitGatewayOauth后,可以自己决定何时为模型网关发起浏览器登录;MCP 服务器状态新增httpOrigin;轮次进行中也能更新执行环境的选择。
v0.157.1(2026-09-26)
这一版的发布说明是空的(生成失败),以下依据 rust-v0.157.0...rust-v0.157.1 之间的提交整理,都是 Windows 上的修复:
- 启动 code-mode host 与本地 stdio MCP 服务器时不再弹出控制台窗口。
- 修复守护进程在残留 Job Object 成员关系时无法启动,以及分离启动的守护进程继承启动器的输出管道、导致调用方一直等待的问题。
v0.156.x
v0.156.0(2026-09-22)
- 🆕 全屏对话记录:新增
/tui,选择下次启动时的界面模式。Fullscreen 由 Codex 接管对话记录的滚动、选择与搜索,Scrollback 沿用终端自己的回滚记录,选择保存为tui.fullscreen_transcript(这一版默认false,v0.157.0 起默认开启)。全屏模式下可以用鼠标拖选、双击选词、右键复制,F3(对话记录视图里也可以按/)在整个对话中搜索,F4聚焦某组工具活动查看详情,普通单击就能打开链接(见斜杠命令)。 - 🆕 语音对话默认开启:功能开关
realtime_conversation转为稳定并默认开启,不必再到/experimental里打开。F8开始或结束语音对话(tui.keymap.chat.toggle_voice),/voice settings从服务端的声音目录里选择之后对话使用的声音(保存为realtime.voice);Linux 与 Windows 的发布包也附带了语音运行时。 - 🆕
/usage的菜单改为 View analytics 与 Redeem reset 两项。前者打开全屏的账户用量分析面板,分概览、用量、消息、插件、技能、对话等标签页展示 token 用量、活跃情况与常用的插件和技能,支持 7 天与 30 天两种范围,Business 与 Enterprise 账号看到的是 token 与 credits;/usage daily、weekly、cumulative直接打开对应的 token 活动视图。 - 🆕 代理总览(界面上改称 agent command center)大改:按 All、Needs you、Working、Ready、Inactive 分标签筛选(
Tab、Shift+Tab切换),可以按项目、状态或模型分组;任务详情显示所用模型、token 数,Business 与 Enterprise 套餐还显示 credits 与美元估算;由另一个 app server 管理的任务以只读历史打开。任务操作的默认快捷键改成单个按键,如n新建、w新建 worktree 会话、a归档、h隐藏、Backspace删除,按?查看全部(见子代理)。 - 🆕 worktree 转为稳定功能并默认开启:
--worktree、/worktree不必再先启用实验功能;在本地 Git 仓库里执行/new、/fork会先问新对话放在当前检出还是新 worktree 里;代理总览里按w从项目的默认分支新建 worktree 会话(见 Codex Cloud、GitHub 与 IDE)。 - 🆕 新增
ada、babbage、curie、cushman、dali、davinci六个内置主题,选中项等处的强调色也跟随主题变化。回复中的 Mermaid 代码块渲染成字符图,$$...$$、\[...\]形式的独立公式与行内公式以 Unicode 排版;Mermaid、公式与表格的渲染可以分别用tui.rendering.mermaid、tui.rendering.math、tui.rendering.tables关掉,关掉后显示原文。 - 🆕
/daemon菜单显示本机后台服务(app-server 守护进程)的版本,可以选择安装最新稳定版,或者把当前 CLI 的安装包复制过去并固定版本;确认后 Codex 退出,在当前终端里执行更新。另有启动参数--no-daemon:本次完全不使用共享的后台服务,resume、fork以及archive、unarchive、delete同样认这个参数(见启动命令行选项)。 - 🆕 实验功能
daemon_auto_start(/experimental中的 Automatically start the background server,这一版默认关闭):交互式启动时自动拉起共享的后台服务,启动或连接失败时直接报错并建议改用--no-daemon,不再悄悄退回内嵌服务。 - 🆕 守护进程改用独立的安装包目录
CODEX_HOME/packages/app-server-daemon:还没有守护进程安装时,daemon start、restart、bootstrap会复制当前 CLI 的完整安装包,bootstrap因此不再要求独立安装版;单独更新守护进程不会改动你的codex命令与 shell 配置。codex app-server daemon update会把旧的独立安装迁移过去,也能让固定了版本的安装回到正式版更新;新增的daemon update --from-cli [-y]则把当前 CLI 的安装包复制过去并固定版本(见 SDK 与 App Server)。 - 🆕
/warnings或F2打开警告查看器,集中查看启动、运行时、MCP 与弃用提示等诊断信息,底部状态栏只显示去重后的警告数;额度快用完的提醒改为固定显示在输入框上方的提示行里。 - 🆕
/model选择器里按s,只把所选模型与推理强度用于当前会话,不改动保存的默认值。 - 🆕
codex mcp login <名字> --no-browser:只打印授权链接、不打开浏览器,在别处完成授权后,把浏览器地址栏里的回调 URL 粘贴回终端即可(见 MCP 集成)。 - 🆕
[tui.effects]分别控制starfield、shimmer、welcome、effort、progress、title六种动画效果,取代tui.whimsy(旧设置仍能读取,但不再生效);首次启动检测到屏幕阅读器、而你又没设置过tui.animations时,自动写入tui.animations = false;系统开启“减少动态效果”时也不播放动画。 - 🆕 新配置项
model_post_turn_compact_threshold_percent(0~100,默认不启用):一轮结束后,上下文用量达到可用窗口的这个百分比就先做压缩。 - 🆕 模型提供方新增
model_catalog_url(从指定地址获取 Codex 格式的模型目录)与gateway_oauth(网关额外要求的 OAuth 凭据,按配置放进请求头或 cookie);requirements.toml可以用model_provider、model_providers强制指定提供方(见模型与推理)。 - ⚠️ 在输入框为空时连按两次
Esc,改为浏览之前的提示词:←、→选择,Ctrl+T展开详情,Enter把当前会话回退到所选提示词之前,并把它放回输入框重新编辑。回退在原会话里进行,会话 ID、设置与目标都不变,不再分叉出新会话;已经发生的文件改动不会撤销。 - ⚠️ 移除
/personality与功能开关personality:personality设为friendly或pragmatic不再改变回复风格,只有personality = "none"仍会去掉模型指令里的 Personality 小节。 - ⚠️ 移除
windows.sandbox_private_desktop,原生 Windows 的 elevated 与 unelevated 沙箱一律在私有桌面上运行,配置里残留这一项会提示删除;windows.sandbox新增mxc取值(微软的 MXC 容器,需要系统支持);TUI 不再在启动时扫描并警告全局可写的目录。 - ⚠️ 连接本机守护进程或远程 app server 时,
/delete删除会话后回到代理总览,不再退出(使用内嵌服务时仍然退出);在“对话正在另一个应用中打开”的只读界面按Esc,同样回到代理总览。 - ⚠️ 每轮结束时显示的完成时间去掉了
done前缀,写作2:32 PM或Worked for 2m 5s · 2:32 PM;系统设置为 24 小时制时显示成14:32这样的格式。 - ⚠️
project_doc_fallback_filenames只接受单纯的文件名:含/(Windows 上还有\、:)的条目以及.、..会被忽略并记录警告(见 AGENTS.md 项目指令)。 - ⚠️ App server 删除了已弃用的
thread/rollback,改用thread/revert。 - 生效配置或 requirements 里出现不认识的字段时,启动会给出警告(只列来源与字段名,最多三条),拼错或已弃用的设置不再被悄悄忽略。
codex doctor新增文件系统路径检查,逐个解析配置中授权的路径,慢或失败时给出警告;配置加载失败时只报告文件、行号与列号,不再回显配置内容;非交互运行时TERM=dumb只算警告。- 登录与启动阶段的账户发现、云端配置请求直连失败时,改走系统代理重试(功能开关
system_proxy_fallback,默认开启);MCP 的 OAuth 元数据发现返回 503 时改用 OIDC 发现。 - 子代理也可以发起 MCP elicitation(如浏览器登录、表单输入),按现有的审批设置交给你处理;插件安装请求只允许主线程发起。
- 恢复会话时一并恢复之前的计划模式(Plan mode);
codex exec --json的web_search条目保留打开页面、页内查找等动作的细节,有结构化结果时附带results。 - 沙箱:原生 Windows 的离线沙箱同样拦截非回环的入站连接;app server 的 Unix 套接字对受文件系统限制的命令不可见;macOS Seatbelt 禁止能绕过只读限制改写文件的
fcntl调用,并拒绝 XPC 服务查找;受限的 Linux 沙箱会隐藏 WSLg 暴露的重复根目录。 - 修复 tmux 与 SSH 会话中的剪贴板转发;终端把粘贴内容逐键发送时保留制表符缩进;轮次失败、被中断或收到子代理完成事件时,已经流式输出的回答与计划不再丢失。
- App server:
mcpServerStatus/list返回服务器声明的serverCapabilities,thread/resume返回collaborationMode,plugin/read返回插件声明的上手技能onboardingSkill;新增实验性的rollout/compress。
v0.156.1(2026-09-23)
- 🆕 模型选择器加入 GPT-6 Sol 与 GPT-6 Luna。随附目录在你选用
gpt-5.5、gpt-5.6-sol、gpt-5.6-terra时提示迁移到 GPT-6 Sol,选用gpt-5.6-luna时提示迁移到 GPT-6 Luna,已下线的gpt-5.4、gpt-5.4-mini也分别指向这两个新模型;触发限流时的换模型提示改为推荐 GPT-6 Luna。 - ⚠️ 随附目录把 GPT-6 Sol 与 GPT-6 Luna 的默认服务档位设为 Fast:配置里没有
service_tier、也没用/fast关过时,交互式 TUI 选用这两个模型默认就以 Fast 发送请求(官方 Speed 页说明 GPT-6 模型的 Fast 按标准费率的 2.5 倍计),见模型与推理。
v0.155.x
v0.155.0(2026-09-17)
- 🆕 实验性的语音对话
/voice:在/experimental中开启 Voice conversations(功能开关realtime_conversation)后,新会话里就能用语音给 Codex 布置任务,界面显示实时字幕与麦克风、扬声器电平,语音发起的任务完成后会把最终回答念出来。/voice mute或Ctrl+X开关麦克风,/voice stop结束对话。只有附带语音运行时的构建才提供这项功能(从发布流程看,目前是 macOS 与 Linux 的发布包),见斜杠命令。 - 🆕 TUI 的状态行实时显示推理摘要;每轮成功结束后,原来的分隔线换成完成时间(如
done 2:32 PM)。推理摘要默认是否开启见下文 v0.155.1。 - 🆕 代理总览(
codex agents、/agents)可以隐藏(Ctrl+W,不停止任务)、归档(Ctrl+E)或永久删除(Delete)选中的任务,后两者连同子代理一起处理,执行前要确认;→打开选中的任务,新建后台任务时可以粘贴图片(见子代理)。 - 🆕
/worktree的浏览器显示每个 worktree 所属对话的标题、更新时间以及已归档、不可用等状态,还能在确认后删除当前仓库里干净的托管 worktree。 - 🆕 在支持 Touch ID 的 Mac 上,本地 TUI 会话可以用 Touch ID 完成 Codex Apps(连接器)发起的 MCP 身份验证请求;其他 MCP 服务器发起的这类请求一律取消。
- 🆕 新增
codex app-server daemon update,立即检查并安装最新稳定版,再重启托管的守护进程;守护进程的自动更新可以在CODEX_HOME/app-server-daemon/settings.json中关闭或调整间隔,重启后会恢复之前已加载的线程,进行中的目标(/goal)不必等客户端重连就能继续(见 SDK 与 App Server)。 - 🆕 TUI 连接的 app server 是比 CLI 更旧的稳定版时会给出提示,本机守护进程会建议运行
codex app-server daemon update;设tui.show_server_version_notice = false可以关闭。 - 🆕 Amazon Bedrock 提供方支持
aws.credential_export:由外部命令输出 AWS 凭据,凭据缓存在内存里、过期前自动刷新,认证失败时先运行aws.auth_refresh再重新导出(见模型与推理)。 - 🆕
memories.version可以选用新的v2记忆管线(默认仍是v1),两个版本分开存储;memories.dual_write = true时两版记忆同时生成。 - 🆕
SessionStarthook 的来源新增fork:分叉出的会话不再按startup触发,避免重复注入启动上下文(见 Hooks)。 - ⚠️ 移除原生 Windows 专用的
/sandbox-add-read-dir命令。 - ⚠️ 连接本机守护进程或远程 app server 时,
/archive归档后不再退出 Codex,而是回到代理总览;使用内嵌服务时仍然退出。 - ⚠️ 限制了文件系统写入的 Linux 沙箱禁止
AF_VSOCK套接字与io_uring,在 WSL 中还会屏蔽 WSL interop(沙箱内的命令不能再启动 Windows 程序);原生 Windows 的 elevated 沙箱拒绝不允许读取文件系统根目录的权限配置(见沙箱、审批与安全)。 - ⚠️ 随附的模型目录删去
gpt-5.2与gpt-5.4-mini,设置里仍是gpt-5.4-mini时会提示迁移到gpt-5.6-luna;remote_compaction_v2功能开关退役,支持的提供方一律使用流式远程压缩。 - 轮次开始前的上下文压缩失败时,已经提交的提示词仍会保存到对话记录里。
- 修复 tmux 中漏掉窗口尺寸变化、对话记录视图的位置恢复与半页滚动,以及切换线程后残留旧历史的问题。
- MCP 服务器的 OAuth token 过期且无法刷新时,
/mcp中的认证状态改为未登录,工具调用会收到重新连接的提示。 - 自动审批审查更完整地保留待审操作与授权依据,遇到限流等暂时性错误会重试,审查没能完成时仍然拒绝操作,但不再把它说成不安全;单个待审操作不再受 8,000 字节的限制,改以审查模型的输入窗口为限。
- 切换账号后,远程控制会话、缓存的 WebSocket 状态与模型目录一并失效,不再沿用上一个身份。
- 网络代理的凭据代理(
features.network_proxy.credential_broker)可以用新的features.network_proxy.credentials声明自定义凭据提供方;启用凭据代理时,shell 快照不会暴露真实凭据。 - HTTP 429 中表示额度耗尽的错误(如
insufficient_quota)改按用量上限报告,不再显示为重试次数用尽。 - 目标(goal)可以应你的明确要求暂停;自动续跑连续 3 轮只给出空回复、没有任何进展时,目标会被标为
blocked。 - Unix 上的命令 hook 不再继承控制终端,hook 不读 stdin 时也不会卡住(写入 stdin 同样受超时约束)。
- App server 新增
thread/attachment/add、thread/attachment/list、thread/attachment/remove方法与thread/attachment/updated通知,以及实验性的memory/status;Unix 上收到SIGTERM会先清理连接再退出。 - 新增两个默认关闭、仍在开发中的功能开关:
api_key_model_discovery(用 OpenAI API key 登录时从服务端获取模型目录)与codex_apps_mcp_2026_07_28(让内置的 Codex Apps 服务单独启用 2026-07-28 版 MCP 协议)。 - Python SDK 与其运行时包改为在 CLI 稳定版发布后按同一版本号发布;SDK 新增
ExternalMessage(以工具输出的身份传入不受信任的外部内容),thread_resume、thread_fork增加include_turns等参数。
v0.155.1(2026-09-18)
- ⚠️ 本地 TUI 的新会话在没有设置
model_reasoning_summary时,恢复为不请求推理摘要(none)。v0.155.0 为了在状态行显示推理摘要,默认按detailed请求,不支持推理摘要的提供方因此拒绝请求;显式设置的值不受影响。想在状态行看到推理摘要,在配置里设置model_reasoning_summary(如"auto")即可。
v0.154.0(2026-09-09)
- 🆕 模型选择器与 Amazon Bedrock 目录加入 GPT-6-Astra。
- 🆕 实验性的 worktree 支持:用
--worktree或/worktree为新会话或分叉会话创建隔离的检出目录,之后可以浏览并恢复它们;codex exec同样支持托管 worktree。 - 🆕 Codex 继续工作的同时,你可以在行内回答它提出的问题:从建议选项里选,或者自己输入,正在编辑的草稿不会丢。
- 🆕 Windows 上的多个会话可以共享一个后台 Codex 服务,附带守护进程的生命周期命令与托管更新。
- 🆕 Vim 编辑模式新增
R替换模式(支持撤销与.重复),旧式终端里的 Esc 处理也更可靠。 - 🆕 复制回复时在富文本应用中保留格式;
/copy还能复制状态输出或会话的单个字段。 - ⚠️ 已弃用的
codex mcp-server入口被移除,需要把 Codex 嵌入其他程序时改用 app server(见 SDK 与 App Server)。 - 已打开的会话能拿到新安装插件的工具;在外部升级或回滚插件后,会话里的 skills 与 hooks 会随之刷新。
- MCP 连接会协调 OAuth token 的刷新;刷新失败时提示重新登录,而不会自动重放被拒绝的工具调用。
- 在确认信任工作区之前,启动过程不再运行工作区里的辅助程序;macOS 沙箱阻止向终端注入输入。
- 远程恢复与分叉会保留已保存的权限;新会话与分叉默认沿用服务端的模型设置,除非显式覆盖。
- 恢复一个正在另一个应用里打开的对话时,改为显示只读记录并提供重试,同时保留你的草稿。
- 自动审批审查在上下文压缩后能更好地保留授权上下文,并拒绝已被新的用户指令或回答作废的审批。
v0.153.x
v0.153.0(2026-09-03)
- 🆕 Vim 模式支持
u撤销、Ctrl+R重做,完整保留草稿,包括粘贴的内容与附件。 - 🆕 插件 CLI 可以从远程 marketplace 列出、安装和移除插件(见插件)。
- 🆕 设置
tui.auto_recap = false可以关闭自动回顾,手动的/recap仍然可用。 - 🆕 TUI 历史里显示完整的补丁、发给后台终端的输入,以及每一条已完成的命令。
- 🆕 Plus 与 Team 用户在约五小时的用量窗口里剩余额度不足一半时,会更早收到提醒。
- 🆕 新增默认关闭的
features.context_management.experimental_mode:为符合条件的 ChatGPT Plus、Pro 或 Pro Lite 会话(使用 Codex 后端)启用 token 预算上下文、历史笔记与new_context工具;API key 会话、自定义提供方与临时的结构化线程不在此列。 - ⚠️
tui.disable_paste_burst取代原来的顶层设置,旧写法仍作为回退继续有效。 - ⚠️ Full Access 模式下,只需确认的操作不再经过自动审批审查;User approval 模式跳过后台的审查评分与预热,敏感操作检查与向用户提问的处理不变。
- 外部 app-server 连接断开后,TUI 会话会自动重连,保留草稿与对话记录;状态不确定或排队中的提交会暂停,等你确认。
- 自动审批审查的记录能跨越压缩、重启与用户创建的分叉保留下来,同时遵守回滚边界、隔离子代理的历史。
- 记住的 MCP 工具审批按所选的应用账号生效;macOS 上用相对路径配置的 MCP 可执行文件启动更可靠。
- rollout 压缩包含共享历史;
codex exec resume按工作目录挑选会话时能处理压缩过的 rollout;分叉支持符号链接的会话根目录。 - App server:线程元数据新增可为空的
model与reasoningEffort字段;模型目录启用时,支持通过request_user_input_async发起结构化的异步提问。
v0.153.1 → v0.153.4(2026-09-03 → 09-04)
都是围绕 GPT-6-Astra 的热修复,内容见本页开头的表格;0.153.4 起,没有显式配置模型时默认使用 Astra。
v0.152.x
v0.152.0(2026-09-01)
- 🆕 Vim 模式支持在草稿里用
/与?搜索、高亮匹配,并用n、N重复跳转。 - 🆕 触发限流时的横幅提供操作入口:查看用量、管理 credits、重置额度、管理套餐。
- 🆕 TUI 与
codex exec会显示凭据刷新的进度,包括 Amazon Bedrock 的重新认证。 - 🆕 MCP 服务器名可以包含
:、@、/、.,支持包名风格的名字,CLI 命令与认证全程可用。 - 🆕 单个 MCP 工具支持
output_token_limit设置,会话恢复前后的截断行为保持一致(见 MCP 集成)。 - 🆕 App server 客户端可以配置
thread/shellCommand的超时,包括超过一小时的期限。 - ⚠️ 计划工具默认关闭,需要时设置
tools.update_plan.enabled = true开启。 - 插件推荐在启动时就开始加载,减少第一轮之前的等待。
- 启用 Vim 的输入框在新草稿里(包括提交消息或执行斜杠命令之后)一律从 Insert 模式开始。
- 自动审批审查能保留更长的消息与更大的对话记录,并在压缩后保留用户的指令、回答与有效授权。
- 恢复的线程在没有指定工作目录时,回到它保存时的工作目录;更新客户端元数据时保留文件系统权限。
- MCP 工具在缓存刷新与远程插件变化期间保持可用;认证重试会使用辅助程序刷新后提供的请求头。
- 打开模型选择器时会刷新可用模型,且不丢失当前高亮的选项。
- 修复 Windows 沙箱下 Microsoft Store 版 PowerShell 的执行问题、子进程在终端查询时挂起,以及老版 JediTerm 终端的光标显示错乱。
- Codex Cloud 任务请求拒绝不受信任的后端 URL 并禁用重定向,以保护已保存的凭据。
v0.152.1(2026-09-01)
- 自动审批审查遵守模型元数据里提供的 Node REPL 策略。
v0.151.0(2026-08-29)
- 🆕 可以配置可选 MCP 服务器的工具发现宽限期。
- 🆕 扩展(extensions)可以在 MCP 工具结果到达模型之前检查或替换它。
- 🆕 插件目录会合并各仓库的配置;某个项目的 marketplace 无效时会被报告出来,而不再连带隐藏其他有效的插件。
- TUI 的各轮之间保留恢复出的权限配置档,并防止
/cd放宽沙箱限制。 - 切换模型或回退到其他模型时,工具的可用性与推理强度保持正确。
- 远程沙箱按执行端实际的主目录、操作系统与路径约定来执行限制。
- app server 的响应里保留结构化的 MCP 工具与资源错误。
- 嵌套子代理的 token 用量计入根目标的预算。
- 权限状态变化后,过期的审查分类结果不再能授权操作。
v0.150.x
v0.150.0(2026-08-26)
- 🆕 可以用
@提及引用其他 Codex 任务,并在终端里让 agent 读取、创建任务或给任务发消息。 - 🆕
/copy提供选择器,可以复制完整回复、单个代码块或引用块。 - 🆕 未命名的终端任务会自动得到描述性的标题;
/rename会根据对话建议一个可编辑的标题。 - 🆕 在支持的终端里,Markdown 链接显示为可点击的标签,其他终端仍显示 URL。
- 🆕 可以绑定快捷键循环切换权限模式;Vim 模式支持用
.重复上一次编辑。 - 🆕 新增
Interrupthook:顶层轮次被中断时,可以运行命令或 MCP 处理器(见 Hooks)。 - ⚠️ 未受信任的项目不再提供项目级的
AGENTS.md指令(见 AGENTS.md 项目指令);权限变更之后,托管的禁止读取规则仍然有效。 - app server 的诊断信息对凭据的脱敏更完整,覆盖提供方、认证刷新与证明相关字段。
- 修复远程 MCP 的 bearer token 查找与必需服务器的启动,同时保持与旧版执行端兼容。
- 修复 Windows 在 Unicode 用户路径下的提权沙箱设置与启动别名。
- 修复 Unix 上脱离的进程占着终端或终端输出缓冲区写满时导致的退出挂起。
- 修复 Amazon Bedrock 模型的对话压缩与多代理兼容性。
v0.150.1(2026-08-27)
- 远程压缩默认把保留的图片计入 token 预算,必要时裁掉较早的图片。
v0.149.1(2026-08-24)
发布说明里没有列出面向用户的变更。
查看更完整的变更
- 每个版本的完整 PR 列表在
https://github.com/openai/codex/releases/tag/rust-v<版本号>。 - 官方文档站的 What's new 每周汇总一次 CLI、桌面端、IDE 扩展与 Codex Cloud 的新功能。
- 实验性功能是否在你的版本里可用、是否已开启,可以用
codex features list查看(列出每个功能的成熟阶段与实际生效状态)。