版本封存

Claude Code v2.1.285：claude --desktop、allowedProviders 受管理設定，以及背景 shell 指令的時間上限

Claude Code v2.1.285 新增 claude --desktop、claude plugin configure 與 allowedProviders 受管理設定，背景 shell 指令會在時間上限後停止，自訂 base URL 後方也可使用 1M context。

2026年9月29日 • 10 min read • 作者：ClaudeWorld

Claude Code v2.1.285 是一個大型版本。它新增了 claude --desktop、claude plugin configure 指令與 allowedProviders 受管理設定，為背景 shell 指令加上時間上限，並讓使用自訂 ANTHROPIC_BASE_URL 的工作階段，可以使用具備 1M context window 之模型的完整視窗。此外，還有大量針對子代理、Artifact 工具、/ultrareview 上傳、MCP、外掛與 VS Code 擴充功能的修正與變更。

新功能

以 claude --desktop 開啟桌面應用程式

claude --desktop 會在目前目錄開啟 Claude 桌面應用程式，搭配 --continue / --resume <id> 則會開啟指定的工作階段。

從命令列設定外掛

claude plugin configure <plugin> 會顯示外掛的選項與尚未設定的項目，也可以搭配 --values-stdin 儲存從 stdin 讀取的新值。claude plugin install --config 也接受 <server>.<key>=<value>，讓內建 .mcpb MCP 伺服器自身的設定可以在安裝時指定，無須進入 /plugin → Configure 就能啟動。

allowedProviders 受管理設定

新的 allowedProviders 受管理設定可限制一台機器能使用哪些 API 供應商：Anthropic API、自訂端點、Bedrock、Mantle、Vertex AI、Foundry、Claude Platform on AWS 或 Cloud gateway。

新的環境變數

CLAUDE_CODE_DISABLE_WEB_FETCH 可關閉 WebFetch 工具，CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES 則可限制逾時的非串流備援請求被重新送出的次數。

背景 shell 指令的時間上限

背景執行的 Bash 與 PowerShell 指令現在會在時間上限後停止，上限由搭配 run_in_background 的 timeout 決定（預設 30 分鐘，最長 2 小時）。指令被停止時會通知 Claude。

自訂 ANTHROPIC_BASE_URL 後方的 1M context

使用自訂 ANTHROPIC_BASE_URL 的工作階段，現在會使用具備 1M context window 之模型（Opus 4.7+、Sonnet 5+、Fable）的完整視窗。若您的閘道在 200K 就會停止，請執行 /autocompact 200k。

自動模式預設延伸到 claude -p 與 Python Agent SDK

在第三方供應商上或關閉遙測時，若未設定權限模式，claude -p 與 Python Agent SDK 工作階段現在也會像互動式工作階段一樣以自動模式啟動；--permission-mode 仍可覆寫此行為。當您的使用者設定預設為其他模式時，將自動模式設為預設權限模式的一次性提議，現在也會在第三方供應商上與關閉遙測時出現。

恢復正在背景執行的工作階段

對正在背景執行的工作階段使用 /resume 與 claude --resume 時，現在會開啟該工作階段而不是拒絕；以 claude --resume <id> "prompt" 提供的提示，會作為它的下一個回合送出。

