Claude Code v2.1.287：Claude Mods、You should know mod，以及 Bedrock、Vertex 與 Foundry 預設 1M context

Claude Code v2.1.287 是一個大型版本，推出了讓外掛可以修改更深層行為的 Claude Mods，以及名為 You should know 的內建 mod。此版本也讓 Opus 4.7+ 與 Fable 在 Bedrock、Vertex、Foundry 與 Claude apps gateway 上預設使用 1M context，新增 2025-11-25 協定 MCP 伺服器的 URL 提示，並收緊經由符號連結寫入以及寫入受保護檔案之 shell 指令的核准方式。其餘項目為修正，其中有一大批與螢幕閱讀器模式相關。

新功能

Claude Mods 與 You should know mod

Claude Mods 讓外掛可以修改更深層的行為。內建的 You should know mod 會執行一個側邊代理替您留意，並標記您或 Claude 可能遺漏的事項；可用 /plugin enable cc-plugin-you-should-know@builtin 啟用（適用於開啟遙測的第一方工作階段）。

Bedrock、Vertex、Foundry 與 Claude apps gateway 預設 1M context

Opus 4.7+ 與 Fable 現在在 Bedrock、Vertex、Foundry 與 Claude apps gateway 上預設使用 1M context window，無須 [1m] 後綴。設定 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 可維持 200K。

MCP 伺服器的 URL 提示

使用 2025-11-25 協定的 MCP 伺服器現在可以傳送 URL 提示，例如用於登入。若某個伺服器在此次更新後無法連線，請在其 MCP 設定項目中加入 "bareElicitationCapability": true。

Agents 檢視：`n:` 篩選與排入佇列的回覆

Agents 檢視新增 n:<text> 篩選，可比對工作階段名稱與任務；篩選現在也會顯示收合區段中的符合項目，按 Enter 即可開啟第一個符合項目。從 claude agents 送出的回覆現在會以排入佇列的訊息送達，回合執行期間送出的斜線指令（/stop 除外）會在回合結束後才執行。

對高風險 shell 寫入的更嚴格核准

透過 repo 中已提交的符號連結，寫入敏感檔案或寫到工作目錄樹之外的 shell 寫入，現在會指出實際寫入位置並等待使用者確認，目標為 ~ 的指令行也是如此。整個工具層級的 Bash 允許規則與會放行的 hook，對於 Claude Code 檔案工具一律拒絕的檔案（例如 Anthropic 設定檔存放區與主機憑證檔案），現在會改為詢問，而不是直接執行 shell 寫入。危險的 rm（例如針對 / 或家目錄的指令）在同一指令也將輸出重新導向到 ~ 或萬用字元路徑時，也會保留其一律詢問的防護。

OpenTelemetry `user_prompt` 事件中的 `prompt_text`

OpenTelemetry 的 user_prompt 事件現在包含 prompt_text，這是 prompt 的副本，供會將帶點號鍵名巢狀展開的後端使用。凡是您會捨棄或遮蔽 prompt 的地方，也請同樣處理它。

其他行為變更

等待中的權限提示現在會依由舊到新的順序顯示，新的提示不再蓋住您正在閱讀的提示（帶有倒數計時的提示仍會顯示在最上層）；訊息被標記後的自動模型切換，也會保留您目前的努力程度，而不是改用新模型的預設值。設定為 alwaysLoad: false 的 MCP 伺服器，現在會將其所有工具延後到工具搜尋時才載入。Windows 與 Linux 上的右鍵貼上，以及 Linux 上的中鍵貼上，現在會在放開按鍵時才執行，放開前移開游標即可取消。

VS Code：Run in background

VS Code 為執行中的指令或子代理新增「Run in background」，可將其移到背景並繼續工作；agent map 也會在背景 shell 與 Monitor 的卡片上顯示其輸出。Claude in Chrome 的「Enabled by default」開關現在也會連接編輯器自己的工作階段，這些工作階段在執行瀏覽器動作前仍會詢問。

修正與改進

