跳至主要內容

Claude Code v2.1.304:/auto-mode-setup 支援更多環境、Managed Agents 安全檢查與 Code Review 審查等級

Claude Code v2.1.304 將 /auto-mode-setup 擴展到 Bedrock、Vertex、Foundry 等環境,新增 Managed Agents 安全比對與 Code Review 審查等級,並修正 worktree、rm -r 與壓縮相關問題。

Claude Code v2.1.304 是一個大型版本,變更日誌共列出 76 個項目。此版本讓引導式的 /auto-mode-setup 可用於更多供應商與會話類型,新增 /claude-api managed-agents-secure、Pro 與 Max 方案的恢復對話警告,以及 Code Review 的審查等級,並在自訂 ANTHROPIC_BASE_URL 後方預設開啟工具搜尋。修正方面,claude --worktree 在某些情況下不再未經詢問就移除 worktree 及其分支,而對已掛載磁碟執行 rm -r 現在也會出現安全提示。

新功能

/auto-mode-setup 支援更多供應商與會話

/auto-mode-setup 是一個引導式設定,會讀取您的專案與近期會話,讓自動模式了解您的環境。它現在也可用於 Bedrock、Vertex、Foundry、Claude apps gateway,以及停用遙測的會話。

/claude-api managed-agents-secure

新的 /claude-api managed-agents-secure 會將 Managed Agents 代理的設定與 Anthropic 公布的安全指南進行比對,且不會變更任何內容。此外,/claude-api 技能在 Claude Platform on AWS 上現在會使用 ant CLI,而不再退回使用 SDK 或 curl。

Pro 與 Max 方案的恢復對話警告

在 Pro 與 Max 方案中,當恢復一段閒置的對話會用掉 5 小時用量限制中明顯的比例時,Claude Code 現在會發出警告。您可以照樣恢復,或開始新的對話;若您提及先前的對話,Claude 可以查閱它。

自訂 Base URL 後方預設開啟工具搜尋

在自訂 ANTHROPIC_BASE_URL 後方,工具搜尋現在預設開啟。若閘道回應 400 或 422,請求會在不使用工具搜尋的情況下重試。

技能清單、技能掛鉤上限與 allowed-tools

壓縮之後,Claude 現在會再次收到技能清單,而 /reload-skills 現在只會傳送新增或變更的技能。同一來源(某個 repo、您自己的資料夾或某個外掛)的技能,每個會話最多可註冊 1,024 個掛鉤與 16,384 個 matcher 字元。在僅允許外掛掛鉤的政策下,於主對話中使用、但其掛鉤被排除的技能,將不再取得其 allowed-tools。

CLAUDE_CODE_AUTO_COMPACT_WINDOW 支援 k 與 M 後綴

CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k 不再悄悄設定成 100K 的視窗。此變數現在與 --autocompact 一樣接受 k 與 M 後綴,並會在數值超出範圍或被忽略時發出警告。

Mod API 變更

  • mod 的 tool.check 回應現在可以包含 decider: "person":只有權限對話框或主機的回呼可以核准該請求;在無人可詢問的情況下,會以 mod 提供的理由拒絕。
  • tool.check 事件現在帶有 e.isReadOnly,在工具呼叫為唯讀時設定。
  • mod 的 settings.read 掛鉤現在會收到每一層設定,並可改寫合併後的設定,因此受管的 mod 可以把組織的設定設為上限,包括保留期清理所使用的 cleanupPeriodDays。
  • 當先執行的外掛略過您 mod 的某個掛鉤時,對話記錄現在會顯示一行說明,指出事件與外掛名稱。

Code Review 審查等級與全組織涵蓋

Owner 現在可以為組織選擇 Quick、Standard(預設)或 Deep 審查等級,並為個別儲存庫設定各自的等級。Code Review 管理設定也新增選項,可審查 GitHub 組織中的所有儲存庫(包括之後新增的儲存庫),而不必逐一選取。

VS Code:背景子代理與 mod 繪製

