生活分享

Claude Code 2.1.323 更新:實驗性 Code Mode、外掛版本限制與更嚴格的沙盒權限

依 Anthropic 更新日誌,Claude Code 2.1.323 加入實驗性 Code Mode 與外掛版本範圍檢查,並收緊沙盒、MCP 與權限行為。使用 Claude Code 的開發者、外掛作者與團隊管理者,升級前宜了解哪些設定與工作流程可能受影響。

新聞日期: 閱讀時間約 5 分鐘

LINE 分享
目錄
  1. 1. 這次更新的重點
  2. 2. 安全與權限行為的變動
  3. 3. 升級前可能受影響的設定
  4. 4. 企業與管理端的小幅新增

這次更新的重點

Anthropic 在更新日誌中表示,Claude Code 2.1.323 新增 Code Mode,這是一項實驗性、需主動選用的功能,Claude 會撰寫 JavaScript 來呼叫其工具。日誌指向一個說明文件頁面,用來開啟此功能,或針對整個組織關閉它。

在外掛(為 Claude Code 增加功能的擴充套件)方面,Anthropic 表示外掛的設定檔 plugin.json 現在支援 engines["claude-code"]:超出所標示 Claude Code 版本範圍的外掛不會被安裝、更新或載入,安裝與更新會挑選符合範圍的最新版本。檢查外掛用的 claude plugin validate 指令,也新增對外掛 TypeScript hooks 模組的型別檢查(hooks 是在特定時機自動執行的自訂程式),每項發現都以警告呈現,加上 --strict 則會失敗。

其他新增項目包括:Artifact 工具資產上傳支援 .docx;當模型需要的用量額度被關閉或用完時,會出現含停止、改用用量額度、升級的選項選單;在 claude -p 與 SDK 工作階段中,hooks 長時間執行時每 30 秒送出進度心跳。Anthropic 說,這可避免 Claude Desktop 等主機端把該回合視為卡住(待其納入此版本後)。

安全與權限行為的變動

Anthropic 的日誌列出多項收緊措施。沙盒是限制指令能存取哪些檔案與資源的隔離環境;在 macOS 與 Linux 的沙盒中,git worktree add、move、remove 現在會以唯讀方式失敗(worktree 是同一個 git 儲存庫的額外工作資料夾),在工作階段未啟動或未獲授權的 worktree 中提交也一樣。「不再詢問」所產生的允許規則,若看起來含有機密,或會被存到 git 追蹤的 settings.local.json,則只在該工作階段有效、不會儲存。

MCP 伺服器是讓 Claude 連接外部工具與服務的介面。完成 MCP 伺服器登入的工具現在會要求使用者確認,即使在 bypass 與 auto 模式也一樣;無人可詢問時(例如 dontAsk 模式)須使用 /mcp。專案 .mcp.json 的 MCP 伺服器核准改為比對確切名稱,以其他拼法寫成的核准項目會再次詢問。此外,worktree 建立會拒絕 .git 資料夾為連結或含硬連結的檢出,Anthropic 建議改用一般 clone。

Anthropic 還表示,Claude Code 自己的 ripgrep 與多數內部 git 指令現在執行時不帶多數登入權杖與 API 金鑰,因此這類 git 指令下的認證輔助程式或 hook 不再能找到它們。另有一項:對背景工作階段執行 /logout,過去沒有效果,現在會登出電腦上所有工作階段、刪除已儲存的 MCP 登入與外掛機密,並結束該工作階段。

升級前可能受影響的設定

下表整理日誌中可能需要調整設定的部分變動。其中「上下文視窗」指模型一次能處理的內容量。

依 Anthropic 更新日誌整理的部分變動
項目日誌所述變動可能受影響者
未知模型的上下文視窗假設值由 200K 改為 1M;可用 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 維持 200K使用 Claude Code 不認得之模型 ID 的人
其他廠商較小視窗模型視窗填滿後可能每回合都失敗,直到 /clear使用他廠模型的工作階段
代理伺服器組織設定與政策請求不再使用僅由 ALL_PROXY 設定的代理;需設定 HTTPS_PROXY在代理網路中的團隊
自架 runner被取代工作單的隨選 runner 結束碼還原為 1(2.1.321、2.1.322 曾改為 0)依結束碼判斷結果的自動化流程
子代理狀態列subagentStatusLine 設定已移除,含該鍵的設定檔仍照常載入自訂狀態列的使用者
外掛 agent 設定已棄用;仍有效,但會在啟動等處警告外掛作者

企業與管理端的小幅新增

Anthropic 表示,Claude Tag 在 Slack 啟動的工作階段已納入 Enterprise 方案的 Compliance API(測試版),管理員可列出工作階段並讀取逐字稿。Code Review 管理設定新增 Download CSV 按鈕,可依月、週或日匯出單一儲存庫、單一 GitHub 組織或全部的審查成本。VS Code 擴充功能則新增信任提示:在未信任的資料夾首次使用前會先詢問,拒絕則該資料夾的設定與 MCP 伺服器不會被使用。

常見問題

Code Mode 是預設開啟的嗎?

不是。據 Anthropic 更新日誌,Code Mode 是實驗性、需主動選用的功能;組織也可依其文件頁面的說明關閉它。

我的外掛會因這次更新無法使用嗎?

據 Anthropic 說明,若外掛在 plugin.json 以 engines["claude-code"] 標示版本範圍,超出範圍的 Claude Code 版本將不會安裝、更新或載入該外掛。未標示者,日誌未提及受影響。

為何部分 git 相關 hook 可能找不到憑證?

Anthropic 表示,Claude Code 自己的 ripgrep 與多數內部 git 指令現在執行時不帶多數登入權杖與 API 金鑰,因此其下的認證輔助程式或 hook 不再能找到它們。

使用其他廠商模型要注意什麼?

Anthropic 表示,不認得的模型 ID 假設視窗改為 1M;若該模型視窗較小,填滿後可能每回合失敗,需 /clear。日誌建議事先設定 CLAUDE_CODE_DISABLE_1M_CONTEXT=1。

要去哪裡看完整的變更內容?

本文只整理 Anthropic 官方 Claude Code 更新日誌中的部分重點,完整清單與細節請以官方更新日誌與文件為準。

查看同分類最新消息

覺得這篇整理實用嗎?分享給需要的朋友

LINE 分享

資料來源

本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。

生活分享