Claude Code v2.1.282：maxProseWidth 設定、遙測設定調整與保留的技能命名空間

Claude Code v2.1.282 是一個大型版本，主軸是設定以及設定可被信任的範圍：新增適用於寬終端機的 maxProseWidth 設定，更嚴格地處理專案設定中的遙測變數與受管理設定，並為從 claude.ai 同步的技能保留名稱。此版本也修正了更多恢復工作階段時遺失先前推理的情況、一批 vim 模式問題，以及 VS Code、雲端工作階段與 Claude Tag 的多個項目。

新功能

適用於寬終端機的 `maxProseWidth`

新的 maxProseWidth 設定可限制 Claude 文字段落在寬終端機中的寬度，表格與程式碼區塊則維持完整寬度。

專案設定不再能開啟遙測匯出

專案與本機設定現在會忽略會開啟匯出、設定匯出端點或擷取內容的 OpenTelemetry 變數，例如 CLAUDE_CODE_ENABLE_TELEMETRY 與 OTEL_LOG_*。新的啟動通知，以及 /status 與 claude doctor 中的新項目，會列出專案設定檔中被忽略或關閉了遙測的遙測變數。

關閉遙測時使用伺服器端自動模式分類器

在直接連線 Anthropic API 且遙測關閉的情況下，自動模式現在預設使用伺服器端分類器；可用 CLAUDE_CODE_AUTO_MODE_SERVER=0 選擇退出。

保留 `anthropic-skills` 與 `claude-ai` 名稱

Skill(anthropic-skills:*) 與 Skill(claude-ai:*) 允許規則現在只涵蓋從 claude.ai 同步的技能，不再包含只是使用這類名稱的外掛或其他技能。位於 anthropic-skills 或 claude-ai 命名空間的技能資料夾、指令檔與工作流程指令不再載入（以此命名的外掛仍會載入，但名稱相同時以同步的技能優先）。以 anthropic-skills 或 claude-ai 為名設定的 MCP 伺服器現在不會列出任何技能或提示，但其工具仍可使用；在 MCP 設定中將伺服器改名即可重新列出。

管理員與受管理設定

新的 allowClaudeInChromeWithManagedMcp 受管理設定可讓 claude --chrome 與獨占的 managed-mcp.json 同時執行，Chrome 遭封鎖時顯示的錯誤訊息也會提到這個設定。當受管理設定或 --settings 設定了 allowUnsandboxedCommands: false，或受管理設定設定了 allowManagedDomainsOnly: true 時，sandbox.excludedCommands 現在會忽略專案與本機設定中的項目。在 Windows/WSL 上，存在但無效或無法讀取的管理員政策（HKLM、managed-settings.json）現在會阻止使用者可寫入的 HKCU 與 WSL /etc/claude-code 設定生效。

Claude apps gateway 的就緒寬限期

Claude apps gateway 新增 store.readiness_grace_seconds，讓 /readyz 在短暫的 Postgres 中斷（例如資料庫容錯移轉）期間仍維持就緒狀態。

雲端工作階段：GitHub App 狀態與更多 repo 選項

Settings › Connectors › GitHub 現在會顯示 Claude GitHub App 是否已為您的帳戶安裝且可以連線，並提供連線、安裝或重新連線的步驟。您可以將不同 GitHub 擁有者的 repo（例如 fork 的上游）附加到已有 repo 的執行中雲端工作階段（包括從 Slack 啟動的工作階段）；repo 位於 GitHub 以外 Git 伺服器的工作階段，也新增了「Open repository」與「Open compare page」連結。

修正與改進