背景子代理現在會在其 Agent 卡片下方以單一狀態列顯示,而不是將每個步驟串流到聊天中;完整對話記錄仍保留在 /tasks。對於使用 Amazon Bedrock、Google Vertex AI 與 Microsoft Foundry、位於 LLM 閘道後方,或關閉遙測的會話,mod 現在也可以在聊天面板中繪製。

修正與改進

  • 安全提示:在 HEAD 處於 detached 狀態或位於其他分支時,claude --worktree 結束時不再未經詢問就移除 worktree 及其分支(這曾可能導致 commit 遺失)。對已掛載磁碟或其最上層資料夾(/Volumes、/media、WSL 的 /mnt/c)執行 rm -r,現在會出現與 rm -rf /Applications 相同的安全提示。
  • 沙箱:在 Linux 上,當 sandbox.filesystem.denyRead glob 含有不是字元類別的方括號(例如 [user-id] 路由資料夾)時,沙箱中的指令不再無法啟動。
  • 對話記錄:在修剪檔案期間磁碟已滿時,CLAUDE_CODE_TRANSCRIPT_LOCAL_GC 不再從已儲存的對話記錄中遺失訊息。
  • Headless 執行:外掛不再能透過產生子代理或重新執行已完成的子代理,讓 headless 執行在超過 --max-turns、Stop 或輸入結束後仍持續進行。
  • 壓縮:在 Claude Code 壓縮一段被 API 判定為過長的對話時停止一輪,不再導致「Context limit reached」或「Prompt is too long」錯誤。
  • 子代理與代理團隊:在完成後立即被傳送訊息或恢復的子代理,不再有時遺忘其最近的工作;從主會話核准關閉請求也不再使整個 CLI 結束。
  • LLM 閘道:遇到 context_management: Extra inputs are not permitted 錯誤時,Claude Code 現在會不帶該欄位重新送出請求。
  • Effort:當 CLAUDE_CODE_EFFORT_LEVEL 為 auto 或 unset 且未送出等級時,/effort status、/effort ultracode 與提示列的 effort 指示器不再顯示猜測的 effort 等級。
  • Remote Control:當終端機登入的是另一個帳號時,Remote Control 不再永久扣留桌面版對話的歷史記錄。
  • Claude Desktop:在 macOS 與 Linux 上,Code 分頁會話中未使用沙箱的 Bash 指令,現在可以看到在 ~/.zshrc 等 shell 啟動檔中匯出的環境變數。
  • 效能:同時執行多個子代理時的回應速度與吞吐量有所改善,在長對話或恢復的對話中送出請求時的記憶體用量也有所改善;在自動模式下,安全分類器的 context 不再隨每個請求一併儲存,使會話檔案變小。
  • 雲端會話:新對話的第一輪不再等待從 claude.ai 同步之外掛的本機(stdio)MCP 伺服器,除非該伺服器設定了 alwaysLoad: true。
  • Windows:使用標準 Git for Windows 安裝時,git 指令的啟動有所改善,因為 Claude Code 現在會直接執行其 git.exe,而不經由 cmd 啟動器。
  • VS Code:修正了會話以「Subprocess initialization did not complete within 60000ms」啟動失敗的其中一個原因:SessionStart 指令掛鉤的執行時間不再計入該限制,總計最多 10 分鐘。設定 claudeCode.claudeProcessWrapper 時,Past conversations 也不再隱藏會話。
  • Code Review:在管理員開啟 Code Review 後一兩分鐘內開啟的 pull request,不再被悄悄略過;現在會重試並進行審查。
  • 快速模式:Claude Opus 5.5 上 /fast 對話框標題中的「(research preview)」標籤已移除。

此版本共包含 76 項變更;所有項目請參閱完整變更日誌。

如何更新

  1. 檢查已安裝的版本:claude --version
  2. 直接就地更新:claude update
  3. 如果您以 200k 這類後綴設定 CLAUDE_CODE_AUTO_COMPACT_WINDOW,請檢查該數值:現在可接受 k 與 M 後綴(先前 200k 會悄悄設定為 100K 的視窗),超出範圍或被忽略的數值也會發出警告。

相關連結