Codex CLI 0.164：预设槽与内联模型参数解析

OpenAI 的 Codex CLI 在 0.164.0 版本中引入了一批面向工作流效率的改进：十个 /presets 预设槽、/model 与 /permissions 的内联参数支持，以及远程命令的凭据掩码。这些改动看似零散，实则共同指向一个目标——让命令行里的 AI 编程助手更接近“可配置的开发环境”，而非一次性对话工具。

预设槽：把常用配置固化下来

/presets 提供了十个可命名的配置槽位。此前用户每次切换模型、调整权限策略，往往需要重复输入完整命令或依赖外部脚本；现在可以把一组参数保存为预设，通过槽位快速调用。

这个设计的价值在于降低上下文切换成本。比如一个团队可能同时维护“快速补全”“深度重构”“只读审查”三种使用模式，对应不同的模型和权限组合。预设槽让这些模式成为可复用的命令，而不是散落在 shell 历史里的长串参数。十个槽位的上限也说明官方将其定位为轻量配置，而非完整的配置文件体系。

内联参数：/model 与 /permissions 直接带参

0.164 版本允许在调用 /model 和 /permissions 时直接附带参数，省去二次交互。对于习惯脚本化操作的用户，这意味着可以把模型选择和权限设定写进单条命令，便于在 CI 或自动化流程中复用。

权限内联尤其值得注意。Codex CLI 涉及文件读写和命令执行，权限边界是实际使用中的敏感点。将权限参数显式写在命令里，比依赖默认值或交互式确认更容易审计——命令历史本身就是一份权限变更记录。

斜杠命令（Slash Command） 是交互式 CLI 中约定俗成的指令形式，以 / 开头，由 CLI 自身解析而非交给底层 shell。与普通 shell 命令不同，斜杠命令通常在交互会话内生效，可读取并修改会话状态（如当前模型、权限策略）。0.164 之前，/model、/permissions 多为无参调用，执行后进入子菜单或追问式选择；内联参数则把参数解析合并进同一条指令，本质上是把“命令 + 交互应答”压缩为一次幂等调用。这也解释了它对脚本化的意义：无参命令依赖 TTY 交互，难以在管道或 CI 中复用，而带参形式可以非交互式地确定性地完成配置切换，退出码和输出也更易被上层工具解析。

凭据掩码：远程命令的安全补丁

远程命令场景下，0.164 版本加入了凭据掩码（credential masking）。当命令输出或日志中可能包含敏感信息时，该机制会对其进行遮蔽处理。

这一改动针对的是 AI 编程工具普遍存在的一个风险面：CLI 在执行远程操作时，令牌、密钥等凭据可能经由输出流泄露到日志或终端回显中。掩码机制不能替代最小权限原则，但作为一道默认防线，它降低了误暴露的概率。官方提示用户在升级后检查依赖远程命令的工作流，确认掩码行为是否符合预期。

凭据掩码（Credential Masking） 与常见的日志脱敏思路一致：在数据离开进程边界前，用模式匹配或已知密钥指纹识别敏感子串，并以 *** 之类占位符替换。它区别于“凭据加密”（传输或静态存储加密）和“凭据隔离”（不把密钥放入环境变量或命令行），属于输出侧的兜底手段。典型实现会维护一组正则或熵检测规则，覆盖 API Key、Bearer Token、私钥块等形态，并在 stdout/stderr、调试日志和错误回溯中统一过滤。其局限在于掩码发生在事后，若密钥已被写入远端日志系统或通过副作用外泄，仍不可挽回；同时过于激进的规则可能误伤正常输出。因此业界普遍将其视为纵深防御的一层，需与最小权限、短期令牌、密钥轮换等措施配合。

升级建议与检查清单

本次更新属于功能增强型版本，没有提及破坏性变更，但有几处值得在升级后验证：预设槽的持久化位置与团队共享方式、内联参数与既有脚本的兼容性、以及远程命令输出中掩码的覆盖范围。对于在自动化流水线中使用 Codex CLI 的团队，建议先在非关键环境验证内联权限参数的实际生效逻辑，再推广到主流程。

总体来看，0.164 的改进方向是“可配置性”与“安全性”两条线并行：预设和内联参数解决效率问题，凭据掩码补上安全短板。对于把 Codex CLI 当作日常开发工具的用户，这些变化值得花时间重新梳理一遍自己的命令习惯。

背景补充

预设（Preset）与配置文件的区别 值得厘清。预设槽通常指在应用内部持久化的一小组命名参数集合，粒度较粗，面向会话级快速切换；而配置文件（如 TOML/YAML）支持分层覆盖、环境变量插值和项目级与用户级合并，适合承载复杂且需版本管理的配置。十个槽位的上限暗示预设走的是“热键式”轻量路径，持久化位置多半在用户配置目录而非项目仓库，这也意味着团队共享需要额外手段（导出、同步或文档化）。理解这一边界，有助于判断哪些配置应固化进预设、哪些仍应交给配置文件或环境变量，避免把团队协作约定塞进个人槽位而失去可追溯性。