教程2026-10-30 · 智涌AI

Codex 0.166 键盘选区与队列恢复怎么用

Codex CLI 0.166 教程头图:终端展示 codex-cli 0.166.0、queue --thread/--message/--resume 与 doctor --network-only

Codex CLI 0.166.0(GitHub 标签 rust-v0.166.0,2026-10-29 19:47 UTC)正式带上了 transcript 键盘选区、集成搜索,以及 codex queue --resume。本机装了 @openai/codex@0.166.0,跑过 codex --version、codex --help、codex queue --help 和 codex doctor --help;选区与排队行为对照 Release 与 PR #57221–#57224、#57232。套餐、额度和本地模型接法见 Codex 怎么买、多少钱;短讯见 Codex 0.166 快讯。这里不展开。

环境:Debian box;2026-10-30(北京时间)执行 npm install @openai/codex@0.166.0,codex --version 输出 codex-cli 0.166.0。下文命令可复制。选区快捷键与动作以 Release 与上述 PR 为准;本机只跑了 help/version,没有走付费 API。

前置:升到 0.166.0 并扫一眼命令面

npm 上 @openai/codex 可装到 0.166.0。任选:

# 一次性跑(拉对应平台二进制)
npx @openai/codex@0.166.0 --version

# 或装进全局 / 项目
npm install -g @openai/codex@0.166.0
codex --version
# → codex-cli 0.166.0

本机实测版本行即 codex-cli 0.166.0。顶层 help 已列出 agents、exec、queue、resume、fork、doctor、mcp、plugin 等;无子命令时参数转给交互 CLI。和 0.165 对比的完整变更页:rust-v0.165.0...rust-v0.166.0。

构建元数据(Release Chores):开发与发布构建统一到 Node.js 24.22.1 与 Rust 1.95.0;standalone executor 打进正式 CLI / app-server 包。你本机 Node 不必等于 24 才能跑已发布的 npm 包——本机用 Node 22 也能装出 0.166.0 并打出版本行。

终端:codex-cli 0.166.0;codex queue --help 显示 --thread、--message、--resume;doctor 含 --network-only
2026-10-30 本机:@openai/codex@0.166.0;版本 codex-cli 0.166.0;queue --help 含 --resume;doctor --help 含 --network-only。

分步 1:键盘选区——从历史里精确抠一段

长会话里常要引用 Agent 早先打出的报错、补丁或命令输出。0.166 把键盘驱动的 transcript 选区做成正式能力:词、行、页级移动,集成搜索,快捷键可配(Release 首条 New Features)。

PR #57221 把动作写细:

搜索挂在选区模式上(#57222):

入口快捷键(#57223):配置键 tui.keymap.global.select_transcript。未改绑定时有隐式「leader + [」——leader 跟你现有 TUI leader 配置走。可显式 remap 或 unbind;与已有绑定冲突时按现有键位处理。选区命令优先于被 remap 的 pager 快捷键。页脚显示选区导航与复制提示,宽度不够时缩略。

离开选区时按住退出键,旧逻辑可能把重复输入灌进 composer 并误提交草稿。#57224 改了输入路由:退出键被消费掉,提交与排队要重新按键;选区外的粘贴在搜索态会被忽略。

异步问答与 transcript 回复的 Markdown 渲染也对齐了(#57259、#57292),选中复制时格式更一致。用法上:先搜索跳到关键字,再用 V 扩成整行或词移动收窄,复制后贴回 composer,当作「只保留这段」的锚点。

分步 2:codex queue --resume——排队后把线程拉回来

本机 codex queue --help 原文要点:

Usage: codex queue [OPTIONS] --thread <THREAD> --message <TEXT>

      --thread <THREAD>   Session UUID 或精确会话名
      --message <TEXT>    要排队的文本
      --resume            入队后,尝试在本地 daemon 或所选 --remote
                          上恢复该线程;恢复失败只警告,入队仍算成功

常见情况:线程已卸下,你还想先塞一条后续指令,再把它拉起来继续跑:

# 把 THREAD 换成会话 UUID 或确切名字
codex queue --thread "$THREAD" \
  --message "继续修 failing test,先看最近 git diff,不要扩 scope" \
  --resume

PR #57232 补充:

远程对准可用 --remote:ws://host:port、wss://…、unix:// 或 unix://PATH;bearer 可用 --remote-auth-token-env 指环境变量名。-c key=value 可覆盖启动配置,但排队消息用的是该线程已有模型。本地还可 -C/--cd 指定工作根。

codex resume(子命令 resume)负责交互会话恢复(默认 picker,可用 --last);queue --resume 是先写入队列消息,再可选唤醒。只想接着聊,用 codex resume --last 更直接。

场景更合适的命令
回到上次交互会话继续聊codex resume / codex resume --last
给已有会话塞消息,并尝试唤醒未加载线程codex queue … --resume
只诊断连通与 WebSocketcodex doctor --network-only
从历史复制一段精确上下文transcript 键盘选区 + 复制
分叉一份历史另开话题codex fork(本版另修了恢复/分叉时审批与权限保留)

分步 3:安全拦截说明与 doctor --network-only

TUI 侧(#57363、#57365):生物安全与网络安全策略拦截会给出主题说明,并可选更安全的后续提示;说明与错误域不匹配时回退旧错误处理。拦截解释未就绪时先显示临时通知;排队输入在 recourse 等待期间会被暂存。

排障侧本机已确认:

codex doctor --network-only
# 只跑:有效配置、网络环境、provider HTTP、Responses WebSocket
# 跳过库表、MCP 等;配置加载失败则红acted 报错并停止探测

codex doctor --json          # 机器可读(脱敏)
codex doctor --summary       # 只看分组行与最终计数

另:捆绑、Vertex AI、Amazon Bedrock 模型目录加入 GPT-6.1 Terra(#57293)。目录里有条目,不代表你账号所在区域一定开通,以产品侧为准。修复列表里两条运维向改动也相关:恢复/分叉时保留已确认的审批与权限(#57227);跨 resume/fork 保留推理 Token 记账,避免过早压缩(#57839)。

常见坑

  1. --resume 失败仍显示成功:help 写明恢复失败只警告,入队仍成功。CI/脚本别只看退出码;要扫 stderr 警告,或随后用 codex resume / codex agents 确认线程是否在跑。
  2. 选区快捷键对不上:默认隐式是 leader + [。若改过 tui.keymap.global.select_transcript 或解绑,按旧记忆会失效。与 pager remap 冲突时选区优先——先查配置再怀疑功能消失。
  3. 离开选区误提交草稿:升到 0.166 后 #57224 会吃掉退出键并要求重新按键才提交。若仍复现,先确认 codex --version 真是 0.166.0(有人全局与 npx 各装一版)。
  4. 把 queue --resume 当成 resume:前者必须带 --thread 与 --message;缺一不可。只想继续上次会话,用 codex resume --last。
  5. THREAD 写错名字:help 要求 Session UUID 或精确会话名。模糊名前缀不会自动补全;归档会话会拒恢复。

完成标准

最后

先升到 0.166.0,用 help 确认 queue --resume 和 doctor --network-only,再在真实会话里练选区复制和排队恢复。发版说明见文末;套餐与本地模型看 系列第 1 篇,短讯见 Codex 0.166 快讯。

信息来源
关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。