觀點 · 資訊分享

Claude Code 2.1.199：API 臨時出錯時，寫到一半的內容不再被丟掉，子代理也會交回部分成果

Claude Code 在 7 月 2 日釋出 2.1.199：串流回應中途出錯時會保留已產生的部分，被限流打斷的子代理會把部分成果交回，另外也新增一次載入多個技能的用法。

一句話看懂：Claude Code 2.1.199 讓連線出錯時「做到一半的內容」不再被丟掉，被打斷的子代理也會把部分成果交回。

Claude Code 2.1.199 更新重點資訊圖卡：API 臨時出錯，已產生的部分不再丟掉，子代理也會交回成果

先用白話講：這次更新在修什麼？

想像你請助理寫一份長報告，寫到第八頁時網路斷了。以前的做法是：整份丟掉，叫他重寫。這次的做法是：先把已經寫好的八頁交給你，並告訴你「這份不完整」，由你決定要不要接著寫。

Claude Code 是 Anthropic 推出的 AI 寫程式工具，常常會跑很久的任務。長任務最怕的就是中途出錯：模型服務暫時過載、被限流、憑證出問題。2.1.199 把這些「出錯時」的處理改得更體貼。

Claude Code 在 2026 年 7 月 2 日釋出 2.1.199，主要修正（依官方 GitHub 更新說明）：

串流回應不再整個丟掉：API 在輸出一半時回傳過載或伺服器錯誤，已產生的部分會保留，並提示回應不完整
子代理被限流也會交成果：子代理被限流或伺服器錯誤打斷時，會把做到一半的成果交回給主代理，而不是悄悄失敗
錯誤不再被當成功：子代理遇到 API 錯誤（例如用量上限）時，會把錯誤回報給主代理，不再當成「成功完成」
暫時性限流自動重試：與你的用量上限無關的伺服器限流（HTTP 429）會自動退避重試，這是針對訂閱使用者
憑證錯誤立刻說清楚：遇到 TLS 檢查型代理、缺少 NODE_EXTRA_CA_CERTS、憑證過期等 SSL 錯誤，不再浪費重試次數，會立刻失敗並提示怎麼修

項目	說明
一次載入多個技能	輸入 `/skill-a /skill-b 要做的事`，開頭的技能最多 5 個會一起載入
設定檔損毀	從啟動時的復原對話框重設損毀的設定檔，現在會先備份再重設
背景代理	修正在 Linux 上殘留損毀紀錄後，背景代理每約 50 秒把自己與所有代理殺掉的問題；修正 `claude stop` 被重新啟動動作蓋掉的問題
計畫模式	會對「會改變狀態」的瀏覽器工具呼叫詢問，唯讀的批次呼叫則自動放行

更新說明提到兩個和重試有關的環境變數：

更新說明只描述了行為，沒有給設定範例，實際的設定值與用法請以官方文件為準。另外，/model、/fast 這類指令在檢視子代理時輸入，現在會顯示提示，說明指令是套用在主代理身上。

這種版本沒有吸睛的新功能，但對天天用 Claude Code 跑長任務的人最實用。長任務最痛的就是跑了半小時後遇到暫時性錯誤、全部重來；能保留部分成果、錯誤訊息講清楚怎麼修，省下的是真金白銀的 token 和時間。

「子代理把 API 錯誤當成功回報」這個修正也值得留意：以前主代理可能以為子任務做完了，繼續往下走，結果是錯的。如果你有用子代理做多步驟自動化，升級後建議重新跑過一次關鍵流程，確認行為符合預期。

子代理是什麼？

Claude Code 可以把一部分工作交給另一個 Claude 去做，這個被派出去的叫子代理（subagent）。做完後把結果交回主代理。這次的修正讓子代理即使被中途打斷，也會把做到一半的成果交回，而不是悄悄失敗。

重試次數可以自己調嗎？

可以。依更新說明，CLAUDE_CODE_RETRY_WATCHDOG 會把非容量類暫時性錯誤的預設重試次數提高到 300 次，同時解除 CLAUDE_CODE_MAX_RETRIES 原本上限 15 的限制。這是進階設定，一般使用者不需要動。

一次載入多個技能怎麼用？

在訊息開頭連續輸入多個斜線技能，例如 /skill-a /skill-b 後面接要做的事，Claude Code 會把開頭的技能全部載入，最多 5 個；以前只會載入第一個。

作者

接案做系統開發、網站與主機託管。觀點裡的文章都是我自己寫的,寫的是做專案時第一手遇到的事。