Claude Code v2.1.290：claude attach 與 logs 可用名稱指定、Managed Agents 上手指令，以及會回補的 WebSearch 額度

Claude Code v2.1.290 是一次大型發布，變更日誌共列出 190 個項目。此版本讓 claude attach 與 claude logs 可以用部分工作階段名稱指定目標，為 /claude-api 新增 Managed Agents 上手指令，並把互動式工作階段的 WebSearch 上限改為隨時間回補的額度。其餘大部分項目在強化權限規則、沙箱檢查與組織管理的設定，另外也修正了排程任務、代理檢視、/ultrareview、外掛與 mods 的許多問題。

新功能

以工作階段名稱使用 `claude attach` 與 `claude logs`

此版本新增 claude attach <name> 與 claude logs <name>，可以用部分工作階段名稱取代工作階段 id。

`/claude-api` 的 Managed Agents 上手指令

/claude-api managed-agents-onboard <url> 會把網頁描述的 Managed Agents 模式設定成 ant apply 檔案；/claude-api managed-agents-onboard <quickstart-name> 則會用 ant CLI 建立 Console 快速入門範本，例如 deep-researcher。claude-api 技能中的 Managed Agents 範例現在除非代理需要，否則會關閉網路工具，並使用 auto 權限政策。

WebSearch 額度會回補；WebFetch 可讀取超過 100,000 字元的內容

在互動式工作階段中，WebSearch 額度現在會以每小時 100 次的速度隨時間回補，而不是在 200 次呼叫後就用盡；CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR 可設定速率，設為 0 則將其關閉。WebFetch 不再悄悄捨棄超過 100,000 個字元的頁面文字，而會說明還有多少內容未讀，並接受 offset 參數繼續讀取。

專案設定不再能啟用 Claude in Chrome 或設定 `CLAUDE_CODE_DISABLE_ATTACHMENTS`

專案的設定檔不再能啟用 Claude in Chrome；請改用 --chrome、/chrome 或你的使用者設定。儲存庫的 .claude/settings.json 或 .claude/settings.local.json 也不再能設定 CLAUDE_CODE_DISABLE_ATTACHMENTS，但 shell、使用者與受管理的設定仍然可以。

Bash 會更常要求核准

Bash 工具現在執行 pyright 前會先詢問，因為它不再被視為唯讀指令；更多形式的 ps 指令也會要求核准，而不是直接執行。參數仍會被 shell 當作萬用字元展開的唯讀指令（例如 rg 或 git grep），以及某些 zsh 與 bash 解讀變數名稱方式不同的指令，現在也會提示核准。

受管理設定的警告

當受管理設定檔是一個指向受管理設定資料夾以外檔案的連結時，Claude Code 現在會發出警告。當受管理設定忽略使用者設定的沙箱 allowRead 路徑或允許的網域時，/status 與 doctor 也會發出警告。

`/code-review` 中等投入程度支援更多模型

/code-review 在中等投入程度（medium effort）下，現在也會在沒有調校過審查設定的模型上回報清理與 CLAUDE.md 慣例相關的發現，包括 Opus 5.5 與 Sonnet 5.5。

代理檢視與背景工作階段的變更

從 claude agents 送給忙碌中背景工作階段的 /model、/effort 與 /rename，現在會立即套用、不需確認，而不是等到該輪結束。等待排程喚醒（/loop）的背景工作階段在更新與記憶體不足時會繼續執行；排程任務已消失的背景工作階段，會在約 20 秒後移到 Completed。

外掛與 Mod API 新增項目

mod 的 turn.step 結果新增 serverToolUses（由 API 自行執行的工具呼叫，即 advisor）；外掛掛鉤的 tool.check 事件新增 agentId，讓掛鉤能分辨子代理與主工作階段的權限檢查；mod 的 tool.check 掛鉤讀取的問題與判定新增 ceiling，指出組織對某工具要求的核准層級。外掛掛鉤的型別定義新增 ThemeKey 與 Color 型別，claude plugin validate 也會列出 mod 在把關點註冊的每個掛鉤是否有 .catch（在 --json 下為 gatingHooks）。

Claude Tag：Slack 中的快速模式

在 Slack 中以 !fast 提及 Claude，可將討論串切換為快速模式（必要時改用 Opus），用 !fast off 則可切回；啟用期間回覆會顯示 (fast)。在存取套組（access bundle）中建立自訂連線時，新增選填的 Path prefixes 欄位，讓允許規則只涵蓋這些路徑；頻道指示的上限改為 8,192 個字元（而非位元組），並在 Save 旁顯示字數。

