版本封存

Claude Code v2.1.219：Claude Opus 5 成為預設 Opus 模型、子代理可巢狀生成、沙箱嚴格允許清單

Claude Code v2.1.219 新增 Claude Opus 5 並設為預設 Opus 模型，子代理可巢狀生成至第 3 層，新增沙箱網路嚴格允許清單與 DirectoryAdded 掛鉤，動態工作流程預設改為中型規模。

• 10 min read • 作者：ClaudeWorld

Claude Code v2.1.219 新增 Claude Opus 5（claude-opus-5），並將其設為預設的 Opus 模型。此版本也讓子代理預設可以生成巢狀子代理，針對沙箱網路、工作目錄與動態工作流程規模新增了設定與掛鉤，並改善了 MCP 連線的診斷資訊。修正項目涵蓋 headless 輸出、/model 選擇器、Remote Control、Windows 與螢幕閱讀器模式。

新功能

Claude Opus 5 成為預設 Opus 模型

新增 Claude Opus 5（claude-opus-5），並成為預設的 Opus 模型，支援 1M context，快速模式（fast mode）價格為每百萬 token $10/$50。Opus 4.7 已從快速模式中移除，因此 /fast 現在適用於 Opus 5 與 Opus 4.8。claude-api 技能也改為預設使用 Claude Opus 5，並提供從 Opus 4.8 遷移的路徑。

巢狀子代理最多可達第 3 層

子代理現在預設可生成巢狀子代理，深度最多 3 層（先前為 1 層）；設定 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 即可停用巢狀生成。在 stream-json 輸出中，設定 --forward-subagent-text 時，深度 2 以上生成的子代理現在也會出現，並以生成它們的 Agent 呼叫之 tool_use id 作為索引鍵。

沙箱的嚴格網路允許清單

新的 sandbox.network.strictAllowlist 設定會直接拒絕沙箱中的指令連線至不在允許清單上的主機，不會跳出提示。

新的 DirectoryAdded 掛鉤

當 /add-dir 或 SDK 的 register_repo_root 控制請求在工作階段進行中註冊新的工作目錄後，會觸發新的 DirectoryAdded 掛鉤。

動態工作流程規模準則

動態工作流程現在預設採用中型規模準則（目標是少於 15 個代理）；可在 /config 的 Dynamic workflow size 中選擇其他規模或不設限。新的 workflowSizeGuideline 設定鍵可讓您從任何設定檔設定這項建議性準則，設定後 /config 中的對應列會隱藏。執行中工作流程的狀態列現在會顯示目前的預設工作流程規模，並提示可透過 /config 變更。

更清楚的 MCP 連線診斷

當伺服器連線失敗時，claude mcp list 與 /mcp 現在會顯示 HTTP 狀態碼與錯誤文字，Claude Code 也會針對開頭或結尾含有隱藏空白字元的 MCP 設定值發出警告。headless stream-json 的 init 事件新增了 mcp_server_errors，列出因設定驗證而被略過的 --mcp-config 項目；在終端機中執行時則會顯示啟動警告。

修正與改進

Headless

  • 當某一輪因串流途中的 API 錯誤而中斷時，claude -p 的文字輸出不再遺失已產生的回答。

模型選擇器

  • /model 選擇器現在會將合併後的 Opus 列顯示為「Opus (1M context)」，而不是單純的「Opus」。
  • /model 選擇器現在只醒目標示最新模型的名稱，讓醒目標示代表新版本，而不是清單中任意的一部分。
  • 對於已包含 Fable 的方案，Fable 模型列不再因過時快取寫死的標籤而顯示「Requires usage credits」。

Remote Control

  • 在切換模型、重新連線或組織檢查失敗後，Remote Control 用戶端不再保留過時的快速模式狀態。
  • 「Remote Control is only available via api.anthropic.com」錯誤訊息現在會指出造成該錯誤的具體設定。

MCP

  • 受管 MCP 允許清單／拒絕清單中的 ${VAR} 項目，現在會從啟動環境與受管設定的 env 解析，而不是從設定檔的 env 解析。

Windows

  • 當 CLAUDE_CODE_GIT_BASH_PATH 指向的不是 bash/sh 執行檔時，不再導致程式結束或被當成 bash 使用；現在會忽略並顯示警告。

終端機與輸入

  • 在 GNU screen 中使用選取即複製時，現在會複製選取內容，而不是把 base64 印到終端機上。
  • Vim 模式下，在空白提示中按 ← 時，現在從 NORMAL 模式也能返回代理檢視，而不只限於 INSERT 模式。
  • 螢幕閱讀器模式現在只會回顯所輸入的字元，而不是每次按鍵都重寫整行輸入。

Teleport

  • 當目前的檢出與工作階段的儲存庫不一致時，claude --teleport 現在會顯示您目前的檢出指向哪個儲存庫。

如何更新

  1. 檢查已安裝的版本：claude --version
  2. 就地更新：claude update
  3. 子代理現在預設可生成最多 3 層的巢狀子代理；如果想停用巢狀生成，請設定 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1。

相關連結