修正與改進

  • 沙箱：專案設定不能再放寬或關閉管理員要求的沙箱、替換受管理拒絕清單後方的代理伺服器、擴充嚴格的允許清單，或重新開放受管理的讀取拒絕。
  • PowerShell：當 PowerShell 工具的指令剖析器無法啟動時（例如機器記憶體不足），其權限檢查不再略過拒絕與詢問規則，也不再把該失敗快取供之後的檢查使用。
  • Artifact 工具：Artifact 允許規則（「don’t ask again」）不再讓此工具未經詢問就發布工作目錄以外的檔案；若要讓規則涵蓋該檔案，請以 --add-dir 加入其資料夾。
  • 遮蔽：經遮蔽的記錄與對話記錄，不再顯示含有 @ 的 URL 密碼的一部分；URL 把 @ 寫成 %40 時，也不再顯示整個密碼。
  • WebFetch 與政策：Team 與 Enterprise 工作階段，以及 Claude Code 無法判斷登入方案的工作階段，若啟動時無法載入組織政策，現在會在政策載入前暫不提供 WebFetch。以 ANTHROPIC_AUTH_TOKEN 對 Anthropic API 驗證的工作階段，現在也會載入組織政策。
  • Windows：專案與本機設定的 env 不再設定 ALLUSERSPROFILE、SystemDrive 或 CommonProgramFiles 相關變數；請改在使用者或受管理設定中設定。
  • 子代理：fork 子代理現在會在上層的權限模式下執行，保留工作階段的計畫模式或 dontAsk 模式，且無法退出計畫模式。
  • 子代理：自動模式中的背景子代理不再於每次回報後要求第二個多餘的回覆，子代理在把報告交回呼叫者後也會立即結束執行。
  • Hook：同步 hook 啟動的背景程序（例如 some-daemon &）持續佔用其輸出時，Claude Code 不再因此卡住；hook 現在會在其自身程序結束後不久完成。
  • 重試：串流持續失敗時，失敗的 API 請求不再被重試多達 21 次，因為非串流備援現在與該請求共用重試額度。被 API 輸出內容過濾器擋下的回應，現在會立即顯示過濾器的錯誤，而不是重新送出並重試。
  • 恢復與壓縮：當儲存的對話記錄含有欄位缺漏或格式錯誤的壓縮標記或迴圈喚醒項目時，壓縮或恢復工作階段不再失敗、不再於沒有歷史記錄的情況下開啟，也不再當機。
  • 登入：修正瀏覽器已顯示成功後，登入流程可能永遠等待的問題。
  • 背景工作階段：從 claude agents 回覆一個正在等待權限提示的背景工作階段時，不再偶爾核准該待處理的指令。
  • MCP：MCP 伺服器名稱 widgets 現在在雲端工作階段與 self-hosted runner 上為保留名稱；您自己以此命名的伺服器，或 widgets_ 等相近寫法，將不再載入，請將其改名。
  • MCP CLI：claude mcp list 現在會列出 WebSocket（ws）MCP 伺服器及其 URL 與健康狀態；claude mcp get 則會隱藏外掛所提供之 stdio MCP 伺服器的指令、參數與環境變數值（仍會顯示變數名稱）。
  • Bedrock 與 Vertex AI：管理員移除預設模型的存取權時，工作階段現在會改用同一等級中較舊的可用模型，而不是失敗。
  • /ultrareview：在 macOS 與 Linux 上，上傳本機 repo 現在需要 git 2.31 或更新版本，以 --separate-git-dir 建立的 checkout 會被拒絕；上傳內容也不再包含檔名在副檔名前有冒號之憑證檔案（例如 server:8443.key）的未提交變更。
  • VS Code：當編輯器不回應擴充功能的自動儲存時，檔案的 Read、Write 與 Edit 呼叫不再停滯十分鐘後被略過。Manage plugins 新增外掛選項表單，新的隨選診斷工具也讓 Claude 能隨時讀取 Problems 面板目前的錯誤與警告。
  • Claude Tag：使用 Enterprise 方案 Standard 或 Usage-Based Chat 席位且同時擁有 Cowork 的成員，現在可以私訊 Claude；不再需要包含 Claude Code 的席位。

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

如何更新

  1. 檢查已安裝的版本：claude --version
  2. 就地更新：claude update
  3. 若您在自訂 ANTHROPIC_BASE_URL 後方的閘道在 200K 就會停止，請執行 /autocompact 200k。請將在雲端工作階段或 self-hosted runner 上使用、名為 widgets 的 MCP 伺服器改名；在 Windows 上，請把專案或本機 env 中的 ALLUSERSPROFILE、SystemDrive 或 CommonProgramFiles 值移到使用者或受管理設定。

相關連結