Codex CLI v0.167 更新解读：agents 未读标记与自动压缩修复，还有一个文档打架的坑

v0.167.0 带来 6 个新功能和 6 个修复，最值得关注的是 agent 命令中心的未读标记，以及自动上下文压缩终于把失败响应占用的 token 算进去了。作者还发现 release notes 与官方文档在 --no-daemon 参数上互相矛盾，并整理了 config.toml 里压缩阈值的具体配置方法。

codex agents 命令中心与一个文档矛盾

• codex agents 用于在共享的本地或远程服务器上打开 agent 命令中心，浏览聊天记录并切换 agent，状态为 Stable
• 本次更新给命令中心和会话选择器加了未读标记，共享服务器上没看过的结果会标出来
• TUI 内可用 /agents 打开同一界面，/subagents 则切换当前活跃的 subagent 线程
• 注意：release notes 写的是 codex agents --no-daemon，但官方文档明确说该命令不支持 --no-daemon，两者矛盾。建议先直接跑 codex agents，失败了再试加参数
• 相关参数：--remote <URL> 连远程服务器，--cd <DIR> 设置远程任务目录，--remote-auth-token-env 需搭配 --remote 使用

自动压缩修复：失败响应的 token 不再漏算

• 此前失败响应保留的输出、以及缺少 token 用量数据的响应，都不计入压缩判断，导致实际消耗被低估
• 这种偏差会让长会话在压缩从未触发的情况下耗尽上下文，是本次影响面最大的修复
• 阈值在 config.toml 里配置：model_auto_compact_token_limit 设触发 token 数（示例 300000）
• model_auto_compact_token_limit_scope 可选 total（计全部活跃上下文，默认）或 body_after_prefix（只计压缩前缀之后的增量）
• model_post_turn_compact_threshold_percent 控制回合结束时按可用窗口百分比压缩（如 85），设 0 可关闭；compact_prompt 可自定义压缩提示词
• 手动压缩用 /compact，长任务后使用可保留要点又不撑爆上下文

两个还没进配置文档的新功能

• Vertex AI 设置向导：release notes 提到开启 gcp_setup_wizard 可通过 Application Default Credentials 或凭据文件配置 Google Cloud Vertex AI，但该键名截至 2026-11-09 在配置参考里查不到
• 已文档化的 Vertex AI 键：model_providers.gcp.project_id、location（默认 global）、credential_file、base_url，均可覆盖对应的环境变量
• 系统代理：可在 /experimental 里选择启用 macOS 或 Windows 的系统代理设置，对应键 features.network_proxy 默认关闭
• 但读取系统代理配置及 HTTP_PROXY 等环境变量的处理方式未在文档中确认，开启前建议先查环境变量相关页面

其余修复：不再丢状态

• 切换 model provider 后已保存的聊天仍然可见；无法恢复的会话也能读 transcript，并生成可编辑的 prompt 以便换地方继续
• Ctrl+L 只清屏不清会话，历史消息仍可通过 Ctrl+T 找回（文档只确认了前半句）
• 删除暴露出开头 ! 的文本后，草稿能保持普通聊天模式
• 网络审批提示在请求结束后自动关闭，同一端点的并发请求逐个提示
• Realtime V3 长对话会随转写增长把已完成的语音存入聊天历史

文档层面的变化

• app-server README 新增 [permissions.network] 下的托管网络约束说明
• 新增需要人工重新审批的 prompt-user 命令规则
• 注意配置参考里没有这个字面名称的段落，实际文档格式是 [permissions.<name>] 配套 network.* 键