配置不再被清空、Mac 不再反复登出:2.1.329 四个值得升级的稳定性修复
2.1.329 的更新日志很长,里面有几条修复看起来不起眼,却正好对应日常最让人崩溃的几种情况:配置突然没了、反复要求重新登录、终端卡住不动、文件读不出来。这里挑出四条说清楚。
1. ~/.claude.json 不再莫名被重置
~/.claude.json 保存着 Claude Code 的大量本地状态。此前存在一种情况:网络卡顿或文件被锁住,导致这个文件暂时读不出来,恰好又赶上一次保存,结果文件被清空并重置为默认值。
如果你遇到过"昨天还好好的,今天打开像新装的一样",很可能就是它。2.1.329 修复了这个问题。家目录放在网络盘、或者同步工具经常锁文件的用户,升级尤其有意义。
2. macOS 上不再反复被登出
在 macOS 上,如果 Claude Code 能读取钥匙串(Keychain)却无法写入,之前会出现反复登出的现象。
2.1.329 调整了处理方式:遇到这种情况的那个会话会在凭据到期时停下,并说明原因;其他会话则保持登录。 换句话说,问题被限制在一个会话里,而且你能知道为什么,而不是所有窗口一起掉线、反复要你登录。
3. 状态栏脚本不会再拖垮提示符
自定义状态栏(status line)是很多人喜欢的玩法:用一个脚本输出分支、模型、用量等信息。但如果脚本写得有问题,一直不停地输出、不会结束,此前会让提示符卡死,内存占用涨到好几个 GB。
2.1.329 修复了这个问题。不过还是建议:状态栏脚本应当输出一次就退出,别在里面写无限循环或持续 tail 日志。
4. PDF、图片和 Office 文件不再变成 .bin
有些 MCP 服务器或网站在返回文件时,会把类型标成通用的 application/octet-stream。此前这类 PDF、图片以及 .docx、.xlsx、.pptx 文件会被保存成 .bin,其中 PDF 和图片因此无法被 Claude 读取。
修复之后,这些文件会按正确的类型保存,Claude 也能正常读取其中的 PDF 和图片。如果你之前通过某个 MCP 拉文件时总遇到"读不了",升级后可以再试一次。
怎么确认已生效
在终端执行 claude --version,确认版本号不低于 2.1.329;若低于,按你的安装方式升级即可。
小结
这四条修复都不是新功能,但每一条都可能在某天让你少折腾半小时。配置丢失、反复登出、终端卡死、文件读不出——如果其中任何一条你遇到过,就值得尽快升级。