模型：在 Opus 5.5 與 Sonnet 5.5 之間切換（/model、opusplan）時，不再改寫先前的 MCP 工具公告，此問題可能導致先前的延伸思考被捨棄。
模型：以 claude.ai 登入時在 /model 中選擇 Fable，不再儲存當前版本的 ID，因此您儲存的預設值現在會像 Opus 與 Sonnet 一樣跟隨最新的 Fable。
Advisor：/advisor 的配對檢查現在允許 Sonnet 5.5 為 Opus 4.7 與 4.8 提供建議，API 會拒絕的 advisor 也會事先標示出來，而不是被無聲捨棄。
Bedrock 與 Vertex：啟動時的模型檢查不再忽略強制的 availableModels 清單，此問題可能讓 /model 只剩一列 Opus。
Headless 與 SDK：在回覆進行中切換模型後，claude -p 與 SDK 工作階段不再於之後的每則訊息重複進行模型備援。
權限：名為 __proto__ 的 MCP 工具，其組織層級的單一工具權限上限不再被無聲捨棄；Bash 權限提示現在也會以白話說明，而不是顯示「Contains simple_expansion」之類的內部剖析器名稱。
工作階段：恢復工作階段或壓縮之後，資料夾的 CLAUDE.md 不再被重複附加；雲端工作階段在壓縮期間重新啟動時，也不再偶爾遺失先前的對話。
Agents 檢視：claude agents 不再偶爾漏顯背景工作階段正在等待的權限提示；在代理結束並移除工作階段所在的 worktree 後，也能從這裡重新開啟該背景工作階段。
Hook：設定了 asyncRewake 的 hook 在其腳本檔案遺失時，不再一再以「found issues」通知喚醒 Claude；損壞的 hook 現在只會回報一次。
Remote Control：重新連線請求沒有回應時，Remote Control 不再長達數分鐘收不到訊息（現在會在 30 秒後放棄並重試）；在 macOS 上，以 claude remote-control 啟動的工作階段也不再於 Mac 進入閒置睡眠時在回合中途停止。
檔案傳送：Claude 從雲端工作階段與 Remote Control 傳送的檔案，在逾時、網路錯誤或 502、503、504 後現在會重試一次，大型檔案會直接從磁碟串流，而不是讀進記憶體；從 Claude 應用程式送出、附有 17 到 20 個檔案的訊息，也不再只送達前 16 個。
MCP：當伺服器變更其支援的 MCP 協定版本時，MCP 連接器的工具呼叫不再偶爾執行兩次，連接器的呼叫也不再一直失敗到重新啟動為止。大型 MCP 工具結果也會使用更少記憶體，並產生較小的工作階段檔案。
螢幕閱讀器模式：在搜尋框與登入代碼欄位中，游標現在會停留在輸入的文字處；檔案編輯核准提示與其他 diff 會包含變更的行；claude agents 中的時間最多每 10 秒才更新一次。新的或變更的行現在會直接寫出，不再先將游標停在行首；設定 CLAUDE_AX_PREPARK_MS=50 可恢復該停頓。
介面：/config 中可循環切換的設定現在會顯示 ‹ ›，並可用 ←/→ 雙向切換；「Reduce motion」設定現在也會停止執行中工具的圓點與三個轉圈指示。
Windows：輸入以管線傳入或被重新導向時，互動式 claude 不再卡住或以「Raw mode is not supported」當機，而會說明原因並結束（管線輸入請使用 -p）。移除每個指令前都會執行的子 shell 後，Bash 工具也變得更快；當拒絕 Bash 工具會連帶關閉 PowerShell 工具時，啟動時也會顯示警告。
self-hosted runner：在使用 Anthropic 管理之 git、且未安裝 GitHub CLI 的 macOS 與 Linux 機器上，工作階段可使用內建的 gh api（僅限 REST）。
Code Review：當前一個 commit 的審查已失敗兩次時，Code Review 不再於新的推送後略過該 pull request，而會審查最新的 commit。

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

如何更新

檢查已安裝的版本：claude --version
就地更新：claude update
若某個 MCP 伺服器在更新後無法連線，請在其 MCP 設定項目中加入 "bareElicitationCapability": true。若您的 OpenTelemetry 管線會捨棄或遮蔽 prompt，請對新的 prompt_text 欄位做同樣處理；若想在 Bedrock、Vertex、Foundry 或 Claude apps gateway 上維持 200K context，請設定 CLAUDE_CODE_DISABLE_1M_CONTEXT=1。

新功能