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_taskssession_crons

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

UX Improvements

操作體驗調整

new
Status line JSON input 現在包含 GitHub repoPR 資訊(當偵測到時),讓 status bar 外掛可以顯示目前所在的 PR 狀態。
new
Slash command 和 @-mention 建議清單現在在全螢幕模式下支援滑鼠 hover 和 click,不必再強迫使用鍵盤導航。
new
Read 工具在整個檔案讀取超過 token 限制時,改為回傳第一頁的截斷內容並附上「PARTIAL view」提示,而非直接報錯中斷。
new
OTEL tracing 新增 agent_idparent_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 會不斷重新呼叫自身而形成無限迴圈的問題已修正。