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.denyReadglob 含有不是字元類別的方括號(例如[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 項變更;所有項目請參閱完整變更日誌。
如何更新
- 檢查已安裝的版本:
claude --version - 直接就地更新:
claude update - 如果您以
200k這類後綴設定CLAUDE_CODE_AUTO_COMPACT_WINDOW,請檢查該數值:現在可接受k與M後綴(先前200k會悄悄設定為 100K 的視窗),超出範圍或被忽略的數值也會發出警告。