Overview

這個版本在做什麼

Claude Code 2.1.145 延續近幾個版本對 agentic 工作流的深耕,這次集中在三個方向:讓 agent session 的狀態資訊更容易被外部工具消費(JSON 輸出、OTEL trace)、強化 Plugin 生態的使用者體驗(安裝前預覽),以及收緊幾個安全與行為邊界。

新功能不多但都是實用的 QoL 補強;Bug 修正清單則相當長,顯示這個版本有做一輪較仔細的問題清理。

New Feature

claude agents --json:session 列表可腳本化

claude agents --json 讓你把目前所有 live Claude session 以 JSON 格式輸出到 stdout,方便接進外部工具。官方 changelog 點名的使用場景:tmux-resurrect(session 持久化)、status bars(終端機狀態列顯示 agent 數量)、session pickers(用 fzf 等工具快速切換 agent)。

# 列出所有 live sessions(JSON) claude agents --json # 接 jq 取出等待輸入的 session 數 claude agents --json | jq '[.[] | select(.awaiting_input)] | length' # 接 fzf 快速跳到指定 session claude agents --json | jq -r '.[].id' | fzf | xargs claude attach

同一批次也改善了 claude agents 的 terminal tab title:現在會顯示「等待輸入的 session 數量」,讓你在 alt-tab 切換視窗時,不用打開清單就能知道有幾個 agent 在等你回應。

New Feature

/plugin 安裝前完整預覽

/plugin 的 Discover 和 Browse 畫面現在在你按下安裝之前,就會顯示這個 plugin 包含哪些東西:

顯示項目

Commands

plugin 提供的 slash commands 清單,可先確認指令名稱不會跟現有指令衝突。

顯示項目

Agents & Skills

plugin 包含的 agent 和 skill 定義,了解安裝後會新增哪些自動化能力。

顯示項目

Hooks

plugin 會在哪些事件(PreToolUse、Stop 等)掛鉤,評估對工作流的影響。

顯示項目

MCP / LSP Servers

plugin 附帶的 MCP server 或 LSP 設定,安裝前可確認是否需要額外相依套件。

這讓 Plugin 安裝從「先裝再看」變成「先看再裝」,對重視工作流穩定性的使用者尤其有幫助。

New Feature

Stop / SubagentStop hook 新增欄位

Stop 和 SubagentStop hook 的 input 現在多了兩個欄位:background_tasks 和 session_crons。

這讓 Stop hook 的腳本可以知道「這個 session 停止時,還有哪些背景任務在跑、有哪些排程 cron 存在」,從而決定是否要延後清理、發送通知、或等待背景任務完成。對使用 Claude Code 做長時間 agentic 工作流的場景特別實用。

UX Improvements

操作體驗調整

new
Status line JSON input 現在包含 GitHub repo 和 PR 資訊(當偵測到時),讓 status bar 外掛可以顯示目前所在的 PR 狀態。
new
Slash command 和 @-mention 建議清單現在在全螢幕模式下支援滑鼠 hover 和 click,不必再強迫使用鍵盤導航。
new
Read 工具在整個檔案讀取超過 token 限制時,改為回傳第一頁的截斷內容並附上「PARTIAL view」提示,而非直接報錯中斷。
new
OTEL tracing 新增 agent_id 和 parent_agent_id 屬性到 claude_code.tool spans,背景 subagent 的 span 現在正確巢狀在對應 Agent tool span 之下。
Security Fix

Bash 環境變數權限繞過修正

這個版本修正了一個安全問題:在 Bash 指令中,單純的變數賦值(bare variable assignments) 如果涉及非 allowlist 的環境變數,原本會被自動核准(permission-prompt bypass),現在已修正為正確觸發權限確認。

實際影響:如果有人(或有程式碼)試圖用 SOME_VAR=sensitive_value command 的形式繞過環境變數相關的權限設定,這條路現在被堵住了。使用正常工作流的使用者不受影響。

Bug Fixes

其他修正

fix
MCP prompt slash commands 在缺少必要參數時,錯誤訊息現在會指名是哪個參數遺漏,並顯示正確用法,而非吐出原始 server 驗證錯誤。
fix
Terminal 縮放或重新聚焦後,spinner 和已用時間顯示會凍結直到按鍵的問題已修正。
fix
跨專案的 resume hint 在 Windows PowerShell 5.1 中失效的問題已修正,現在改用 ; 作為指令分隔符。
fix
Agent view 回覆面板中的語音 push-to-talk 無法運作的問題已修正。
fix
同時建立多個 task 時,task list 以隨機順序渲染的問題已修正。
fix
Anthropic marketplace 已安裝的情況下,仍持續顯示「Failed to install」舊橫幅的問題已修正。
fix
在 session 內執行 gh pr create 等指令後,footer 的 PR badge 不即時更新的問題已修正。
fix
Agent Teams 中 teammate 名稱含有非 ASCII 字元時,每次 API 呼叫都失敗的問題(header encoding 錯誤)已修正。
fix
/review 使用已棄用的 projectCards GraphQL query,在有 Classic Projects 的 repo 會報錯的問題已修正。
fix
claude plugin validate 未偵測出 skills 指向檔案而非目錄的問題已修正,現在會提示應使用父目錄路徑。
fix
使用 context: fork 的 skill 會不斷重新呼叫自身而形成無限迴圈的問題已修正。