跳至主要內容

Claude Code v2.1.78:增強錯誤處理和插件持久化功能

Claude Code v2.1.78 引入了 StopFailure 鉤子、持久化插件數據、改進的終端通知以及眾多錯誤修復,提供更強健的開發體驗。

2026年3月18日 10 min read 作者:ClaudeWorld

Claude Code v2.1.78:增強錯誤處理和插件持久化功能

Claude Code v2.1.78 在錯誤處理、插件管理和終端整合���面帶來了重大改進。此版本專注於讓您的開發工作流程更加穩定和用戶友好,特別針對插件開發者和在複雜終端環境中工作的用戶進行了優化。

新功能

增強的錯誤處理

StopFailure 鉤子事件:新增的 StopFailure 鉤子事件會在對話因 API 錯誤(如速率限制或認證失敗)而結束時觸發。這讓您能更清楚地了解出現問題時發生了什麼,並允許自定義錯誤處理工作流程。

改進的 API 錯誤管理:修復了當 API 錯誤觸發停止鉤子時會重新將阻塞錯誤反饋給模型的無限循環問題,消除了用戶的困擾。

插件系統改進

持久化插件數據:新的 ${CLAUDE_PLUGIN_DATA} 變數能讓插件的持久狀態在插件更新後仍然保留。當您執行 /plugin uninstall 時,系統現在會在刪除持久數據前提示確認,保護您重要的插件配置。

增強的代理配置:插件開發者現在可以為插件附帶的代理使用 effortmaxTurnsdisallowedTools 前置元數據支持,提供對代理行為更精細的控制。

終端和介面增強

更好的 tmux 整合:當在啟用了 set -g allow-passthrough on 的 tmux 內運行時,終端通知(iTerm2/Kitty/Ghostty 彈出窗口和進度條)現在���正確到達外部終端。

串流改進:回應文字現在會在生成時逐行串流,提供更流暢和響應更快的用戶體驗。

語音模式修復:解決了修飾鍵組合推拉通話鍵綁定(如 ctrl+k)的問題,並在 Windows 11 上添加了 WSL2 與 WSLg 的支持。

開發者體驗改進

Git 整合修復:解決了在 Linux 沙箱化 Bash 中 git log HEAD 因「模糊參數」錯誤而失敗的問題,並清理了污染工作目錄中 git status 的存根文件。

對話歷史:修復了在使用子代理的大型會話(>5 MB)中 cc log--resume 靜默截斷對話歷史的問題。

沙箱安全:當設置 sandbox.enabled: true 但缺少依賴項時,現在會顯示可見的啟動警告,防止沙箱被靜默禁用。

VS Code 整合

UI 優化:修復了在已認證狀態下打開側邊欄時短暫閃現登錄畫面的問題。

模型選擇:解決了選擇 Opus 模型時出現「API 錯誤:已達速率限制」的錯誤。

如何更新

使用您偏好的方法將 Claude Code 更新至 v2.1.78:

  • npm: npm update -g @anthropic/claude-code
  • Homebrew: brew upgrade claude-code
  • 下載: 訪問發布頁面進行手動安裝

更新後,請重新啟動任何活動的 Claude Code 會話以確保所有新功能可用。

相關連結