Claude Code v2.1.30 & v2.1.31 更新整理：PDF 分頁讀取、/debug 指令與穩定性修復

Claude Code 連續兩天推兩版，一版加功能、一版修穩定性——用 AI 寫 code 的人，更新了嗎？

最近 Claude Code 在 2/3 跟 2/4 連續推了 v2.1.30 和 v2.1.31 兩個版本，一版是功能導向、一版是穩定性修復。趁熱整理一下兩版的重點差異，讓大家快速判斷要不要更新。

v2.1.30 — 功能導向更新

這版的亮點真的不少，幾個比較有感的功能：

PDF 分頁讀取

Read 工具新增 pages 參數，可以指定只讀取特定頁面範圍（例如 pages: "1-5"）。以前大型 PDF 一次塞進 context 很容易爆，現在超過 10 頁的 PDF 用 @ 提及時會回傳輕量級的 reference 而非整份內容。

MCP OAuth 預設 Client Credentials

針對不支援 Dynamic Client Registration 的 MCP server（例如 Slack），新增了 --client-id 跟 --client-secret 參數，讓 claude mcp add 時可以直接帶入預設的 OAuth credentials。

/debug 指令

新增 /debug 指令，可以直接讓 Claude 幫你排查當前 session 的問題。debug 變得更直覺了。

其他功能

• Task 工具指標：結果新增 token count、tool uses、duration 等指標，可以更清楚看到每次 Task 的消耗
• --resume 記憶體優化：降低 68%，session 多的人會有感
• read-only 模式：新增支援更多 git log 和 git show flag
• reduced motion mode：可在 config 中設定減少動畫

Bug 修復

• 幽靈文字區塊：修掉 API 對話歷史中出現的 "(no content)" 文字區塊，減少 token 浪費
• prompt cache：修正 tool descriptions 或 input schemas 變更時 cache 沒有正確 invalidate 的問題
• Subagent MCP 工具：修復 subagent 無法存取 SDK 提供的 MCP 工具的問題
• 權限對話框：不再搶奪焦點打斷你正在打字
• Windows .bashrc：修復 Windows 用戶有 .bashrc 時無法執行 bash 的 regression
• VSCode：問題對話框支援多行輸入（Shift+Enter 換行），修復 session list 重複顯示

v2.1.31 — 穩定性修復

隔天馬上推出的修復版，主要解決 v2.1.30 以及之前的穩定性問題：

關鍵修復

• PDF crash：過大的 PDF 導致 session 永久卡住、必須開新對話的問題修了
• Sandbox 誤報：sandbox 模式下 Bash 指令錯誤回報 "Read-only file system" 的問題修了
• Plan Mode crash：進入 Plan Mode 時若 ~/.claude.json 缺少預設欄位會 crash
• Streaming 溫度設定：temperatureOverride 在 streaming API 路徑被靜默忽略，所有 streaming 請求都使用預設溫度 1——這對有自訂溫度需求的 API 用戶影響蠻大的

改善

• 系統提示詞優化：更明確引導 model 使用專用工具（Read、Edit、Glob、Grep）而非 bash 等效指令（cat、sed、grep、find）
• Terminal 排版：減少 spinner 出現/消失時的排版抖動
• 錯誤訊息：PDF 和 request size 的錯誤訊息現在會顯示實際限制（100 頁、20MB）
• 定價顯示：第三方 provider（Bedrock、Vertex、Foundry）用戶不再看到誤導性的 Anthropic API 定價
• LSP 相容性：修復與嚴格 language server 的 shutdown/exit 相容性

新增

• Session resume 提示：退出時顯示如何繼續對話的提示
• 日文 IME：支援全形空格輸入

結論

v2.1.30 加功能、v2.1.31 修穩定性——兩版搭在一起才是完整的更新。

如果你有在用 Claude Code API 或是常處理大型 PDF，建議直接更新到 v2.1.31。PDF 分頁讀取跟 streaming 溫度設定的修復是這兩版最有感的改動。

References

1. Claude Code GitHub Releases
2. Claude Code 官方 Changelog

關鍵字

Claude Code, v2.1.30, v2.1.31, PDF 分頁讀取, MCP OAuth, /debug, streaming temperature, Anthropic, AI Coding, 開發工具更新