Claude Code 2.1.30 更新了什么

Claude Code 2.1.30 是 2026 年 2 月初那一版。官方 changelog 条目不少，真正会改日常用法的就几条：PDF 能按页读、Slack 这类不支持动态注册的 MCP 能自己带 OAuth 客户端、会话卡了可以用 /debug，resume 也少吃很多内存。下面按动手顺序写，不当发布说明抄一遍。

官方发布页：https://github.com/anthropics/claude-code/releases/tag/v2.1.30

先确认自己是不是 2.1.30

终端里跑：

claude --version

装完再看一次版本。

升级用官方安装脚本 https://claude.ai/install.sh ，不要用社区的 node 包管理器全局装。

PDF：按页读，大文件别整本塞进上下文

Read 工具给 PDF 加了 pages 参数。只要前几页目录或某段附录，写成 pages: "1-5" 就行，不用把整本喂进去。

超过 10 页的 PDF，用 @ 点名文件时，现在只会塞一条轻量引用，不再把全文内联进上下文。以前拖一份几十页的规格书进来，上下文直接炸掉一半；现在先挂个引用，需要哪几页再用 Read 指定 pages。

日常可以这样用：

先 @ 挂上文件，确认它看见了
再说读 1-3 页目录，再读 12-15 页接口定义
别指望一次把 80 页全读完。按页拆，上下文更干净

小 PDF（不超过 10 页）还是可以直接整份读。大文件才强制走按页。

MCP：给 Slack 这类服务带上自己的 OAuth 客户端

不少 MCP 服务器（Slack 是官方点名的例子）不支持 Dynamic Client Registration。以前 claude mcp add 走到 OAuth 会卡在没有客户端。2.1.30 允许把预先配好的 client id 和 secret 传进去。

命令形状是：claude mcp add ，再带 --client-id 和 --client-secret，以及原来的服务器名字、URL 等参数。secret 别写进仓库，本机环境变量或交互输入更稳妥。已经能动态注册的服务器，继续按原来的方式加就行。

/debug：会话不对劲先让它自查

新增 /debug。会话里出现重复回复、工具卡住、费用对不上，先打这个命令，让 Claude 帮你看当前这场会话，比自己翻本地记录快。

它解决不了所有问题，但能把模型在胡写还是本地状态坏了先分开。升级之后遇到奇怪卡顿，优先试这一条，再考虑清会话重来。

只读模式下 git log / git show 多了几个旗标

只读模式里，git log 和 git show 现在能带这些旗标：

--topo-order
--cherry-pick
--format
--raw

看提交图、对一下 cherry-pick、自定义 format、看 raw diff，不用先退出只读。日常走读提交和查某段是谁引进来的会顺一点。写操作还是被挡住，只是只读查询宽了一点。

Task 工具：结束时能看见花费

Task 跑完会带 token 数、工具调用次数、耗时。以前子任务结束就一句做完了，现在能判断是不是该拆小一点，或者某次探索太贵。

TaskStop 也不再只写 Task stopped，会带上停掉的那条命令或任务描述。并行开了好几个子代理时，终于知道停的是哪一个。

resume 省内存、切换模型立刻生效、减少动效

resume 以前会话一多就吃内存。2.1.30 把会话索引换成按文件状态渐进加载，官方数字是大约省 68%。长期挂着很多历史会话的人，升级体感最明显的可能是这一条。

/model 以前会排队，等当前轮走完才切。现在立刻执行。切错模型、或者想马上换成更便宜的，不用干等。

配置里多了减少动效。眼睛对闪烁敏感，或者远程桌面卡的时候，把它打开。

几个值得在意的修复

这几条修的是会让人以为模型坏了的问题：

对话历史里冒出幽灵 (no content) 文本块。既浪费 token，也容易把模型带偏。这次清掉了。
提示词缓存以前只在工具名字变了才失效。工具描述或入参结构改了，缓存还是旧的。现在这几项变了都会作废。
对话里带着 thinking 块时跑 /login，可能直接 400。已修。
转录文件坏了、parentUuid 成环，恢复会话会挂死。现在不会。

另外还有：Max 20x 超额不可用时错误地提示升级、权限弹窗抢焦点、子代理拿不到 SDK 提供的 MCP 工具、Windows 上有 bashrc 就跑不了 bash。

VSCode 侧两处小改：提问对话框的 Other 输入框支持 Shift+Enter 换行；新开会话时列表不再出现重复项。用扩展的人升完看一眼会话列表，重复的应该没了。

升级就这几步

跑 claude --version ，看现在是不是 2.1.30 或更新
用官方安装脚本覆盖安装，别走 node 包管理器全局装
再跑一次版本确认
有一堆历史会话的，升级后再 --resume，内存应该明显下来
常用 Slack 一类 MCP，按上面补 client-id 和 client-secret

不是每个版本都值得立刻升。2.1.30 这几条（PDF 按页、MCP OAuth、resume 内存、那几个会卡死的问题）对日常用的人够用了。升完如果会话还是怪，先 /debug，再考虑新开一场。

官方 changelog：https://github.com/anthropics/claude-code/releases/tag/v2.1.30