Codex CLI 0.147.0 除了功能更新,还包含一批值得单独关注的安全修复——涉及密钥/令牌展示脱敏、插件隔离加固、陌生本地项目的信任确认强制化等。本文基于官方 Release Notes 系统梳理这批安全相关变更。
修复一:更完整地遮蔽 Secret 与 Bearer Token
Redact secrets and complete bearer tokens from displayed
commands and replayed conversation history
在展示命令和重放对话历史时,Codex CLI 现在会更完整地遮蔽敏感凭据和完整的 Bearer Token。此前的脱敏机制可能存在覆盖不完整的情况——比如某些格式的 Token 在命令重放场景下会被完整暴露,这次修复扩大了脱敏覆盖范围。
实战提醒:
安全修复并不替代最小权限原则。仓库内的 Plugin、Hook、
MCP 和脚本仍应像普通依赖一样审查,不能因为有了脱敏
机制就放松对密钥管理的整体要求
修复二:陌生本地项目强制要求显式信任
Require explicit trust for unfamiliar local projects and enforce
managed authentication restrictions before credentials are used
对于不熟悉/首次接触的本地项目,Codex CLI 现在要求显式的信任确认,并且在凭据被实际使用之前,会强制执行托管认证限制(managed authentication restrictions)。这个设计逻辑和"陌生 U 盘插入电脑要先扫描"类似——不因为项目"看起来正常"就自动给予完全信任,而是要求用户主动确认。
修复三:插件隔离加固 + 策略更新失败时拒绝网络
Harden plugin isolation and deny network access when policy
updates fail
关键设计:
如果插件的安全策略更新过程本身失败了,系统不会
"默认放行"网络访问,而是采取更保守的"拒绝"策略
这是一个值得称赞的安全设计原则——失败时默认拒绝(fail closed)而不是默认放行(fail open)。很多系统在策略加载失败时会退化为"不限制"的宽松状态(这本身就是一种常见漏洞模式),Codex 这里选择了更安全的相反方向。
配套的稳定性/体验修复
虽然不是严格意义上的安全修复,但这批更新里还包含几项直接影响日常使用体验的问题修复,一并列出:
- 修复终端重新获得焦点、MCP 服务器初始化、
Ghostty 处理键盘快捷键场景中终端输入丢失或卡住的问题
- 修正日文字符、Emoji、超链接和视口边界附近文本的
渲染与光标定位问题
- 正确中断 Windows 后台进程,统一处理 Windows
文件系统路径
完整的升级前检查清单
结合官方文档和社区维护的迁移指南,建议按以下顺序验证升级:
1. 记录升级前的 codex --version、登录方式和安装渠道
2. 搜索 CI、脚本和文档中残留的 --full-auto 参数引用
3. 备份或提交 config.toml、AGENTS.md、Rules、Hooks 与
Plugin Marketplace 的预期版本
4. 更新 CLI 后检查 codex --help 和 codex exec --help
输出是否符合预期
5. 在非生产仓库测试只读、workspace-write、审批批准和
拒绝三条路径是否都表现正常
6. 验证已有的 MCP、Plugins、Skills、Subagents 和
导入会话是否正常工作
7. Windows 团队额外测试路径处理、进程中断和终端输入
8. 全部验证通过后,再更新共享镜像、CI Runner 或团队
安装文档
为什么建议尽快升级
三项核心安全修复的共同特征:
1. Secret 脱敏 —— 降低敏感信息意外泄露到日志/
命令历史的风险
2. 陌生项目强制信任确认 —— 防止在未经审查的项目里
意外执行凭据相关操作
3. 插件隔离 + fail-closed 策略 —— 即便策略系统本身
出故障,也不会退化成"不设防"状态
这三项修复分别覆盖了"展示层泄露""信任边界""故障降级方向"三个不同维度的安全属性,对于团队/企业环境中把 Codex CLI 集成进 CI 或多人共享配置的场景,建议尽快评估升级。
总结
Codex CLI 0.147.0 的安全加固合集虽然不像功能更新那样吸引眼球,但"失败时默认拒绝""陌生项目强制信任确认""更完整的密钥脱敏"这几项设计,体现了团队在安全默认值(secure by default)上的持续投入。对于把 AI 编程助手用在真实生产环境、涉及敏感代码库的团队来说,这类"看不见但很重要"的更新值得优先关注。
来源:Codex CLI 0.147.0 Release Notes — OpenAI 官方 GitHub Release