VS Code：預設顯示訊息時間戳記

訊息時間戳記現在預設會顯示，可透過 Claude Code: Show Message Timestamps 設定關閉。VS Code 也新增在 Claude 工作時送出訊息的螢幕閱讀器朗讀「Message queued.」，並可在 Manage plugins 對話框中檢視並執行外掛 marketplace 的安裝或更新指令。

Claude apps gateway

Claude apps gateway 的登入核准頁面新增 Deny 按鈕，可結束待處理的登入，讓等待中的終端機在數秒內停止。gateway 支援的最低 PostgreSQL 版本從 14 改為 11，並會在其向身分識別提供者出示的憑證到期前 30 天內記錄警告。

修正與改進

請求：在以非 400 狀態碼、或在同時帶有第二個 beta 時拒絕 Claude Code 某個 beta 標頭的代理伺服器與閘道後方，請求不再失敗。含有數百張圖片的長工作階段不再卡在「Request rejected as unprocessable by the model」錯誤；當 API 的輸出內容篩選器在 Claude 仍在思考時中止回覆，請求會先重試一次再顯示錯誤。
排程任務：對話壓縮後恢復工作階段時，設有間隔的 /loop 與提醒現在會正常恢復（適用於此版本起進行的壓縮）；在前景設定的任務在 ← 或 /background 交接後會正常觸發；週期性任務也不再於每次恢復、respawn 或 fork 時多執行一次。
恢復工作階段：恢復的子代理與隊友在執行途中收到訊息後，會保留先前的思考內容與提示快取；在終端機以 --continue 或 --resume <session-id> 恢復時會還原計畫模式；載入大型工作階段的對話記錄時，計時器、輸入與畫面繪製也會持續運作。
權限規則：拒絕與詢問規則不再漏掉名稱來自 declare、typeset、export 或 readonly 前綴變數的指令或路徑；Read 拒絕規則現在會套用到貼上或拖曳到提示中的圖片路徑，以及以 @ 提及之資料夾所列出的檔名；PreToolUse 掛鉤改寫工具呼叫的輸入後，權限規則與安全檢查也會正常套用。
計畫模式與自動模式：計畫模式不再讓自動模式分類器核准帶有伺服器推送詢問政策的非唯讀連接器工具；自動模式的拒絕訊息也不再建議會讓整個工具略過分類器、或會被 Claude Code 忽略的權限規則。
受限與略過權限模式：--restricted（以及 CLAUDE_CODE_RESTRICTED=1）工作階段不再開啟跨工作階段的訊息 socket；背景 worker 在 respawn 時，若未接受略過權限的免責聲明，也不再套用 --allow-dangerously-skip-permissions。
連結與符號連結：以符號連結指向工作目錄之外的專案 CLAUDE.md、規則或 AGENTS.md，在 permissions.blockReadsOutsideWorkingDirectories 或 Read 拒絕規則下不再載入；透過讀取途中被替換的連結，macOS 與 Windows 上的圖片讀取不再能回傳核准範圍以外的檔案，在讀取封鎖或 --restricted 下的 @ 提及也不再能讀取工作目錄以外的檔案；編輯符號連結設定檔所指向的檔案時，現在也會出現設定檔權限詢問。
組織控管：使用者安裝的 mod 不再能讓組織的外掛被卸載，也不再能讓組織的防護略過檢查；這類 mod 現在會被卸載。組織提供的 MCP 伺服器在登入或重新連線後，不再被重新列為你自己的伺服器；disableClaudeAiConnectors 與 allowedMcpServers 的 URL 規則，現在也會套用到先前遺漏的 .mcp.json、外掛或代理中宣告的 MCP 項目。
沙箱：把 heredoc 透過管線傳給另一個指令的沙箱指令（cat <<EOF | python3）不再每次執行都要求核准；在沙箱自動允許下，沙箱中的 Monitor 工具指令現在會遵守你的權限規則；git clone 選項的簡寫形式也不再沿用 sandbox.excludedCommands 中 git * 這類模式的沙箱豁免。
/ultrareview：在多種邊緣情況下（Windows 上 git stash create 失敗、設定了 core.safecrlf=true、git filter driver 名為 unset 或 unspecified、git 2.54 以上將分支存放在 .git 之外），未提交的變更不再被捨棄、拒絕或未經篩選就上傳；上傳錯誤訊息也更短，會指出失敗的步驟並提供修正方式。
代理檢視：Esc 不再確認「restart this session」提示；重複按 Ctrl+X 不再刪除整個下一個區塊；背景工作階段當機後立即送出的回覆，會在其重新啟動期間重試最多 12 秒；Homebrew 升級後，claude agents 不再以「Couldn’t restart the background service」失敗（自此版本之後的下一次升級起生效）。
睡眠與喚醒：Mac 從睡眠喚醒時，背景代理不再以「Agent stalled」失敗，Workflow 工具的子代理也不再從提示重新開始；在 Bedrock、Vertex、Foundry 與自訂閘道上，因電腦睡眠而中斷的回應不再被當成停滯的串流；Mac 在自動壓縮途中睡眠時，壓縮也不再以「Prompt is too long」放棄。
凍結與記憶體：修正傳送某些超長訊息後、秘密掃描或權限提示遇到很長的類 token 文字時、秘密遮罩遇到很長的不間斷文字時，以及在 Linux 與 WSL 上像 ~/**/.env 這類沙箱讀取規則涵蓋大型資料夾時的凍結。在 VS Code 擴充功能等 SDK 主機下，若受管理設定在慢速檔案系統上拒絕讀取大量路徑，啟動不再緩慢或失敗（自 2.1.285 起的問題）；HTTP MCP 伺服器傳回非常大的回應時，也不再造成無上限的記憶體使用。
技能與指令：即使資料夾名稱不同（例如非英文名稱），現在也能依 SKILL.md 中的名稱找到技能，技能清單會同時顯示兩個名稱。在 Windows 上，技能與指令中多行的 ! shell 區塊在 CRLF 換行下可正常運作；技能與自訂指令現在會拒絕含有 tab 與換行以外原始控制字元的 ! shell 指令。
Bash 工具：在新的設定目錄上，若第一個指令在啟動後數秒內執行，Bash 工具不再偶爾在整個工作階段中遺失 shell 別名、函式與外掛的 PATH 項目；當 git 或 gh 等工具未安裝時，錯誤訊息會指出缺少的程式，而不是顯示「Premature close」（macOS、Linux）。
對話框與登入：CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m 不再被解讀為 5 毫秒；帶有單位後綴的值現在會改用 dialogExpiry。執行 claude auth login 後首次啟動不再要求重新選擇登入方式；macOS 的 /login 在鑰匙圈拒絕新登入時也不再回報成功。
網路流量：CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 現在也會略過啟動時的連線預熱；被網路代理伺服器封鎖（HTTP 403）的 MCP 伺服器不再重試三次；在 Claude apps gateway 後方，若機器上沒有強制 gateway 登入的受管理設定，背景指令、代理檢視與 daemon worker 不再向 Anthropic 傳送遙測與功能旗標請求。
Claude in Chrome：browser_batch 呼叫在被回報逾時前的時間從 60 秒增加到 90 秒；Chrome 連線失敗後，/chrome 的「Reconnect extension」現在會還原瀏覽器工具，無法還原時也會說明原因。
VS Code：在空白聊天的位置開啟已儲存的對話後，該空白聊天不再讓背景的 Claude 程序持續執行；在開啟的對話框後方出現的權限提示不再搶走鍵盤焦點；Continue After Reload 現在也會完成被重新啟動中斷的步驟；將游標停在檔案標籤上會顯示其相對於專案資料夾的路徑。
Code Review：阻擋性的審查留言不再以與其嚴重程度矛盾的「nit」標籤開頭；在已關閉 Code Review 的組織中，fork 與 Manual 模式的 pull request 上不再張貼留言「@claude review」的提示。

此版本共包含 190 項變更，完整清單請參閱完整變更日誌。

如何更新

檢查已安裝的版本：claude --version
就地更新：claude update
如果專案的設定檔曾用來啟用 Claude in Chrome 或設定 CLAUDE_CODE_DISABLE_ATTACHMENTS，這些設定在專案層級已不再生效：Claude in Chrome 請改用 --chrome、/chrome 或使用者設定，CLAUDE_CODE_DISABLE_ATTACHMENTS 請改在 shell、使用者或受管理的設定中設定。

新功能

以工作階段名稱使用 claude attach 與 claude logs

/claude-api 的 Managed Agents 上手指令