Claude Code v2.1.268：閘道定價同步、外掛指令 JSON 輸出與 WebFetch 期限

Claude Code v2.1.268 是一次大型更新，變更日誌共列出 96 個項目。主要方向包括 Claude apps gateway 的管理功能、外掛指令的機器可讀輸出、權限與機密資訊處理的修正，以及大量 VS Code 與 Claude Tag 修正。此版本也修正了自 2.1.265 起，在第三方 Anthropic 相容端點上每一輪都以 HTTP 400 失敗的問題。

新功能

Claude apps gateway 定價與網路控管

在 gateway.yaml 中設定 pricing: 後，已登入的 Claude Code 用戶端會透過受管設定（managed settings）取得相同的費率，讓 /cost 與遙測資料和閘道的支出計量一致。當 access_control.allow_cidrs 為空時，閘道會在啟動時發出警告，並在第一次收到來自公開位址的請求時發出一次性警告。新的 gatewayInternalNetworks 受管設定則讓管理員可以允許對位於組織自有公開 IPv4 網段上的 Claude apps gateway 執行 /login。

外掛與驗證指令的 JSON 輸出

claude plugin install、uninstall、update、enable 與 disable 現在支援 --json，claude plugin list --json 的每一列也新增 errorDetails 與 noteDetails。claude auth status --json 的輸出現在也包含 configDirectory。

Self-hosted runner 工作階段清理

claude self-hosted-runner --remove-session-state 會在每個工作階段結束時，刪除 <base-dir>/_sessions/ 底下該工作階段專屬的目錄。此選項預設為關閉。

WebFetch 期限

當伺服器一直保持回應開啟卻不結束時，WebFetch 不再無限期卡住：擷取現在會在 300 秒後失敗。可設定 CLAUDE_CODE_WEBFETCH_DEADLINE_MS 覆寫此期限，設為 0 即可關閉。

任務追蹤工具僅限特定模型

任務追蹤工具（TaskCreate/Get/Update/List 與 TodoWrite）現在只會在 Claude 3.x、Opus 4.0–4.7、Sonnet 4.0–4.6 與 Haiku 4.5 上提供。若要在其他模型上使用，請設定 CLAUDE_CODE_ENABLE_TODO_TOOLS=1。

Artifact 工具的權限規則

一般的 WebFetch deny 與 ask 規則不再套用於 Artifact 工具的讀取與更新；若要封鎖或管控這些操作，請使用 Artifact 規則（或 WebFetch(domain:claude.ai)）。在設定為略過所有核准的本機 Cowork 工作階段中，Artifact 工具現在會拒絕工作階段資料夾以外或位於符號連結之後的本機檔案，而不是不經詢問就直接讀取。已發布的 artifact 也新增了瀏覽器分頁圖示，由 Claude 依每個頁面挑選。

更快的恢復，外掛不必再重新載入

--continue 與 --resume 現在會立即顯示對話，不再等待 SessionStart hook 執行完畢，第一則訊息也不再重新讀取整份對話紀錄。在 /plugin 中安裝、啟用或停用外掛後，只要關閉選單即會生效，之後不再需要執行 /reload-plugins。

Bedrock、Vertex 與 Foundry 與第一方工作階段一致

在 Bedrock、Vertex 與 Foundry 上，系統提示現在以附件形式提供環境、模型與設定資訊，工具清單在整段對話中也會維持位元組層級的穩定（較晚連線的工具改為延遲載入，而不是改寫清單），兩者都與第一方工作階段的行為一致。

修正與改進

