2026 年 8 月 20 日发布的 Claude Code v2.1.238,带来了大量 Remote Control(远程控制)功能的稳定性修复,同时新增了 keybindingFlavor 快捷键风格配置和自托管 Runner 的多项增强。本文基于官方 Changelog 详解本次更新的核心内容。
新增 readline 风格快捷键
Added a keybindingFlavor setting: set it to "readline"
to make Ctrl+W in the prompt delete back to the previous
whitespace, as in Bash; the default ("classic") is
unchanged
对习惯了 Bash 里 Ctrl+W 删除到上一个空白处这个操作的用户,可以把 keybindingFlavor 设置为 "readline",让 Claude Code 输入框里的这个快捷键行为和 Bash 保持一致;默认的 "classic" 风格行为不受影响,纯粹是新增了一个可选项。
插件市场 headersHelper:动态生成认证请求头
Plugin marketplaces: headersHelper on a url marketplace
or a catalog entry runs a command that mints HTTP headers
(e.g. a short-lived token) for catalog and same-origin
archive fetches
触发时机:仅在安装/更新该插件时运行,命令内容会先
展示出来,claude plugin install/update 会询问
[y/N](或传 -y 跳过确认)
这项功能对需要短期有效令牌认证的私有插件市场很实用——不需要把长期有效的密钥硬编码在配置文件里,而是通过运行一个命令动态生成短期令牌,安装或更新插件的那一刻现取现用,同时命令内容会先展示给用户确认,避免在用户不知情的情况下静默执行。
自托管 Runner 增强
新增 claude self-hosted-runner --defer-shutdown-max-min
<minutes>:收到SIGTERM后,先继续为已连接会话提供
服务,超过指定分钟数后再终止剩余任务并退出
新增 --proxy-authorization-command /
--proxy-authorization-file:为需要每次连接都重新
签发Proxy-Authorization请求头的出口代理提供支持
对于用自托管 Runner 支撑团队协作的场景,--defer-shutdown-max-min 让服务重启或缩容时不会粗暴打断正在进行的会话,而是给一个宽限期让当前任务尽量收尾;代理认证相关的新参数则解决了企业网络里出口代理要求频繁刷新认证头这类合规场景的接入问题。
Remote Control 一揽子稳定性修复
- 修复通过claude remote-control启动的会话,会
继承启动shell里会话范围环境变量的问题
- 修复远程会话进程崩溃后一直不可用,直到
claude remote-control重启才能恢复的问题:现在
下次发消息给它时可以直接复用
- 修复Claude处理中途,从网页端或桌面端发送的
Remote Control消息,在本轮结束后从transcript
中消失的问题
- 修复手机或网页端切换的模型选择,未同步更新到
终端显示的问题
- 修复短暂网络抖动延迟续签登录状态时,Remote
Control报"login expired"断连的问题:现在会
重试并保持连接
- 修复退出登录时Remote Control报告重连失败的问题:
现在退出登录会直接以清晰的提示信息结束会话
这一批修复集中在"网络不稳定环境下 Remote Control 会话的韧性"这个主题——短暂断网、登录续期延迟、进程崩溃后的恢复,这些此前都可能导致用户需要手动重启整个远程控制流程才能继续工作,现在这些场景大都能自动恢复。
跨会话消息:失败反馈更明确
Cross-session messaging:
- 发送给拒绝接收消息的会话(如设置crossSessionInbound:
"refuse")时,现在会向发送方明确报告"refused",
而不是静默显示成功
- 收件方会话的收件箱丢弃消息时(限流或队列已满),
现在会告知发送方,而不是消息凭空消失
这两处修复解决的是一个容易让用户产生误判的问题——此前跨会话发消息如果被拒绝或丢弃,发送方完全感知不到,还以为消息已经送达。现在失败会被明确报告,避免了"以为任务已经安排下去,实际上根本没送达"这类信任落差。
其他值得关注的修复
- 修复长交互会话中内存无限增长的问题:subagent
工具结果离开最近显示窗口后即被释放
- 修复自定义/项目/插件output style在会话中途逐渐
漂移回默认语气的问题
- 修复MCP elicitation对话框对超过4096字符的URL
不显示内容的问题
- 修复权限提示的diff中,含有宽字符(如emoji)或
制表符的行被裁切的问题
- 修复挂起(Ctrl+Z)会话被kill后,终端有时停留在
bracketed-paste模式且光标隐藏的问题
- 改进启动速度:bare claude命令在macOS上启动更快
- 改进自动更新检查时机:启动约10秒后才运行,避免
与启动过程争抢CPU
内存无限增长问题的修复对长会话重度用户尤其重要——此前长时间保持交互会话,subagent 产生的工具调用结果会持续累积占用内存,现在这些结果离开最近显示窗口后就会被释放,长期运行的稳定性得到改善。
实战建议
1. Bash重度用户可以尝试把keybindingFlavor设置为
"readline",让Ctrl+W行为和终端保持一致
2. 依赖Remote Control进行手机/网页远程操控的用户,
升级后可以感受到网络不稳定场景下连接韧性的
明显改善
3. 使用自托管Runner的团队,可以评估
--defer-shutdown-max-min参数,避免服务重启时
粗暴打断正在进行的任务
4. 依赖跨会话消息协作的多会话工作流用户,升级后
注意消息失败会有明确报告,不再需要担心静默丢失
总结
v2.1.238 延续了近期版本"体验打磨为主"的节奏,本次更新的重心明显集中在 Remote Control 这个功能线上——移动办公、多端协同已经成为不少用户的常态工作方式,这批稳定性修复直接提升的是这类使用场景下的日常体验。
来源:Claude Code Changelog v2.1.238 — Claude Code 官方文档,Anthropic,2026年8月20日