Documentation — Spybara

accessibility.md +145 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

5# 使用 Claude Code 搭配螢幕閱讀器

7> 為 VoiceOver 和 NVDA 等螢幕閱讀器設定 Claude Code，以及螢幕放大鏡、減少動畫和色盲友善主題的設定。

9Claude Code 具有螢幕閱讀器模式，可將其視覺終端介面替換為純文字、線性文字。該模式不使用方框、進度動畫和就地重繪，而是列印標記的行，螢幕閱讀器（例如 VoiceOver 或 NVDA）會依序讀取這些行，讓您可以進行完整對話、批准工具權限並從頭到尾檢查輸出。

11螢幕閱讀器模式是選擇性加入的。如果您使用螢幕放大鏡、減少動畫或色盲友善主題而不是螢幕閱讀器，請參閱[螢幕閱讀器模式以外的無障礙設定](#accessibility-settings-beyond-screen-reader-mode)。

13<Note>

14 螢幕閱讀器模式需要 Claude Code v2.1.181 或更新版本。較早版本會以 `error: unknown option '--ax-screen-reader'` 拒絕 `--ax-screen-reader` 旗標。

15</Note>

17<h2 id="turn-on-screen-reader-mode">

18 開啟螢幕閱讀器模式

19</h2>

21選擇與您使用螢幕閱讀器頻率相符的方法：

23* 針對一個工作階段：執行 `claude --ax-screen-reader`。

24* 針對從一個 shell 啟動的工作階段：將 `CLAUDE_AX_SCREEN_READER` 環境變數設定為 `1`。在 Bash 或 Zsh 中，執行 `export CLAUDE_AX_SCREEN_READER=1`；在 PowerShell 中，執行 `$env:CLAUDE_AX_SCREEN_READER = "1"`。將該行新增至您的 shell 設定檔以涵蓋每個 shell。

25* 針對機器上的每個工作階段：將 `"axScreenReader": true` 新增至您的使用者[設定檔](/zh-TW/settings)。這涵蓋任何終端，包括 VS Code 整合終端。

27<Note>

28 這些方法按優先順序列出：[`--ax-screen-reader`](/zh-TW/cli-reference#cli-flags) 旗標會覆寫 [`CLAUDE_AX_SCREEN_READER`](/zh-TW/env-vars) 環境變數，而環境變數會覆寫 [`axScreenReader`](/zh-TW/settings#available-settings) 設定。

29</Note>

31如果您透過 SSH 使用 Claude Code，請在執行 Claude Code 的遠端機器上設定環境變數或設定。

33當模式開啟時，Claude Code 列印的第一件事是確認行，命名開啟它的方法：`[Screen Reader Mode: on via flag]`、`[Screen Reader Mode: on via env]` 或 `[Screen Reader Mode: on via settings]`；此方法命名格式需要 Claude Code v2.1.206 或更新版本。

34{/* max-version: 2.1.205 */}較早版本會列印 `[Accessible screen reader mode: on]`。

36<h2 id="turn-off-screen-reader-mode">

37 關閉螢幕閱讀器模式

38</h2>

40反轉開啟模式的任何方法：不使用旗標啟動、取消設定環境變數，或將 `axScreenReader` 設定為 `false`。設定 `CLAUDE_AX_SCREEN_READER=0` 即使設定為 `true` 也會保持模式關閉。

42<h2 id="what-your-screen-reader-hears">

43 您的螢幕閱讀器聽到的內容

44</h2>

46在螢幕閱讀器模式中，Claude Code 寫入平面文字：

48* 介面 chrome 沒有方框繪製字元

49* 沒有僅限顏色的提示

50* 沒有未變更內容的重繪；進度微調器呈現為靜態文字

51* Claude 回覆中的表格讀作 `Header: value` 句子而不是方框字元網格。{/* min-version: 2.1.198 */}需要 Claude Code v2.1.198 或更新版本；較早版本即使在螢幕閱讀器模式下也會將表格繪製為網格。

53輸出會累積在您終端的回滾中，因此您可以使用螢幕閱讀器的檢查命令或終端的搜尋功能重新閱讀較早的回合。

55螢幕閱讀器模式呈現為純滾動文字，即使您已使用 [`tui` 設定](/zh-TW/settings#available-settings)開啟[全螢幕呈現](/zh-TW/fullscreen)；當模式啟用時，該設定無效。附加的背景工作階段仍會全螢幕呈現；請參閱[已知限制](#known-limitations)。

57文字記錄中的每條訊息都以標籤開頭，您的螢幕閱讀器會宣佈該標籤，命名其內容：您的訊息、Claude 的回覆、工具活動、錯誤和提示。這些標籤也可搜尋，因此您可以透過搜尋終端的回滾在文字記錄的各個部分之間跳躍：

59| 標籤 | 含義 |

60| :--------------------- | :--------------------------------------------------- |

61| `you:` | 您的訊息 |

62| `claude:` | Claude 的回覆 |

63| `tool:` | 工具活動，例如檔案編輯或執行的命令 |

64| `tool error:` | 失敗的工具 |

65| `error:` | 對話中的錯誤，例如失敗的 API 請求 |

66| `Permission Required:` | 等待您回答的權限提示 |

67| `Cost:` | Claude Code 結束時的工作階段成本摘要（如果您的帳戶[顯示成本](/zh-TW/costs)） |

69終端游標跟隨輸入插入符號，因此螢幕閱讀器的讀取目前行命令會以您正在編輯的提示回答「我在哪裡」。

71<h3 id="jump-between-turns">

72 在回合之間跳躍

73</h3>

75Claude Code 在回合邊界處發出 OSC 133 shell 整合標記，因此您終端的跳至上一個提示鍵會在回合之間移動，而無需讀取整個文字記錄：

77* iTerm2：Cmd+Shift+Up

78* VS Code 終端：Windows 上的 Ctrl+Up，macOS 上的 Cmd+Up

79* Windows Terminal：預設沒有鍵；在其設定中繫結 `scrollToMark` 動作

80* Kitty 和 Ghostty：檢查終端的文件以了解其跳至提示鍵

82macOS Terminal 不會對標記進行操作，Claude Code 在 WezTerm 中不會發出標記。在這些終端中，改為搜尋回滾中的 `you:` 標籤。

84<h2 id="answer-menus-and-prompts">

85 回答選單和提示

86</h2>

88在螢幕閱讀器模式中，您通常使用方向鍵導覽的選單（包括權限提示）會變成編號清單。每個選項都會宣佈為編號行，後面跟著 `Enter selection` 提示，該提示命名有效範圍。輸入您想要的選項編號並按 Enter。

90* 若要取消可關閉的選單：按 Escape。其提示以 `or Escape to cancel` 結尾。

91* 如果您輸入清單上沒有的編號：Claude Code 會宣佈有效範圍並讓您重試。

93是或否提示要求輸入答案而不是兩選項選單。回答 `y` 或 `n` 並按 Enter。`yes` 和 `no` 也可以。

95<h2 id="hear-when-claude-code-needs-you">

96 聽到 Claude Code 何時需要您

97</h2>

99在螢幕閱讀器模式中，Claude Code 會在需要您注意時響起終端鈴聲，因此您不必持續檢查文字記錄。鈴聲在以下情況下響起：

100

101* Claude 完成回覆

102* 出現權限提示

103* 執行時間超過 5 秒的工具完成

104

105鈴聲是您終端的標準警報。若要將其靜音，請變更您終端應用程式中的鈴聲設定。鈴聲不需要螢幕閱讀器模式：在模式外，將 [`preferredNotifChannel`](/zh-TW/settings#available-settings) 設定為 `"terminal_bell"` 以在 Claude 等待您時獲得類似警報。請參閱[取得終端鈴聲或通知](/zh-TW/terminal-config#get-a-terminal-bell-or-notification)。

106

107<h2 id="accessibility-settings-beyond-screen-reader-mode">

108 螢幕閱讀器模式以外的無障礙設定

109</h2>

110

111這些選項可解決螢幕閱讀器模式以外的無障礙需求。它們都可與其一起使用。

112

113* `CLAUDE_CODE_ACCESSIBILITY` [環境變數](/zh-TW/env-vars)適用於螢幕放大鏡。設定 `CLAUDE_CODE_ACCESSIBILITY=1` 以保持原生終端游標可見，以便放大鏡（例如 macOS Zoom）可以追蹤游標位置。

114* `prefersReducedMotion` [設定](/zh-TW/settings#available-settings)可減少或停用微調器、閃爍和其他動畫，而不會變更介面的其餘部分。

115* `theme` [設定](/zh-TW/settings#available-settings)選擇介面顏色，包括色盲友善的 `dark-daltonized` 和 `light-daltonized` 主題。

116

117<h2 id="known-limitations">

118 已知限制

119</h2>

120

121某些行為未針對螢幕閱讀器模式進行調整：

122

123* 當螢幕閱讀器執行時，螢幕閱讀器模式不會自動開啟。

124* 模式變更（例如進入[計畫模式](/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode)）尚未宣佈。

125* 使用 `claude attach` 或從代理檢視附加到[背景工作階段](/zh-TW/agent-view)會進入終端的替代螢幕，該螢幕沒有原生回滾。這與[其他附加工作階段的行為相同](/zh-TW/fullscreen)。若要返回，請在空提示上按左箭頭，或如果對話框有焦點，請按 Ctrl+Z。

126* Claude Code 在其在結束時列印的摘要中宣佈成本，而不是按回合。

127* 螢幕閱讀器模式不會使用 `-p` 旗標變更[非互動模式](/zh-TW/headless)。非互動模式已寫入純文字，並保持為指令碼的替代方案。

128

129<h2 id="report-an-issue">

130 報告問題

131</h2>

132

133如果螢幕閱讀器、放大鏡或終端出現問題，請在 [Claude Code 問題追蹤器](https://github.com/anthropics/claude-code/issues)上開啟問題，並在標題中提及您的輔助技術。在報告中包含您的作業系統、終端應用程式以及輔助技術名稱和版本。

134

135<h2 id="related-resources">

136 相關資源

137</h2>

138

139這些頁面包含此頁面涵蓋內容的完整參考項目和相關設定：

140

141* [設定](/zh-TW/settings#available-settings)：`axScreenReader`、`prefersReducedMotion`、`theme` 和 `preferredNotifChannel` 項目

142* [環境變數](/zh-TW/env-vars)：`CLAUDE_AX_SCREEN_READER` 和 `CLAUDE_CODE_ACCESSIBILITY` 項目

143* [CLI 參考](/zh-TW/cli-reference#cli-flags)：`--ax-screen-reader` 旗標

144* [終端配置](/zh-TW/terminal-config)：螢幕閱讀器模式外的鈴聲、通知和主題

145* [非互動模式](/zh-TW/headless)：指令碼化 `claude -p` 執行，不使用螢幕閱讀器模式寫入純文字

admin-setup.md +19 −5

Details

69 69

70請參閱 [Server-managed settings](/zh-TW/server-managed-settings) 和 [Settings files and precedence](/zh-TW/settings#settings-files)。70請參閱 [Server-managed settings](/zh-TW/server-managed-settings) 和 [Settings files and precedence](/zh-TW/settings#settings-files)。

71 71

72<h3 id="wsl-sessions-in-claude-code-desktop">

73 Claude Code Desktop 中的 WSL 會話

74</h3>

76在 Windows 上，[Claude Code Desktop 可以在 WSL 2 發行版內執行 Code 會話](/zh-TW/desktop-wsl)。會話的 Claude Code 程序在發行版內執行，因此它透過上述 WSL 探索路徑解析受管設定：除非部署了 `wslInheritsWindowsSettings: true`，否則僅限 Windows 的來源無法到達它。

78在存在受管設定的裝置上，Desktop WSL 會話預設不可用。如果您的組織想要啟用它們，請聯絡您的 Anthropic 帳戶團隊。啟用後：

80* 透過 HKLM 登錄或 `C:\Program Files\ClaudeCode` 檔案部署 `wslInheritsWindowsSettings: true`，以便 WSL 會話繼承與主機會話相同的政策。

81* 透過在 WSL 會話內執行 `/status` 進行驗證：`Setting sources` 行應顯示 `Enterprise managed settings` 以及您部署的 Windows 來源 `(HKLM)` 或 `(file)`。

83WSL 2 公用程式 VM 內的程序對 Windows 端端點偵測感應器不可見。如果您使用 CrowdStrike Falcon，請在 WSL 2 上啟用適用於 Linux 的 Falcon 感應器，並使用 CrowdStrike 的 WSL 文件所需的兩個排除項目（適用於 WSL 虛擬機器程序和 VM 磁碟映像），以便可以觀察到發行版內的程序和檔案活動。Claude Code 的 [OpenTelemetry 工具執行遙測](/zh-TW/monitoring-usage)對 WSL 和原生會話的發出方式相同。

72<h2 id="decide-what-to-enforce">85<h2 id="decide-what-to-enforce">

73 決定要執行什麼86 決定要執行什麼

74</h2>87</h2>

100 設定使用情況可見性113 設定使用情況可見性

101</h2>114</h2>

102 115

103根據您需要報告的內容選擇監控。116根據您需要報告的內容選擇監控。儀表板、API 和支出控制在 Claude for Teams 或 Enterprise 計畫與 Claude Console 組織之間有所不同，因此在根據功能規劃報告之前，請檢查「可用性」欄。

104 117

105| 功能 | 您獲得什麼 | 可用性 | 從哪裡開始 |118| 功能 | 您獲得什麼 | 可用性 | 從哪裡開始 |

106| :------------------ | :------------------------- | :---------------------------------------------------------------------------------------------------------------------- | :------------------------------------------ |119| :--------------------- | :--------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- |

109| Cost tracking | 支出限制、速率限制和使用情況歸因 | Anthropic；在第三方雲端上，[Claude 應用程式閘道](/zh-TW/claude-apps-gateway)提供每個使用者的歸因和[支出限制](/zh-TW/claude-apps-gateway-spend-limits) | [Costs](/zh-TW/costs) |122| Programmatic reporting | 透過 API 的每個使用者使用情況和成本資料 | Enterprise 的 [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide)，Console 的 [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) | [Costs](/zh-TW/costs#manage-costs-for-your-organization) |

123| Spend controls | 支出限制和速率限制 | Teams / Enterprise 的管理員設定、Console 的工作區限制；在第三方雲端上，雲端預算控制或具有每個使用者[支出限制](/zh-TW/claude-apps-gateway-spend-limits)的 [Claude 應用程式閘道](/zh-TW/claude-apps-gateway) | [Costs](/zh-TW/costs#manage-costs-for-your-organization) |

110 124

111雲端提供者透過 AWS Cost Explorer、GCP Billing 或 Azure Cost Management 公開支出。Claude for Teams 和 Enterprise 計畫在 [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) 包含使用情況儀表板。125在 Teams 和 Enterprise 上，每個使用者的使用情況和支出數字來自您組織分析設定中的[支出報告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)，而不是分析儀表板。雲端提供者透過 AWS Cost Explorer、GCP Billing 或 Azure Cost Management 公開支出。如需規劃跨 Claude chat、Claude Code 和 Cowork 的企業預算，請參閱 [Claude Enterprise 消費指南](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide)。

112 126

113<h2 id="review-data-handling">127<h2 id="review-data-handling">

114 檢查資料處理128 檢查資料處理

advisor.md +1 −4

Details

6 6

7> 將您的主要模型與更強大的顧問模型配對，Claude 在任務期間的關鍵時刻會諮詢該模型。7> 將您的主要模型與更強大的顧問模型配對，Claude 在任務期間的關鍵時刻會諮詢該模型。

8 8

~~9{/* plan-availability: feature=advisor providers=anthropic */}~~

11<Note>9<Note>

12 顧問工具是實驗性功能，需要 Claude Code v2.1.98 或更新版本搭配 Anthropic API。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。行為、定價和可用性可能會變更。10 顧問工具是實驗性功能，需要 Anthropic API。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。行為、定價和可用性可能會變更。

13</Note>11</Note>

14 12

15顧問工具讓 Claude 在任務期間的關鍵時刻諮詢第二個通常更強大的模型，例如在提交方案前、遇到重複錯誤時，或在宣佈任務完成前。顧問會收到完整的對話記錄，包括每個工具呼叫和結果，並返回 Claude 在繼續前應用的指導。13顧問工具讓 Claude 在任務期間的關鍵時刻諮詢第二個通常更強大的模型，例如在提交方案前、遇到重複錯誤時，或在宣佈任務完成前。顧問會收到完整的對話記錄，包括每個工具呼叫和結果，並返回 Claude 在繼續前應用的指導。

161 159

162顧問工具需要以下所有條件：160顧問工具需要以下所有條件：

163 161

164* **Claude Code v2.1.98 或更新版本**：執行 `claude update` 以升級。

165* **僅限 Anthropic API**：顧問是伺服器執行的工具。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。透過配置有 `ANTHROPIC_BASE_URL` 的 [LLM 閘道](/zh-TW/llm-gateway)，可用性取決於閘道是否將請求完整轉發到 Anthropic API。162* **僅限 Anthropic API**：顧問是伺服器執行的工具。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。透過配置有 `ANTHROPIC_BASE_URL` 的 [LLM 閘道](/zh-TW/llm-gateway)，可用性取決於閘道是否將請求完整轉發到 Anthropic API。

166* **支援的主要模型**：Opus 4.6 或更新版本、Sonnet 4.6 或更新版本，或 Haiku 4.5。{/* min-version: 2.1.170 */}Fable 5 在 Claude Code v2.1.170 或更新版本上也符合條件。163* **支援的主要模型**：Opus 4.6 或更新版本、Sonnet 4.6 或更新版本，或 Haiku 4.5。{/* min-version: 2.1.170 */}Fable 5 在 Claude Code v2.1.170 或更新版本上也符合條件。

167 164

agent-sdk/mcp.md +3 −1

Details

497 OAuth2 身份驗證497 OAuth2 身份驗證

498</h3>498</h3>

499 499

500[MCP 規範支持 OAuth 2.1](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) 用於授權。SDK 不會自動處理 OAuth 流程，但您可以在應用程式中完成 OAuth 流程後通過標頭傳遞訪問令牌：500[MCP 規範支持 OAuth 2.1](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) 用於授權。SDK 不會開啟瀏覽器或運行互動式 OAuth 流程。當配置的伺服器返回授權質詢且沒有可用的儲存令牌時，代理運行會在沒有該伺服器工具的情況下繼續，並且伺服器在[系統初始化訊息](/zh-TW/agent-sdk/typescript#sdksystemmessage)的 `mcp_servers` 陣列中報告狀態為 `needs-auth`。如果您的代理依賴於特定伺服器的連接，請在啟動時檢查該陣列。

501

502要提供憑據，請在您自己的應用程式中完成 OAuth 流程，並在伺服器的 `headers` 中傳遞生成的訪問令牌：

501 503

502<CodeGroup>504<CodeGroup>

503 ```typescript TypeScript theme={null}505 ```typescript TypeScript theme={null}

agent-sdk/overview.md +36 −3

Details

62 ```62 ```

63 </Tab>63 </Tab>

64 64

~~65 <Tab title="Python">~~65 <Tab title="Python (uv)">

66 [uv](https://docs.astral.sh/uv/) 是一個快速的 Python 套件管理器，可自動處理虛擬環境：

68 ```bash theme={null}

69 uv init

70 uv add claude-agent-sdk

71 ```

72 </Tab>

74 <Tab title="Python (pip)">

75 建立並啟動虛擬環境，然後安裝套件。安裝到虛擬環境可避免在最近的 Debian、Ubuntu 和 Homebrew 安裝上執行 `pip install` 時系統 Python 返回的 `error: externally-managed-environment` 失敗。

77 在 macOS 或 Linux 上：

66 ```bash theme={null}79 ```bash theme={null}

80 python3 -m venv .venv

81 source .venv/bin/activate

82 pip install claude-agent-sdk

83 ```

85 在 Windows 上：

87 ```powershell theme={null}

88 py -m venv .venv

89 .venv\Scripts\Activate.ps1

67 pip install claude-agent-sdk90 pip install claude-agent-sdk

68 ```91 ```

69 92

93 如果 PowerShell 因執行原則錯誤而阻止 `Activate.ps1`，請先執行 `Set-ExecutionPolicy -Scope Process RemoteSigned`。

70 Python 套件需要 Python 3.10 或更新版本。如果 pip 報告 `No matching distribution found for claude-agent-sdk`，表示您的直譯器版本早於 3.10。在 macOS 或 Linux 上執行 `python3 --version`，或在 Windows 上執行 `py --version`，以檢查版本。95 Python 套件需要 Python 3.10 或更新版本。如果 pip 報告 `No matching distribution found for claude-agent-sdk`，表示您的直譯器版本早於 3.10。在 macOS 或 Linux 上執行 `python3 --version`，或在 Windows 上執行 `py --version`，以檢查版本。

71 </Tab>96 </Tab>

72 </Tabs>97 </Tabs>

77 </Step>102 </Step>

78 103

79 <Step title="設定您的 API 金鑰">104 <Step title="設定您的 API 金鑰">

~~80 從[主控台](https://platform.claude.com/)取得 API 金鑰，然後將其設定為環境變數：~~105 從[主控台](https://platform.claude.com/)取得 API 金鑰，然後將其設定為環境變數。

106

107 在 macOS 或 Linux 上：

81 108

82 ```bash theme={null}109 ```bash theme={null}

~~83 export ANTHROPIC_API_KEY=your-api-key~~110 export ANTHROPIC_API_KEY=sk-ant-xxxxx

111 ```

112

113 在 Windows PowerShell 上：

114

115 ```powershell theme={null}

116 $env:ANTHROPIC_API_KEY = "sk-ant-xxxxx"

84 ```117 ```

85 118

86 SDK 也支援透過第三方 API 提供者進行身份驗證：119 SDK 也支援透過第三方 API 提供者進行身份驗證：

agent-sdk/python.md +6 −0

Details

10 安裝10 安裝

11</h2>11</h2>

12 12

13在虛擬環境中安裝套件。在最近的 Debian、Ubuntu 和 Homebrew Python 安裝上，針對系統 Python 執行 `pip install` 會失敗，並出現 `error: externally-managed-environment` 錯誤。

13```bash theme={null}15```bash theme={null}

16python3 -m venv .venv

17source .venv/bin/activate

14pip install claude-agent-sdk18pip install claude-agent-sdk

15```19```

16 20

21如需 uv、Windows PowerShell 和 API 金鑰設定，請參閱 [Agent SDK 概觀中的開始使用](/zh-TW/agent-sdk/overview#get-started)。

17<h2 id="choosing-between-query-and-claudesdkclient">23<h2 id="choosing-between-query-and-claudesdkclient">

18 在 `query()` 和 `ClaudeSDKClient` 之間選擇24 在 `query()` 和 `ClaudeSDKClient` 之間選擇

19</h2>25</h2>

amazon-bedrock.md +1 −5

Details

332 啟動模型檢查332 啟動模型檢查

333</h2>333</h2>

334 334

335當 Claude Code 以 Amazon Bedrock 設定啟動時，它會驗證它打算使用的模型在您的帳戶中是否可存取。此檢查需要 Claude Code v2.1.94 或更新版本。335當 Claude Code 以 Amazon Bedrock 設定啟動時，它會驗證它打算使用的模型在您的帳戶中是否可存取。

336 336

337如果您已固定的模型版本比目前 Claude Code 預設值更舊，且您的帳戶可以叫用較新版本，Claude Code 會提示您更新固定。接受會將新模型 ID 寫入您的[使用者設定檔](/zh-TW/settings)並重新啟動 Claude Code。拒絕會被記住，直到下一次預設版本變更。指向[應用程式推論設定檔 ARN](#map-each-model-version-to-an-inference-profile) 的固定會被跳過，因為這些由您的管理員管理。337如果您已固定的模型版本比目前 Claude Code 預設值更舊，且您的帳戶可以叫用較新版本，Claude Code 會提示您更新固定。接受會將新模型 ID 寫入您的[使用者設定檔](/zh-TW/settings)並重新啟動 Claude Code。拒絕會被記住，直到下一次預設版本變更。指向[應用程式推論設定檔 ARN](#map-each-model-version-to-an-inference-profile) 的固定會被跳過，因為這些由您的管理員管理。

338 338

435 435

436Mantle 是一個 Amazon Bedrock 端點，透過原生 Anthropic API 形狀而不是 Amazon Bedrock Invoke API 提供 Claude 模型。它使用相同的 AWS 認證、IAM 權限和本頁面前面所述的 `awsAuthRefresh` 設定。436Mantle 是一個 Amazon Bedrock 端點，透過原生 Anthropic API 形狀而不是 Amazon Bedrock Invoke API 提供 Claude 模型。它使用相同的 AWS 認證、IAM 權限和本頁面前面所述的 `awsAuthRefresh` 設定。

437 437

438<Note>

439 Mantle 需要 Claude Code v2.1.94 或更新版本。執行 `claude --version` 以檢查。

440</Note>

~~441~~

442<h3 id="enable-mantle">438<h3 id="enable-mantle">

443 啟用 Mantle439 啟用 Mantle

444</h3>440</h3>

analytics.md +5 −3

Details

26* **排行榜**：按 Claude Code 使用情況排名的頂級貢獻者26* **排行榜**：按 Claude Code 使用情況排名的頂級貢獻者

27* **數據匯出**：將貢獻數據下載為 CSV 格式以進行自訂報告27* **數據匯出**：將貢獻數據下載為 CSV 格式以進行自訂報告

28 28

~~29如需每個用戶的令牌計數和成本估計，請配置 [OpenTelemetry 匯出](/zh-TW/monitoring-usage)。~~29如需每個用戶的令牌計數和成本估計，請配置 [OpenTelemetry 匯出](/zh-TW/monitoring-usage)，或從您組織的分析設定匯出 [支出報告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)，其中列出每個用戶和每個模型的令牌使用情況和估計使用額度支出。

30 30

31<h3 id="enable-contribution-metrics">31<h3 id="enable-contribution-metrics">

32 啟用貢獻指標32 啟用貢獻指標

228 以編程方式訪問數據228 以編程方式訪問數據

229</h4>229</h4>

230 230

231要通過 GitHub 查詢此數據，請搜索標記為 `claude-code-assisted` 的 PR。231在 Enterprise 計劃上，[Claude Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) 為您的組織返回每個用戶的參與度、使用情況和成本報告，涵蓋所有 Claude 表面，包括 Claude Code。主要所有者在 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) 處使用 `read:analytics` 範圍創建密鑰。該 API 在 Teams 計劃上不可用。

232

233要通過 GitHub 查詢貢獻數據，請搜索標記為 `claude-code-assisted` 的 PR。

232 234

233<h2 id="access-analytics-for-api-customers">235<h2 id="access-analytics-for-api-customers">

234 訪問 API 客戶的分析236 訪問 API 客戶的分析

235</h2>237</h2>

236 238

237使用 Claude Console 的 API 客戶可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 訪問分析。您需要 UsageView 權限才能訪問儀表板，該權限授予開發人員、計費、管理員、所有者和主要所有者角色。239使用 Claude Console 的 API 客戶可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 訪問分析。您需要 UsageView 權限才能訪問儀表板，該權限授予開發人員、計費、管理員、所有者和主要所有者角色。若要以程式設計方式提取相同的每日每用戶指標，請使用 [Claude Code Analytics API](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-code-analytics-api) 搭配管理員 API 金鑰。

238 240

239<Note>241<Note>

240 GitHub 整合的貢獻指標目前不適用於 API 客戶。Console 儀表板僅顯示使用和支出指標。242 GitHub 整合的貢獻指標目前不適用於 API 客戶。Console 儀表板僅顯示使用和支出指標。

channels.md +1 −1

Details

7> 使用 channels 從 MCP 伺服器將訊息、警報和 webhooks 推送到您的 Claude Code 工作階段。轉發 CI 結果、聊天訊息和監控事件，讓 Claude 在您不在時做出反應。7> 使用 channels 從 MCP 伺服器將訊息、警報和 webhooks 推送到您的 Claude Code 工作階段。轉發 CI 結果、聊天訊息和監控事件，讓 Claude 在您不在時做出反應。

8 8

9<Note>9<Note>

10 Channels 處於[研究預覽](#research-preview)階段，需要 Claude Code v2.1.80 或更新版本。它們需要透過 claude.ai 或 Console API 金鑰進行 Anthropic 驗證，且在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。Team 和 Enterprise 組織必須[明確啟用它們](#enterprise-controls)。10 Channels 處於[研究預覽](#research-preview)階段。它們需要透過 claude.ai 或 Console API 金鑰進行 Anthropic 驗證，且在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。Team 和 Enterprise 組織必須[明確啟用它們](#enterprise-controls)。

11</Note>11</Note>

12 12

13Channel 是一個 MCP 伺服器，可將事件推送到您執行中的 Claude Code 工作階段，讓 Claude 能對您不在終端時發生的事情做出反應。Channels 可以是雙向的：Claude 讀取事件並通過同一 channel 回覆，就像聊天橋接一樣。事件只在工作階段開啟時到達，因此對於始終開啟的設定，您可以在背景程序或持久終端中執行 Claude。13Channel 是一個 MCP 伺服器，可將事件推送到您執行中的 Claude Code 工作階段，讓 Claude 能對您不在終端時發生的事情做出反應。Channels 可以是雙向的：Claude 讀取事件並通過同一 channel 回覆，就像聊天橋接一樣。事件只在工作階段開啟時到達，因此對於始終開啟的設定，您可以在背景程序或持久終端中執行 Claude。

channels-reference.md +1 −5

Details

7> 建立一個 MCP 伺服器，將 webhooks、警報和聊天訊息推送到 Claude Code 工作階段。頻道合約的參考：功能聲明、通知事件、回覆工具、寄件者閘道和權限中繼。7> 建立一個 MCP 伺服器，將 webhooks、警報和聊天訊息推送到 Claude Code 工作階段。頻道合約的參考：功能聲明、通知事件、回覆工具、寄件者閘道和權限中繼。

8 8

9<Note>9<Note>

10 Channels 處於[研究預覽](/zh-TW/channels#research-preview)階段，需要 Claude Code v2.1.80 或更新版本。Team 和 Enterprise 組織必須[明確啟用它們](/zh-TW/channels#enterprise-controls)。10 Channels 處於[研究預覽](/zh-TW/channels#research-preview)階段。Team 和 Enterprise 組織必須[明確啟用它們](/zh-TW/channels#enterprise-controls)。

11</Note>11</Note>

12 12

13Channel 是一個 MCP 伺服器，將事件推送到 Claude Code 工作階段，以便 Claude 可以對終端機外發生的事情做出反應。13Channel 是一個 MCP 伺服器，將事件推送到 Claude Code 工作階段，以便 Claude 可以對終端機外發生的事情做出反應。

453 中繼權限提示453 中繼權限提示

454</h2>454</h2>

455 455

456<Note>

457 權限中繼需要 Claude Code v2.1.81 或更新版本。較早版本會忽略 `claude/channel/permission` 功能。

458</Note>

~~459~~

460當 Claude 呼叫需要批准的工具時，本機終端機對話框開啟，工作階段等待。雙向 channel 可以選擇加入以在平行接收相同提示，並將其中繼到您在另一台裝置上。兩者都保持活躍：您可以在終端機或手機上回答，Claude Code 應用先到達的答案並關閉另一個。456當 Claude 呼叫需要批准的工具時，本機終端機對話框開啟，工作階段等待。雙向 channel 可以選擇加入以在平行接收相同提示，並將其中繼到您在另一台裝置上。兩者都保持活躍：您可以在終端機或手機上回答，Claude Code 應用先到達的答案並關閉另一個。

461 457

462中繼涵蓋工具使用批准，如 Bash、Write 和 Edit。專案信任和 MCP 伺服器同意對話框不中繼；這些僅在本機終端機中出現。458中繼涵蓋工具使用批准，如 Bash、Write 和 Edit。專案信任和 MCP 伺服器同意對話框不中繼；這些僅在本機終端機中出現。

checkpointing.md +2 −2

Details

12 Checkpointing 的運作方式12 Checkpointing 的運作方式

13</h2>13</h2>

14 14

15當您與 Claude 合作時，checkpointing 會自動捕捉每次編輯前的程式碼狀態。這個安全網讓您可以進行雄心勃勃的大規模任務，同時知道您可以隨時回到先前的程式碼狀態。15當您與 Claude 合作時，checkpointing 會自動捕捉每次使用者提示前的程式碼狀態。這個安全網讓您可以進行雄心勃勃的大規模任務，同時知道您可以隨時回到先前的程式碼狀態。

16 16

17<h3 id="automatic-tracking">17<h3 id="automatic-tracking">

18 自動追蹤18 自動追蹤

21Claude Code 追蹤由其檔案編輯工具所做的所有變更：21Claude Code 追蹤由其檔案編輯工具所做的所有變更：

22 22

23* 每個使用者提示都會建立一個新的 checkpoint23* 每個使用者提示都會建立一個新的 checkpoint

~~24* Checkpoints 在會話之間持續存在，因此您可以在恢復的對話中存取它們~~24* Checkpoints 與對話一起儲存，因此恢復的會話仍然可以 `/rewind` 回到它們

25* 自動清理，與會話一起在 30 天後刪除（可配置）25* 自動清理，與會話一起在 30 天後刪除（可配置）

26 26

27<h3 id="rewind-and-summarize">27<h3 id="rewind-and-summarize">

chrome.md +1 −1

Details

36 36

37* [Google Chrome](https://www.google.com/chrome/) 或 [Microsoft Edge](https://www.microsoft.com/edge) 瀏覽器37* [Google Chrome](https://www.google.com/chrome/) 或 [Microsoft Edge](https://www.microsoft.com/edge) 瀏覽器

38* [Claude in Chrome 擴充功能](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 版本 1.0.36 或更高版本，可在 Chrome Web Store 中為兩個瀏覽器取得38* [Claude in Chrome 擴充功能](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 版本 1.0.36 或更高版本，可在 Chrome Web Store 中為兩個瀏覽器取得

~~39* [Claude Code](/zh-TW/quickstart#step-1-install-claude-code) 版本 2.0.73 或更高版本~~39* [Claude Code](/zh-TW/quickstart#step-1-install-claude-code)

40* 直接 Anthropic 計畫（Pro、Max、Team 或 Enterprise）40* 直接 Anthropic 計畫（Pro、Max、Team 或 Enterprise）

41 41

42<Note>42<Note>

cli-reference.md +2 −2

Details

59| 旗標 | 描述 | 範例 |59| 旗標 | 描述 | 範例 |

60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |

61| `--add-dir` | 新增額外的工作目錄供 Claude 讀取和編輯檔案。授予檔案存取權；大多數 `.claude/` 設定 [未從這些目錄探索](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)。驗證每個路徑是否存在為目錄。若要在工作階段之間持久化這些目錄，請在設定中設定 [`permissions.additionalDirectories`](/zh-TW/settings#permission-settings) | `claude --add-dir ../apps ../lib` |61| `--add-dir` | 新增額外的工作目錄供 Claude 讀取和編輯檔案。授予檔案存取權；大多數 `.claude/` 設定 [未從這些目錄探索](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)。驗證每個路徑是否存在為目錄。若要在工作階段之間持久化這些目錄，請在設定中設定 [`permissions.additionalDirectories`](/zh-TW/settings#permission-settings) | `claude --add-dir ../apps ../lib` |

62| `--advisor <model>` | {/* min-version: 2.1.98 */}使用模型別名啟用此工作階段的伺服器端 [advisor tool](/zh-TW/advisor)：`opus`、`sonnet` 或 `fable`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。優先於工作階段的 `advisorModel` 設定。需要 Claude Code v2.1.98 或更新版本 | `claude --advisor opus` |62| `--advisor <model>` | 使用模型別名啟用此工作階段的伺服器端 [advisor tool](/zh-TW/advisor)：`opus`、`sonnet` 或 `fable`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。優先於工作階段的 `advisorModel` 設定 | `claude --advisor opus` |

64| `--agents` | 透過 JSON 動態定義自訂 subagents。使用與 subagent [frontmatter](/zh-TW/sub-agents#supported-frontmatter-fields) 相同的欄位名稱，加上代理程式指示的 `prompt` 欄位 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | 透過 JSON 動態定義自訂 subagents。使用與 subagent [frontmatter](/zh-TW/sub-agents#supported-frontmatter-fields) 相同的欄位名稱，加上代理程式指示的 `prompt` 欄位 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

65| `--allow-dangerously-skip-permissions` | 新增 `bypassPermissions` 到 `Shift+Tab` 模式循環而不立即啟動它。允許您以不同的模式（如 `plan`）開始，稍後切換到 `bypassPermissions`。請參閱 [permission modes](/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | 新增 `bypassPermissions` 到 `Shift+Tab` 模式循環而不立即啟動它。允許您以不同的模式（如 `plan`）開始，稍後切換到 `bypassPermissions`。請參閱 [permission modes](/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}將自訂文字附加到每個 [subagent](/zh-TW/sub-agents) 系統提示的末尾，包括巢狀 subagents。僅適用於使用 `-p` 的非互動模式。需要 Claude Code v2.1.205 或更新版本 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}將自訂文字附加到每個 [subagent](/zh-TW/sub-agents) 系統提示的末尾，包括巢狀 subagents。僅適用於使用 `-p` 的非互動模式。需要 Claude Code v2.1.205 或更新版本 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}呈現螢幕閱讀器友善的輸出：平面文字，無裝飾邊框或動畫。強制使用經典渲染器，因此 [`tui`](/zh-TW/settings#available-settings) 設定在工作階段中無效。優先於 [`CLAUDE_AX_SCREEN_READER`](/zh-TW/env-vars) 和 [`axScreenReader`](/zh-TW/settings#available-settings) 設定。需要 Claude Code v2.1.181 或更新版本 | `claude --ax-screen-reader` |70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}呈現螢幕閱讀器友善的輸出：平面文字，無裝飾邊框或動畫。強制使用經典渲染器，因此 [`tui`](/zh-TW/settings#available-settings) 設定在工作階段中無效；附加的 [background sessions](/zh-TW/agent-view) 仍會全螢幕呈現。優先於 [`CLAUDE_AX_SCREEN_READER`](/zh-TW/env-vars) 和 [`axScreenReader`](/zh-TW/settings#available-settings) 設定。需要 Claude Code v2.1.181 或更新版本 | `claude --ax-screen-reader` |

71| `--bare` | 最小模式：跳過 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索，以便指令碼呼叫啟動更快。Claude 可以存取 Bash、檔案讀取和檔案編輯工具。設定 [`CLAUDE_CODE_SIMPLE`](/zh-TW/env-vars)。請參閱 [bare mode](/zh-TW/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |71| `--bare` | 最小模式：跳過 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索，以便指令碼呼叫啟動更快。Claude 可以存取 Bash、檔案讀取和檔案編輯工具。設定 [`CLAUDE_CODE_SIMPLE`](/zh-TW/env-vars)。請參閱 [bare mode](/zh-TW/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

73| `--bg`、`--background` | 以 [background agent](/zh-TW/agent-view) 身份啟動工作階段並立即返回。列印工作階段 ID 和管理命令。與 `--exec` 結合以執行 shell 命令作為背景工作而不是 Claude 工作階段，或與 `--agent` 結合以執行特定 subagent。{/* min-version: 2.1.198 */}無法與 `-p`/`--print` 結合；請參閱 [error reference](/zh-TW/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`、`--background` | 以 [background agent](/zh-TW/agent-view) 身份啟動工作階段並立即返回。列印工作階段 ID 和管理命令。與 `--exec` 結合以執行 shell 命令作為背景工作而不是 Claude 工作階段，或與 `--agent` 結合以執行特定 subagent。{/* min-version: 2.1.198 */}無法與 `-p`/`--print` 結合；請參閱 [error reference](/zh-TW/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

commands.md +1 −1

Details

50| 命令 | 用途 |50| 命令 | 用途 |

51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

52| `/add-dir <path>` | 為目前工作階段期間的檔案存取添加工作目錄。大多數 `.claude/` 配置[未從添加的目錄發現](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)。您可以稍後使用 `--continue` 或 `--resume` 從添加的目錄繼續工作階段 |52| `/add-dir <path>` | 為目前工作階段期間的檔案存取添加工作目錄。大多數 `.claude/` 配置[未從添加的目錄發現](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)。您可以稍後使用 `--continue` 或 `--resume` 從添加的目錄繼續工作階段 |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}啟用或停用[顧問工具](/zh-TW/advisor)，它在工作期間的關鍵時刻諮詢第二個模型以獲得指導。接受 `opus`、`sonnet`、`fable`（{/* min-version: 2.1.170 */}v2.1.170+）或完整的模型 ID。不帶引數時，開啟選擇器。需要 Claude Code v2.1.98 或更新版本 |53| `/advisor [model\|off]` | 啟用或停用[顧問工具](/zh-TW/advisor)，它在工作期間的關鍵時刻諮詢第二個模型以獲得指導。接受 `opus`、`sonnet`、`fable`（{/* min-version: 2.1.170 */}v2.1.170+）或完整的模型 ID。不帶引數時，開啟選擇器 |

54| `/agents` | {/* min-version: 2.1.198 */}自 v2.1.198 起，執行 `/agents` 會列印提醒，要求您詢問 Claude 以建立或管理 [subagents](/zh-TW/sub-agents)，或直接編輯 `.claude/agents/` 或 `~/.claude/agents/`。{/* max-version: 2.1.197 */}在 v2.1.197 及更早版本上，開啟互動式介面以建立和管理 subagent 配置 |54| `/agents` | {/* min-version: 2.1.198 */}自 v2.1.198 起，執行 `/agents` 會列印提醒，要求您詢問 Claude 以建立或管理 [subagents](/zh-TW/sub-agents)，或直接編輯 `.claude/agents/` 或 `~/.claude/agents/`。{/* max-version: 2.1.197 */}在 v2.1.197 及更早版本上，開啟互動式介面以建立和管理 subagent 配置 |

55| `/autofix-pr [prompt]` | 生成一個[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web#auto-fix-pull-requests) 工作階段，監視目前分支的 PR 並在 CI 失敗或審閱者留下評論時推送修復。使用 `gh pr view` 檢測已簽出分支的開放 PR；若要監視不同的 PR，請先簽出其分支。預設情況下，遠端工作階段被告知修復每個 CI 失敗和審閱評論；傳遞提示以給予它不同的指示，例如 `/autofix-pr only fix lint and type errors`。需要 `gh` CLI 和訪問[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web) |55| `/autofix-pr [prompt]` | 生成一個[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web#auto-fix-pull-requests) 工作階段，監視目前分支的 PR 並在 CI 失敗或審閱者留下評論時推送修復。使用 `gh pr view` 檢測已簽出分支的開放 PR；若要監視不同的 PR，請先簽出其分支。預設情況下，遠端工作階段被告知修復每個 CI 失敗和審閱評論；傳遞提示以給予它不同的指示，例如 `/autofix-pr only fix lint and type errors`。需要 `gh` CLI 和訪問[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web) |

56| `/background [prompt]` | 分離目前的工作階段以作為[背景 agent](/zh-TW/agent-view) 運行並釋放此終端機。傳遞提示以在分離前發送一個額外的指示。使用 `claude agents` 監視工作階段。別名：`/bg` |56| `/background [prompt]` | 分離目前的工作階段以作為[背景 agent](/zh-TW/agent-view) 運行並釋放此終端機。傳遞提示以在分離前發送一個額外的指示。使用 `claude agents` 監視工作階段。別名：`/bg` |

common-workflows.md +1 −1

Details

324 您可以使用以下任何方法：324 您可以使用以下任何方法：

325 325

326 1. 將影像拖放到 Claude Code 視窗中326 1. 將影像拖放到 Claude Code 視窗中

327 2. 複製影像並使用 ctrl+v 將其貼到 CLI 中（不要使用 cmd+v）327 2. 複製影像並使用 Ctrl+V 將其貼到 CLI 中。在 macOS 上，Cmd+V 也適用於 iTerm2。

328 3. 向 Claude 提供影像路徑。例如，「分析此影像：/path/to/your/image.png」328 3. 向 Claude 提供影像路徑。例如，「分析此影像：/path/to/your/image.png」

329 </Step>329 </Step>

330 330

computer-use.md +1 −5

Details

7> 在 Claude Code CLI 中啟用 computer use，讓 Claude 可以在 macOS 上開啟應用程式、點擊、輸入和查看您的螢幕。測試原生應用程式、除錯視覺問題，以及自動化僅限 GUI 的工具，無需離開您的終端機。7> 在 Claude Code CLI 中啟用 computer use，讓 Claude 可以在 macOS 上開啟應用程式、點擊、輸入和查看您的螢幕。測試原生應用程式、除錯視覺問題，以及自動化僅限 GUI 的工具，無需離開您的終端機。

8 8

9<Note>9<Note>

~~10 {/* plan-availability: feature=computer-use plans=pro,max */}~~10 Computer use 是 macOS 上的研究預覽版本，需要 Pro 或 Max 方案。Team 或 Enterprise 方案不提供此功能。它需要互動式工作階段，因此在使用 `-p` 旗標的非互動式模式中不可用。

12 Computer use 是 macOS 上的研究預覽版本，需要 Pro 或 Max 方案。Team 或 Enterprise 方案不提供此功能。它需要 Claude Code v2.1.85 或更新版本以及互動式工作階段，因此在使用 `-p` 旗標的非互動式模式中不可用。

13</Note>11</Note>

14 12

15Computer use 讓 Claude 可以開啟應用程式、控制您的螢幕，並以您的方式在您的機器上工作。從 CLI，Claude 可以編譯 Swift 應用程式、啟動它、點擊每個按鈕，並擷取結果的螢幕截圖，所有這些都在編寫程式碼的同一個對話中進行。13Computer use 讓 Claude 可以開啟應用程式、控制您的螢幕，並以您的方式在您的機器上工作。從 CLI，Claude 可以編譯 Swift 應用程式、啟動它、點擊每個按鈕，並擷取結果的螢幕截圖，所有這些都在編寫程式碼的同一個對話中進行。

237伺服器僅在符合條件的設定上出現。檢查：235伺服器僅在符合條件的設定上出現。檢查：

238 236

239* 您在 macOS 上。Computer use 在 CLI 中不適用於 Linux 或 Windows。在 Windows 上，請改用 [Desktop 中的 computer use](/zh-TW/desktop#let-claude-use-your-computer)。237* 您在 macOS 上。Computer use 在 CLI 中不適用於 Linux 或 Windows。在 Windows 上，請改用 [Desktop 中的 computer use](/zh-TW/desktop#let-claude-use-your-computer)。

240* 您執行的是 Claude Code v2.1.85 或更新版本。執行 `claude --version` 以檢查。

241* 您在 Pro 或 Max 方案上。執行 `/status` 以確認您的訂閱。

242* 您透過 claude.ai 進行身份驗證。Computer use 不適用於 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 等第三方提供者。如果您完全透過第三方提供者存取 Claude，您需要單獨的 claude.ai 帳戶才能使用此功能。238* 您透過 claude.ai 進行身份驗證。Computer use 不適用於 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 等第三方提供者。如果您完全透過第三方提供者存取 Claude，您需要單獨的 claude.ai 帳戶才能使用此功能。

243* 您在互動式工作階段中。Computer use 在使用 `-p` 旗標的非互動式模式中不可用。239* 您在互動式工作階段中。Computer use 在使用 `-p` 旗標的非互動式模式中不可用。

244 240

costs.md +63 −8

Details

10 10

11在企業部署中，平均成本約為每位開發人員每個活躍日 $13，每位開發人員每月 $150-250，90% 的使用者成本保持在每個活躍日 \$30 以下。若要估計您自己團隊的支出，請從小型試點群組開始，並使用下面的追蹤工具建立基準，然後再進行更廣泛的推出。11在企業部署中，平均成本約為每位開發人員每個活躍日 $13，每位開發人員每月 $150-250，90% 的使用者成本保持在每個活躍日 \$30 以下。若要估計您自己團隊的支出，請從小型試點群組開始，並使用下面的追蹤工具建立基準，然後再進行更廣泛的推出。

12 12

~~13本頁涵蓋如何[追蹤您的成本](#track-your-costs)、[管理團隊成本](#managing-costs-for-teams)和[減少 token 使用](#reduce-token-usage)。~~13本頁涵蓋如何[追蹤您的成本](#track-your-costs)、[管理團隊成本](#manage-costs-for-your-organization)和[減少 token 使用](#reduce-token-usage)。

14 14

15<h2 id="track-your-costs">15<h2 id="track-your-costs">

16 追蹤您的成本16 追蹤您的成本

37 37

38在 [VS Code 擴充功能](/zh-TW/vs-code#check-account-and-usage) 中，相同的明細會出現在「帳戶與使用情況」對話框中，並提供「日」和「週」切換。需要 Claude Code v2.1.174 或更新版本。38在 [VS Code 擴充功能](/zh-TW/vs-code#check-account-and-usage) 中，相同的明細會出現在「帳戶與使用情況」對話框中，並提供「日」和「週」切換。需要 Claude Code v2.1.174 或更新版本。

39 39

~~40<h2 id="managing-costs-for-teams">~~40<h3 id="set-a-spend-limit-on-pro-and-max">

~~41 管理團隊成本~~41 在 Pro 和 Max 上設定支出限制

42</h3>

44在 Pro 和 Max 計畫上，您可以使用 `/usage-credits` 命令設定使用額度的每月支出限制。如果您在仍有可用使用額度的情況下達到該限制，Claude Code 會提示您提高或移除該限制，以便您可以繼續使用而不離開 CLI。變更限制需要帳戶的計費存取權限。

46<h2 id="manage-costs-for-your-organization">

47 管理組織的成本

42</h2>48</h2>

43 49

44使用 Claude API 時，您可以在 Claude Code 工作區支出上[設定工作區支出限制](https://platform.claude.com/docs/zh-TW/build-with-claude/workspaces#workspace-limits)。管理員可以在 Console 中[檢視成本和使用情況報告](https://platform.claude.com/docs/zh-TW/build-with-claude/workspaces#usage-and-cost-tracking)。50您對 Claude Code 的控制方式取決於您的組織如何存取 Claude Code：透過 Claude for Teams 或 Enterprise 方案、Claude Console 或雲端提供者。在 Teams 和 Enterprise 方案上，使用量會從每位成員的座位額度中扣除。在 Console 和雲端提供者上，使用量按 token 計費至您的組織。如果您的組織混合使用登入方法，每位開發人員會根據他們驗證的方法進行計量。

52下表將每種設定對應到您查看支出的位置、您限制支出的位置，以及您如何提取每位使用者的數字。

55| :----------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

56| [Claude for Teams 或 Enterprise](#claude-for-teams-and-enterprise) | [組織分析中的支出報告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) | 管理員設定中的支出限制 | [支出報告 CSV](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)；Enterprise 上的 [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) |

57| [Claude Console (API)](#claude-console) | [Console 使用情況頁面](https://platform.claude.com/usage) | 工作區支出限制 | [Console 儀表板](https://platform.claude.com/claude-code)、[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) |

60[OpenTelemetry 匯出](/zh-TW/monitoring-usage)適用於每種設定，是唯一能以近乎即時的方式將每位使用者 token 和成本指標串流到您自己的可觀測性堆疊的選項。

45 61

46在 Pro 和 Max 方案上，您可以使用 `/usage-credits` 命令在使用額度上設定每月支出限制。如果您在仍有使用額度可用時達到該限制，Claude Code 會提示您提高或移除該限制，以便您可以繼續使用而無需離開 CLI。變更限制需要帳戶的計費存取權限。62<h3 id="claude-for-teams-and-enterprise">

63 Claude for Teams 和 Enterprise

64</h3>

66在 Claude for Teams 和 Enterprise 方案上，每位成員的 Claude Code 使用量會從每座位額度中扣除，該額度在滾動五小時視窗和每週視窗上重設。該額度與 Claude chat 和 Cowork 共享，其大小取決於[座位層級](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan)。您的控制項位於 claude.ai 管理員主控台中，而不是 Claude Console。

68* **查看支出**：[組織分析中的支出報告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)顯示每位使用者和每個模型的估計支出，具有 CSV 匯出功能，每日更新。該報告涵蓋使用額度支出，並在啟用使用額度後出現。座位額度內的使用量不以美元計量。

69* **查看採用情況**：[分析儀表板](https://claude.ai/analytics/claude-code)顯示每日活躍使用者、工作階段和貢獻指標，具有貢獻資料的 CSV 匯出。請參閱[使用分析追蹤團隊使用情況](/zh-TW/analytics)。

70* **限制支出**：座位額度是預設上限。若要讓成員超過該額度繼續使用，請啟用[使用額度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)，並在組織、群組或個別成員層級設定支出限制。

71* **提取每位使用者的數字**：在 Enterprise 方案上，[Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide)會傳回跨 Claude 表面（包括 Claude Code）的每位使用者使用量和成本報告。主要擁有者在 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) 建立具有 `read:analytics` 範圍的金鑰。在 Teams 方案上，匯出[支出報告 CSV](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)，其中列出每位使用者和每個模型的 token 使用量和估計支出。

73[Claude Enterprise 消費指南](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide)是管理員的規劃參考。它說明消費在 Claude chat、Claude Code 和 Cowork 之間的差異，並提供每位使用者的美元起點以供預算編制。為編碼座位預算比聊天座位更多：每個 Claude Code 回合都包含檔案內容、工具呼叫和多步驟推理，因此一個除錯工作階段可能會消耗超過一天的聊天。

75<h3 id="claude-console">

76 Claude Console

77</h3>

79API 組織透過[工作區](https://platform.claude.com/docs/en/build-with-claude/workspaces)管理 Claude Code 支出。您可以[設定工作區支出限制](https://platform.claude.com/docs/en/build-with-claude/workspaces#workspace-limits)以限制 Claude Code 總支出，並在 Console 中[檢視成本和使用情況報告](https://platform.claude.com/docs/en/build-with-claude/workspaces#usage-and-cost-tracking)。

47 80

48<Note>81<Note>

49 當您首次使用 Claude Console 帳戶驗證 Claude Code 時，系統會自動為您建立一個名為「Claude Code」的工作區。此工作區為您的組織中所有 Claude Code 使用情況提供集中式成本追蹤和管理。您無法為此工作區建立 API 金鑰；它專門用於 Claude Code 驗證和使用。82 當您首次使用 Claude Console 帳戶驗證 Claude Code 時，系統會自動為您建立一個名為「Claude Code」的工作區。此工作區為您的組織中所有 Claude Code 使用情況提供集中式成本追蹤和管理。您無法為此工作區建立 API 金鑰；它專門用於 Claude Code 驗證和使用。

51 對於具有自訂速率限制的組織，此工作區中的 Claude Code 流量計入您的組織整體 API 速率限制。您可以在 Claude Console 的此工作區的「限制」頁面上設定[工作區速率限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#setting-lower-limits-for-workspaces)，以限制 Claude Code 的份額並保護其他生產工作負載。84 對於具有自訂速率限制的組織，此工作區中的 Claude Code 流量計入您的組織整體 API 速率限制。您可以在 Claude Console 的此工作區的「限制」頁面上設定[工作區速率限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#setting-lower-limits-for-workspaces)，以限制 Claude Code 的份額並保護其他生產工作負載。

52</Note>85</Note>

53 86

54在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上，Claude Code 不會從您的雲端傳送指標。自託管的 [Claude apps gateway](/zh-TW/claude-apps-gateway) 提供每位使用者的使用情況歸因、包含 token 計數的 OTLP 指標，以及這些提供者上的[每位使用者支出限制](/zh-TW/claude-apps-gateway-spend-limits)。透過不同 [LLM gateway](/zh-TW/llm-gateway) 路由 Claude Code 的組織可以改為在 gateway 追蹤支出，因為它會看到每個請求。87對於每位使用者報告，[Console 儀表板](https://platform.claude.com/claude-code)顯示每位成員的支出和接受的行數，[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) 使用 [Admin API 金鑰](https://platform.claude.com/settings/admin-keys)以程式設計方式傳回相同的每日每位使用者指標。請參閱 [API 客戶的分析](/zh-TW/analytics#access-analytics-for-api-customers)。

55 88

~~56<h3 id="rate-limit-recommendations">~~89<h4 id="rate-limit-recommendations">

57 速率限制建議90 速率限制建議

~~58</h3>~~91</h4>

59 92

60為團隊設定 Claude Code 時，請根據您的組織規模考慮這些每位使用者的 Token Per Minute (TPM) 和 Request Per Minute (RPM) 建議：93為團隊設定 Claude Code 時，請根據您的組織規模考慮這些每位使用者的 Token Per Minute (TPM) 和 Request Per Minute (RPM) 建議：

61 94

76 如果您預期會出現異常高的並行使用情況（例如與大型群組進行的即時培訓課程），您可能需要更高的每位使用者 TPM 配置。109 如果您預期會出現異常高的並行使用情況（例如與大型群組進行的即時培訓課程），您可能需要更高的每位使用者 TPM 配置。

77</Note>110</Note>

78 111

112<h3 id="cloud-providers">

113 雲端提供者

114</h3>

115

116在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上，Claude Code 按 token 計費至您的雲端帳戶，支出控制項位於您的雲端提供者的計費主控台中。Claude Code 不會從您的雲端傳送指標回 Anthropic，因此[分析儀表板](/zh-TW/analytics)和 Claude Code Analytics API 不涵蓋此使用情況。

117

118對於每位使用者成本歸因，您有三個選項：

119

120* **OpenTelemetry**：[匯出指標](/zh-TW/monitoring-usage)從每位開發人員的機器到您自己的可觀測性堆疊。無論提供者為何，這都會為您提供每位使用者的 token 計數、成本和工具活動。

121* **Claude apps gateway**：自託管的 [Claude apps gateway](/zh-TW/claude-apps-gateway) 提供每位使用者的使用情況歸因、包含 token 計數的 OTLP 指標，以及這些提供者上的[每位使用者支出限制](/zh-TW/claude-apps-gateway-spend-limits)。

122* **LLM gateway**：透過追蹤每個金鑰支出的代理路由所有 Claude Code 流量。幾家大型企業報告使用 [LiteLLM](/zh-TW/llm-gateway)，一個開源工具，可[按金鑰追蹤支出](https://docs.litellm.ai/docs/proxy/virtual_keys#tracking-spend)。此專案與 Anthropic 無關，尚未進行安全審計。

123

124<h3 id="when-a-developer-asks-about-a-limit">

125 當開發人員詢問限制時

126</h3>

127

128開發人員通常會向其管理員提出限制問題，因此了解他們達到的上限會很有幫助。三種情況意味著不同的事情：

129

130* **「您已達到工作階段限制」或「您已達到每週限制」**：訂閱方案上基於座位的使用視窗。這些視窗在所有模型中共享，因此使用 `/model` 切換模型不會恢復存取權限，儘管在模型特定的「您已達到 Opus 限制」訊息後它確實讓開發人員繼續工作。該訊息顯示視窗何時重設，開發人員可以執行 `/usage-credits` 以請求超過額度的使用量（如果您已啟用[使用額度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)）。請參閱[使用限制錯誤](/zh-TW/errors#youve-hit-your-session-limit)。

131* **上下文或自動壓縮警告**：不是使用限制。對話已接近模型的最大輸入大小，Claude Code 會總結較舊的歷史記錄以釋放空間。將開發人員指向[減少 token 使用量](#reduce-token-usage)。

132* **API 或雲端提供者方案上的意外高支出**：通常可追溯到從未清除的長工作階段或留作預設模型的 Opus。分享的最高影響習慣是在不相關的任務之間清除和將模型與工作相匹配，兩者都涵蓋在[減少 token 使用量](#reduce-token-usage)中。

133

79<h3 id="agent-team-token-costs">134<h3 id="agent-team-token-costs">

80 Agent 團隊 token 成本135 Agent 團隊 token 成本

81</h3>136</h3>

deep-links.md +0 −4

Details

19 19

20本頁涵蓋如何[建立連結](#build-a-link)、[在執行手冊中嵌入連結或從 shell 觸發](#examples)，以及[在每個平台上管理或停用處理程式註冊](#registration-and-supported-platforms)。20本頁涵蓋如何[建立連結](#build-a-link)、[在執行手冊中嵌入連結或從 shell 觸發](#examples)，以及[在每個平台上管理或停用處理程式註冊](#registration-and-supported-platforms)。

21 21

~~22<Note>~~

~~23 深層連結需要 Claude Code v2.1.91 或更新版本。~~

~~24</Note>~~

26<h2 id="how-it-works">22<h2 id="how-it-works">

27 運作方式23 運作方式

28</h2>24</h2>

desktop.md +4 −3

Details

44 44

45在發送第一條訊息之前，在提示區域中配置四項內容：45在發送第一條訊息之前，在提示區域中配置四項內容：

46 46

47* **環境**：選擇 Claude 執行的位置。選擇 **Local** 用於您的機器、**Remote** 用於 Anthropic 託管的雲端會話，或用於您管理的遠端機器的 [**SSH 連線**](#ssh-sessions)。請參閱[環境配置](#environment-configuration)。47* **環境**：選擇 Claude 執行的位置。選擇 **Local** 用於您的機器、**Remote** 用於 Anthropic 託管的雲端會話，[**SSH 連線**](#ssh-sessions)用於您管理的遠端機器，或在 Windows 上選擇 [**WSL 發行版**](/zh-TW/desktop-wsl)。請參閱[環境配置](#environment-configuration)。

48* **專案資料夾**：選擇 Claude 工作的資料夾或儲存庫。對於遠端會話，您可以新增[多個儲存庫](#run-long-running-tasks-remotely)。48* **專案資料夾**：選擇 Claude 工作的資料夾或儲存庫。對於遠端會話，您可以新增[多個儲存庫](#run-long-running-tasks-remotely)。

49* **模型**：從傳送按鈕旁的下拉式選單中選擇[模型](/zh-TW/model-config#available-models)。您可以在會話期間變更此設定。49* **模型**：從傳送按鈕旁的下拉式選單中選擇[模型](/zh-TW/model-config#available-models)。您可以在會話期間變更此設定。

50* **權限模式**：從[模式選擇器](#choose-a-permission-mode)中選擇 Claude 擁有多少自主權。您可以在會話期間變更此設定。50* **權限模式**：從[模式選擇器](#choose-a-permission-mode)中選擇 Claude 擁有多少自主權。您可以在會話期間變更此設定。

71 71

72提示框支援兩種方式來引入外部上下文：72提示框支援兩種方式來引入外部上下文：

73 73

~~74* **@mention 檔案**：輸入 `@` 後跟檔案名稱，將檔案新增到對話上下文。Claude 隨後可以讀取和參考該檔案。@mention 在雲端會話中不可用。~~74* **@mention 檔案**：輸入 `@` 後跟檔案名稱，將檔案新增到對話上下文。Claude 隨後可以讀取和參考該檔案。@mention 在雲端會話和 WSL 會話中不可用。

75* **附加檔案**：使用附件按鈕將影像、PDF 和其他檔案附加到您的提示，或直接將檔案拖放到提示中。這對於分享錯誤的螢幕截圖、設計模型或參考文件很有用。75* **附加檔案**：使用附件按鈕將影像、PDF 和其他檔案附加到您的提示，或直接將檔案拖放到提示中。這對於分享錯誤的螢幕截圖、設計模型或參考文件很有用。

76 76

77<h3 id="choose-a-permission-mode">77<h3 id="choose-a-permission-mode">

385 385

386側邊聊天讓您詢問 Claude 一個使用您會話上下文的問題，但不會將任何內容新增回主對話。當您想要理解一段程式碼、檢查假設或探索想法而不引導會話偏離時，請使用它。386側邊聊天讓您詢問 Claude 一個使用您會話上下文的問題，但不會將任何內容新增回主對話。當您想要理解一段程式碼、檢查假設或探索想法而不引導會話偏離時，請使用它。

387 387

388在 macOS 上按 **Cmd+;** 或在 Windows 上按 **Ctrl+;** 以開啟側邊聊天，或在提示框中輸入 `/btw`。側邊聊天可以讀取主執行緒中到該點為止的所有內容。完成後，關閉側邊聊天並在您離開的地方繼續主會話。側邊聊天在本機和 SSH 會話中可用。388在 macOS 上按 **Cmd+;** 或在 Windows 上按 **Ctrl+;** 以開啟側邊聊天，或在提示框中輸入 `/btw`。側邊聊天可以讀取主執行緒中到該點為止的所有內容。完成後，關閉側邊聊天並在您離開的地方繼續主會話。側邊聊天在本機、SSH 和 WSL 會話中可用。

389 389

390<h3 id="watch-background-tasks">390<h3 id="watch-background-tasks">

391 觀看背景任務391 觀看背景任務

628* **Local**：在您的機器上執行，直接存取您的檔案628* **Local**：在您的機器上執行，直接存取您的檔案

629* **Remote**：在 Anthropic 的雲端基礎設施上執行。即使您關閉應用程式，會話也會繼續。629* **Remote**：在 Anthropic 的雲端基礎設施上執行。即使您關閉應用程式，會話也會繼續。

630* **SSH**：在您透過 SSH 連接的遠端機器上執行，例如您自己的伺服器、雲端虛擬機器或開發容器630* **SSH**：在您透過 SSH 連接的遠端機器上執行，例如您自己的伺服器、雲端虛擬機器或開發容器

631* **WSL** (Windows)：在您機器上的 [WSL 2 發行版](/zh-TW/desktop-wsl)內執行，使用其 Linux 工具鏈和原生路徑

631 632

632<h3 id="local-sessions">633<h3 id="local-sessions">

633 本機會話634 本機會話

desktop-quickstart.md +1 −0

Details

72 72

73 * **Remote**：在 Anthropic 的雲端基礎設施上執行會話，即使您關閉應用程式也會繼續。遠端會話使用與 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 相同的基礎設施。73 * **Remote**：在 Anthropic 的雲端基礎設施上執行會話，即使您關閉應用程式也會繼續。遠端會話使用與 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 相同的基礎設施。

74 * **SSH**：透過 SSH 連接到遠端機器，例如您自己的伺服器、雲端 VM 或開發容器。Desktop 在您第一次連接時會自動在遠端機器上安裝 Claude Code。74 * **SSH**：透過 SSH 連接到遠端機器，例如您自己的伺服器、雲端 VM 或開發容器。Desktop 在您第一次連接時會自動在遠端機器上安裝 Claude Code。

75 * **WSL** (Windows)：在 [WSL 2 distribution](/zh-TW/desktop-wsl) 內執行會話；Claude Code、工具和 git 在 Linux 端執行，具有原生路徑。

75 </Step>76 </Step>

76 77

77 <Step title="選擇模型">78 <Step title="選擇模型">

desktop-wsl.md +55 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

5# Claude Code Desktop in WSL

7> 在 Windows 上的 WSL 2 發行版內執行 Code 工作階段

9在 Windows 上，Code 標籤可以在 WSL 2 發行版內執行工作階段，而不是在 Windows 本身上執行。工作階段的 Claude Code 程序、其工具和 git 都在發行版內執行，使用其 Linux 工具鏈和原生 Linux 路徑，與您的專案所針對的環境相同。

11當您的儲存庫位於發行版的檔案系統內時，請使用 WSL 工作階段。從 Windows 處理這些檔案會通過網路檔案系統，這很慢且會破壞檔案監視；在發行版內執行工作階段可以避免兩者。

13<h2 id="requirements">

14 需求

15</h2>

17* Windows 10 或 11，搭配 [WSL 2](https://learn.microsoft.com/windows/wsl/install)。不支援 WSL 1。

18* 至少一個已安裝的發行版（例如 Ubuntu）。

19* 在發行版內安裝的 `git`。

21<h2 id="start-a-wsl-session">

22 啟動 WSL 工作階段

23</h2>

25<Steps>

26 <Step title="選擇發行版">

27 在 Code 標籤中啟動新工作階段並開啟環境選擇器。您已安裝的 WSL 2 發行版會出現在 **WSL** 區段中。選擇一個。

28 </Step>

30 <Step title="選擇資料夾">

31 工作階段在發行版的主目錄中啟動。使用資料夾選擇器選擇專案資料夾。瀏覽在發行版內進行，使用 Linux 路徑，例如 `/home/you/project`。

32 </Step>

34 <Step title="信任資料夾">

35 資料夾中的第一個工作階段會顯示工作區信任對話框。信任是按發行版和資料夾授予的；信任一個發行版中的資料夾不適用於另一個發行版或 Windows 上的相同路徑。

36 </Step>

37</Steps>

39發行版中的第一個工作階段需要花費一些時間，而 Claude 在其中進行設定。您也可以從一般資料夾選擇器開啟 `\\wsl.localhost\...` 資料夾，它會在該發行版內重新開啟。

41您最近使用過的資料夾會在每個發行版的選擇器中出現，因此重新連接到專案只需一次點擊。

43<h2 id="what-works-in-a-wsl-session">

44 WSL 工作階段中的運作方式

45</h2>

47平行工作階段、側邊聊天、視覺差異檢閱、分支和提取請求狀態，以及 worktrees 都可以運作，由發行版內的 git 和工具鏈支援。「在編輯器中開啟」會開啟透過 [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl) 連接到發行版的 VS Code。

49WSL 工作階段中還有一些功能尚未提供：整合終端、連接器和外掛程式、工作階段分叉、檔案瀏覽器窗格，以及當您在編輯器中輸入 `@` 時的檔案建議。

51<h2 id="managed-devices">

52 受管理的裝置

53</h2>

55在由組織管理的裝置上，WSL 工作階段可能無法使用。如果工作階段啟動失敗，並顯示裝置受管理的訊息，這由您的管理員控制。管理員：請參閱部署指南中的[設定如何到達裝置](/zh-TW/admin-setup#decide-how-settings-reach-devices)。

env-vars.md +29 −29

Details

176| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 寫入偵錯日誌檔案的最小日誌級別。值：`verbose`、`debug`（預設）、`info`、`warn`、`error`。設定為 `verbose` 以包含高容量診斷，例如完整狀態行命令輸出，或提高到 `error` 以減少雜訊 |176| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 寫入偵錯日誌檔案的最小日誌級別。值：`verbose`、`debug`（預設）、`info`、`warn`、`error`。設定為 `verbose` 以包含高容量診斷，例如完整狀態行命令輸出，或提高到 `error` 以減少雜訊 |

177| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 設定為 `1` 以停用 [1M context window](/zh-TW/model-config#extended-context) 支援。設定時，1M 模型變體在模型選擇器中不可用，[Sonnet 5](/zh-TW/model-config#sonnet-5-context-window) 工作階段被視為具有 200K 視窗。對於具有合規性要求的企業環境很有用 |177| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 設定為 `1` 以停用 [1M context window](/zh-TW/model-config#extended-context) 支援。設定時，1M 模型變體在模型選擇器中不可用，[Sonnet 5](/zh-TW/model-config#sonnet-5-context-window) 工作階段被視為具有 200K 視窗。對於具有合規性要求的企業環境很有用 |

178| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 設定為 `1` 以停用 Opus 4.6 和 Sonnet 4.6 的 [adaptive reasoning](/zh-TW/model-config#adjust-effort-level)，並回退到由 `MAX_THINKING_TOKENS` 控制的固定思考預算。{/* min-version: 2.1.111 */}從 v2.1.111 起，對 Fable 5、Sonnet 5 或 Opus 4.7 及更新版本無效，其始終使用自適應推理 |178| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 設定為 `1` 以停用 Opus 4.6 和 Sonnet 4.6 的 [adaptive reasoning](/zh-TW/model-config#adjust-effort-level)，並回退到由 `MAX_THINKING_TOKENS` 控制的固定思考預算。{/* min-version: 2.1.111 */}從 v2.1.111 起，對 Fable 5、Sonnet 5 或 Opus 4.7 及更新版本無效，其始終使用自適應推理 |

179| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}設定為 `1` 以停用 [advisor tool](/zh-TW/advisor)。`/advisor` 命令變為不可用，任何配置的 `advisorModel` 都會被忽略，`--advisor` 旗標被接受但無效，因此傳遞它的現有指令碼繼續工作而不出現錯誤。需要 Claude Code v2.1.98 或更新版本 |179| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | 設定為 `1` 以停用 [advisor tool](/zh-TW/advisor)。`/advisor` 命令變為不可用，任何配置的 `advisorModel` 都會被忽略，`--advisor` 旗標被接受但無效，因此傳遞它的現有指令碼繼續工作而不出現錯誤 |

180| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 設定為 `1` 以關閉 [background agents and agent view](/zh-TW/agent-view)：`claude agents`、`--bg`、`/background` 和隨選主管。相當於 [`disableAgentView`](/zh-TW/settings#available-settings) 設定 |180| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 設定為 `1` 以關閉 [background agents and agent view](/zh-TW/agent-view)：`claude agents`、`--bg`、`/background` 和隨選主管。相當於 [`disableAgentView`](/zh-TW/settings#available-settings) 設定 |

181| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 設定為 `1` 以停用 [fullscreen rendering](/zh-TW/fullscreen) 並使用經典主螢幕渲染器。對話保留在您終端的原生捲動回溯中，因此 `Cmd+f` 和 tmux 複製模式可以正常工作。優先於 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-TW/settings#available-settings) 設定。您也可以使用 `/tui default` 切換。不適用於從 [agent view](/zh-TW/agent-view) 開啟的背景工作階段，其始終使用全螢幕渲染 |181| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 設定為 `1` 以停用 [fullscreen rendering](/zh-TW/fullscreen) 並使用經典主螢幕渲染器。對話保留在您終端的原生捲動回溯中，因此 `Cmd+f` 和 tmux 複製模式可以正常工作。優先於 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-TW/settings#available-settings) 設定。您也可以使用 `/tui default` 切換。不適用於從 [agent view](/zh-TW/agent-view) 開啟的背景工作階段，其始終使用全螢幕渲染 |

182| `CLAUDE_CODE_DISABLE_ARTIFACT` | 設定為 `1` 以停用 [Artifact](/zh-TW/artifacts) 工具，該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。相當於 [`disableArtifact`](/zh-TW/settings#available-settings) 設定 |182| `CLAUDE_CODE_DISABLE_ARTIFACT` | 設定為 `1` 以停用 [Artifact](/zh-TW/artifacts) 工具，該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。相當於 [`disableArtifact`](/zh-TW/settings#available-settings) 設定 |

208| `CLAUDE_CODE_DISABLE_WORKFLOWS` | 設定為 `1` 以停用 [workflows](/zh-TW/workflows#turn-workflows-off)。相當於 [`disableWorkflows`](/zh-TW/settings#available-settings) 設定 |208| `CLAUDE_CODE_DISABLE_WORKFLOWS` | 設定為 `1` 以停用 [workflows](/zh-TW/workflows#turn-workflows-off)。相當於 [`disableWorkflows`](/zh-TW/settings#available-settings) 設定 |

209| `CLAUDE_CODE_EFFORT_LEVEL` | 為支援的模型設定努力級別。值：`low`、`medium`、`high`、`xhigh`、`max` 或 `auto` 以使用模型預設值。可用級別取決於模型。優先於 `/effort` 和 `effortLevel` 設定。請參閱 [Adjust effort level](/zh-TW/model-config#adjust-effort-level) |209| `CLAUDE_CODE_EFFORT_LEVEL` | 為支援的模型設定努力級別。值：`low`、`medium`、`high`、`xhigh`、`max` 或 `auto` 以使用模型預設值。可用級別取決於模型。優先於 `/effort` 和 `effortLevel` 設定。請參閱 [Adjust effort level](/zh-TW/model-config#adjust-effort-level) |

210| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | {/* min-version: 2.1.205 */}設定為 `1` 以啟用將額外文字附加到每個 [subagent](/zh-TW/sub-agents) 系統提示的末尾。[`--append-subagent-system-prompt`](/zh-TW/cli-reference#cli-flags) 旗標提供附加的文字並自動設定此變數，因此您不需要自己設定它。需要 Claude Code v2.1.205 或更新版本 |210| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | {/* min-version: 2.1.205 */}設定為 `1` 以啟用將額外文字附加到每個 [subagent](/zh-TW/sub-agents) 系統提示的末尾。[`--append-subagent-system-prompt`](/zh-TW/cli-reference#cli-flags) 旗標提供附加的文字並自動設定此變數，因此您不需要自己設定它。需要 Claude Code v2.1.205 或更新版本 |

211| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}設定為 `1` 以在 Amazon Bedrock、Google Cloud's Agent Platform 和 Microsoft Foundry 上啟用 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)。需要 Claude Code v2.1.158 或更新版本。對 Anthropic API 無效，其中 auto mode 預設可用。請參閱 [Enable auto mode on Amazon Bedrock, Google Cloud's Agent Platform, or Microsoft Foundry](/zh-TW/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) |211| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {{/* min-version: 2.1.158 */}}設定為 `1` 以在 Amazon Bedrock、Google Cloud's Agent Platform 和 Microsoft Foundry 上啟用 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)。需要 Claude Code v2.1.158 或更新版本。對 Anthropic API 無效，其中 auto mode 預設可用。請參閱 [Enable auto mode on Amazon Bedrock, Google Cloud's Agent Platform, or Microsoft Foundry](/zh-TW/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) |

212| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆蓋 [session recap](/zh-TW/interactive-mode#session-recap) 可用性。設定為 `0` 以強制關閉摘要，無論 `/config` 切換如何。設定為 `1` 以在 [`awaySummaryEnabled`](/zh-TW/settings#available-settings) 為 `false` 時強制啟用摘要。優先於設定和 `/config` 切換 |212| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆蓋 [session recap](/zh-TW/interactive-mode#session-recap) 可用性。設定為 `0` 以強制關閉摘要，無論 `/config` 切換如何。設定為 `1` 以在 [`awaySummaryEnabled`](/zh-TW/settings#available-settings) 為 `false` 時強制啟用摘要。優先於設定和 `/config` 切換 |

213| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 設定為 `1` 以在 [non-interactive mode](/zh-TW/headless) 中背景安裝完成後在回合邊界處刷新外掛程式狀態。預設關閉，因為刷新會在工作階段中途更改系統提示，這會使該回合的 [prompt caching](/zh-TW/prompt-caching) 失效 |213| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 設定為 `1` 以在 [non-interactive mode](/zh-TW/headless) 中背景安裝完成後在回合邊界處刷新外掛程式狀態。預設關閉，因為刷新會在工作階段中途更改系統提示，這會使該回合的 [prompt caching](/zh-TW/prompt-caching) 失效 |

214| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | 設定為 `1` 以在 Anthropic 綁定的非必要流量被阻止時將「Claude 表現如何？」工作階段品質調查路由到您自己的 [OpenTelemetry collector](/zh-TW/monitoring-usage)。調查評分僅作為 OTEL 事件發出到您配置的收集器。在此模式下，沒有調查資料發送到 Anthropic。在設定 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 時適用，否則無效。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` 和組織產品反饋政策優先 |214| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | 設定為 `1` 以在 Anthropic 綁定的非必要流量被阻止時將「Claude 表現如何？」工作階段品質調查路由到您自己的 [OpenTelemetry collector](/zh-TW/monitoring-usage)。調查評分僅作為 OTEL 事件發出到您配置的收集器。在此模式下，沒有調查資料發送到 Anthropic。在設定 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 時適用，否則無效。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` 和組織產品反饋政策優先 |

215| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 控制工具呼叫輸入是否在 Claude 生成時從 API 串流。關閉此選項時，大型工具輸入（例如長檔案寫入）僅在 Claude 完成生成後才到達，這可能看起來像是掛起。在 Anthropic API 上預設啟用。在 Amazon Bedrock 和 Google Cloud's Agent Platform 上，按模型啟用，其中已部署的容器支援它。設定為 `0` 以選擇退出。設定為 `1` 以在透過 `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 路由時強制啟用。在 Microsoft Foundry 和 [gateway](/zh-TW/llm-gateway) 連線上預設關閉 |215| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 控制工具呼叫輸入是否在 Claude 生成時從 API 串流。關閉此選項時，大型工具輸入（例如長檔案寫入）僅在 Claude 完成生成後才到達，這可能看起來像是掛起。在 Anthropic API 上預設啟用。在 Amazon Bedrock 和 Google Cloud's Agent Platform 上，按模型啟用，其中已部署的容器支援它。設定為 `0` 以選擇退出。設定為 `1` 以在透過 `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 路由時強制啟用。在 Microsoft Foundry 和 [gateway](/zh-TW/llm-gateway) 連線上預設關閉 |

216| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 設定為 `1` 以在 `ANTHROPIC_BASE_URL` 指向 Anthropic 相容閘道（例如 LiteLLM、Kong 或內部代理）時從您的閘道的 `/v1/models` 端點填充 `/model` 選擇器。預設關閉，因為由共享 API 金鑰支援的閘道會以其他方式向每個使用者顯示該金鑰可以存取的每個模型。探索的模型仍由 [`availableModels`](/zh-TW/settings#available-settings) 允許清單篩選，工作階段接收；由於 [server-managed delivery is not available on gateway configurations](/zh-TW/server-managed-settings#platform-availability)，透過 MDM 或受管設定檔案傳遞清單 |216| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 設定為 `1` 以在 `ANTHROPIC_BASE_URL` 指向 Anthropic 相容閘道（例如 LiteLLM、Kong 或內部代理）時從您的閘道的 `/v1/models` 端點填充 `/model` 選擇器。預設關閉，因為由共享 API 金鑰支援的閘道會以其他方式向每個使用者顯示該金鑰可以存取的每個模型。探索的模型仍由 [`availableModels`](/zh-TW/settings#available-settings) 允許清單篩選，工作階段接收；由於 [server-managed delivery is not available on gateway configurations](/zh-TW/server-managed-settings#platform-availability)，透過 MDM 或受管設定檔案傳遞清單 |

217| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}在 v2.1.142 中移除，當 [fast mode](/zh-TW/fast-mode) 預設從 Opus 4.6 移至 Opus 4.7 時 |217| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {{/* max-version: 2.1.141 */}}在 v2.1.142 中移除，當 [fast mode](/zh-TW/fast-mode) 預設從 Opus 4.6 移至 Opus 4.7 時 |

218| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 設定為 `false` 以停用提示建議（`/config` 中的「提示建議」切換）。這些是在 Claude 回應後出現在您的提示輸入中的灰顯預測。請參閱 [Prompt suggestions](/zh-TW/interactive-mode#prompt-suggestions) |218| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 設定為 `false` 以停用提示建議（`/config` 中的「提示建議」切換）。這些是在 Claude 回應後出現在您的提示輸入中的灰顯預測。請參閱 [Prompt suggestions](/zh-TW/interactive-mode#prompt-suggestions) |

219| `CLAUDE_CODE_ENABLE_TASKS` | 控制工作階段是否使用結構化 Task 工具（`TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList`）或舊版 `TodoWrite` 工具。{/* min-version: 2.1.142 */}自 Claude Code v2.1.142 起，Task 工具是所有模式中的預設值。設定為 `0` 以還原為 `TodoWrite`。請參閱 [Task list](/zh-TW/interactive-mode#task-list) 和 [Migrate to Task tools](/zh-TW/agent-sdk/todo-tracking#migrate-to-task-tools) |219| `CLAUDE_CODE_ENABLE_TASKS` | 控制工作階段是否使用結構化 Task 工具（`TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList`）或舊版 `TodoWrite` 工具。{{/* min-version: 2.1.142 */}}自 Claude Code v2.1.142 起，Task 工具是所有模式中的預設值。設定為 `0` 以還原為 `TodoWrite`。請參閱 [Task list](/zh-TW/interactive-mode#task-list) 和 [Migrate to Task tools](/zh-TW/agent-sdk/todo-tracking#migrate-to-task-tools) |

220| `CLAUDE_CODE_ENABLE_TELEMETRY` | 設定為 `1` 以啟用 OpenTelemetry 資料收集以進行指標和日誌記錄。在配置 OTel 匯出器之前需要。請參閱 [Monitoring](/zh-TW/monitoring-usage) |220| `CLAUDE_CODE_ENABLE_TELEMETRY` | 設定為 `1` 以啟用 OpenTelemetry 資料收集以進行指標和日誌記錄。在配置 OTel 匯出器之前需要。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

225| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}設定為 `1` 以強制文字記錄持久化、提示歷史記錄和 `claude agents` 註冊，即使此 `claude` 是從另一個 Claude Code 工作階段內啟動的。在繼承的 `CLAUDE_CODE_CHILD_SESSION` 值（例如來自 Claude Code 的 Bash 工具首次啟動的 `screen` 工作階段）導致真正的頂層工作階段被誤分類為嵌套時使用。{/* min-version: 2.1.178 */}自 v2.1.178 起，Claude Code 會自動偵測 tmux 情況並忽略繼承的標記，因此 tmux 不再需要此變數。也在 v2.1.169 及更早版本上受尊重；對 v2.1.170 和 v2.1.171 無效，其中它覆蓋的嵌套工作階段偵測被移除 |225| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {{/* min-version: 2.1.172 */}}設定為 `1` 以強制文字記錄持久化、提示歷史記錄和 `claude agents` 註冊，即使此 `claude` 是從另一個 Claude Code 工作階段內啟動的。在繼承的 `CLAUDE_CODE_CHILD_SESSION` 值（例如來自 Claude Code 的 Bash 工具首次啟動的 `screen` 工作階段）導致真正的頂層工作階段被誤分類為嵌套時使用。{{/* min-version: 2.1.178 */}}自 v2.1.178 起，Claude Code 會自動偵測 tmux 情況並忽略繼承的標記，因此 tmux 不再需要此變數。也在 v2.1.169 及更早版本上受尊重；對 v2.1.170 和 v2.1.171 無效，其中它覆蓋的嵌套工作階段偵測被移除 |

226| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {/* min-version: 2.1.186 */}設定為 `1` 以在您的終端支援但未自動偵測時強制刪除線呈現 `~~text~~`，例如透過 SSH 而未轉發 `TERM_PROGRAM`。沒有此選項，未偵測的終端會顯示文字刪除線標記而不是呈現為刪除線。需要 Claude Code v2.1.186 或更新版本 |226| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {{/* min-version: 2.1.186 */}}設定為 `1` 以在您的終端支援但未自動偵測時強制刪除線呈現 `~~text~~`，例如透過 SSH 而未轉發 `TERM_PROGRAM`。沒有此選項，未偵測的終端會顯示文字刪除線標記而不是呈現為刪除線。需要 Claude Code v2.1.186 或更新版本 |

227| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 設定為 `1` 以強制啟用 DEC 私有模式 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)（當您的終端支援但未自動偵測時）。對於實現 BSU/ESU 但不回覆功能探測的模擬器（例如 Emacs `eat`）很有用。在 tmux 下無效 |227| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 設定為 `1` 以強制啟用 DEC 私有模式 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)（當您的終端支援但未自動偵測時）。對於實現 BSU/ESU 但不回覆功能探測的模擬器（例如 Emacs `eat`）很有用。在 tmux 下無效 |

228| `CLAUDE_CODE_FORK_SUBAGENT` | 設定為 `1` 以啟用 Claude 生成 [forked subagents](/zh-TW/sub-agents#fork-the-current-conversation)，或 `0` 以停用它們，覆蓋任何伺服器端推出。啟用時，Claude 可以要求 `fork` subagent 類型以生成分叉，一個繼承完整對話上下文而不是從頭開始的 subagent。沒有 subagent 類型的生成仍使用通用 subagent，所有 subagent 生成都在背景中執行。明確的 [`/fork`](/zh-TW/commands) 命令無需此變數即可工作。在互動式模式和透過 SDK 或 `claude -p` 中工作 |228| `CLAUDE_CODE_FORK_SUBAGENT` | 設定為 `1` 以啟用 Claude 生成 [forked subagents](/zh-TW/sub-agents#fork-the-current-conversation)，或 `0` 以停用它們，覆蓋任何伺服器端推出。啟用時，Claude 可以要求 `fork` subagent 類型以生成分叉，一個繼承完整對話上下文而不是從頭開始的 subagent。沒有 subagent 類型的生成仍使用通用 subagent，所有 subagent 生成都在背景中執行。明確的 [`/fork`](/zh-TW/commands) 命令無需此變數即可工作。在互動式模式和透過 SDK 或 `claude -p` 中工作 |

229| `CLAUDE_CODE_GIT_BASH_PATH` | 僅限 Windows：Git Bash 可執行檔（`bash.exe`）的路徑。在 Git Bash 已安裝但不在您的 PATH 中時使用。請參閱 [Windows setup](/zh-TW/setup#set-up-on-windows) |229| `CLAUDE_CODE_GIT_BASH_PATH` | 僅限 Windows：Git Bash 可執行檔（`bash.exe`）的路徑。在 Git Bash 已安裝但不在您的 PATH 中時使用。請參閱 [Windows setup](/zh-TW/setup#set-up-on-windows) |

235| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | 設定為 `1` 以跳過 IDE 擴充功能的自動安裝。相當於將 [`autoInstallIdeExtension`](/zh-TW/settings#global-config-settings) 設定為 `false` |235| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | 設定為 `1` 以跳過 IDE 擴充功能的自動安裝。相當於將 [`autoInstallIdeExtension`](/zh-TW/settings#global-config-settings) 設定為 `false` |

237| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆蓋 Claude Code 假設用於作用中模型的上下文視窗大小。{/* min-version: 2.1.193 */}自 v2.1.193 起，直接應用於 Claude Code 不識別為 Claude 模型的模型名稱；對於識別的 Claude 模型，僅當同時設定 `DISABLE_COMPACT` 時才生效。當透過 `ANTHROPIC_BASE_URL` 路由到模型時使用，其上下文視窗與其名稱的內建大小不符 |237| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆蓋 Claude Code 假設用於作用中模型的上下文視窗大小。{{/* min-version: 2.1.193 */}}自 v2.1.193 起，直接應用於 Claude Code 不識別為 Claude 模型的模型名稱；對於識別的 Claude 模型，僅當同時設定 `DISABLE_COMPACT` 時才生效。當透過 `ANTHROPIC_BASE_URL` 路由到模型時使用，其上下文視窗與其名稱的內建大小不符 |

238| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 設定大多數請求的最大輸出 token 數。預設值和上限因模型而異；請參閱 [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。增加此值會減少在 [auto-compaction](/zh-TW/costs#reduce-token-usage) 觸發之前可用的有效上下文視窗 |238| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 設定大多數請求的最大輸出 token 數。預設值和上限因模型而異；請參閱 [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。增加此值會減少在 [auto-compaction](/zh-TW/costs#reduce-token-usage) 觸發之前可用的有效上下文視窗 |

239| `CLAUDE_CODE_MAX_RETRIES` | 覆蓋重試失敗 API 請求的次數（預設值：10）。{/* min-version: 2.1.186 */}自 v2.1.186 起上限為 15；{/* min-version: 2.1.199 */}自 v2.1.199 起，`CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。對於需要等待較長中斷的無人值守工作階段，請改為設定 `CLAUDE_CODE_RETRY_WATCHDOG` |239| `CLAUDE_CODE_MAX_RETRIES` | 覆蓋重試失敗 API 請求的次數（預設值：10）。{{/* min-version: 2.1.186 */}}自 v2.1.186 起上限為 15；{{/* min-version: 2.1.199 */}}自 v2.1.199 起，`CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。對於需要等待較長中斷的無人值守工作階段，請改為設定 `CLAUDE_CODE_RETRY_WATCHDOG` |

241| `CLAUDE_CODE_MAX_TURNS` | 當未傳遞明確限制時，限制代理回合的數量。相當於傳遞 [`--max-turns`](/zh-TW/cli-reference#cli-flags)，當兩者都設定時優先。不是正整數的值在啟動時會被拒絕並出現錯誤，而不是被視為無限制 |241| `CLAUDE_CODE_MAX_TURNS` | 當未傳遞明確限制時，限制代理回合的數量。相當於傳遞 [`--max-turns`](/zh-TW/cli-reference#cli-flags)，當兩者都設定時優先。不是正整數的值在啟動時會被拒絕並出現錯誤，而不是被視為無限制 |

243| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}MCP 工具呼叫的閒置逾時（以毫秒為單位）。當 stdio、HTTP、SSE、WebSocket 或 [claude.ai connector](/zh-TW/mcp#use-mcp-servers-from-claude-ai) MCP 伺服器在此期間內沒有發送回應和進度通知時，工具呼叫會中止並出現錯誤，而不是等待整體 `MCP_TOOL_TIMEOUT`。覆蓋網路伺服器的每個傳輸預設值 300000（5 分鐘）和 stdio 伺服器的 1800000（30 分鐘）。設定為 `0` 以停用閒置檢查。低於 1000 的值會提高到 1 秒，該值上限為有效的 `MCP_TOOL_TIMEOUT`。`.mcp.json` 中的每個伺服器 `timeout` 至少 1000 會將該伺服器的閒置視窗提高到至少 `timeout` 值。不適用於 IDE 伺服器或 SDK 進程內伺服器。需要 Claude Code v2.1.187 或更新版本。{/* min-version: 2.1.203 */}在 v2.1.203 之前，stdio 伺服器不受閒置逾時限制 |243| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {{/* min-version: 2.1.187 */}}MCP 工具呼叫的閒置逾時（以毫秒為單位）。當 stdio、HTTP、SSE、WebSocket 或 [claude.ai connector](/zh-TW/mcp#use-mcp-servers-from-claude-ai) MCP 伺服器在此期間內沒有發送回應和進度通知時，工具呼叫會中止並出現錯誤，而不是等待整體 `MCP_TOOL_TIMEOUT`。覆蓋網路伺服器的每個傳輸預設值 300000（5 分鐘）和 stdio 伺服器的 1800000（30 分鐘）。設定為 `0` 以停用閒置檢查。低於 1000 的值會提高到 1 秒，該值上限為有效的 `MCP_TOOL_TIMEOUT`。`.mcp.json` 中的每個伺服器 `timeout` 至少 1000 會將該伺服器的閒置視窗提高到至少 `timeout` 值。不適用於 IDE 伺服器或 SDK 進程內伺服器。需要 Claude Code v2.1.187 或更新版本。{{/* min-version: 2.1.203 */}}在 v2.1.203 之前，stdio 伺服器不受閒置逾時限制 |

245| `CLAUDE_CODE_NEW_INIT` | 設定為 `1` 以使 `/init` 執行互動式設定流程。流程會詢問要產生哪些檔案，包括 CLAUDE.md、skills 和 hooks，然後再探索程式碼庫並寫入它們。沒有此變數，`/init` 會自動產生 CLAUDE.md 而不提示 |245| `CLAUDE_CODE_NEW_INIT` | 設定為 `1` 以使 `/init` 執行互動式設定流程。流程會詢問要產生哪些檔案，包括 CLAUDE.md、skills 和 hooks，然後再探索程式碼庫並寫入它們。沒有此變數，`/init` 會自動產生 CLAUDE.md 而不提示 |

246| `CLAUDE_CODE_NO_FLICKER` | 設定為 `1` 以啟用 [fullscreen rendering](/zh-TW/fullscreen)，一項研究預覽，可減少閃爍並在長對話中保持記憶體平坦。相當於 [`tui`](/zh-TW/settings#available-settings) 設定；您也可以使用 `/tui fullscreen` 切換 |246| `CLAUDE_CODE_NO_FLICKER` | 設定為 `1` 以啟用 [fullscreen rendering](/zh-TW/fullscreen)，一項研究預覽，可減少閃爍並在長對話中保持記憶體平坦。相當於 [`tui`](/zh-TW/settings#available-settings) 設定；您也可以使用 `/tui fullscreen` 切換 |

247| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 驗證的 OAuth 重新整理權杖。設定時，`claude auth login` 會直接交換此權杖，而不是開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。對於在自動化環境中佈建驗證很有用 |247| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 驗證的 OAuth 重新整理權杖。設定時，`claude auth login` 會直接交換此權杖，而不是開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。對於在自動化環境中佈建驗證很有用 |

248| `CLAUDE_CODE_OAUTH_SCOPES` | 重新整理權杖發出時所使用的空格分隔 OAuth 範圍，例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必需 |248| `CLAUDE_CODE_OAUTH_SCOPES` | 重新整理權杖發出時所使用的空格分隔 OAuth 範圍，例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必需 |

249| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 驗證的 OAuth 存取權杖。`/login` 對於 SDK 和自動化環境的替代方案。優先於鑰匙圈儲存的認證。使用 [`claude setup-token`](/zh-TW/authentication#generate-a-long-lived-token) 產生一個 |249| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 驗證的 OAuth 存取權杖。`/login` 對於 SDK 和自動化環境的替代方案。優先於鑰匙圈儲存的認證。使用 [`claude setup-token`](/zh-TW/authentication#generate-a-long-lived-token) 產生一個 |

250| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}在 v2.1.160 中移除，現在是無操作。先前將 [fast mode](/zh-TW/fast-mode) 固定到 Claude Opus 4.6，而不是目前的預設值。Opus 4.6 不再支援快速模式 |250| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {{/* max-version: 2.1.159 */}}在 v2.1.160 中移除，現在是無操作。先前將 [fast mode](/zh-TW/fast-mode) 固定到 Claude Opus 4.6，而不是目前的預設值。Opus 4.6 不再支援快速模式 |

251| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}設定為 `1` 以將 OpenTelemetry 匯出器診斷錯誤寫入 stderr。預設情況下，這些錯誤僅在 `--debug` 時出現，因此配置不當的匯出器（例如 Prometheus 連接埠衝突）會以其他方式無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱 [Monitoring](/zh-TW/monitoring-usage) |251| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {{/* min-version: 2.1.179 */}}設定為 `1` 以將 OpenTelemetry 匯出器診斷錯誤寫入 stderr。預設情況下，這些錯誤僅在 `--debug` 時出現，因此配置不當的匯出器（例如 Prometheus 連接埠衝突）會以其他方式無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

252| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待處理 OpenTelemetry spans 的逾時（以毫秒為單位）（預設值：5000）。請參閱 [Monitoring](/zh-TW/monitoring-usage) |252| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待處理 OpenTelemetry spans 的逾時（以毫秒為單位）（預設值：5000）。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

253| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新動態 OpenTelemetry 標頭的間隔（以毫秒為單位）（預設值：1740000 / 29 分鐘）。請參閱 [Dynamic headers](/zh-TW/monitoring-usage#dynamic-headers) |253| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新動態 OpenTelemetry 標頭的間隔（以毫秒為單位）（預設值：1740000 / 29 分鐘）。請參閱 [Dynamic headers](/zh-TW/monitoring-usage#dynamic-headers) |

254| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 匯出器在關閉時完成的逾時（以毫秒為單位）（預設值：2000）。如果指標在退出時被丟棄，請增加此值。請參閱 [Monitoring](/zh-TW/monitoring-usage) |254| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 匯出器在關閉時完成的逾時（以毫秒為單位）（預設值：2000）。如果指標在退出時被丟棄，請增加此值。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

260| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 設定為 `1` 以透過 HTTPS 而不是 SSH 複製 GitHub `owner/repo` 外掛程式來源。在 CI 執行器、容器或任何沒有為 `github.com` 配置 SSH 金鑰的環境中很有用 |260| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 設定為 `1` 以透過 HTTPS 而不是 SSH 複製 GitHub `owner/repo` 外掛程式來源。在 CI 執行器、容器或任何沒有為 `github.com` 配置 SSH 金鑰的環境中很有用 |

261| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一個或多個唯讀外掛程式種子目錄的路徑，在 Unix 上以 `:` 分隔，在 Windows 上以 `;` 分隔。使用此選項可將預先填充的外掛程式目錄捆綁到容器映像中。Claude Code 在啟動時從這些目錄註冊市場，並使用預先快取的外掛程式而無需重新複製。請參閱 [Pre-populate plugins for containers](/zh-TW/plugin-marketplaces#pre-populate-plugins-for-containers) |261| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一個或多個唯讀外掛程式種子目錄的路徑，在 Unix 上以 `:` 分隔，在 Windows 上以 `;` 分隔。使用此選項可將預先填充的外掛程式目錄捆綁到容器映像中。Claude Code 在啟動時從這些目錄註冊市場，並使用預先快取的外掛程式而無需重新複製。請參閱 [Pre-populate plugins for containers](/zh-TW/plugin-marketplaces#pre-populate-plugins-for-containers) |

262| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 設定為 `1` 以停止 Claude Code 在生成 PowerShell 以進行工具呼叫、hooks 和狀態行命令時傳遞 `-ExecutionPolicy Bypass`，並改為尊重機器的有效執行政策。預設情況下，Claude Code 在程序範圍內繞過執行政策，以便 `.ps1` 指令碼和模組匯入在預設受限的 Windows 安裝上工作。無論此設定如何，程序範圍繞過永遠不會覆蓋群組原則 `MachinePolicy` 或 `UserPolicy` |262| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 設定為 `1` 以停止 Claude Code 在生成 PowerShell 以進行工具呼叫、hooks 和狀態行命令時傳遞 `-ExecutionPolicy Bypass`，並改為尊重機器的有效執行政策。預設情況下，Claude Code 在程序範圍內繞過執行政策，以便 `.ps1` 指令碼和模組匯入在預設受限的 Windows 安裝上工作。無論此設定如何，程序範圍繞過永遠不會覆蓋群組原則 `MachinePolicy` 或 `UserPolicy` |

263| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}[非互動式模式](/zh-TW/headless#background-tasks-at-exit)使用 `-p` 旗標在最終回合後等待的最大時間（以毫秒為單位），用於背景 subagents 和工作流程，其結果是輸出的一部分。預設值：`600000`，或 10 分鐘。超過上限時，剩餘背景任務會被終止，程序會退出。設定為 `0` 以無限期等待。此上限與適用於純背景 shells 的 5 秒寬限期分開 |263| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {{/* min-version: 2.1.182 */}}[非互動式模式](/zh-TW/headless#background-tasks-at-exit)使用 `-p` 旗標在最終回合後等待的最大時間（以毫秒為單位），用於背景 subagents 和工作流程，其結果是輸出的一部分。預設值：`600000`，或 10 分鐘。超過上限時，剩餘背景任務會被終止，程序會退出。設定為 `0` 以無限期等待。此上限與適用於純背景 shells 的 5 秒寬限期分開 |

264| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}設定為 `1` 以在 `ANTHROPIC_BASE_URL` 指向自訂代理時傳播 W3C 追蹤上下文。傳播涵蓋模型和 HTTP MCP 請求上的 `traceparent` 標頭以及 Bash、PowerShell 和 hook 子程序的 `TRACEPARENT` 環境變數。預設情況下，傳播僅在直接連線到 Anthropic API 時啟用。在 v2.1.152 中新增。請參閱 [Traces (beta)](/zh-TW/monitoring-usage#traces-beta) |264| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {{/* min-version: 2.1.152 */}}設定為 `1` 以在 `ANTHROPIC_BASE_URL` 指向自訂代理時傳播 W3C 追蹤上下文。傳播涵蓋模型和 HTTP MCP 請求上的 `traceparent` 標頭以及 Bash、PowerShell 和 hook 子程序的 `TRACEPARENT` 環境變數。預設情況下，傳播僅在直接連線到 Anthropic API 時啟用。在 v2.1.152 中新增。請參閱 [Traces (beta)](/zh-TW/monitoring-usage#traces-beta) |

265| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 並代表其管理模型提供者路由的主機平台設定。設定時，提供者選擇、端點和驗證變數（例如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`）在設定檔案中被忽略，以便使用者設定無法覆蓋主機的路由。Amazon Bedrock、Google Cloud's Agent Platform 和 Microsoft Foundry 的自動遙測選擇退出也會被跳過，因此遙測遵循標準 `DISABLE_TELEMETRY` 選擇退出。請參閱 [Default behaviors by API provider](/zh-TW/data-usage#default-behaviors-by-api-provider) |265| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 並代表其管理模型提供者路由的主機平台設定。設定時，提供者選擇、端點和驗證變數（例如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`）在設定檔案中被忽略，以便使用者設定無法覆蓋主機的路由。Amazon Bedrock、Google Cloud's Agent Platform 和 Microsoft Foundry 的自動遙測選擇退出也會被跳過，因此遙測遵循標準 `DISABLE_TELEMETRY` 選擇退出。請參閱 [Default behaviors by API provider](/zh-TW/data-usage#default-behaviors-by-api-provider) |

267| `CLAUDE_CODE_REMOTE` | 當 Claude Code 作為 [cloud session](/zh-TW/claude-code-on-the-web) 執行時自動設定為 `true`。從 hook 或設定指令碼讀取此項以偵測您是否在雲端環境中 |267| `CLAUDE_CODE_REMOTE` | 當 Claude Code 作為 [cloud session](/zh-TW/claude-code-on-the-web) 執行時自動設定為 `true`。從 hook 或設定指令碼讀取此項以偵測您是否在雲端環境中 |

268| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中自動設定為目前工作階段的 ID。讀取此項以構造回到工作階段文字記錄的連結。請參閱 [Link output back to the session](/zh-TW/claude-code-on-the-web#link-output-back-to-the-session) |268| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中自動設定為目前工作階段的 ID。讀取此項以構造回到工作階段文字記錄的連結。請參閱 [Link output back to the session](/zh-TW/claude-code-on-the-web#link-output-back-to-the-session) |

270| `CLAUDE_CODE_RESUME_PROMPT` | 覆蓋在繼續在中途結束的工作階段時注入的延續訊息。預設為 `Continue from where you left off.`。長時間執行的代理的生成指令碼可以將此設定為更具指令性的啟動訊息。空字串使用預設值 |270| `CLAUDE_CODE_RESUME_PROMPT` | 覆蓋在繼續在中途結束的工作階段時注入的延續訊息。預設為 `Continue from where you left off.`。長時間執行的代理的生成指令碼可以將此設定為更具指令性的啟動訊息。空字串使用預設值 |

271| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}設定為 `1` 用於無人值守工作階段，例如評估工具、CI 工作或遠端工作者。無限期重試 `429` 和 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 嘗試後失敗。監視程式在嘗試之間退避最多 5 分鐘，或直到限制在回應帶有速率限制重設時間時重設，因此達到使用限制的工作階段會等待剩餘視窗。{/* min-version: 2.1.199 */}自 v2.1.199 起，它也會提高其他暫時性錯誤（例如伺服器錯誤、逾時和丟棄的連線）的預設重試計數至 300，大約三小時的退避，並在您明確設定該變數時移除 `CLAUDE_CODE_MAX_RETRIES` 的上限 15。需要 Claude Code v2.1.186 或更新版本 |271| `CLAUDE_CODE_RETRY_WATCHDOG` | {{/* min-version: 2.1.186 */}}設定為 `1` 用於無人值守工作階段，例如評估工具、CI 工作或遠端工作者。無限期重試 `429` 和 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 嘗試後失敗。監視程式在嘗試之間退避最多 5 分鐘，或直到限制在回應帶有速率限制重設時間時重設，因此達到使用限制的工作階段會等待剩餘視窗。{{/* min-version: 2.1.199 */}}自 v2.1.199 起，它也會提高其他暫時性錯誤（例如伺服器錯誤、逾時和丟棄的連線）的預設重試計數至 300，大約三小時的退避，並在您明確設定該變數時移除 `CLAUDE_CODE_MAX_RETRIES` 的上限 15。需要 Claude Code v2.1.186 或更新版本 |

272| `CLAUDE_CODE_SAFE_MODE` | 設定為 `1` 以在安全模式下啟動：CLAUDE.md、skills、plugins、hooks、MCP 伺服器、自訂命令和代理、輸出樣式、工作流程、自訂主題、自訂快捷鍵、狀態行和檔案建議命令、LSP 伺服器和自動記憶體不載入，用於對損壞的配置進行故障排除。受管設定政策仍然適用，包括政策配置的 hooks、狀態行和檔案建議命令；受管外掛程式、受管 skills、受管 CLAUDE.md 和政策配置的 MCP 伺服器不適用。相當於傳遞 [`--safe-mode`](/zh-TW/cli-reference#cli-flags)。直接生成的子程序繼承該變數 |272| `CLAUDE_CODE_SAFE_MODE` | 設定為 `1` 以在安全模式下啟動：CLAUDE.md、skills、plugins、hooks、MCP 伺服器、自訂命令和代理、輸出樣式、工作流程、自訂主題、自訂快捷鍵、狀態行和檔案建議命令、LSP 伺服器和自動記憶體不載入，用於對損壞的配置進行故障排除。受管設定政策仍然適用，包括政策配置的 hooks、狀態行和檔案建議命令；受管外掛程式、受管 skills、受管 CLAUDE.md 和政策配置的 MCP 伺服器不適用。相當於傳遞 [`--safe-mode`](/zh-TW/cli-reference#cli-flags)。直接生成的子程序繼承該變數 |

273| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 物件，當設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時限制特定指令碼在每個工作階段中可被呼叫的次數。鍵是針對命令文字進行比對的子字串；值是整數呼叫限制。例如，`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對是基於子字串的，因此 shell 擴展技巧（如 `./scripts/deploy.sh $(evil)`）仍然計入上限。透過 `xargs` 或 `find -exec` 的執行時扇出未被偵測；這是深度防禦控制 |273| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 物件，當設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時限制特定指令碼在每個工作階段中可被呼叫的次數。鍵是針對命令文字進行比對的子字串；值是整數呼叫限制。例如，`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對是基於子字串的，因此 shell 擴展技巧（如 `./scripts/deploy.sh $(evil)`）仍然計入上限。透過 `xargs` 或 `find -exec` 的執行時扇出未被偵測；這是深度防禦控制 |

274| `CLAUDE_CODE_SCROLL_SPEED` | 在 [fullscreen rendering](/zh-TW/fullscreen#mouse-wheel-scrolling) 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值，以及低於 1 的分數值（例如 `0.5`）以減慢終端上原生捲動路徑中加速的觸控板和滾輪捲動。設定為 `3` 以符合 `vim`（如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件）。在 JetBrains IDE 終端中被忽略，Claude Code 使用其自己的捲動處理 |274| `CLAUDE_CODE_SCROLL_SPEED` | 在 [fullscreen rendering](/zh-TW/fullscreen#mouse-wheel-scrolling) 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值，以及低於 1 的分數值（例如 `0.5`）以減慢終端上原生捲動路徑中加速的觸控板和滾輪捲動。設定為 `3` 以符合 `vim`（如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件）。在 JetBrains IDE 終端中被忽略，Claude Code 使用其自己的捲動處理 |

280| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 設定為 `1` 以在任何模型上使用較短的系統提示和縮寫工具描述。設定為 `0`、`false`、`no` 或 `off` 以選擇退出，即使實驗或伺服器配置會以其他方式啟用它。完整工具集、hooks、MCP 伺服器和 CLAUDE.md 探索保持啟用 |280| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 設定為 `1` 以在任何模型上使用較短的系統提示和縮寫工具描述。設定為 `0`、`false`、`no` 或 `off` 以選擇退出，即使實驗或伺服器配置會以其他方式啟用它。完整工具集、hooks、MCP 伺服器和 CLAUDE.md 探索保持啟用 |

283| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 跳過 Microsoft Foundry 的 Azure 驗證，用於代理或閘道，該代理或閘道注入其自己的 `Authorization` 標頭。Claude Code 發送沒有 Azure 認證的請求，並保留您提供的 `Authorization` 標頭，例如透過 `ANTHROPIC_CUSTOM_HEADERS`。當設定 `ANTHROPIC_FOUNDRY_API_KEY` 或 `ANTHROPIC_FOUNDRY_AUTH_TOKEN` 時被忽略。{/* min-version: 2.1.203 */}在 v2.1.203 之前，此變數使 Microsoft Foundry 用戶端無法發送請求，除非同時設定了 API 金鑰 |283| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 跳過 Microsoft Foundry 的 Azure 驗證，用於代理或閘道，該代理或閘道注入其自己的 `Authorization` 標頭。Claude Code 發送沒有 Azure 認證的請求，並保留您提供的 `Authorization` 標頭，例如透過 `ANTHROPIC_CUSTOM_HEADERS`。當設定 `ANTHROPIC_FOUNDRY_API_KEY` 或 `ANTHROPIC_FOUNDRY_AUTH_TOKEN` 時被忽略。{{/* min-version: 2.1.203 */}}在 v2.1.203 之前，此變數使 Microsoft Foundry 用戶端無法發送請求，除非同時設定了 API 金鑰 |

285| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 設定為 `1` 以跳過將提示歷史記錄和工作階段文字記錄寫入磁碟。使用此變數啟動的工作階段不會出現在 `--resume`、`--continue` 或向上箭頭歷史記錄中。對於臨時指令碼化工作階段很有用 |285| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 設定為 `1` 以跳過將提示歷史記錄和工作階段文字記錄寫入磁碟。使用此變數啟動的工作階段不會出現在 `--resume`、`--continue` 或向上箭頭歷史記錄中。對於臨時指令碼化工作階段很有用 |

287| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/zh-TW/hooks#stop) 或 [SubagentStop](/zh-TW/hooks#subagentstop) hook 可能連續阻止回合結束的最大次數，然後 Claude Code 覆蓋它並無論如何結束回合（預設值：8）。設定為 `0` 以停用上限。如果您的 hook 合法需要更多迭代來解決，請提高此值 |287| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/zh-TW/hooks#stop) 或 [SubagentStop](/zh-TW/hooks#subagentstop) hook 可能連續阻止回合結束的最大次數，然後 Claude Code 覆蓋它並無論如何結束回合（預設值：8）。設定為 `0` 以停用上限。如果您的 hook 合法需要更多迭代來解決，請提高此值 |

288| `CLAUDE_CODE_SUBAGENT_MODEL` | 請參閱 [Model configuration](/zh-TW/model-config)。{/* min-version: 2.1.196 */}自 v2.1.196 起，將其設定為 `inherit` 與不設定相同；較早版本將 `inherit` 視為覆蓋，強制每個 subagent 進入主對話的模型 |288| `CLAUDE_CODE_SUBAGENT_MODEL` | 請參閱 [Model configuration](/zh-TW/model-config)。{{/* min-version: 2.1.196 */}}自 v2.1.196 起，將其設定為 `inherit` 與不設定相同；較早版本將 `inherit` 視為覆蓋，強制每個 subagent 進入主對話的模型 |

289| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 設定為 `1` 以從子程序環境中移除 Anthropic 和雲端提供者認證（Bash 工具、hooks、MCP stdio 伺服器）。父 Claude 程序保留這些認證以進行 API 呼叫，但子程序無法讀取它們，減少了嘗試透過 shell 擴展來竊取機密的提示注入攻擊的暴露。在 Linux 上，這也會在隔離的 PID 命名空間中執行 Bash 子程序，以便它們無法透過 `/proc` 讀取主機程序環境；作為副作用，`ps`、`pgrep` 和 `kill` 無法看到或發信號給主機程序。配置 `allowed_non_write_users` 時，`claude-code-action` 會自動設定此項 |289| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 設定為 `1` 以從子程序環境中移除 Anthropic 和雲端提供者認證（Bash 工具、hooks、MCP stdio 伺服器）。父 Claude 程序保留這些認證以進行 API 呼叫，但子程序無法讀取它們，減少了嘗試透過 shell 擴展來竊取機密的提示注入攻擊的暴露。在 Linux 上，這也會在隔離的 PID 命名空間中執行 Bash 子程序，以便它們無法透過 `/proc` 讀取主機程序環境；作為副作用，`ps`、`pgrep` 和 `kill` 無法看到或發信號給主機程序。配置 `allowed_non_write_users` 時，`claude-code-action` 會自動設定此項 |

290| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 在非互動式模式（`-p` 旗標）中設定為 `1` 以等待外掛程式安裝完成，然後再進行第一個查詢。沒有此選項，外掛程式會在背景中安裝，可能在第一個回合時不可用。與 `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` 結合以限制等待時間 |290| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 在非互動式模式（`-p` 旗標）中設定為 `1` 以等待外掛程式安裝完成，然後再進行第一個查詢。沒有此選項，外掛程式會在背景中安裝，可能在第一個回合時不可用。與 `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` 結合以限制等待時間 |

291| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同步外掛程式安裝的逾時（以毫秒為單位）。超過時，Claude Code 會在沒有外掛程式的情況下繼續並記錄錯誤。無預設值：沒有此變數，同步安裝會等待直到完成 |291| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同步外掛程式安裝的逾時（以毫秒為單位）。超過時，Claude Code 會在沒有外掛程式的情況下繼續並記錄錯誤。無預設值：沒有此變數，同步安裝會等待直到完成 |

295| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | 設定為 `false` 以停用 diff 輸出中的語法醒目提示。當顏色干擾您的終端設定時很有用。若要也停用程式碼區塊和檔案預覽中的醒目提示，請使用 [`syntaxHighlightingDisabled`](/zh-TW/settings) 設定 |295| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | 設定為 `false` 以停用 diff 輸出中的語法醒目提示。當顏色干擾您的終端設定時很有用。若要也停用程式碼區塊和檔案預覽中的醒目提示，請使用 [`syntaxHighlightingDisabled`](/zh-TW/settings) 設定 |

296| `CLAUDE_CODE_TASK_LIST_ID` | 跨工作階段共享任務清單。在多個 Claude Code 實例中設定相同的 ID 以協調共享任務清單。請參閱 [Task list](/zh-TW/interactive-mode#task-list) |296| `CLAUDE_CODE_TASK_LIST_ID` | 跨工作階段共享任務清單。在多個 Claude Code 實例中設定相同的 ID 以協調共享任務清單。請參閱 [Task list](/zh-TW/interactive-mode#task-list) |

298| `CLAUDE_CODE_TMPDIR` | 覆蓋用於內部臨時檔案的臨時目錄。Claude Code 將 `/claude-{uid}/`（Unix）或 `/claude/`（Windows）附加到此路徑。預設值：macOS 上的 `/tmp`、Linux/Windows 上的 `os.tmpdir()`。{/* min-version: 2.1.161 */}自 v2.1.161 起，在 macOS 和 Linux 上，當您的覆蓋是長路徑時，[sandboxed](/zh-TW/sandboxing) Bash 子程序會在系統預設下收到簡短的回退 `$TMPDIR`，因為某些工具在臨時路徑變得太長時會失敗。未沙箱化的 Bash 命令繼承您的 shell 的 `$TMPDIR` 不變。Claude Code 自己的臨時檔案始終使用您的覆蓋 |298| `CLAUDE_CODE_TMPDIR` | 覆蓋用於內部臨時檔案的臨時目錄。Claude Code 將 `/claude-{uid}/`（Unix）或 `/claude/`（Windows）附加到此路徑。預設值：macOS 上的 `/tmp`、Linux/Windows 上的 `os.tmpdir()`。{{/* min-version: 2.1.161 */}}自 v2.1.161 起，在 macOS 和 Linux 上，當您的覆蓋是長路徑時，[sandboxed](/zh-TW/sandboxing) Bash 子程序會在系統預設下收到簡短的回退 `$TMPDIR`，因為某些工具在臨時路徑變得太長時會失敗。未沙箱化的 Bash 命令繼承您的 shell 的 `$TMPDIR` 不變。Claude Code 自己的臨時檔案始終使用您的覆蓋 |

299| `CLAUDE_CODE_TMUX_TRUECOLOR` | 設定為 `1` 以允許 tmux 內的 24 位真彩色輸出。預設情況下，當設定 `$TMUX` 時，Claude Code 會限制為 256 色，因為 tmux 不會通過真彩色逃逸序列，除非配置為這樣做。在將 `set -ga terminal-overrides ',*:Tc'` 新增到您的 `~/.tmux.conf` 後設定此項。請參閱 [Terminal configuration](/zh-TW/terminal-config) 以取得其他 tmux 設定 |299| `CLAUDE_CODE_TMUX_TRUECOLOR` | 設定為 `1` 以允許 tmux 內的 24 位真彩色輸出。預設情況下，當設定 `$TMUX` 時，Claude Code 會限制為 256 色，因為 tmux 不會通過真彩色逃逸序列，除非配置為這樣做。在將 `set -ga terminal-overrides ',*:Tc'` 新增到您的 `~/.tmux.conf` 後設定此項。請參閱 [Terminal configuration](/zh-TW/terminal-config) 以取得其他 tmux 設定 |

305| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | 控制 PowerShell 工具。在沒有 Git Bash 的 Windows 上，工具會自動啟用；設定為 `0` 以停用它。在安裝了 Git Bash 的 Windows 上，工具正在逐步推出：設定為 `1` 以選擇加入或 `0` 以選擇退出。在 Linux、macOS 和 WSL 上，設定為 `1` 以啟用它，這需要您的 `PATH` 上有 `pwsh`。在 Windows 上啟用時，Claude 可以原生執行 PowerShell 命令，而不是透過 Git Bash 路由。請參閱 [PowerShell tool](/zh-TW/tools-reference#powershell-tool) |305| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | 控制 PowerShell 工具。在沒有 Git Bash 的 Windows 上，工具會自動啟用；設定為 `0` 以停用它。在安裝了 Git Bash 的 Windows 上，工具正在逐步推出：設定為 `1` 以選擇加入或 `0` 以選擇退出。在 Linux、macOS 和 WSL 上，設定為 `1` 以啟用它，這需要您的 `PATH` 上有 `pwsh`。在 Windows 上啟用時，Claude 可以原生執行 PowerShell 命令，而不是透過 Git Bash 路由。請參閱 [PowerShell tool](/zh-TW/tools-reference#powershell-tool) |

307| `CLAUDE_CONFIG_DIR` | 覆蓋配置目錄（預設值：`~/.claude`）。所有設定、認證、工作階段歷史記錄和外掛程式都儲存在此路徑下。對於並排執行多個帳戶很有用：例如，`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |307| `CLAUDE_CONFIG_DIR` | 覆蓋配置目錄（預設值：`~/.claude`）。所有設定、認證、工作階段歷史記錄和外掛程式都儲存在此路徑下。對於並排執行多個帳戶很有用：例如，`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

308| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}設定為 `1` 以停止進行中的背景工作，而不是在您按 `←` 或使用 [`/background`](/zh-TW/agent-view#from-inside-a-session) 將工作階段背景化時帶入它。Claude Code 會要求您在背景化前確認，然後停止會以其他方式帶入的任務。需要 Claude Code v2.1.195 或更新版本 |308| `CLAUDE_DISABLE_ADOPT` | {{/* min-version: 2.1.195 */}}設定為 `1` 以停止進行中的背景工作，而不是在您按 `←` 或使用 [`/background`](/zh-TW/agent-view#from-inside-a-session) 將工作階段背景化時帶入它。Claude Code 會要求您在背景化前確認，然後停止會以其他方式帶入的任務。需要 Claude Code v2.1.195 或更新版本 |

309| `CLAUDE_EFFORT` | 在 Bash 工具子程序和 hook 命令中自動設定為該回合的作用中 [effort level](/zh-TW/model-config#adjust-effort-level)：`low`、`medium`、`high`、`xhigh` 或 `max`。Ultracode 不是一個不同的級別，報告為 `xhigh`。符合傳遞給 [hooks](/zh-TW/hooks) 的 `effort.level` 欄位。僅在目前模型支援努力參數時設定 |309| `CLAUDE_EFFORT` | 在 Bash 工具子程序和 hook 命令中自動設定為該回合的作用中 [effort level](/zh-TW/model-config#adjust-effort-level)：`low`、`medium`、`high`、`xhigh` 或 `max`。Ultracode 不是一個不同的級別，報告為 `xhigh`。符合傳遞給 [hooks](/zh-TW/hooks) 的 `effort.level` 欄位。僅在目前模型支援努力參數時設定 |

310| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 設定為 `1` 以強制啟用位元級串流閒置監視程式，或設定為 `0` 以強制停用它。未設定時，監視程式預設對 Anthropic API 和 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 連線啟用。位元監視程式會在 180 秒內沒有位元組到達線路時中止連線（直接 Anthropic API 連線上預設為 180 秒，Claude Platform on AWS 和其他提供者上為 300 秒），或在設定 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 時為該值，該值被限制為最少 5 分鐘，獨立於事件級監視程式 |310| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 設定為 `1` 以強制啟用位元級串流閒置監視程式，或設定為 `0` 以強制停用它。未設定時，監視程式預設對 Anthropic API 和 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 連線啟用。位元監視程式會在 180 秒內沒有位元組到達線路時中止連線（直接 Anthropic API 連線上預設為 180 秒，Claude Platform on AWS 和其他提供者上為 300 秒），或在設定 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 時為該值，該值被限制為最少 5 分鐘，獨立於事件級監視程式 |

311| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | 設定為 `1` 以在 Amazon Bedrock `vnd.amazon.eventstream` 回應上啟用位元級串流閒置監視程式。預設關閉。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 配置逾時 |311| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | 設定為 `1` 以在 Amazon Bedrock `vnd.amazon.eventstream` 回應上啟用位元級串流閒置監視程式。預設關閉。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 配置逾時 |

312| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 設定為 `1` 以強制啟用事件級串流閒置監視程式，或設定為 `0` 以強制停用它。{/* min-version: 2.1.196 */}未設定時，監視程式預設對所有提供者啟用。在 v2.1.196 之前，未設定的預設值由伺服器在直接 Anthropic API 上控制，在其他提供者上關閉。{/* min-version: 2.1.169 */}自 v2.1.169 起，直接 Anthropic API 和 Claude Platform on AWS 以外的提供者也有預設開啟的 5 分鐘主體閒置逾時，獨立於此變數；請參閱 `API_FORCE_IDLE_TIMEOUT`。在 Amazon Bedrock 上，您也可以使用 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` 啟用獨立的位元級監視程式；當兩者都設定時，它們一起執行。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 配置逾時 |312| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 設定為 `1` 以強制啟用事件級串流閒置監視程式，或設定為 `0` 以強制停用它。{{/* min-version: 2.1.196 */}}未設定時，監視程式預設對所有提供者啟用。在 v2.1.196 之前，未設定的預設值由伺服器在直接 Anthropic API 上控制，在其他提供者上關閉。{{/* min-version: 2.1.169 */}}自 v2.1.169 起，直接 Anthropic API 和 Claude Platform on AWS 以外的提供者也有預設開啟的 5 分鐘主體閒置逾時，獨立於此變數；請參閱 `API_FORCE_IDLE_TIMEOUT`。在 Amazon Bedrock 上，您也可以使用 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` 啟用獨立的位元級監視程式；當兩者都設定時，它們一起執行。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 配置逾時 |

313| `CLAUDE_ENV_FILE` | Claude Code 在每個 Bash 命令之前在同一 shell 程序中執行的 shell 指令碼的路徑，因此檔案中的匯出對命令可見。用於在命令之間保持 virtualenv 或 conda 啟用。也由 [SessionStart](/zh-TW/hooks#persist-environment-variables)、[Setup](/zh-TW/hooks#setup)、[CwdChanged](/zh-TW/hooks#cwdchanged) 和 [FileChanged](/zh-TW/hooks#filechanged) hooks 動態填充 |313| `CLAUDE_ENV_FILE` | Claude Code 在每個 Bash 命令之前在同一 shell 程序中執行的 shell 指令碼的路徑，因此檔案中的匯出對命令可見。用於在命令之間保持 virtualenv 或 conda 啟用。也由 [SessionStart](/zh-TW/hooks#persist-environment-variables)、[Setup](/zh-TW/hooks#setup)、[CwdChanged](/zh-TW/hooks#cwdchanged) 和 [FileChanged](/zh-TW/hooks#filechanged) hooks 動態填充 |

314| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 當未提供明確名稱時，自動產生的 [Remote Control](/zh-TW/remote-control) 工作階段名稱的前綴。預設為您的機器主機名稱，產生名稱如 `myhost-graceful-unicorn`。`--remote-control-session-name-prefix` CLI 旗標為單一呼叫設定相同的值 |314| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 當未提供明確名稱時，自動產生的 [Remote Control](/zh-TW/remote-control) 工作階段名稱的前綴。預設為您的機器主機名稱，產生名稱如 `myhost-graceful-unicorn`。`--remote-control-session-name-prefix` CLI 旗標為單一呼叫設定相同的值 |

315| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | 串流閒置監視程式在關閉停滯連線之前的逾時（以毫秒為單位）。當您明確設定此變數時，最小值為 `300000`（5 分鐘）；較低的值會無聲地限制以吸收延伸思考暫停和代理緩衝。未設定時，事件級監視程式預設為 300 秒，位元級監視程式在直接 Anthropic API 連線上預設為 180 秒（Claude Platform on AWS 和其他提供者上為 300 秒）。未設定的 180 秒位元監視程式預設是一個單獨的值，不受 5 分鐘限制。`API_FORCE_IDLE_TIMEOUT` 下描述的主體閒置逾時獨立適用。在 Amazon Bedrock 上，也適用於 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |315| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | 串流閒置監視程式在關閉停滯連線之前的逾時（以毫秒為單位）。當您明確設定此變數時，最小值為 `300000`（5 分鐘）；較低的值會無聲地限制以吸收延伸思考暫停和代理緩衝。未設定時，事件級監視程式預設為 300 秒，位元級監視程式在直接 Anthropic API 連線上預設為 180 秒（Claude Platform on AWS 和其他提供者上為 300 秒）。未設定的 180 秒位元監視程式預設是一個單獨的值，不受 5 分鐘限制。`API_FORCE_IDLE_TIMEOUT` 下描述的主體閒置逾時獨立適用。在 Amazon Bedrock 上，也適用於 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

321| `DISABLE_DOCTOR_COMMAND` | 設定為 `1` 以隱藏 [`/doctor`](/zh-TW/commands#all-commands) 設定檢查 skill 及其 `/checkup` 別名。對於使用者不應執行安裝診斷的受管部署很有用。不影響 `claude doctor` 終端命令。{/* min-version: 2.1.205 */}在 v2.1.205 之前，此變數隱藏了 `/doctor` 診斷螢幕命令 |321| `DISABLE_DOCTOR_COMMAND` | 設定為 `1` 以隱藏 [`/doctor`](/zh-TW/commands#all-commands) 設定檢查 skill 及其 `/checkup` 別名。對於使用者不應執行安裝診斷的受管部署很有用。不影響 `claude doctor` 終端命令。{{/* min-version: 2.1.205 */}}在 v2.1.205 之前，此變數隱藏了 `/doctor` 診斷螢幕命令 |

341| `ENABLE_PROMPT_CACHING_1H` | 設定為 `1` 以要求 1 小時的提示快取 TTL，而不是預設的 5 分鐘。適用於 API 金鑰、[Amazon Bedrock](/zh-TW/amazon-bedrock)、[Google Cloud's Agent Platform](/zh-TW/google-vertex-ai)、[Microsoft Foundry](/zh-TW/microsoft-foundry) 和 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 使用者。訂閱使用者自動接收 1 小時 TTL。1 小時快取寫入以更高的速率計費 |341| `ENABLE_PROMPT_CACHING_1H` | 設定為 `1` 以要求 1 小時的提示快取 TTL，而不是預設的 5 分鐘。適用於 API 金鑰、[Amazon Bedrock](/zh-TW/amazon-bedrock)、[Google Cloud's Agent Platform](/zh-TW/google-vertex-ai)、[Microsoft Foundry](/zh-TW/microsoft-foundry) 和 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 使用者。訂閱使用者自動接收 1 小時 TTL。1 小時快取寫入以更高的速率計費 |

343| `ENABLE_TOOL_SEARCH` | 控制 [MCP tool search](/zh-TW/mcp#scale-with-mcp-tool-search)。未設定：預設所有 MCP 工具延遲，但在 Google Cloud's Agent Platform 上或當 `ANTHROPIC_BASE_URL` 指向非第一方主機時提前載入。值：`true`（始終延遲並發送 beta 標頭，在 Google Cloud's Agent Platform 或不支援 `tool_reference` 的代理上請求失敗）、`auto`（閾值模式：如果工具符合上下文的 10% 內則提前載入）、`auto:N`（自訂閾值，例如 `auto:5` 表示 5%）、`false`（提前載入全部） |343| `ENABLE_TOOL_SEARCH` | 控制 [MCP tool search](/zh-TW/mcp#scale-with-mcp-tool-search)。未設定：預設所有 MCP 工具延遲，但在 Google Cloud's Agent Platform 上或當 `ANTHROPIC_BASE_URL` 指向非第一方主機時提前載入。值：`true`（始終延遲並發送 beta 標頭，在 Google Cloud's Agent Platform 或不支援 `tool_reference` 的代理上請求失敗）、`auto`（閾值模式：如果工具符合上下文的 10% 內則提前載入）、`auto:N`（自訂閾值，例如 `auto:5` 表示 5%）、`false`（提前載入全部） |

344| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 設定為任何非空值以在任何主要模型上重複過載錯誤後觸發回退。{/* min-version: 2.1.160 */}自 v2.1.160 起，配置的 [fallback model chain](/zh-TW/model-config#fallback-model-chains) 會在任何主要模型的重複過載錯誤時觸發，因此此變數不影響切換到回退模型 |344| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 設定為任何非空值以在任何主要模型上重複過載錯誤後觸發回退。{{/* min-version: 2.1.160 */}}自 v2.1.160 起，配置的 [fallback model chain](/zh-TW/model-config#fallback-model-chains) 會在任何主要模型的重複過載錯誤時觸發，因此此變數不影響切換到回退模型 |

351| `MAX_STRUCTURED_OUTPUT_RETRIES` | 當模型的回應無法驗證非互動式模式（`-p` 旗標）中的 [`--json-schema`](/zh-TW/cli-reference#cli-flags) 時重試的次數。預設為 5 |351| `MAX_STRUCTURED_OUTPUT_RETRIES` | 當模型的回應無法驗證非互動式模式（`-p` 旗標）中的 [`--json-schema`](/zh-TW/cli-reference#cli-flags) 時重試的次數。預設為 5 |

352| `MAX_THINKING_TOKENS` | 覆蓋 [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) token 預算。上限是模型的 [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) 減一。設定為 `0` 以在 Anthropic API 上停用思考，除了 Fable 5，它無法關閉思考。在 [third-party providers](/zh-TW/third-party-integrations) 上，`0` 同樣省略該參數，具有 [adaptive reasoning](/zh-TW/model-config#adjust-effort-level) 的模型仍可能思考。對於自適應推理模型上的非零值，預算會被忽略，除非透過 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 停用自適應推理 |352| `MAX_THINKING_TOKENS` | 覆蓋 [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) token 預算。上限是模型的 [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) 減一。設定為 `0` 以在 Anthropic API 上停用思考，除了 Fable 5，它無法關閉思考。在 [third-party providers](/zh-TW/third-party-integrations) 上，`0` 同樣省略該參數，具有 [adaptive reasoning](/zh-TW/model-config#adjust-effort-level) 的模型仍可能思考。對於自適應推理模型上的非零值，預算會被忽略，除非透過 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 停用自適應推理 |

353| `MCP_CLIENT_SECRET` | 需要 [pre-configured credentials](/zh-TW/mcp#use-pre-configured-oauth-credentials) 的 MCP 伺服器的 OAuth 用戶端密碼。在使用 `--client-secret` 新增伺服器時避免互動式提示 |353| `MCP_CLIENT_SECRET` | 需要 [pre-configured credentials](/zh-TW/mcp#use-pre-configured-oauth-credentials) 的 MCP 伺服器的 OAuth 用戶端密碼。在使用 `--client-secret` 新增伺服器時避免互動式提示 |

354| `MCP_CONNECTION_NONBLOCKING` | 控制啟動是否在第一個查詢之前等待 MCP 伺服器連線。{/* min-version: 2.1.142 */}自 Claude Code v2.1.142 起，MCP 啟動預設為非阻止：伺服器在背景中連線，其工具在完成時變為可用。設定為 `0` 以還原阻止 5 秒連線等待。配置 [`alwaysLoad: true`](/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器仍會阻止啟動，無論如何，因為其工具必須在建立第一個提示時存在 |354| `MCP_CONNECTION_NONBLOCKING` | 控制啟動是否在第一個查詢之前等待 MCP 伺服器連線。{{/* min-version: 2.1.142 */}}自 Claude Code v2.1.142 起，MCP 啟動預設為非阻止：伺服器在背景中連線，其工具在完成時變為可用。設定為 `0` 以還原阻止 5 秒連線等待。配置 [`alwaysLoad: true`](/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器仍會阻止啟動，無論如何，因為其工具必須在建立第一個提示時存在 |

355| `MCP_CONNECT_TIMEOUT_MS` | 阻止 MCP 啟動等待連線批次的時間（以毫秒為單位），然後拍攝工具清單快照（預設值：5000）。適用於 `MCP_CONNECTION_NONBLOCKING=0` 或標記為 [`alwaysLoad: true`](/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器。在截止時間時仍待處理的伺服器會在背景中繼續連線，但在下一個查詢之前不會出現。與 `MCP_TIMEOUT` 不同，後者限制個別伺服器的連線嘗試 |355| `MCP_CONNECT_TIMEOUT_MS` | 阻止 MCP 啟動等待連線批次的時間（以毫秒為單位），然後拍攝工具清單快照（預設值：5000）。適用於 `MCP_CONNECTION_NONBLOCKING=0` 或標記為 [`alwaysLoad: true`](/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器。在截止時間時仍待處理的伺服器會在背景中繼續連線，但在下一個查詢之前不會出現。與 `MCP_TIMEOUT` 不同，後者限制個別伺服器的連線嘗試 |

356| `MCP_OAUTH_CALLBACK_PORT` | OAuth 重新導向回呼的固定連接埠，作為在使用 [pre-configured credentials](/zh-TW/mcp#use-pre-configured-oauth-credentials) 新增 MCP 伺服器時 `--callback-port` 的替代方案 |356| `MCP_OAUTH_CALLBACK_PORT` | OAuth 重新導向回呼的固定連接埠，作為在使用 [pre-configured credentials](/zh-TW/mcp#use-pre-configured-oauth-credentials) 新增 MCP 伺服器時 `--callback-port` 的替代方案 |

360| `MCP_TOOL_TIMEOUT` | MCP 工具執行的逾時（以毫秒為單位）（預設值：100000000，約 28 小時）。`.mcp.json` 中的每個伺服器 `timeout` 欄位會覆蓋該伺服器的此值。{/* min-version: 2.1.203 */}每個伺服器 `timeout` 至少 1000 也會設定該伺服器的工具呼叫的最小閒置視窗，因此 `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` 永遠不會更早中止它們；此下限需要 Claude Code v2.1.203 或更新版本。對於環境變數，低於 1000 的值會下限為 1 秒；對於每個伺服器欄位，低於 1000 的值會被忽略 |360| `MCP_TOOL_TIMEOUT` | MCP 工具執行的逾時（以毫秒為單位）（預設值：100000000，約 28 小時）。`.mcp.json` 中的每個伺服器 `timeout` 欄位會覆蓋該伺服器的此值。{{/* min-version: 2.1.203 */}}每個伺服器 `timeout` 至少 1000 也會設定該伺服器的工具呼叫的最小閒置視窗，因此 `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` 永遠不會更早中止它們；此下限需要 Claude Code v2.1.203 或更新版本。對於環境變數，低於 1000 的值會下限為 1 秒；對於每個伺服器欄位，低於 1000 的值會被忽略 |

362| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}設定為 `1` 以在 `assistant_response` OpenTelemetry 日誌事件上包含模型的回應文字。未設定時，使用 `OTEL_LOG_USER_PROMPTS` 的值。設定為 `0` 以保持回應編輯，即使設定 `OTEL_LOG_USER_PROMPTS`。需要 Claude Code v2.1.193 或更新版本。請參閱 [Monitoring](/zh-TW/monitoring-usage#assistant-response-event) |362| `OTEL_LOG_ASSISTANT_RESPONSES` | {{/* min-version: 2.1.193 */}}設定為 `1` 以在 `assistant_response` OpenTelemetry 日誌事件上包含模型的回應文字。未設定時，使用 `OTEL_LOG_USER_PROMPTS` 的值。設定為 `0` 以保持回應編輯，即使設定 `OTEL_LOG_USER_PROMPTS`。需要 Claude Code v2.1.193 或更新版本。請參閱 [Monitoring](/zh-TW/monitoring-usage#assistant-response-event) |

363| `OTEL_LOG_RAW_API_BODIES` | 設定為 `1` 以將完整的 Anthropic Messages API 請求和回應 JSON 作為 `api_request_body` / `api_response_body` 日誌事件發出（在 60 KB 處截斷），或 `file:<dir>` 以將未截斷的主體寫入磁碟並發出 `body_ref` 路徑。預設停用；主體包括整個對話歷史記錄。請參閱 [Monitoring](/zh-TW/monitoring-usage#api-request-body-event) |363| `OTEL_LOG_RAW_API_BODIES` | 設定為 `1` 以將完整的 Anthropic Messages API 請求和回應 JSON 作為 `api_request_body` / `api_response_body` 日誌事件發出（在 60 KB 處截斷），或 `file:<dir>` 以將未截斷的主體寫入磁碟並發出 `body_ref` 路徑。預設停用；主體包括整個對話歷史記錄。請參閱 [Monitoring](/zh-TW/monitoring-usage#api-request-body-event) |

364| `OTEL_LOG_TOOL_CONTENT` | 設定為 `1` 以在 OpenTelemetry span 事件中包含工具輸入和輸出內容。預設停用以保護敏感資料。請參閱 [Monitoring](/zh-TW/monitoring-usage) |364| `OTEL_LOG_TOOL_CONTENT` | 設定為 `1` 以在 OpenTelemetry span 事件中包含工具輸入和輸出內容。預設停用以保護敏感資料。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

365| `OTEL_LOG_TOOL_DETAILS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含工具輸入引數、MCP 伺服器名稱、工具失敗時的原始錯誤字串、`api_refusal` 事件上的拒絕 `category` 和其他工具詳細資訊。預設停用以保護個人識別資訊。請參閱 [Monitoring](/zh-TW/monitoring-usage) |365| `OTEL_LOG_TOOL_DETAILS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含工具輸入引數、MCP 伺服器名稱、工具失敗時的原始錯誤字串、`api_refusal` 事件上的拒絕 `category` 和其他工具詳細資訊。預設停用以保護個人識別資訊。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

366| `OTEL_LOG_USER_PROMPTS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含使用者提示文字。預設停用（提示被編輯）。請參閱 [Monitoring](/zh-TW/monitoring-usage) |366| `OTEL_LOG_USER_PROMPTS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含使用者提示文字。預設停用（提示被編輯）。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

368| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}設定為 `true` 以在指標屬性中包含工作階段進入點（預設值：排除）。在 v2.1.152 中新增。請參閱 [Monitoring](/zh-TW/monitoring-usage) |368| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {{/* min-version: 2.1.152 */}}設定為 `true` 以在指標屬性中包含工作階段進入點（預設值：排除）。在 v2.1.152 中新增。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

369| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {/* min-version: 2.1.161 */}自 v2.1.161 起，Claude Code 將 `OTEL_RESOURCE_ATTRIBUTES` 金鑰附加到指標資料點標籤。設定為 `false` 以排除它們（預設值：包含）。請參閱 [Monitoring](/zh-TW/monitoring-usage#multi-team-organization-support) |369| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {{/* min-version: 2.1.161 */}}自 v2.1.161 起，Claude Code 將 `OTEL_RESOURCE_ATTRIBUTES` 金鑰附加到指標資料點標籤。設定為 `false` 以排除它們（預設值：包含）。請參閱 [Monitoring](/zh-TW/monitoring-usage#multi-team-organization-support) |

372| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | 覆蓋顯示給 [Skill tool](/zh-TW/skills#control-who-invokes-a-skill) 的 skill 中繼資料的字元預算。預算在上下文視窗的 1% 處動態縮放，回退為 8,000 個字元。為了向後相容性保留舊名稱 |372| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | 覆蓋顯示給 [Skill tool](/zh-TW/skills#control-who-invokes-a-skill) 的 skill 中繼資料的字元預算。預算在上下文視窗的 1% 處動態縮放，回退為 8,000 個字元。為了向後相容性保留舊名稱 |

385| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}使用 Google Cloud's Agent Platform 時覆蓋 Claude Opus 4.7 的區域。在 v2.1.111 中新增 |385| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {{/* min-version: 2.1.111 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Opus 4.7 的區域。在 v2.1.111 中新增 |

386| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}使用 Google Cloud's Agent Platform 時覆蓋 Claude Opus 4.8 的區域。在 v2.1.154 中新增 |386| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {{/* min-version: 2.1.154 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Opus 4.8 的區域。在 v2.1.154 中新增 |

387| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Sonnet 5 的區域。在 v2.1.197 中新增 |387| `VERTEX_REGION_CLAUDE_5_SONNET` | {{/* min-version: 2.1.197 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Sonnet 5 的區域。在 v2.1.197 中新增 |

388| `VERTEX_REGION_CLAUDE_FABLE_5` | {{/* min-version: 2.1.170 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Fable 5 的區域。在 v2.1.170 中新增 |388| `VERTEX_REGION_CLAUDE_FABLE_5` | {{/* min-version: 2.1.170 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Fable 5 的區域。在 v2.1.170 中新增 |

390 390

errors.md +2 −1

Details

283You've hit your Opus limit · resets 3:45pm283You've hit your Opus limit · resets 3:45pm

284```284```

285 285

286Claude Code 會阻止進一步的請求，直到訊息中顯示的重設時間。286Claude Code 會阻止進一步的請求，直到訊息中顯示的重設時間。工作階段和每週限制在所有模型中共享，因此切換模型不會恢復存取。Opus 限制僅適用於 Opus 請求，因此使用 `/model` 切換到另一個模型可讓您繼續工作。

287 287

288**該怎麼做：**288**該怎麼做：**

289 289

290* 等待錯誤訊息中顯示的重設時間290* 等待錯誤訊息中顯示的重設時間

291* 對於 Opus 限制，執行 `/model` 並切換到另一個模型以繼續工作

291* 執行 `/usage` 以查看您的方案限制及其重設時間292* 執行 `/usage` 以查看您的方案限制及其重設時間

292* 執行 `/usage-credits` 以在 Pro 和 Max 上購買額外使用額度，或在 Team 和 Enterprise 上向您的管理員請求。請參閱[付費方案的使用額度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)以了解如何計費。293* 執行 `/usage-credits` 以在 Pro 和 Max 上購買額外使用額度，或在 Team 和 Enterprise 上向您的管理員請求。請參閱[付費方案的使用額度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)以了解如何計費。

293* 若要升級您的方案以獲得更高的基本限制，請參閱 [claude.com/pricing](https://claude.com/pricing)294* 若要升級您的方案以獲得更高的基本限制，請參閱 [claude.com/pricing](https://claude.com/pricing)

fast-mode.md +2 −6

Details

18 Opus 4.7 的快速模式自 2026 年 6 月 25 日起已棄用，將於 2026 年 7 月 24 日移除。移除後，Opus 4.7 上的快速模式請求將返回錯誤，不會回退至標準 Opus 4.7。遷移至 Opus 4.8 以保持加速。18 Opus 4.7 的快速模式自 2026 年 6 月 25 日起已棄用，將於 2026 年 7 月 24 日移除。移除後，Opus 4.7 上的快速模式請求將返回錯誤，不會回退至標準 Opus 4.7。遷移至 Opus 4.8 以保持加速。

19</Warning>19</Warning>

20 20

~~21<Note>~~

~~22 快速模式需要 Claude Code v2.1.36 或更新版本。使用 `claude --version` 檢查您的版本。~~

~~23</Note>~~

25需要了解的事項：21需要了解的事項：

26 22

27* 使用 `/fast` 在 Claude Code CLI 中切換快速模式。VS Code 擴充功能不支援快速模式。23* 使用 `/fast` 在 Claude Code CLI 中切換快速模式。VS Code 擴充功能不支援快速模式。

38* 輸入 `/fast` 並按 Tab 鍵切換開啟或關閉34* 輸入 `/fast` 並按 Tab 鍵切換開啟或關閉

39* 在您的[使用者設定檔案](/zh-TW/settings)中設定 `"fastMode": true`35* 在您的[使用者設定檔案](/zh-TW/settings)中設定 `"fastMode": true`

40 36

41預設情況下，在互動式工作階段中開啟的快速模式會在工作階段之間保持。{/* min-version: 2.1.205 */}在[非互動式模式](/zh-TW/headless)中，使用 `-p` 旗標時，`/fast` 僅在使用快速模式在其 [`--settings`](/zh-TW/cli-reference#cli-flags) 值中啟動的工作階段中運作，例如 `claude -p --settings '{"fastMode": true}'`；切換則僅適用於該工作階段，不會儲存為您的預設值，在任何其他非互動式工作階段中，該命令會報告快速模式不可用。管理員可以配置快速模式在每個工作階段重設。詳見[要求每個工作階段選擇加入](#require-per-session-opt-in)以了解詳情。37預設情況下，在互動式工作階段中開啟的快速模式會在工作階段之間保持。{/* min-version: 2.1.205 */}在[非互動式模式](/zh-TW/headless)中，使用 `-p` 旗標時，`/fast` 僅在使用快速模式在其 [`--settings`](/zh-TW/cli-reference#cli-flags) 值中啟動的工作階段中運作，例如 `claude -p --settings '{"fastMode": true}'`；切換則僅適用於該工作階段，不會儲存為您的預設值，在任何其他非互動式工作階段中，該命令會報告快速模式不可用。您可以配置快速模式在每個工作階段重設。詳見[要求每個工作階段選擇加入](#require-per-session-opt-in)以了解詳情。

42 38

43為了獲得最佳成本效率，在工作階段開始時啟用快速模式，而不是在對話中途切換。詳見[了解成本權衡](#understand-the-cost-tradeoff)以了解詳情。39為了獲得最佳成本效率，在工作階段開始時啟用快速模式，而不是在對話中途切換。詳見[了解成本權衡](#understand-the-cost-tradeoff)以了解詳情。

44 40

131 要求每個工作階段選擇加入127 要求每個工作階段選擇加入

132</h3>128</h3>

133 129

134預設情況下，快速模式在工作階段之間保持：如果使用者啟用快速模式，它在未來工作階段中保持開啟。[Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) 或 [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) 方案上的管理員可以透過在[受管設定](/zh-TW/settings#settings-files)或[伺服器受管設定](/zh-TW/server-managed-settings)中將 `fastModePerSessionOptIn` 設定為 `true` 來防止這種情況。這會導致每個工作階段以快速模式關閉開始，要求使用者使用 `/fast` 明確啟用它。130預設情況下，快速模式在工作階段之間保持：使用者在互動式工作階段中啟用的快速模式會在未來工作階段中保持開啟。若要變更此行為，在任何[設定檔](/zh-TW/settings#settings-files)中將 `fastModePerSessionOptIn` 設定為 `true`，這會導致每個工作階段以快速模式關閉開始，並要求使用者使用 `/fast` 明確啟用它。[Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) 或 [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) 方案上的擁有者可以透過[伺服器受管設定](/zh-TW/server-managed-settings)在組織範圍內部署它。

135 131

136```json theme={null}132```json theme={null}

137{133{

feature-availability.md +3 −2

Details

169 <tbody>169 <tbody>

170 <tr>170 <tr>

171 <td>[分析儀表板和 API](/zh-TW/analytics)</td>171 <td>[分析儀表板和 API](/zh-TW/analytics)</td>

172 <td>✓ (Team 和 Enterprise)</td>172 <td>✓ (儀表板：Team 和 Enterprise；API：Enterprise)</td>

173 <td>✓ <sup><a href="#fn5">5</a></sup></td>173 <td>✓ <sup><a href="#fn5">5</a></sup></td>

174 <td>✗</td>174 <td>✗</td>

175 <td>✗</td>175 <td>✗</td>

287| Dispatch ([Desktop](/zh-TW/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |287| Dispatch ([Desktop](/zh-TW/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

288| [Code Review](/zh-TW/code-review) | ✗ | ✗ | ✓ | ✓ |288| [Code Review](/zh-TW/code-review) | ✗ | ✗ | ✓ | ✓ |

289| [Artifacts](/zh-TW/artifacts) | ✓ | ✓ | ✓ | 管理員啟用 |289| [Artifacts](/zh-TW/artifacts) | ✓ | ✓ | ✓ | 管理員啟用 |

290| [分析儀表板、API 和貢獻指標](/zh-TW/analytics) | ✗ | ✗ | ✓ | ✓ |290| [分析儀表板和貢獻指標](/zh-TW/analytics) | ✗ | ✗ | ✓ | ✓ |

291| [Enterprise Analytics API](/zh-TW/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

291| [伺服器管理的設定](/zh-TW/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |292| [伺服器管理的設定](/zh-TW/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

292| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |293| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

293| SCIM | ✗ | ✗ | ✗ | ✓ |294| SCIM | ✗ | ✗ | ✗ | ✓ |

fullscreen.md +28 −1

Details

7> 啟用更平順、無閃爍的渲染模式，具有滑鼠支援和穩定的記憶體使用，適用於長對話。7> 啟用更平順、無閃爍的渲染模式，具有滑鼠支援和穩定的記憶體使用，適用於長對話。

8 8

9<Note>9<Note>

10 全螢幕渲染是一個選擇加入的[研究預覽](#research-preview)，需要 Claude Code v2.1.89 或更新版本。在您目前的對話中執行 `/tui fullscreen` 以切換，或在 v2.1.110 之前的版本上設定 `CLAUDE_CODE_NO_FLICKER=1`。行為可能會根據回饋而改變。10 全螢幕渲染是一個選擇加入的[研究預覽](#research-preview)。在您目前的對話中執行 `/tui fullscreen` 以切換，或在 v2.1.110 之前的版本上設定 `CLAUDE_CODE_NO_FLICKER=1`。行為可能會根據回饋而改變。

11</Note>11</Note>

12 12

13全螢幕渲染是 Claude Code CLI 的替代渲染路徑，可消除閃爍、在長對話中保持記憶體使用平穩，並新增滑鼠支援。它在終端的替代螢幕緩衝區上繪製介面，就像 `vim` 或 `htop` 一樣，並且只渲染目前可見的訊息。這減少了每次更新時傳送到終端的資料量。13全螢幕渲染是 Claude Code CLI 的替代渲染路徑，可消除閃爍、在長對話中保持記憶體使用平穩，並新增滑鼠支援。它在終端的替代螢幕緩衝區上繪製介面，就像 `vim` 或 `htop` 一樣，並且只渲染目前可見的訊息。這減少了每次更新時傳送到終端的資料量。

213 213

214禁用點擊後，Claude Code 仍然捕捉滑鼠，因此滾輪和觸控板捲動對話，但左鍵點擊在 Claude Code 內不執行任何操作。您仍然需要按住終端的按鍵進行原生點擊並拖曳選擇。右鍵點擊和中鍵貼上在支援它們的終端上繼續運作。214禁用點擊後，Claude Code 仍然捕捉滑鼠，因此滾輪和觸控板捲動對話，但左鍵點擊在 Claude Code 內不執行任何操作。您仍然需要按住終端的按鍵進行原生點擊並拖曳選擇。右鍵點擊和中鍵貼上在支援它們的終端上繼續運作。

215 215

216<h2 id="troubleshooting">

217 疑難排解

218</h2>

219

220<h3 id="stale-or-misplaced-text-on-screen">

221 螢幕上出現過時或位置錯誤的文字

222</h3>

223

224全螢幕渲染只會傳送幀之間變更的儲存格。某些終端機（最常見的是 Windows Terminal 和其他 ConPTY 支援的主機）會不正確地合併這些定位寫入，並在您調整視窗大小之前，在螢幕上留下較早輸出的片段。

225

226設定 [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/zh-TW/env-vars) 以在每一幀上重新繪製每個儲存格，而不是傳送增量更新。

227

228在 Windows PowerShell 上：

229

230```powershell theme={null}

231$env:CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT = "1"

232claude

233```

234

235在 macOS 或 Linux 上：

236

237```bash theme={null}

238CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude

239```

240

241在 Windows 上，Claude Code 已自動為背景工作階段和 [agent view](/zh-TW/agent-view) 啟用完整重繪，因此您只需要為直接啟動的互動式全螢幕工作階段設定該變數。

242

216<h2 id="research-preview">243<h2 id="research-preview">

217 研究預覽244 研究預覽

218</h2>245</h2>

glossary.md +1 −1

Details

236 Non-interactive mode236 Non-interactive mode

237</h3>237</h3>

238 238

239一種執行單個提示並退出而不進行對話會話的模式，使用 `-p` 或 `--print` 調用。用於 CI、指令碼和管道。[Agent SDK](/zh-TW/agent-sdk/overview) 是 Python 和 TypeScript 的等效項。以前稱為 headless mode。239一種執行單個提示並退出而不進行對話會話的模式，使用 `-p` 或 `--print` 調用。用於 CI、指令碼和管道。除非您傳遞 `--no-session-persistence`，否則執行仍會儲存為可恢復的會話。[Agent SDK](/zh-TW/agent-sdk/overview) 是 Python 和 TypeScript 的等效項。以前稱為 headless mode。

240 240

241了解更多：[Run Claude Code programmatically](/zh-TW/headless)241了解更多：[Run Claude Code programmatically](/zh-TW/headless)

242 242

google-vertex-ai.md +1 −5

Details

98 98

99如果您有 Google Cloud 認證並想開始透過 Google Cloud 的 Agent Platform 使用 Claude Code，登入精靈會引導您完成整個過程。您只需在每個專案中完成一次 GCP 端的先決條件；精靈會處理 Claude Code 端的設定。99如果您有 Google Cloud 認證並想開始透過 Google Cloud 的 Agent Platform 使用 Claude Code，登入精靈會引導您完成整個過程。您只需在每個專案中完成一次 GCP 端的先決條件；精靈會處理 Claude Code 端的設定。

100 100

101<Note>

102 Google Cloud 的 Agent Platform 設定精靈需要 Claude Code v2.1.98 或更新版本。執行 `claude --version` 以檢查。

103</Note>

~~104~~

105<Steps>101<Steps>

106 <Step title="在您的 GCP 專案中啟用 Claude 模型">102 <Step title="在您的 GCP 專案中啟用 Claude 模型">

107 為您的專案[啟用 Google Cloud 的 Agent Platform API](#1-enable-agent-platform-api)，然後在 [Google Cloud 的 Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) 中要求存取您想要的 Claude 模型。請參閱 [IAM 設定](#iam-configuration)以了解您的帳戶需要的權限。103 為您的專案[啟用 Google Cloud 的 Agent Platform API](#1-enable-agent-platform-api)，然後在 [Google Cloud 的 Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) 中要求存取您想要的 Claude 模型。請參閱 [IAM 設定](#iam-configuration)以了解您的帳戶需要的權限。

262 啟動模型檢查258 啟動模型檢查

263</h2>259</h2>

264 260

265當 Claude Code 以 Google Cloud 的 Agent Platform 設定啟動時，它會驗證它打算使用的模型在您的專案中是否可存取。此檢查需要 Claude Code v2.1.98 或更新版本。261當 Claude Code 以 Google Cloud 的 Agent Platform 設定啟動時，它會驗證它打算使用的模型在您的專案中是否可存取。

266 262

267如果您已固定的模型版本比目前 Claude Code 預設值更舊，且您的專案可以呼叫較新版本，Claude Code 會提示您更新固定。接受會將新模型 ID 寫入您的[使用者設定檔](/zh-TW/settings)並重新啟動 Claude Code。拒絕會被記住，直到下一次預設版本變更。263如果您已固定的模型版本比目前 Claude Code 預設值更舊，且您的專案可以呼叫較新版本，Claude Code 會提示您更新固定。接受會將新模型 ID 寫入您的[使用者設定檔](/zh-TW/settings)並重新啟動 Claude Code。拒絕會被記住，直到下一次預設版本變更。

268 264

hooks.md +0 −4

Details

1648 1648

1649`"defer"` 用於執行 `claude -p` 作為子程序並讀取其 JSON 輸出的整合，例如 Agent SDK 應用程式或建立在 Claude Code 之上的自訂 UI。它讓該呼叫程序在工具呼叫處暫停 Claude，通過其自己的介面收集輸入，並從中斷處恢復。Claude Code 僅在 [非互動模式](/zh-TW/headless) 中使用 `-p` 標誌時遵守此值。在互動式工作階段中，它記錄警告並忽略 hook 結果。1649`"defer"` 用於執行 `claude -p` 作為子程序並讀取其 JSON 輸出的整合，例如 Agent SDK 應用程式或建立在 Claude Code 之上的自訂 UI。它讓該呼叫程序在工具呼叫處暫停 Claude，通過其自己的介面收集輸入，並從中斷處恢復。Claude Code 僅在 [非互動模式](/zh-TW/headless) 中使用 `-p` 標誌時遵守此值。在互動式工作階段中，它記錄警告並忽略 hook 結果。

1650 1650

1651<Note>

1652 `defer` 值需要 Claude Code v2.1.89 或更高版本。較早的版本無法識別它，工具通過正常權限流程進行。

1653</Note>

~~1654~~

1655`AskUserQuestion` 工具是典型情況：Claude 想要詢問使用者某些事情，但沒有終端來回答。往返工作如下：1651`AskUserQuestion` 工具是典型情況：Claude 想要詢問使用者某些事情，但沒有終端來回答。往返工作如下：

1656 1652

16571. Claude 呼叫 `AskUserQuestion`。`PreToolUse` hook 觸發。16531. Claude 呼叫 `AskUserQuestion`。`PreToolUse` hook 觸發。

hooks-guide.md +1 −5

Details

747 使用 `if` 欄位按工具名稱和引數篩選747 使用 `if` 欄位按工具名稱和引數篩選

748</h4>748</h4>

749 749

750<Note>

751 `if` 欄位需要 Claude Code v2.1.85 或更新版本。較早的版本會忽略它並在每次匹配的呼叫上執行 hook。

752</Note>

~~753~~

754`if` 欄位使用[權限規則語法](/zh-TW/permissions)按工具名稱和引數一起篩選 hooks，因此 hook 程序只在工具呼叫相符時生成。這超越了 `matcher`，它只在工具名稱級別篩選。750`if` 欄位使用[權限規則語法](/zh-TW/permissions)按工具名稱和引數一起篩選 hooks，因此 hook 程序只在工具呼叫相符時生成。這超越了 `matcher`，它只在工具名稱級別篩選。

755 751

756例如，若要只在 Claude 使用 `git` 命令而不是所有 Bash 命令時執行 hook：752例如，這個配置只在 Claude 使用 `git` 命令而不是所有 Bash 命令時執行 hook：

757 753

758```json theme={null}754```json theme={null}

759{755{

how-claude-code-works.md +1 −1

Details

188 188

189* **Manual**：Claude 在檔案編輯和 shell 命令之前詢問189* **Manual**：Claude 在檔案編輯和 shell 命令之前詢問

190* **Accept edits**：Claude 編輯檔案並執行常見的檔案系統命令（如 `mkdir` 和 `mv`）而不詢問，仍然詢問其他命令190* **Accept edits**：Claude 編輯檔案並執行常見的檔案系統命令（如 `mkdir` 和 `mv`）而不詢問，仍然詢問其他命令

191* **Plan**：Claude 探索並提出計畫而不編輯您的原始檔案；許可提示仍然如 Manual 模式一樣適用191* **Plan**：Claude 探索並提出計畫而不編輯您的原始檔案

192* **Auto**：Claude 使用背景安全檢查評估所有操作192* **Auto**：Claude 使用背景安全檢查評估所有操作

193 193

194您也可以在 `.claude/settings.json` 中允許特定命令，以便 Claude 不會每次都詢問。這對於受信任的命令（如 `npm test` 或 `git status`）很有用。設定可以從組織範圍的政策範圍到個人偏好。請參閱[許可](/zh-TW/permissions)以取得詳細資訊。194您也可以在 `.claude/settings.json` 中允許特定命令，以便 Claude 不會每次都詢問。這對於受信任的命令（如 `npm test` 或 `git status`）很有用。設定可以從組織範圍的政策範圍到個人偏好。請參閱[許可](/zh-TW/permissions)以取得詳細資訊。

keybindings.md +0 −4

Details

6 6

7> 使用快捷鍵配置檔案在 Claude Code 中自訂鍵盤快捷鍵。7> 使用快捷鍵配置檔案在 Claude Code 中自訂鍵盤快捷鍵。

8 8

~~9<Note>~~

~~10 可自訂的鍵盤快捷鍵需要 Claude Code v2.1.18 或更新版本。使用 `claude --version` 檢查您的版本。~~

~~11</Note>~~

13Claude Code 支援可自訂的鍵盤快捷鍵。執行 `/keybindings` 以在 `~/.claude/keybindings.json` 建立或開啟您的配置檔案。9Claude Code 支援可自訂的鍵盤快捷鍵。執行 `/keybindings` 以在 `~/.claude/keybindings.json` 建立或開啟您的配置檔案。

14 10

15<h2 id="configuration-file">11<h2 id="configuration-file">

mcp.md +1 −1

Details

722}722}

723```723```

724 724

725URL 必須使用 `https://`。`authServerMetadataUrl` 需要 Claude Code v2.1.64 或更新版本。中繼資料 URL 的 `scopes_supported` 會覆蓋上游 server 宣傳的範圍。725URL 必須使用 `https://`。中繼資料 URL 的 `scopes_supported` 會覆蓋上游 server 宣傳的範圍。

726 726

727<h3 id="restrict-oauth-scopes">727<h3 id="restrict-oauth-scopes">

728 限制 OAuth 範圍728 限制 OAuth 範圍

memory.md +0 −4

Details

365 365

366自動記憶讓 Claude 在您不編寫任何內容的情況下跨工作階段累積知識。Claude 在工作時為自己保存筆記：建置命令、除錯見解、架構筆記、程式碼樣式偏好和工作流程習慣。Claude 不會每個工作階段都保存內容。它根據資訊在未來對話中是否有用來決定值得記住的內容。366自動記憶讓 Claude 在您不編寫任何內容的情況下跨工作階段累積知識。Claude 在工作時為自己保存筆記：建置命令、除錯見解、架構筆記、程式碼樣式偏好和工作流程習慣。Claude 不會每個工作階段都保存內容。它根據資訊在未來對話中是否有用來決定值得記住的內容。

367 367

368<Note>

369 自動記憶需要 Claude Code v2.1.59 或更高版本。使用 `claude --version` 檢查您的版本。

370</Note>

~~371~~

372<h3 id="enable-or-disable-auto-memory">368<h3 id="enable-or-disable-auto-memory">

373 啟用或停用自動記憶369 啟用或停用自動記憶

374</h3>370</h3>

permission-modes.md +1 −5

Details

132 使用 plan mode 在編輯前分析132 使用 plan mode 在編輯前分析

133</h2>133</h2>

134 134

135Plan mode 告訴 Claude 研究和提議變更而不進行變更。Claude 讀取檔案、執行 shell 命令進行探索，並寫入計劃，但不編輯您的原始程式碼。權限提示的應用方式與手動模式相同。135Plan mode 告訴 Claude 研究和提議變更而不進行變更。Claude 讀取檔案、執行 shell 命令進行探索，並寫入計劃，但不編輯您的原始程式碼。權限提示的應用方式與手動模式相同，除非[自動模式](/zh-TW/auto-mode-config)可用且 `useAutoModeDuringPlan` 已開啟（這是預設值）。啟用自動模式後，分類器會批准唯讀命令（例如搜尋和檔案讀取）而不提示。無論哪種方式，編輯都會保持被阻止，直到您批准計劃。

136 136

137通過按 `Shift+Tab` 或在單個提示前加上 `/plan` 進入 plan mode。您也可以從 CLI 啟動 plan mode：137通過按 `Shift+Tab` 或在單個提示前加上 `/plan` 進入 plan mode。您也可以從 CLI 啟動 plan mode：

138 138

178 使用 auto mode 消除提示178 使用 auto mode 消除提示

179</h2>179</h2>

180 180

181<Note>

182 Auto mode 需要 Claude Code v2.1.83 或更新版本。

183</Note>

~~184~~

185Auto mode 讓 Claude 執行而不顯示例行權限提示。單獨的分類器模型在執行前審查操作，阻止任何超出您要求的操作、針對無法識別的基礎設施的操作，或似乎由 Claude 讀到的敵對內容驅動的操作。明確的[詢問規則](/zh-TW/permissions#manage-permissions)仍然會強制提示。181Auto mode 讓 Claude 執行而不顯示例行權限提示。單獨的分類器模型在執行前審查操作，阻止任何超出您要求的操作、針對無法識別的基礎設施的操作，或似乎由 Claude 讀到的敵對內容驅動的操作。明確的[詢問規則](/zh-TW/permissions#manage-permissions)仍然會強制提示。

186 182

187Auto mode 也指示 Claude 繼續工作而不停止以提出澄清問題，儘管當您的提示或技能明確依賴它時，Claude 仍然會提問。若要在保持權限提示的情況下獲得更強的自主行為，請改為設定[主動輸出風格](/zh-TW/output-styles)。183Auto mode 也指示 Claude 繼續工作而不停止以提出澄清問題，儘管當您的提示或技能明確依賴它時，Claude 仍然會提問。若要在保持權限提示的情況下獲得更強的自主行為，請改為設定[主動輸出風格](/zh-TW/output-styles)。

plugin-marketplaces.md +31 −17

Details

573 573

574Claude Code 支援從私人儲存庫安裝 plugin。對於手動安裝和更新，Claude Code 使用您現有的 git 認證助手，因此 HTTPS 存取透過 `gh auth login`、macOS Keychain 或 `git-credential-store` 的方式與在您的終端中相同。只要主機已在您的 `known_hosts` 檔案中且金鑰已載入 `ssh-agent`，SSH 存取就可以運作，因為 Claude Code 會抑制主機指紋和金鑰密碼的互動式 SSH 提示。574Claude Code 支援從私人儲存庫安裝 plugin。對於手動安裝和更新，Claude Code 使用您現有的 git 認證助手，因此 HTTPS 存取透過 `gh auth login`、macOS Keychain 或 `git-credential-store` 的方式與在您的終端中相同。只要主機已在您的 `known_hosts` 檔案中且金鑰已載入 `ssh-agent`，SSH 存取就可以運作，因為 Claude Code 會抑制主機指紋和金鑰密碼的互動式 SSH 提示。

575 575

576背景自動更新在啟動時執行，不使用認證助手，因為互動式提示會阻止 Claude Code 啟動。若要為私人 marketplace 啟用自動更新，請在您的環境中設定適當的驗證令牌：576背景自動更新的運作方式不同。根據預設，背景重新整理會為其 `git pull` 停用 git 認證助手，因此即使已配置助手，pull 也無法對私人儲存庫進行 HTTPS 驗證。SSH 遠端不受影響：載入在 `ssh-agent` 中的金鑰會以與手動操作相同的方式驗證背景 pull。當背景 pull 失敗時，Claude Code 會回退到從頭重新複製 marketplace。重新複製確實會使用您儲存的 git 認證，但它可能會在大型儲存庫上[逾時](#git-operations-time-out)，因此私人 marketplace 自動更新可能會間歇性失敗。

577 577

578| 提供者 | 環境變數 | 備註 |578兩個設定使私人 marketplace 的行為可預測：

579| :-------- | :-------------------------- | :-------------------- |

580| GitHub | `GITHUB_TOKEN` 或 `GH_TOKEN` | 個人存取令牌或 GitHub App 令牌 |

581| GitLab | `GITLAB_TOKEN` 或 `GL_TOKEN` | 個人存取令牌或專案令牌 |

582| Bitbucket | `BITBUCKET_TOKEN` | 應用程式密碼或儲存庫存取令牌 |

583 579

584在您的 shell 配置中設定令牌（例如，`.bashrc`、`.zshrc`）或在執行 Claude Code 時傳遞它：580* 設定 `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` 以在背景 pull 失敗時保留現有複製，而不是刪除並重新複製。您的 plugin 會從最後同步的狀態繼續運作，使用 `/plugin marketplace update` 的手動更新仍會使用您的認證進行 pull。

581* 配置 git 認證助手，例如使用 `gh auth setup-git` 針對 GitHub，以便重新複製回退可以在不提示的情況下進行驗證。

582

583在您的環境中設定提供者令牌（例如 `GITHUB_TOKEN`）本身不會啟用背景驗證。令牌只有透過已配置的認證助手（例如 `gh` CLI 的助手，它讀取 `GH_TOKEN` 和 `GITHUB_TOKEN`）才會生效。

584

585若要使背景 pull 本身透過 HTTPS 進行驗證，請配置全域 git URL 重寫。重寫會在遠端 URL 中嵌入令牌，因此即使背景 pull 停用認證助手，它也會生效，成功的 pull 會跳過重新複製回退。以下範例會重寫 marketplace 儲存庫的 URL 以包含存取令牌：

585 586

586```bash theme={null}587```bash theme={null}

587export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx588git config --global url."https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins".insteadOf "https://github.com/acme-corp/plugins"

588```589```

589 590

591將重寫範圍限制在 marketplace 儲存庫或組織路徑。其基礎僅為主機的重寫適用於該機器上對該主機的每次 fetch 和 push，並覆蓋您的正常認證，包括推送到您自己的儲存庫。

592

593每個提供者在重寫的 URL 中預期不同的使用者名稱，相同的路徑範圍適用於每個提供者。對於自託管伺服器，請將主機名稱替換為您的伺服器主機名稱：

594

595| 提供者 | 重寫的 URL 形式 |

596| :-------- | :---------------------------------------------------------------- |

597| GitHub | `https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins` |

598| GitLab | `https://oauth2:YOUR_TOKEN@gitlab.com/acme-corp/plugins` |

599| Bitbucket | `https://x-token-auth:YOUR_TOKEN@bitbucket.org/acme-corp/plugins` |

600

601重寫會以純文字形式將令牌儲存在您的 gitconfig 中，因此請使用具有對 marketplace 儲存庫的唯讀存取權的令牌。

602

590<Note>603<Note>

591 對於 CI/CD 環境，將令牌配置為秘密環境變數。GitHub Actions 自動為同一組織中的儲存庫提供 `GITHUB_TOKEN`。604 在 CI/CD 環境中，在從私人儲存庫安裝 plugin 之前配置 git 認證助手。在 GitHub Actions 上，匯出具有對 marketplace 儲存庫的讀取存取權的令牌作為 `GH_TOKEN`，然後執行 `gh auth setup-git`。預設工作流程令牌只能存取工作流程自己的儲存庫，因此另一個儲存庫中的私人 marketplace 需要個人存取令牌或應用程式令牌。在管道中配置的全域 URL 重寫也會直接驗證背景 pull。

592</Note>605</Note>

593 606

594<h3 id="test-locally-before-distribution">607<h3 id="test-locally-before-distribution">

1160 1173

1161對於背景自動更新：1174對於背景自動更新：

1162 1175

1163* 在您的環境中設定適當的令牌：`echo $GITHUB_TOKEN`1176* 根據預設，背景重新整理會停用 git 認證助手以進行拉取，因此拉取無法透過 HTTPS 進行驗證。具有在 `ssh-agent` 中載入的金鑰的 SSH 遠端仍會進行驗證。失敗的拉取會觸發從頭開始的重新複製，這會使用您儲存的認證，但在大型儲存庫上可能會逾時

1164* 檢查令牌是否具有必需的權限（對儲存庫的讀取存取權）1177* 設定 `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` 以在背景拉取失敗時保留現有複製

1165* 對於 GitHub，確保令牌對私人儲存庫具有 `repo` 範圍1178* 配置 git 認證助手（例如 `gh auth setup-git`），以便重新複製後備可以進行驗證

1166* 對於 GitLab，確保令牌至少具有 `read_repository` 範圍1179* 如果重新複製在大型儲存庫上逾時，請使用 [`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out) 增加限制

1167* 驗證令牌未過期1180* 配置範圍限定於 marketplace 儲存庫的 [git URL 重寫](#private-repositories)，以便背景拉取直接進行驗證

1181* 或使用 `/plugin marketplace update <name>` 手動更新私人 marketplace，這會使用您的認證

1168 1182

1169<h3 id="marketplace-updates-fail-in-offline-environments">1183<h3 id="marketplace-updates-fail-in-offline-environments">

1170 Marketplace 更新在離線環境中失敗1184 Marketplace 更新在離線環境中失敗

1171</h3>1185</h3>

1172 1186

1173**症狀**：Marketplace `git pull` 失敗，Claude Code 清除現有快取，導致 plugin 變得不可用。1187**症狀**：Marketplace `git pull` 在背景中失敗，Claude Code 重複嘗試無法成功的重新複製。

1174 1188

1175**原因**：預設情況下，當 `git pull` 失敗時，Claude Code 會移除過時的複製並嘗試重新複製。在離線或隔離環境中，重新複製以相同方式失敗，導致 marketplace 目錄為空。1189**原因**：根據預設，當 `git pull` 失敗時，Claude Code 會嘗試從頭開始重新複製。在離線或隔離環境中，重新複製以相同方式失敗，之後先前快取的還原是盡力而為。重新整理在啟動後在背景中執行，因此不會延遲啟動，但每個工作階段都會重複失敗的嘗試，每個 git 操作都可以等待 [120 秒逾時](#git-operations-time-out)。

1176 1190

1177**解決方案**：設定 `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` 以在拉取失敗時保留現有快取，而不是清除它：1191**解決方案**：設定 `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` 以在拉取失敗時跳過重新複製嘗試並繼續使用現有快取：

1178 1192

1179```bash theme={null}1193```bash theme={null}

1180export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=11194export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

plugins.md +1 −1

Details

521 521

522<Note>522<Note>

523 遷移後，從 `.claude/` 中移除原始檔案以避免重複。專案和使用者 `.claude/agents/` 定義會覆蓋同名的 plugin agents，因此 plugin 版本只有在移除原始檔案後才會生效。523 遷移後，從 `.claude/` 中移除原始檔案以避免重複。專案和使用者 `.claude/agents/` 定義會覆蓋同名的 plugin agents，因此 plugin 版本只有在移除原始檔案後才會生效。Plugin skills 會被命名為 `/plugin-name:skill-name`，因此原始的 `/skill-name` 和 plugin 副本都會保持可用，而不是其中一個覆蓋另一個。

524</Note>524</Note>

525 525

526<h2 id="next-steps">526<h2 id="next-steps">

prompt-caching.md +0 −4

Details

95 95

96成本每個對話應用一次。在第一個快速模式轉換之後，Claude Code 會繼續發送標頭，並且只改變請求的速度設定，這不是快取鍵的一部分。關閉快速模式、[在速率限制後自動回退到標準速度](/zh-TW/fast-mode#handle-rate-limits)，以及稍後重新開啟它都會保持快取。`/clear` 和 `/compact` 會重設此設定，因為它們無論如何都會在這些點重新建立快取。96成本每個對話應用一次。在第一個快速模式轉換之後，Claude Code 會繼續發送標頭，並且只改變請求的速度設定，這不是快取鍵的一部分。關閉快速模式、[在速率限制後自動回退到標準速度](/zh-TW/fast-mode#handle-rate-limits)，以及稍後重新開啟它都會保持快取。`/clear` 和 `/compact` 會重設此設定，因為它們無論如何都會在這些點重新建立快取。

97 97

~~98<Note>~~

~~99 在切換時保持標頭需要 Claude Code v2.1.86 或更新版本。在較早的版本上，每次快速模式切換和速率限制回退都會使快取失效。~~

100</Note>

~~101~~

102<h3 id="connecting-or-disconnecting-an-mcp-server">98<h3 id="connecting-or-disconnecting-an-mcp-server">

103 連接或斷開 MCP 伺服器99 連接或斷開 MCP 伺服器

104</h3>100</h3>

remote-control.md +1 −5

Details

21 21

22與[網頁版 Claude Code](/zh-TW/claude-code-on-the-web)（在雲端基礎設施上執行）不同，Remote Control 會話直接在您的機器上執行並與您的本地檔案系統互動。網頁和行動介面只是該本地會話的一個窗口。22與[網頁版 Claude Code](/zh-TW/claude-code-on-the-web)（在雲端基礎設施上執行）不同，Remote Control 會話直接在您的機器上執行並與您的本地檔案系統互動。網頁和行動介面只是該本地會話的一個窗口。

23 23

~~24<Note>~~

~~25 Remote Control 需要 Claude Code v2.1.51 或更新版本。使用 `claude --version` 檢查您的版本。~~

~~26</Note>~~

28本頁涵蓋設定、如何啟動和連接到會話，以及 Remote Control 與網頁版 Claude Code 的比較。24本頁涵蓋設定、如何啟動和連接到會話，以及 Remote Control 與網頁版 Claude Code 的比較。

29 25

30<h2 id="requirements">26<h2 id="requirements">

104 </Tab>100 </Tab>

105 101

106 <Tab title="VS Code">102 <Tab title="VS Code">

107 在 [Claude Code VS Code 擴充功能](/zh-TW/vs-code)中，在提示框中輸入 `/remote-control` 或 `/rc`，或使用 `/` 開啟命令選單並選擇它。需要 Claude Code v2.1.79 或更新版本。103 在 [Claude Code VS Code 擴充功能](/zh-TW/vs-code)中，在提示框中輸入 `/remote-control` 或 `/rc`，或使用 `/` 開啟命令選單並選擇它。

108 104

109 ```text theme={null}105 ```text theme={null}

110 /remote-control106 /remote-control

routines.md +0 −1

Details

419* 您使用 Console API 金鑰或雲端提供商（例如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry）進行身份驗證。`/schedule` 需要 claude.ai 訂閱登入。如果在您的 shell 中設定了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`，或在 `settings.json` 中設定了 `apiKeyHelper`，請先移除它，因為這些設定優先於 claude.ai 登入419* 您使用 Console API 金鑰或雲端提供商（例如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry）進行身份驗證。`/schedule` 需要 claude.ai 訂閱登入。如果在您的 shell 中設定了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`，或在 `settings.json` 中設定了 `apiKeyHelper`，請先移除它，因為這些設定優先於 claude.ai 登入

420* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK` 在您的 shell 環境或 [`settings.json` 檔案](/zh-TW/settings#available-settings)的 `env` 區塊中設定。這些會停用功能旗標擷取，而 `/schedule` 依賴於此功能420* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK` 在您的 shell 環境或 [`settings.json` 檔案](/zh-TW/settings#available-settings)的 `env` 區塊中設定。這些會停用功能旗標擷取，而 `/schedule` 依賴於此功能

421* 您在 Claude Code 網頁工作階段中。改為從 [web UI](https://claude.ai/code/routines) 管理例行程序421* 您在 Claude Code 網頁工作階段中。改為從 [web UI](https://claude.ai/code/routines) 管理例行程序

422* {/* min-version: 2.1.81 */}您的 CLI 版本早於 v2.1.81。執行 `claude update`

423 422

424無論 CLI 如何配置，您始終可以在 [claude.ai/code/routines](https://claude.ai/code/routines) 建立和管理例行程序。423無論 CLI 如何配置，您始終可以在 [claude.ai/code/routines](https://claude.ai/code/routines) 建立和管理例行程序。

425 424

sandboxing.md +1 −1

Details

136 136

137工作階段暫存目錄在沙箱內預設可寫，與工作目錄一起。Claude Code 為沙箱化命令設定 `$TMPDIR` 為此目錄，因此寫入暫存檔案的工具無需額外配置即可工作。未沙箱化命令繼承您的 shell 的 `$TMPDIR` 不變，這意味著沙箱化和未沙箱化命令將 `$TMPDIR` 解析為不同的目錄。若要在兩者之間傳遞暫存檔案，請改為在工作目錄下寫入它們。137工作階段暫存目錄在沙箱內預設可寫，與工作目錄一起。Claude Code 為沙箱化命令設定 `$TMPDIR` 為此目錄，因此寫入暫存檔案的工具無需額外配置即可工作。未沙箱化命令繼承您的 shell 的 `$TMPDIR` 不變，這意味著沙箱化和未沙箱化命令將 `$TMPDIR` 解析為不同的目錄。若要在兩者之間傳遞暫存檔案，請改為在工作目錄下寫入它們。

138 138

139某些命令根本無法在沙箱內執行，例如與其不相容的工具或需要您未允許的主機的工具。與其讓任務失敗或要求您關閉沙箱化，Claude Code 包含一個逃生艙：當命令因沙箱限制而失敗時，Claude 分析失敗，可能使用 `dangerouslyDisableSandbox` 參數重試命令。重試的命令在沙箱外執行，因此它通過常規權限流程進行，需要您的批准。139某些命令根本無法在沙箱內執行，例如與其不相容的工具或需要您未允許的主機的工具。與其讓任務失敗或要求您關閉沙箱化，Claude Code 包含一個逃生艙：當命令因沙箱限制而失敗時，Claude 分析失敗，可能使用 `dangerouslyDisableSandbox` 參數重試命令。重試的命令在沙箱外執行，因此通過常規權限流程進行。在 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 中，分類器評估基礎命令而不是提示您。

140 140

141您可以通過在 [sandbox settings](/zh-TW/settings#sandbox-settings) 中設定 `"allowUnsandboxedCommands": false` 來禁用此逃生艙。禁用時，`/sandbox` Overrides 標籤顯示為 **Strict sandbox mode**，`dangerouslyDisableSandbox` 參數被完全忽略，所有命令必須沙箱化執行或在 `excludedCommands` 中明確列出。141您可以通過在 [sandbox settings](/zh-TW/settings#sandbox-settings) 中設定 `"allowUnsandboxedCommands": false` 來禁用此逃生艙。禁用時，`/sandbox` Overrides 標籤顯示為 **Strict sandbox mode**，`dangerouslyDisableSandbox` 參數被完全忽略，所有命令必須沙箱化執行或在 `excludedCommands` 中明確列出。

142 142

scheduled-tasks.md +0 −4

Details

6 6

7> 使用 /loop 和 cron 排程工具在 Claude Code 工作階段內重複執行提示、輪詢狀態或設定一次性提醒。7> 使用 /loop 和 cron 排程工具在 Claude Code 工作階段內重複執行提示、輪詢狀態或設定一次性提醒。

8 8

~~9<Note>~~

~~10 排程任務需要 Claude Code v2.1.72 或更新版本。使用 `claude --version` 檢查您的版本。~~

~~11</Note>~~

13排程任務讓 Claude 按間隔自動重新執行提示。使用它們來輪詢部署、監督 PR、檢查長時間執行的建置，或在工作階段稍後提醒自己執行某些操作。若要改為對事件發生時做出反應而不是輪詢，請參閱 [Channels](/zh-TW/channels)：您的 CI 可以直接將失敗推送到工作階段中。若要保持工作階段逐輪執行直到符合條件而不是按間隔執行，請參閱 [`/goal`](/zh-TW/goal)。9排程任務讓 Claude 按間隔自動重新執行提示。使用它們來輪詢部署、監督 PR、檢查長時間執行的建置，或在工作階段稍後提醒自己執行某些操作。若要改為對事件發生時做出反應而不是輪詢，請參閱 [Channels](/zh-TW/channels)：您的 CI 可以直接將失敗推送到工作階段中。若要保持工作階段逐輪執行直到符合條件而不是按間隔執行，請參閱 [`/goal`](/zh-TW/goal)。

14 10

15任務的範圍限於工作階段：它們存在於目前的對話中，當您啟動新的對話時就會停止。使用 `--resume` 或 `--continue` 繼續會恢復任何尚未[過期](#seven-day-expiry)的任務：在過去 7 天內建立的重複執行任務，或排程時間尚未到達的一次性任務。對於獨立於任何工作階段而存在的排程，請使用 [Routines](/zh-TW/routines) 在 Anthropic 管理的基礎設施上建立例行程序、設定 [Desktop 排程任務](/zh-TW/desktop-scheduled-tasks)，或使用 [GitHub Actions](/zh-TW/github-actions)。11任務的範圍限於工作階段：它們存在於目前的對話中，當您啟動新的對話時就會停止。使用 `--resume` 或 `--continue` 繼續會恢復任何尚未[過期](#seven-day-expiry)的任務：在過去 7 天內建立的重複執行任務，或排程時間尚未到達的一次性任務。對於獨立於任何工作階段而存在的排程，請使用 [Routines](/zh-TW/routines) 在 Anthropic 管理的基礎設施上建立例行程序、設定 [Desktop 排程任務](/zh-TW/desktop-scheduled-tasks)，或使用 [GitHub Actions](/zh-TW/github-actions)。

server-managed-settings.md +0 −1

Details

22 22

23* Claude for Teams 或 Claude for Enterprise 方案23* Claude for Teams 或 Claude for Enterprise 方案

24* 您的 Claude 組織中的擁有者或主要擁有者角色，以檢視和編輯配置24* 您的 Claude 組織中的擁有者或主要擁有者角色，以檢視和編輯配置

~~25* Claude for Teams 的 Claude Code 版本 2.1.38 或更新版本，或 Claude for Enterprise 的版本 2.1.30 或更新版本~~

26* 對 `api.anthropic.com` 的網路存取25* 對 `api.anthropic.com` 的網路存取

27 26

28<h2 id="choose-between-server-managed-and-endpoint-managed-settings">27<h2 id="choose-between-server-managed-and-endpoint-managed-settings">

settings.md +6 −10

Details

214 214

215| 金鑰 | 說明 | 範例 |215| 金鑰 | 說明 | 範例 |

216| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |216| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

217| `advisorModel` | {/* min-version: 2.1.98 */}伺服器端 [advisor tool](/zh-TW/advisor) 的模型。接受模型別名，例如 `"opus"`、`"sonnet"` 或 `"fable"`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。當您執行 `/advisor` 時自動寫入。取消設定以停用 advisor。需要 Claude Code v2.1.98 或更新版本 | `"opus"` |217| `advisorModel` | 伺服器端 [advisor tool](/zh-TW/advisor) 的模型。接受模型別名，例如 `"opus"`、`"sonnet"` 或 `"fable"`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。當您執行 `/advisor` 時自動寫入。取消設定以停用 advisor | `"opus"` |

218| `agent` | 將主執行緒作為命名 subagent 執行，並為從 `claude agents` 分派的工作階段設定預設 agent。應用該 subagent 的系統提示、工具限制和模型。請參閱[明確叫用 subagents](/zh-TW/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |218| `agent` | 將主執行緒作為命名 subagent 執行，並為從 `claude agents` 分派的工作階段設定預設 agent。應用該 subagent 的系統提示、工具限制和模型。請參閱[明確叫用 subagents](/zh-TW/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**預設**：`false`。當[遠端控制](/zh-TW/remote-control)已連線時，允許 Claude 主動傳送推播通知到您的手機，例如當長時間工作完成時。在 `/config` 中顯示為**Claude 決定時推播**。請參閱[行動推播通知](/zh-TW/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更新版本 | `true` |219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**預設**：`false`。當[遠端控制](/zh-TW/remote-control)已連線時，允許 Claude 主動傳送推播通知到您的手機，例如當長時間工作完成時。在 `/config` 中顯示為**Claude 決定時推播**。請參閱[行動推播通知](/zh-TW/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更新版本 | `true` |

242| `axScreenReader` | {/* min-version: 2.1.181 */}渲染螢幕閱讀器友善的輸出：沒有裝飾邊框或動畫的平面文字。螢幕閱讀器模式始終使用經典渲染器，因此在其使用中時 `tui` 設定無效。[`CLAUDE_AX_SCREEN_READER`](/zh-TW/env-vars) 環境變數和 [`--ax-screen-reader`](/zh-TW/cli-reference#cli-flags) 旗標優先。需要 Claude Code v2.1.181 或更新版本 | `true` |242| `axScreenReader` | {/* min-version: 2.1.181 */}渲染螢幕閱讀器友善的輸出：沒有裝飾邊框或動畫的平面文字。螢幕閱讀器模式始終使用經典渲染器，因此在其使用中時 `tui` 設定無效。附加的[背景工作階段](/zh-TW/agent-view)仍會全螢幕渲染。[`CLAUDE_AX_SCREEN_READER`](/zh-TW/env-vars) 環境變數和 [`--ax-screen-reader`](/zh-TW/cli-reference#cli-flags) 旗標優先。需要 Claude Code v2.1.181 或更新版本 | `true` |

243| `blockedMarketplaces` | （Managed 設定僅限）marketplace 來源的黑名單。在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行，因此在設定政策之前新增的 marketplace 無法用於擷取 plugins。在下載前檢查被阻止的來源，因此它們永遠不會接觸檔案系統。請參閱 [Managed marketplace 限制](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |243| `blockedMarketplaces` | （Managed 設定僅限）marketplace 來源的黑名單。在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行，因此在設定政策之前新增的 marketplace 無法用於擷取 plugins。在下載前檢查被阻止的來源，因此它們永遠不會接觸檔案系統。請參閱 [Managed marketplace 限制](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

244| `browserExternalPageTools` | （Managed 設定僅限）設定為 `"disabled"` 以防止 Claude 使用工具讀取或作用於桌面應用程式[瀏覽器窗格](/zh-TW/desktop#browse-external-sites)中的外部頁面。使用者仍可自行導覽到外部網站，本機開發伺服器預覽不受影響 | `"disabled"` |244| `browserExternalPageTools` | （Managed 設定僅限）設定為 `"disabled"` 以防止 Claude 使用工具讀取或作用於桌面應用程式[瀏覽器窗格](/zh-TW/desktop#browse-external-sites)中的外部頁面。使用者仍可自行導覽到外部網站，本機開發伺服器預覽不受影響 | `"disabled"` |

245| `channelsEnabled` | （Managed 設定僅限）允許組織使用[頻道](/zh-TW/channels)。在 claude.ai Team 和 Enterprise 方案上，當此設定未設定或為 `false` 時，頻道會被阻止。對於使用 API 金鑰驗證的 [Anthropic Console](/zh-TW/authentication#claude-console-authentication) 帳戶，除非您的組織部署 managed 設定（在這種情況下此金鑰必須設定為 `true`），否則預設允許頻道 | `true` |245| `channelsEnabled` | （Managed 設定僅限）允許組織使用[頻道](/zh-TW/channels)。在 claude.ai Team 和 Enterprise 方案上，當此設定未設定或為 `false` 時，頻道會被阻止。對於使用 API 金鑰驗證的 [Anthropic Console](/zh-TW/authentication#claude-console-authentication) 帳戶，除非您的組織部署 managed 設定（在這種情況下此金鑰必須設定為 `true`），否則預設允許頻道 | `true` |

255| `disableAutoMode` | 設定為 `"disable"` 以防止[自動模式](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)被啟用。從 `Shift+Tab` 循環中移除 `auto` 並在啟動時拒絕 `--permission-mode auto`。在[managed 設定](/zh-TW/permissions#managed-settings)中最有用，使用者無法覆蓋它 | `"disable"` |255| `disableAutoMode` | 設定為 `"disable"` 以防止[自動模式](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)被啟用。從 `Shift+Tab` 循環中移除 `auto` 並在啟動時拒絕 `--permission-mode auto`。在[managed 設定](/zh-TW/permissions#managed-settings)中最有用，使用者無法覆蓋它 | `"disable"` |

256| `disableBundledSkills` | 設定為 `true` 以停用隨 Claude Code 一起提供的 [skills](/zh-TW/skills) 和工作流程：bundled skills 和工作流程會被完全移除，而內建斜線命令（如 `/init`）保持可輸入但對模型隱藏。來自 plugins、`.claude/skills/` 和 `.claude/commands/` 的 Skills 不受影響。等同於將 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` 設定為 `1` | `true` |256| `disableBundledSkills` | 設定為 `true` 以停用隨 Claude Code 一起提供的 [skills](/zh-TW/skills) 和工作流程：bundled skills 和工作流程會被完全移除，而內建斜線命令（如 `/init`）保持可輸入但對模型隱藏。`/doctor` 保持可輸入，如內建命令；改用 [`DISABLE_DOCTOR_COMMAND`](/zh-TW/env-vars) 隱藏它。來自 plugins、`.claude/skills/` 和 `.claude/commands/` 的 Skills 不受影響。等同於將 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` 設定為 `1` | `true` |

257| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}停用 [claude.ai MCP connectors](/zh-TW/mcp#use-mcp-servers-from-claude-ai)，使其不會自動擷取或連線。在任何設定範圍中設定。任何來源中的 `true` 優先，因此簽入的專案 `.claude/settings.json` 可以選擇退出雲端 connectors，但專案層級的 `false` 無法覆蓋使用者或政策層級的 `true`。透過 `--mcp-config` 明確傳遞的 Servers 不受影響。若要拒絕個別 connectors 而不是所有 connectors，請改用 [`deniedMcpServers`](/zh-TW/managed-mcp)。需要 Claude Code v2.1.182 或更新版本 | `true` |257| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}停用 [claude.ai MCP connectors](/zh-TW/mcp#use-mcp-servers-from-claude-ai)，使其不會自動擷取或連線。在任何設定範圍中設定。任何來源中的 `true` 優先，因此簽入的專案 `.claude/settings.json` 可以選擇退出雲端 connectors，但專案層級的 `false` 無法覆蓋使用者或政策層級的 `true`。透過 `--mcp-config` 明確傳遞的 Servers 不受影響。若要拒絕個別 connectors 而不是所有 connectors，請改用 [`deniedMcpServers`](/zh-TW/managed-mcp)。需要 Claude Code v2.1.182 或更新版本 | `true` |

258| `disableDeepLinkRegistration` | 設定為 `"disable"` 以防止 Claude Code 在啟動時向作業系統註冊 `claude-cli://` 協議處理程式。[深層連結](/zh-TW/deep-links)讓外部工具透過預先填入的提示開啟 Claude Code 工作階段。在協議處理程式註冊受限或單獨管理的環境中很有用 | `"disable"` |258| `disableDeepLinkRegistration` | 設定為 `"disable"` 以防止 Claude Code 在啟動時向作業系統註冊 `claude-cli://` 協議處理程式。[深層連結](/zh-TW/deep-links)讓外部工具透過預先填入的提示開啟 Claude Code 工作階段。在協議處理程式註冊受限或單獨管理的環境中很有用 | `"disable"` |

307| `showThinkingSummaries` | **預設**：`false`。在互動式工作階段中顯示[擴展思考](/zh-TW/model-config#extended-thinking)摘要。未設定或 `false` 時，思考區塊由 API 編輯並顯示為摺疊的存根。編輯只會改變您看到的內容，而不是模型生成的內容：若要減少思考支出，請[降低預算或停用思考](/zh-TW/model-config#extended-thinking)。此設定在非互動模式（`-p`）、Agent SDK 或 IDE 擴充功能（例如 VS Code）中無效 | `true` |307| `showThinkingSummaries` | **預設**：`false`。在互動式工作階段中顯示[擴展思考](/zh-TW/model-config#extended-thinking)摘要。未設定或 `false` 時，思考區塊由 API 編輯並顯示為摺疊的存根。編輯只會改變您看到的內容，而不是模型生成的內容：若要減少思考支出，請[降低預算或停用思考](/zh-TW/model-config#extended-thinking)。此設定在非互動模式（`-p`）、Agent SDK 或 IDE 擴充功能（例如 VS Code）中無效 | `true` |

309| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**預設**：`0.01`。為 Claude 每輪看到的[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)保留的模型內容視窗分數。當清單超過預算時，最少使用的 skills 的描述會摺疊為裸名稱，以便 Claude 仍可叫用它們，但不會看到原因。提高以保持更多描述可見，代價是每輪更多內容。`/doctor` 顯示目前的截斷計數和受影響的 skills。需要 Claude Code v2.1.105 或更新版本 | `0.02` |309| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**預設**：`0.01`。為 Claude 每輪看到的[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)保留的模型內容視窗分數。當清單超過預算時，最少使用的 skills 的描述會摺疊為裸名稱，以便 Claude 仍可叫用它們，但不會看到原因。提高以保持更多描述可見，代價是每輪更多內容。`/doctor` 估計清單成本對預算。需要 Claude Code v2.1.105 或更新版本 | `0.02` |

310| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**預設**：`1536`。[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)中每個 skill 的字元上限，Claude 每輪看到的 `description` 和 `when_to_use` 文字的組合。超過此長度的文字會被截斷。提高以保持長描述完整，代價是每輪更多內容；降低以在 [`skillListingBudgetFraction`](#available-settings) 下適應更多 skills。需要 Claude Code v2.1.105 或更新版本 | `2048` |310| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**預設**：`1536`。[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)中每個 skill 的字元上限，Claude 每輪看到的 `description` 和 `when_to_use` 文字的組合。超過此長度的文字會被截斷。提高以保持長描述完整，代價是每輪更多內容；降低以在 [`skillListingBudgetFraction`](#available-settings) 下適應更多 skills。需要 Claude Code v2.1.105 或更新版本 | `2048` |

311| `skillOverrides` | {/* min-version: 2.1.129 */}按 skill 名稱鍵入的每個 skill 可見性覆蓋。值為 `"on"`、`"name-only"`、`"user-invocable-only"` 或 `"off"`。讓您隱藏或摺疊 skill 而無需編輯其 SKILL.md。不適用於 plugin skills，這些由 `/plugin` 管理。`/skills` 功能表將這些寫入 `.claude/settings.local.json`。請參閱[從設定覆蓋 skill 可見性](/zh-TW/skills#override-skill-visibility-from-settings)。需要 Claude Code v2.1.129 或更新版本 | `{"legacy-context": "name-only", "deploy": "off"}` |311| `skillOverrides` | {/* min-version: 2.1.129 */}按 skill 名稱鍵入的每個 skill 可見性覆蓋。值為 `"on"`、`"name-only"`、`"user-invocable-only"` 或 `"off"`。讓您隱藏或摺疊 skill 而無需編輯其 SKILL.md。不適用於 plugin skills，這些由 `/plugin` 管理。`/skills` 功能表將這些寫入 `.claude/settings.local.json`。請參閱[從設定覆蓋 skill 可見性](/zh-TW/skills#override-skill-visibility-from-settings)。需要 Claude Code v2.1.129 或更新版本 | `{"legacy-context": "name-only", "deploy": "off"}` |

312| `skipWebFetchPreflight` | 跳過[WebFetch 網域安全檢查](/zh-TW/data-usage#webfetch-domain-safety-check)，該檢查在擷取前將每個請求的主機名稱傳送到 `api.anthropic.com`。在阻止流量到 Anthropic 的環境中設定為 `true`，例如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 部署，具有限制性的出站。跳過時，WebFetch 嘗試任何 URL 而不諮詢黑名單 | `true` |312| `skipWebFetchPreflight` | 跳過[WebFetch 網域安全檢查](/zh-TW/data-usage#webfetch-domain-safety-check)，該檢查在擷取前將每個請求的主機名稱傳送到 `api.anthropic.com`。在阻止流量到 Anthropic 的環境中設定為 `true`，例如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 部署，具有限制性的出站。跳過時，WebFetch 嘗試任何 URL 而不諮詢黑名單 | `true` |

323| `theme` | {/* min-version: 2.1.119 */}**預設**：`"dark"`。介面的色彩主題：`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"` 或自訂主題參考，例如 `"custom:<slug>"` 或 `"custom:<plugin-name>:<slug>"`。請參閱[建立自訂主題](/zh-TW/terminal-config#create-a-custom-theme)。在 `/config` 中顯示為**主題** | `"dark"` |323| `theme` | {/* min-version: 2.1.119 */}**預設**：`"dark"`。介面的色彩主題：`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"` 或自訂主題參考，例如 `"custom:<slug>"` 或 `"custom:<plugin-name>:<slug>"`。請參閱[建立自訂主題](/zh-TW/terminal-config#create-a-custom-theme)。在 `/config` 中顯示為**主題** | `"dark"` |

324| `tui` | 終端機 UI 渲染器。使用 `"fullscreen"` 以取得無閃爍[替代螢幕渲染器](/zh-TW/fullscreen)，具有虛擬化捲軸。使用 `"default"` 以取得經典主螢幕渲染器。透過 `/tui` 設定。您也可以設定 [`CLAUDE_CODE_NO_FLICKER`](/zh-TW/env-vars) 環境變數。背景工作階段從[代理檢視](/zh-TW/agent-view)開啟時，無論此設定如何，始終使用全螢幕渲染器 | `"fullscreen"` |324| `tui` | 終端機 UI 渲染器。使用 `"fullscreen"` 以取得無閃爍[替代螢幕渲染器](/zh-TW/fullscreen)，具有虛擬化捲軸。使用 `"default"` 以取得經典主螢幕渲染器。透過 `/tui` 設定。您也可以設定 [`CLAUDE_CODE_NO_FLICKER`](/zh-TW/env-vars) 環境變數。背景工作階段從[代理檢視](/zh-TW/agent-view)開啟時，無論此設定如何，始終使用全螢幕渲染器 | `"fullscreen"` |

325| `ultracode` | 為工作階段開啟 [ultracode](/zh-TW/workflows#let-claude-decide-with-ultracode)。此金鑰不從 `settings.json` 讀取。透過 `/effort ultracode`、`--settings` 或 Agent SDK 控制請求設定 | `true` |325| `ultracode` | 為工作階段開啟 [ultracode](/zh-TW/workflows#let-claude-decide-with-ultracode)。此金鑰不從 `settings.json` 讀取。透過 `/effort ultracode`、`--settings` 或 Agent SDK 控制請求設定。{/* min-version: 2.1.203 */}若要以 ultracode 已開啟的狀態啟動工作階段，請使用 `claude --effort ultracode` 啟動，需要 Claude Code v2.1.203 或更新版本 | `true` |

327| `verbose` | {/* min-version: 2.1.119 */}**預設**：`false`。顯示完整工具輸出而不是截斷摘要。在 `/config` 中顯示為**詳細輸出**。`--verbose` 旗標會覆蓋此設定以進行一個工作階段 | `true` |327| `verbose` | {/* min-version: 2.1.119 */}**預設**：`false`。顯示完整工具輸出而不是截斷摘要。在 `/config` 中顯示為**詳細輸出**。`--verbose` 旗標會覆蓋此設定以進行一個工作階段 | `true` |

871* `hostPattern`：正規表達式模式以符合 marketplace 主機（使用 `hostPattern`）871* `hostPattern`：正規表達式模式以符合 marketplace 主機（使用 `hostPattern`）

872* `settings`：直接在 settings.json 中宣告的內嵌 marketplace，無需單獨的託管儲存庫（使用 `name` 和 `plugins`）872* `settings`：直接在 settings.json 中宣告的內嵌 marketplace，無需單獨的託管儲存庫（使用 `name` 和 `plugins`）

873 873

874`git` 來源類型適用於任何 git 託管服務，包括自託管 GitLab 和 Bitbucket。Claude Code 使用與該機器上 `git clone` 相同的驗證來複製儲存庫：已設定的認證助手、SSH 金鑰或主機特定的 token 環境變數。請參閱[私有儲存庫](/zh-TW/plugin-marketplaces#private-repositories)以了解設定詳細資訊。874`git` 來源類型適用於任何 git 託管服務，包括自託管 GitLab 和 Bitbucket。Claude Code 使用與該機器上 `git clone` 相同的驗證來複製儲存庫：已設定的認證助手或 SSH 金鑰。提供者 token（例如 `GITHUB_TOKEN`）只有透過讀取它的認證助手才會生效。請參閱[私有儲存庫](/zh-TW/plugin-marketplaces#private-repositories)以了解設定詳細資訊。

875 875

876對於 `github` 和 `git` 來源，在 `source` 物件內設定 `"skipLfs": true`（與 `repo` 或 `url` 並列）以在 Claude Code 複製或更新 marketplace 儲存庫時跳過 Git LFS 下載。LFS 指標檔案保持為指標而不是下載其內容。當儲存庫包含與 plugin 內容無關的大型 LFS 物件時，請使用此選項。{/* min-version: 2.1.153 */}需要 Claude Code v2.1.153 或更新版本。876對於 `github` 和 `git` 來源，在 `source` 物件內設定 `"skipLfs": true`（與 `repo` 或 `url` 並列）以在 Claude Code 複製或更新 marketplace 儲存庫時跳過 Git LFS 下載。LFS 指標檔案保持為指標而不是下載其內容。當儲存庫包含與 plugin 內容無關的大型 LFS 物件時，請使用此選項。{/* min-version: 2.1.153 */}需要 Claude Code v2.1.153 或更新版本。

877 877

1158 1158

1159**Managed 設定僅限**：阻止 skills、agents、hooks 和 MCP servers 來自使用者和專案來源，因此它們只能來自 plugins 或 managed 設定。將其與 `strictKnownMarketplaces` 結合以控制完整的自訂供應鏈：marketplace 白名單控制使用者可以安裝哪些 plugins，此設定阻止所有不來自 plugin 或 managed 設定的內容。1159**Managed 設定僅限**：阻止 skills、agents、hooks 和 MCP servers 來自使用者和專案來源，因此它們只能來自 plugins 或 managed 設定。將其與 `strictKnownMarketplaces` 結合以控制完整的自訂供應鏈：marketplace 白名單控制使用者可以安裝哪些 plugins，此設定阻止所有不來自 plugin 或 managed 設定的內容。

1160 1160

1161<Note>

1162 `strictPluginOnlyCustomization` 需要 Claude Code v2.1.82 或更新版本。較早的版本會忽略該鍵並繼續載入使用者和專案自訂，因此鎖定在用戶端更新之前不會強制執行。

1163</Note>

~~1164~~

1165該值要麼是 `true` 以鎖定所有四個表面，要麼是命名要鎖定的表面的陣列：1161該值要麼是 `true` 以鎖定所有四個表面，要麼是命名要鎖定的表面的陣列：

1166 1162

1167```json theme={null}1163```json theme={null}

sub-agents.md +3 −1

Details

926[Claude resumes the subagent with full context from previous conversation]926[Claude resumes the subagent with full context from previous conversation]

927```927```

928 928

929如果停止的 subagent 接收 `SendMessage`，它會自動在背景中恢復，無需新的 `Agent` 呼叫。929如果停止的 subagent 接收 `SendMessage`，它會自動在背景中恢復，無需新的 `Agent` 呼叫。同樣適用於 Claude 使用 `TaskStop` 工具停止的 subagent。

930

931{/* min-version: 2.1.191 */}自 v2.1.191 起，您自己停止的 subagent，使用 `/tasks` 中的 `x` 或 SDK `stop_task` 請求，不會自動恢復。`SendMessage` 呼叫返回拒絕，告訴 Claude 代理已被取消。在 subagent 面板中輸入該 subagent 的文字以自己恢復它，這會清除停止，以便稍後 `SendMessage` 呼叫可以再次自動恢復它。

930 932

931恢復會在相同 ID 下啟動代理的新執行，所以已經失敗或完成的 subagent 在任務列表和 Agent SDK 的任務事件中再次顯示為執行中。在 v2.1.205 之前，它在恢復的執行工作時保持顯示其較早的失敗或完成狀態。933恢復會在相同 ID 下啟動代理的新執行，所以已經失敗或完成的 subagent 在任務列表和 Agent SDK 的任務事件中再次顯示為執行中。在 v2.1.205 之前，它在恢復的執行工作時保持顯示其較早的失敗或完成狀態。

932 934

terminal-config.md +1 −1

Details

296 296

297如果顯示閃爍或捲動位置在 Claude 工作時跳躍，請切換到[全螢幕渲染模式](/zh-TW/fullscreen)。它繪製到終端機為全螢幕應用程式保留的單獨螢幕，而不是附加到您的正常捲動，這保持記憶體使用平穩並新增滑鼠支援以進行捲動和選擇。在此模式中，您使用滑鼠或 PageUp 在 Claude Code 內捲動，而不是使用您的終端機的原生捲動；請參閱[全螢幕頁面](/zh-TW/fullscreen#search-and-review-the-conversation)以瞭解如何搜尋和複製。297如果顯示閃爍或捲動位置在 Claude 工作時跳躍，請切換到[全螢幕渲染模式](/zh-TW/fullscreen)。它繪製到終端機為全螢幕應用程式保留的單獨螢幕，而不是附加到您的正常捲動，這保持記憶體使用平穩並新增滑鼠支援以進行捲動和選擇。在此模式中，您使用滑鼠或 PageUp 在 Claude Code 內捲動，而不是使用您的終端機的原生捲動；請參閱[全螢幕頁面](/zh-TW/fullscreen#search-and-review-the-conversation)以瞭解如何搜尋和複製。

298 298

299執行 `/tui fullscreen` 以在目前工作階段中切換，您的對話保持完整。若要使其成為預設值，請在啟動 Claude Code 之前設置 `CLAUDE_CODE_NO_FLICKER` 環境變數：299執行 `/tui fullscreen` 以切換並儲存偏好設定。您的對話會完整重新啟動，未來的工作階段會以全螢幕開始。您也可以在啟動 Claude Code 之前設置 `CLAUDE_CODE_NO_FLICKER` 環境變數：

300 300

301<CodeGroup>301<CodeGroup>

302 ```bash Bash and Zsh theme={null}302 ```bash Bash and Zsh theme={null}

tools-reference.md +1 −5

Details

39| `RemoteTrigger` | 在 claude.ai 上建立、更新、執行和列出 [Routines](/zh-TW/routines)。支援 `/schedule` 命令。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines 位於 claude.ai 上，需要 Pro、Max、Team 或 Enterprise 計畫，因此此工具無法從 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 存取 | 否 |39| `RemoteTrigger` | 在 claude.ai 上建立、更新、執行和列出 [Routines](/zh-TW/routines)。支援 `/schedule` 命令。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines 位於 claude.ai 上，需要 Pro、Max、Team 或 Enterprise 計畫，因此此工具無法從 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 存取 | 否 |

40| `ReportFindings` | 將程式碼審查結果報告為結構化清單，每個結果包含檔案、摘要和失敗情景，以便 Claude Code 可以呈現它們而不是將其列印為文字。當有效的程式碼審查指示告訴它時，Claude 會呼叫它。{/* min-version: 2.1.196 */}需要 Claude Code v2.1.196 或更新版本。{/* min-version: 2.1.199 */}自 v2.1.199 起，結果也可以攜帶選擇性的 `category` slug，例如 `correctness` 或 `test-coverage`，顯示在呈現清單中的檔案位置旁邊 | 否 |40| `ReportFindings` | 將程式碼審查結果報告為結構化清單，每個結果包含檔案、摘要和失敗情景，以便 Claude Code 可以呈現它們而不是將其列印為文字。當有效的程式碼審查指示告訴它時，Claude 會呼叫它。{/* min-version: 2.1.196 */}需要 Claude Code v2.1.196 或更新版本。{/* min-version: 2.1.199 */}自 v2.1.199 起，結果也可以攜帶選擇性的 `category` slug，例如 `correctness` 或 `test-coverage`，顯示在呈現清單中的檔案位置旁邊 | 否 |

41| `ScheduleWakeup` | 重新排程 [自主進行的 `/loop`](/zh-TW/scheduled-tasks#let-claude-choose-the-interval) 的下一次迭代。Claude 在每次迭代結束時呼叫此工具，以選擇下一次執行的時間，範圍在一分鐘到一小時之間；您不需要直接呼叫它。若要改為結束迴圈，Claude 會以 `stop: true` 呼叫它，這會取消待處理的喚醒。{/* min-version: 2.1.202 */}`stop` 欄位需要 Claude Code v2.1.202 或更新版本。待處理的喚醒會出現在 [Stop hook input](/zh-TW/hooks#stop-input) 的 `session_crons` 中。{/* plan-availability: feature=loop-dynamic providers=anthropic */}在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用，其中沒有間隔的 `/loop` 提示會改為按固定時間表執行 | 否 |41| `ScheduleWakeup` | 重新排程 [自主進行的 `/loop`](/zh-TW/scheduled-tasks#let-claude-choose-the-interval) 的下一次迭代。Claude 在每次迭代結束時呼叫此工具，以選擇下一次執行的時間，範圍在一分鐘到一小時之間；您不需要直接呼叫它。若要改為結束迴圈，Claude 會以 `stop: true` 呼叫它，這會取消待處理的喚醒。{/* min-version: 2.1.202 */}`stop` 欄位需要 Claude Code v2.1.202 或更新版本。待處理的喚醒會出現在 [Stop hook input](/zh-TW/hooks#stop-input) 的 `session_crons` 中。{/* plan-availability: feature=loop-dynamic providers=anthropic */}在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用，其中沒有間隔的 `/loop` 提示會改為按固定時間表執行 | 否 |

42| `SendMessage` | 傳送訊息給 [agent team](/zh-TW/agent-teams) 隊友，或按 agent ID 或名稱 [恢復 subagent](/zh-TW/sub-agents#resume-subagents)。已停止的 subagents 會在背景中自動恢復。結構化的團隊協議訊息需要 agent teams。接收者永遠不會將來自另一個 agent 的訊息視為您的同意或批准。{/* min-version: 2.1.198 */}自 v2.1.198 起，subagent 將來自啟動它的 agent 的訊息視為正常任務指示，而不是對等請求。{/* min-version: 2.1.199 */}自 v2.1.199 起，傳送到現在解析為與對話中較早時間不同的 agent 的名稱會被拒絕而不是傳遞；請參閱 [恢復 subagents](/zh-TW/sub-agents#resume-subagents) | 否 |42| `SendMessage` | 傳送訊息給 [agent team](/zh-TW/agent-teams) 隊友，或按 agent ID 或名稱 [恢復 subagent](/zh-TW/sub-agents#resume-subagents)。已完成的 subagent 會在背景中自動恢復；您從 `/tasks` 停止的 subagent 不會，且呼叫會傳回拒絕。結構化的團隊協議訊息需要 agent teams。接收者永遠不會將來自另一個 agent 的訊息視為您的同意或批准。{/* min-version: 2.1.198 */}自 v2.1.198 起，subagent 將來自啟動它的 agent 的訊息視為正常任務指示，而不是對等請求。{/* min-version: 2.1.199 */}自 v2.1.199 起，傳送到現在解析為與對話中較早時間不同的 agent 的名稱會被拒絕而不是傳遞；請參閱 [恢復 subagents](/zh-TW/sub-agents#resume-subagents) | 否 |

43| `SendUserFile` | 將工作階段中的檔案傳送給您，並附上選擇性標題，以便生成的報告、圖表、螢幕擷取畫面或建置的成品可以到達您的裝置，而不是只在文字記錄中提及。{/* min-version: 2.1.196 */}自 v2.1.196 起，選擇性的 `display` 輸入控制呈現方式：`render` 在用戶端中內聯開啟檔案，`attach` 僅顯示下載卡片，未設定時用戶端會根據檔案類型決定。當連接了 [Remote Control](/zh-TW/remote-control) 用戶端或工作階段在受管雲端環境（例如 [Claude Code on the web](/zh-TW/claude-code-on-the-web)）中執行時可用。傳遞透過 Anthropic 託管的基礎設施執行，因此該工具在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用 | 否 |43| `SendUserFile` | 將工作階段中的檔案傳送給您，並附上選擇性標題，以便生成的報告、圖表、螢幕擷取畫面或建置的成品可以到達您的裝置，而不是只在文字記錄中提及。{/* min-version: 2.1.196 */}自 v2.1.196 起，選擇性的 `display` 輸入控制呈現方式：`render` 在用戶端中內聯開啟檔案，`attach` 僅顯示下載卡片，未設定時用戶端會根據檔案類型決定。當連接了 [Remote Control](/zh-TW/remote-control) 用戶端或工作階段在受管雲端環境（例如 [Claude Code on the web](/zh-TW/claude-code-on-the-web)）中執行時可用。傳遞透過 Anthropic 託管的基礎設施執行，因此該工具在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用 | 否 |

44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}上傳 `ONBOARDING.md` 並傳回隊友可以在 Claude Code 中開啟的分享連結。在撰寫指南後從 `/team-onboarding` 呼叫。適用於 Pro、Max、Team 和 Enterprise 計畫上的 claude.ai 訂閱者 | 是 |44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}上傳 `ONBOARDING.md` 並傳回隊友可以在 Claude Code 中開啟的分享連結。在撰寫指南後從 `/team-onboarding` 呼叫。適用於 Pro、Max、Team 和 Enterprise 計畫上的 claude.ai 訂閱者 | 是 |

45| `Skill` | 在主對話中執行 [skill](/zh-TW/skills#control-who-invokes-a-skill) | 是 |45| `Skill` | 在主對話中執行 [skill](/zh-TW/skills#control-who-invokes-a-skill) | 是 |

204 Monitor 工具204 Monitor 工具

205</h2>205</h2>

206 206

207<Note>

208 Monitor 工具需要 Claude Code v2.1.98 或更新版本。

209</Note>

~~210~~

211Monitor 工具讓 Claude 在背景監視某些內容，並在其變更時做出反應，而無需暫停對話。要求 Claude：207Monitor 工具讓 Claude 在背景監視某些內容，並在其變更時做出反應，而無需暫停對話。要求 Claude：

212 208

213* 追蹤日誌檔案並在錯誤出現時標記209* 追蹤日誌檔案並在錯誤出現時標記

ultraplan.md +1 −1

Details

7> 從您的 CLI 開始規劃，在網路上的 Claude Code 中草擬，然後遠端執行或回到您的終端機執行7> 從您的 CLI 開始規劃，在網路上的 Claude Code 中草擬，然後遠端執行或回到您的終端機執行

8 8

9<Note>9<Note>

~~10 Ultraplan 處於研究預覽階段，需要 Claude Code v2.1.91 或更新版本。行為和功能可能會根據反饋而改變。~~10 Ultraplan 處於研究預覽階段。行為和功能可能會根據反饋而改變。

11</Note>11</Note>

12 12

13Ultraplan 將規劃任務從您的本機 CLI 交給在 [plan mode](/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode) 中執行的 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 工作階段。Claude 在雲端草擬計畫，同時您可以繼續在終端機中工作。當計畫準備好時，您可以在瀏覽器中開啟它來評論特定部分、要求修訂，並選擇在何處執行它。13Ultraplan 將規劃任務從您的本機 CLI 交給在 [plan mode](/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode) 中執行的 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 工作階段。Claude 在雲端草擬計畫，同時您可以繼續在終端機中工作。當計畫準備好時，您可以在瀏覽器中開啟它來評論特定部分、要求修訂，並選擇在何處執行它。

ultrareview.md +1 −1

Details

7> 使用 /code-review ultra 在雲端執行深度多代理程式碼審查，在合併前尋找並驗證錯誤。7> 使用 /code-review ultra 在雲端執行深度多代理程式碼審查，在合併前尋找並驗證錯誤。

8 8

9<Note>9<Note>

10 Ultrareview 是 Claude Code v2.1.86 及更新版本中提供的研究預覽功能。該功能、定價和可用性可能會根據反饋而變更。該命令現在以 `/code-review ultra` 的方式調用，而 `/ultrareview` 仍保留為別名。10 Ultrareview 是研究預覽功能。該功能、定價和可用性可能會根據反饋而變更。該命令現在以 `/code-review ultra` 的方式調用，而 `/ultrareview` 仍保留為別名。

11</Note>11</Note>

12 12

13Ultrareview 是在 Claude Code 網路基礎設施上執行的深度程式碼審查。當您執行 `/code-review ultra` 時，Claude Code 會在遠端沙箱中啟動一群審查代理程式，以尋找您分支或拉取請求中的錯誤。13Ultrareview 是在 Claude Code 網路基礎設施上執行的深度程式碼審查。當您執行 `/code-review ultra` 時，Claude Code 會在遠端沙箱中啟動一群審查代理程式，以尋找您分支或拉取請求中的錯誤。

voice-dictation.md +1 −1

Details

9在 Claude Code CLI 中說出您的提示，而不是輸入它們。您的語音會即時轉錄到提示輸入中，因此您可以在同一條訊息中混合語音和輸入。使用 `/voice` 啟用聽寫，然後在說話時按住一個鍵或點擊一次開始，再點擊一次發送。9在 Claude Code CLI 中說出您的提示，而不是輸入它們。您的語音會即時轉錄到提示輸入中，因此您可以在同一條訊息中混合語音和輸入。使用 `/voice` 啟用聽寫，然後在說話時按住一個鍵或點擊一次開始，再點擊一次發送。

10 10

11<Note>11<Note>

~~12 語音聽寫需要 Claude Code v2.1.69 或更高版本。點擊模式需要 v2.1.116 或更高版本。使用 `claude --version` 檢查您的版本。~~12 點擊模式需要 Claude Code v2.1.116 或更高版本。使用 `claude --version` 檢查您的版本。

Details

7> 從桌面應用程式的內建瀏覽器瀏覽外部網站、使用 /doctor 執行完整設定檢查，以及取得自動模式文字記錄保護和代理程式檢視升級。7> 從桌面應用程式的內建瀏覽器瀏覽外部網站、使用 /doctor 執行完整設定檢查，以及取得自動模式文字記錄保護和代理程式檢視升級。

8 8

9<div className="digest-meta">9<div className="digest-meta">

~~10 <span>版本 <a href="/docs/zh-TW/changelog#2-1-202">v2.1.202 → v2.1.206</a></span>~~10 <span>版本 <a href="/docs/en/changelog#2-1-202">v2.1.202 → v2.1.206</a></span>

11 <span>2 項功能 · 7 月 6–10 日</span>11 <span>2 項功能 · 7 月 6–10 日</span>

12</div>12</div>

13 13

60 </div>60 </div>

61</div>61</div>

62 62

~~63[v2.1.202–v2.1.206 的完整變更日誌 →](/zh-TW/changelog#2-1-202)~~63[v2.1.202–v2.1.206 的完整變更日誌 →](/en/changelog#2-1-202)

Documentation 2026-07-11 19:03 UTC to 2026-07-13 23:57 UTC