第三方端點：修正自 2.1.265 起，在第三方 Anthropic 相容端點（ANTHROPIC_BASE_URL）上每一輪都以 HTTP 400 失敗的問題，原因是 Artifact 工具輸入結構描述中的一個正規表示式會被這些端點拒絕。
權限：符號連結目錄（macOS 上的 /etc、/tmp、/var；Linux 上的 /bin）上的 deny 與 ask 規則，在路徑以實際位置表示時現在也會套用，Bash 指令也不再忽略以符號連結路徑寫成的 deny 規則。當同一行出現權限檢查器無法分析的 env -C、eval 或類似指令時，Read 或 Edit 的 deny 規則現在也會生效。
機密資訊：外掛與 marketplace 的錯誤訊息不再顯示 git 來源 URL 中的 token 或密碼；/mcp 與 /plugin 的伺服器詳細資料、claude mcp list/get 以及 MCP 登入錯誤，也不再顯示從 MCP 設定中 ${VAR} 預留位置解析出的機密值。
未受信任的資料夾：重新產生的程序內 teammate 不再從你尚未信任的資料夾中、同名的代理檔案取得工具或系統提示。
CPU 使用率：長時間閒置的工作階段不再因忙碌迴圈而占滿一個 CPU 核心，工作階段回顧期間頻繁的終端機焦點回報也不再讓 CPU 持續處於高負載。
模型存取：符合資格的使用者不再因過時的模型存取拒絕快取而被告知模型受限；當另一個 Claude Code 程序重新整理過時的模型存取項目時，執行中的工作階段也不再悄悄切換為組織的預設模型。在 Pro 與 Team 方案上，Fable 模型的長上下文 429 錯誤現在會顯示 1M 上下文訊息，而不是用量額度同意提示。
SDK：使用 excludeDynamicSections 的 SDK 工作階段，提示快取與延伸思考不再於中途失效；SDK 的提示建議、側邊提問與 /rename 也不再送出壓縮前的對話內容。
壓縮：/compact 與自動壓縮產生的對話摘要，不再損壞含有 $ 序列的文字。
驗證：透過設定檔進行的工作負載身分聯合（claude-code-action 即採用此設定方式）不再於執行中途以 401 … jti reused 失敗；當本機回呼連接埠範圍無法綁定時，MCP 伺服器的 OAuth 登入也不再以「No available ports for OAuth redirect」失敗。
Hook：PermissionRequest hook 現在會在 --print 模式下觸發；CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 現在也能延長沒有個別 timeout 的 SessionEnd hook（先前它們仍會在 1.5 秒後被取消）。
代理檢視：在 claude agents 中以正常節奏再次按下 ← 返回代理清單時，不再被忽略；當 worktree 無法移除而導致工作階段刪除卡住時，訊息現在會說明原因與下一步，若是 git worktree，再按一次 ctrl+x 即可強制刪除該目錄。
回應速度：在全螢幕模式下，新增或移除提示行（Shift+Enter）的重繪速度現在與輸入一個字元相同；大量使用工具的回合不再因隱藏的逐批工具提醒而重繪對話紀錄；含有 .claude/workflows/ 腳本的專案啟動也更快。
自動模式：動作遭拒時，Claude 收到的訊息現在會指出阻擋該動作的規則，並要求 Claude 嘗試更安全的方法、先完成不相關的工作，再停下來詢問你。
VS Code：修正在設定檔或 environmentVariables 設定中指定 CLAUDE_CONFIG_DIR 時，工作階段清單、設定開關與聊天分頁的問題；從工作階段清單恢復時現在會遵守 claudeCode.preferredLocation: "sidebar"；「Manage plugins」對話框的變更現在會套用到已開啟的工作階段，無須重新啟動。鍵盤與螢幕閱讀器使用者可用左右方向鍵切換永久允許規則的儲存位置，也新增了「Claude Code: Focus last message」指令。
Claude Code on the web：執行超過約六小時的雲端工作階段，不再悄悄遺失儲存在持久化工作階段資料夾中的檔案；儲存的檔案現在最多可保留一天。
Claude Tag：每個公開頻道現在各自保存記憶筆記，Claude 不再回想起在其他公開頻道儲存的筆記（工作區筆記仍為共享）。Claude 也會同時執行多個唯讀查詢以加快回覆，並會說明阻擋動作的是權限檢查、它自己決定先確認，還是缺少存取權限。
Code Review：當驗證某項發現的其中一個代理中途失敗時，審查不再以未完成結束；當 PR 編輯的根目錄檔案只是與 CLAUDE.md 列出的檔案同名時，審查也不再忽略該目錄 CLAUDE.md 中的慣例。

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

如何更新

檢查已安裝的版本：claude --version
就地更新：claude update
檢查你的權限規則：一般的 WebFetch deny 與 ask 規則已不再涵蓋 Artifact 工具的讀取與更新，若你原本依賴這些規則，請新增 Artifact 規則（或 WebFetch(domain:claude.ai)）。若你在上述以外的模型上使用任務追蹤工具，請設定 CLAUDE_CODE_ENABLE_TODO_TOOLS=1。

新功能