API 錯誤：修正對話歷史中含有 API 無法解密的網頁搜尋結果時（例如由第三方閘道回答的回合），每個請求都以 400 錯誤失敗的問題。
API 錯誤：修正工作階段每回合都因「Invalid data in redacted_thinking block」API 錯誤而失敗的問題；Claude Code 現在會捨棄對話中的 thinking 區塊並重試一次。
壓縮：摘要請求被拒絕時，壓縮不再失敗，而會改用備援模型重試。
恢復工作階段：修正更多 --continue 與 --resume 以變動過的形式重新送出先前訊息的情況；在 Claude 工作時使用 /model、/rename、/artifacts 或其他立即執行的斜線指令，也不再捨棄先前的延伸思考。非常大的工作階段（包括從未壓縮過的）恢復速度也有所提升。
模型：修正在關閉 thinking 且努力程度高於 high 的工作階段中，安全相關的模型切換後回合失敗（「Effort ‘xhigh’ isn’t available with thinking turned off」）的問題。
Fable 使用額度：在 Claude Desktop 等由 SDK 承載的工作階段中，未回應的 Fable 使用額度提示不再切換模型（改為結束該回合）；當方案需要尚未開啟的使用額度時，以完整 Fable 模型 ID 執行 /model 現在會開啟使用額度提示，而不是停在 API 錯誤。
登入：另一個 Claude Code 程序在更新登入資訊途中被關閉或強制結束後，請求不再因「another Claude Code process is refreshing it」登入錯誤而失敗長達一分鐘。
權限：模式中間含有 :* 的 Bash 權限規則，過去在設定檔中會被略過、只有 --allowedTools 會採用；現在無論來源為何都會生效，並在啟動時警告其匹配方式。
受管理設定：布林鎖定鍵（例如 disableClaudeAiConnectors 或 allowManagedPermissionRulesOnly）的值打錯時，鎖定現在仍會套用，啟動時也會指出該鍵。單一巢狀值無效時，受管理的 permissions、autoMode、worktree 或 attribution 設定也不再整個被忽略。
受管理設定：在受管理的 allowManagedPermissionRulesOnly 之下，repo、使用者與 --add-dir 的技能、指令以及技能目錄外掛清單，不能再透過 allowed-tools 預先核准自己的工具。
macOS：啟動時不再透過經由 .. 或 /.vol 類型核心路徑連到 macOS /Network 的 repo 符號連結讀取 CLAUDE.md 與規則。
Shell 工具：Bash 與 PowerShell 不再以「Exit code 1」掩蓋磁碟配額已滿的狀況，也不再在暫存資料夾留下大型輸出檔案。
輸入：終端機的 bracketed paste 模式在工作階段中途被重設後，貼上的多行文字不再逐行送出；在會把 ctrl+enter 當成換行送出的終端機上（1.25 之前的 Windows Terminal），立即傳送的提示現在會顯示 ctrl+x ctrl+s。
Vim 模式：>> 不再縮排空行，r 搭配超過行長的次數不再修改文字，2J 不再多合併一行，dd、dj、dG 或整行 p/P 之後游標會落在第一個非空白字元，. 之前輸入的次數現在也會生效。
外掛：當外掛的設定檔仍啟用它或無法讀取時，解除安裝不再回報成功並刪除外掛已儲存的選項；若移除後無法讀取已安裝外掛清單，也會保留已儲存的選項與密鑰。
Vertex AI：對於 Claude Code 尚未辨識的模型（例如新推出的模型），現在也會提供網頁搜尋。
VS Code：面板不再於每次更新時重新解析整個回覆，因此長回覆不再落後於串流。
Claude Tag：模型已退役的 Slack 討論串現在會改用可用的模型，而不是每次回覆都退回到其他模型；新連線的 Slack 工作區也會採用目前的預設模型，而不是保留連線當時的預設值。

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

如何更新

檢查已安裝的版本：claude --version
就地更新：claude update
若您設定了名為 anthropic-skills 或 claude-ai 的 MCP 伺服器，請在 MCP 設定中將其改名，才能重新列出其技能與提示。專案或本機設定中開啟匯出的遙測變數現在會被忽略；啟動通知、/status 與 claude doctor 會列出這些變數。

新功能

適用於寬終端機的 maxProseWidth