
字节笔记本
2026年10月9日 · 约 3 分钟读完
终端标签不该只会转圈:Claude Code 接上了三种状态
终端标签一直只有两种表情:转圈,或者停。agent 真正卡在确认框上时,标签还在转,人就会误判它还在干活。Claude Code 2.1.295 把 Program Status Protocol(OSC 7501)接进来,让兼容终端能区分三种状态:在跑、在等、结束。发布说明落在 2026 年 10 月 8 日,作者是官方仓库的 ashwin-ant。
这不是新模型,也不是云端功能。它是一段终端转义协议:程序把自己的状态推给仿真器,标签页和状态栏可以跟着变。X 上 Ghostty 作者用 Rex 验证过这条协议,热度大约 1600 赞。事实以官方 changelog 为准。

OSC 7501 解决什么
coding agent 会长时间占着一个窗格。人切去看别的仓库,再回来时只看到一个转圈。OSC 7501 让支持它的终端把状态拆开:working 是工具还在跑;waiting 是在等确认或输入,不能当成空闲;done 是这轮结束,可以放心切走。
对开着十几个 agent 窗格的人,这比再装一个菜单栏监控更贴近现场。状态跟终端走,不经过云,也不另开账号。前提是终端实现了这条 OSC。没实现的仿真器看起来和升级前一样。

同版本里还有哪些能摸到的改动
changelog 同一条发布里,还有几处直接改手感的东西。Hooks 增加 onFailure: "block":命令或 HTTP hook 启动失败、超时或异常退出时,可以挡住后续动作,避免「hook 没跑也继续改文件」。/copy 会带上引用里的草稿正文,并且去掉 > 前缀,粘到别处不用再清引用符。claude -p 如果一直挂着,且 stderr 是 TTY,会在标准错误里打印此刻在等什么,非交互管道不再像死掉。
插件的安装、启用、停用和 marketplace add,会在写入的设置文件加载失败时给出警告,少一种「装上了但没生效还不知道」。网关侧多了 timeouts.upstream_ttfb_ms、按上游限制模型列表,以及 forceLoginMethod: "gateway"。重试看门狗可以用 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 限制无人值守时在 429/529 上傻等的时间。
修复面很宽:-p 丢上文、MCP 重连退避、Windows 插件大小写、超长回复把终端冻住、语法高亮挂起。这些不构成单独选题,但说明 2.1.295 不是只为 OSC 打的补丁包。
该不该为它升级
如果你已经在 Ghostty 一类声明支持 OSC 7501 的终端里并行跑多个 Claude Code,这条值得升。升级成本是一次 CLI 版本跳变,不改工作流。如果你的终端还不认这条协议,升完表面看不出差别,可以等仿真器跟上,或者先用同版本里的 hook 失败阻断和 -p 等待提示。
协议本身不解决「agent 在等什么」的语义,它只把三种粗状态推到标签上。真正的确认文案还在会话里。把它当成状态灯,而不是监控系统,预期会准很多。



