Documentation 2026-11-10 21:57 UTC to 2026-11-11 22:59 UTC

96| [Managed policy CLAUDE.md](https://code.claude.com/docs/zh-TW/memory.md#deploy-organization-wide-claude-md) | 為 Claude 提供的組織範圍行為指引，而非由用戶端強制執行的規則 | 受管政策路徑中的檔案 |96| [Managed policy CLAUDE.md](https://code.claude.com/docs/zh-TW/memory.md#deploy-organization-wide-claude-md) | 為 Claude 提供的組織範圍行為指引，而非由用戶端強制執行的規則 | 受管政策路徑中的檔案 |

97| [MCP server control](https://code.claude.com/docs/zh-TW/managed-mcp.md) | 限制使用者可以新增或連接的 MCP 伺服器、部署固定集合，或為每個使用者提供遠端伺服器以及他們自己的伺服器 | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、`managedMcpServers`，或已部署的 `managed-mcp.json` 檔案 |97| [MCP server control](https://code.claude.com/docs/zh-TW/managed-mcp.md) | 限制使用者可以新增或連接的 MCP 伺服器、部署固定集合，或為每個使用者提供遠端伺服器以及他們自己的伺服器 | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、`managedMcpServers`，或已部署的 `managed-mcp.json` 檔案 |

98| [Plugin marketplace control](https://code.claude.com/docs/zh-TW/plugins/org.md#restrict-what-users-can-install) | 限制使用者可以新增和安裝的市集來源，並拒絕為單次執行側載外掛程式、agent 和 MCP 伺服器的 CLI 旗標。阻止[`command` 外掛程式來源](https://code.claude.com/docs/zh-TW/plugins/marketplace-reference#command-plugin-source)，並以允許清單指定哪些市集的外掛程式可以在終端機中被建議 | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`disableCommandPluginSources`、`pluginSuggestionMarketplaces` |98| [Plugin marketplace control](https://code.claude.com/docs/zh-TW/plugins/org.md#restrict-what-users-can-install) | 限制使用者可以新增和安裝的市集來源，並拒絕為單次執行側載外掛程式、agent 和 MCP 伺服器的 CLI 旗標。阻止[`command` 外掛程式來源](https://code.claude.com/docs/zh-TW/plugins/marketplace-reference#command-plugin-source)，並以允許清單指定哪些市集的外掛程式可以在終端機中被建議 | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`disableCommandPluginSources`、`pluginSuggestionMarketplaces` |

99| [Customization lockdown](https://code.claude.com/docs/zh-TW/settings-reference.md#strictpluginonlycustomization) | 阻止 skills、agents、hooks 和 MCP 伺服器來自使用者和專案來源，使其只能來自外掛程式或受管設定。鎖定 skills 也會停止[您的開發人員在 claude.ai 上啟用的 skills](https://code.claude.com/docs/zh-TW/skills.md#where-synced-skills-load)同步 | `strictPluginOnlyCustomization` |99| [Customization lockdown](https://code.claude.com/docs/zh-TW/settings-reference.md#strictpluginonlycustomization) | 阻止來自使用者和專案來源的 skills、agent、hook 和 MCP 伺服器。鎖定 skills 也會停止[您的開發人員在 claude.ai 上啟用的 skills](https://code.claude.com/docs/zh-TW/skills.md#where-synced-skills-load)同步 | `strictPluginOnlyCustomization` |

100| [Disable claude.ai sync](https://code.claude.com/docs/zh-TW/settings-reference.md#syncclaudeaiskills) | 停止 Claude Code 載入[skills](https://code.claude.com/docs/zh-TW/skills.md#how-synced-skills-behave)和[外掛程式](https://code.claude.com/docs/zh-TW/plugins/loading.md#synced-plugins)您的開發人員在 claude.ai 上啟用。如果您為組織關閉 claude.ai 上的 Skills，Claude Code 會停止同步兩者，在 v2.1.273 或更新版本上，它也會移除已同步的。若要在不關閉 Skills 的情況下停止其中任一個，請在受管設定中將其鍵設定為 `false` | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |100| [Disable claude.ai sync](https://code.claude.com/docs/zh-TW/settings-reference.md#syncclaudeaiskills) | 停止 Claude Code 載入[skills](https://code.claude.com/docs/zh-TW/skills.md#how-synced-skills-behave)和[外掛程式](https://code.claude.com/docs/zh-TW/plugins/loading.md#synced-plugins)您的開發人員在 claude.ai 上啟用。如果您為組織關閉 claude.ai 上的 Skills，Claude Code 會停止同步兩者，在 v2.1.273 或更新版本上，它也會移除已同步的。若要在不關閉 Skills 的情況下停止其中任一個，請在受管設定中將其鍵設定為 `false` | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |

101| [Hook restrictions](https://code.claude.com/docs/zh-TW/settings-reference.md#allowmanagedhooksonly) | 限制哪些 hooks 執行並限制 HTTP hook URL；請參閱[在 `allowManagedHooksOnly` 下執行的內容](https://code.claude.com/docs/zh-TW/settings-reference#what-runs-under-allowmanagedhooksonly)以了解完整的效果清單 | `allowManagedHooksOnly`、`allowedHttpHookUrls` |101| [Hook restrictions](https://code.claude.com/docs/zh-TW/settings-reference.md#allowmanagedhooksonly) | 限制哪些 hooks 執行並限制 HTTP hook URL；請參閱[在 `allowManagedHooksOnly` 下執行的內容](https://code.claude.com/docs/zh-TW/settings-reference#what-runs-under-allowmanagedhooksonly)以了解完整的效果清單 | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

102| [Login enforcement](https://code.claude.com/docs/zh-TW/settings-reference.md#forceloginmethod) | 限制登入為特定方法或 Anthropic 組織。方法限制適用於 VS Code 擴充功能、Agent SDK、`claude setup-token` 和 `/install-github-app`，而終端的互動式登入畫面（透過 `/login` 或首次執行上線到達）則會預先選擇該方法而不強制執行；Claude Code 驗證終端、VS Code 擴充功能和 Agent SDK 中 claude.ai 帳戶登入的組織，不檢查 Claude Console 登入或[閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway)登入。在 v2.1.212 之前，只有終端登入應用任一鍵。設定時，由 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 驗證的會話在啟動時被阻止；雲端提供者會話不受影響，除非這些認證之一或由較早的 Claude Console 登入儲存的 API 金鑰也存在 | `forceLoginMethod`、`forceLoginOrgUUID` |102| [Login enforcement](https://code.claude.com/docs/zh-TW/settings-reference.md#forceloginmethod) | 限制登入為特定方法或 Anthropic 組織。方法限制適用於 VS Code 擴充功能、Agent SDK、`claude setup-token` 和 `/install-github-app`，而終端的互動式登入畫面（透過 `/login` 或首次執行上線到達）則會預先選擇該方法而不強制執行；Claude Code 驗證終端、VS Code 擴充功能和 Agent SDK 中 claude.ai 帳戶登入的組織，不檢查 Claude Console 登入或[閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway)登入。在 v2.1.212 之前，只有終端登入應用任一鍵。設定時，由 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 驗證的會話在啟動時被阻止；雲端提供者會話不受影響，除非這些認證之一或由較早的 Claude Console 登入儲存的 API 金鑰也存在 | `forceLoginMethod`、`forceLoginOrgUUID` |

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> 顧問工具是實驗性功能，需要 Anthropic API。它在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。行為、定價和可用性可能會變更。11> 顧問工具是實驗性功能，需要 Anthropic API 或 [Claude Platform on AWS](https://code.claude.com/docs/zh-TW/claude-platform-on-aws.md)。在 Claude Platform on AWS 上，需要 Claude Code v2.1.300 或更新版本。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。行為、定價和可用性可能會變更。

12 12 

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

14 14 

174 174 

175## 需求175## 需求

176 176 

177顧問工具需要以下所有條件：177* **提供者**：Anthropic API 或 [Claude Platform on AWS](https://code.claude.com/docs/zh-TW/claude-platform-on-aws.md)，而非 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。在 Claude Platform on AWS 上，顧問需要 Claude Code v2.1.300 或更新版本。

178 178* **LLM 閘道**：透過設定有 `ANTHROPIC_BASE_URL` 的 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)時，可用性取決於閘道是否將請求完整轉發到 Anthropic API。如果閘道或其上游無法識別顧問工具，請參閱[自動重試和錯誤轉發](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#automatic-retry-and-error-forwarding)以了解 Claude Code 如何回應。

179* **僅限 Anthropic API**：顧問是伺服器執行的工具。它在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。透過配置有 `ANTHROPIC_BASE_URL` 的 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)，可用性取決於閘道是否將請求完整轉發到 Anthropic API。如果閘道或其上游無法識別顧問工具，請參閱[自動重試和錯誤轉發](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#automatic-retry-and-error-forwarding)以了解 Claude Code 如何回應。

180* **支援的主要模型**：Fable、Opus 4.6 或更新版本、Sonnet 4.6 或更新版本、Haiku 4.5，或 Haiku 5.5。請參閱[選擇顧問模型](#choose-an-advisor-model)以了解每個顧問接受的模型。179* **支援的主要模型**：Fable、Opus 4.6 或更新版本、Sonnet 4.6 或更新版本、Haiku 4.5，或 Haiku 5.5。請參閱[選擇顧問模型](#choose-an-advisor-model)以了解每個顧問接受的模型。

181* **功能旗標擷取**：Claude Code 透過從 Anthropic 擷取的功能旗標來開啟顧問。在設定了關閉旗標擷取的變數（例如 `DISABLE_TELEMETRY`）的工作階段中，顧問保持關閉。請參閱[需要功能旗標擷取的功能](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)。180* **功能旗標擷取**：除非您使用的是 Claude Platform on AWS，否則顧問需要從 Anthropic 擷取的功能旗標。設定了關閉擷取之變數（例如 `DISABLE_TELEMETRY`）的工作階段不會有該旗標。若要檢查您的工作階段，請參閱[哪些工作階段會略過擷取或在沒有該旗標的情況下啟動](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)。

182 181 

183## 關閉顧問182## 關閉顧問

184 183 

220 220 

221> [!NOTE]221> [!NOTE]

222>222>

223> `effort` 在每個回應內交換延遲和代幣成本以獲得推理深度。[擴展思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 是一個單獨的功能，在輸出中產生 `thinking` 區塊，而 [Python](https://code.claude.com/docs/zh-TW/agent-sdk/python.md#thinkingconfig) 或 [TypeScript](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#thinkingconfig) 上 `ThinkingConfig` 的 `display` 欄位控制您是否接收其文字。它們是獨立的：您可以設定 `effort: "low"` 並啟用擴展思考，或 `effort: "max"` 而不啟用它。223> `effort` 在每個回應內以延遲和 token 成本換取推理深度。[延伸思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 會在輸出中產生 `thinking` 區塊，而 [Python](https://code.claude.com/docs/zh-TW/agent-sdk/python.md#thinkingconfig) 或 [TypeScript](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#thinkingconfig) 上 `ThinkingConfig` 的 `display` 欄位控制您是否接收其文字。

224 224 

225對於執行簡單、範圍明確的任務（如列出檔案或執行單個 grep）的 agent，使用較低的 effort 來降低成本和延遲。在頂層 `query()` 選項中設定 `effort` 以用於[工作階段](https://code.claude.com/docs/zh-TW/sub-agents.md#choose-an-effort-level)，或在 [`AgentDefinition`](https://code.claude.com/docs/zh-TW/agent-sdk/subagents#agentdefinition-configuration) 上使用 `effort` 欄位以每個 subagent 為基礎覆寫工作階段等級。225對於執行簡單、範圍明確的任務（如列出檔案或執行單個 grep）的 agent，使用較低的 effort 來降低成本和延遲。在頂層 `query()` 選項中設定 `effort` 以用於[工作階段](https://code.claude.com/docs/zh-TW/sub-agents.md#choose-an-effort-level)，或在 [`AgentDefinition`](https://code.claude.com/docs/zh-TW/agent-sdk/subagents#agentdefinition-configuration) 上使用 `effort` 欄位以每個 subagent 為基礎覆寫工作階段等級。

226 226 

220附加終端使用者身份後，這些事件會變成您可以轉發到安全資訊和事件管理 (SIEM) 平台的按使用者稽核追蹤：220附加終端使用者身份後，這些事件會變成您可以轉發到安全資訊和事件管理 (SIEM) 平台的按使用者稽核追蹤：

221 221 

222* `tool_decision` 和 `tool_result`：每個工具呼叫、其被允許或拒絕的情況，以及其結果222* `tool_decision` 和 `tool_result`：每個工具呼叫、其被允許或拒絕的情況，以及其結果

223* `safety_event`：哪項檢查拒絕了工具呼叫或要求為其顯示權限提示，例如權限規則或自動模式分類器。某些呼叫[沒有安全事件](https://code.claude.com/docs/zh-TW/monitoring-usage.md#calls-without-a-safety-event)。需要 Claude Code v2.1.307 或更新版本

224* `mcp_server_connection`：MCP 伺服器連線和連線失敗223* `mcp_server_connection`：MCP 伺服器連線和連線失敗

225* `permission_mode_changed`：權限模式變更224* `permission_mode_changed`：權限模式變更

226 225 

227這些事件會以帶有 `claude_code.` 前綴命名的日誌記錄匯出，例如 `claude_code.safety_event`。請參閱監控參考中的[稽核安全事件](https://code.claude.com/docs/zh-TW/monitoring-usage.md#audit-security-events)以了解完整的安全相關事件清單和每個事件攜帶的屬性。226這些事件會以帶有 `claude_code.` 前綴命名的日誌記錄匯出，例如 `claude_code.tool_decision`。請參閱監控參考中的[稽核安全事件](https://code.claude.com/docs/zh-TW/monitoring-usage.md#audit-security-events)以了解完整的安全相關事件清單和每個事件攜帶的屬性。

228 227 

229## 控制匯出中的敏感資料228## 控制匯出中的敏感資料

230 229 

233| 變數 | 新增內容 |232| 變數 | 新增內容 |

234| - | - |233| - | - |

235| `OTEL_LOG_USER_PROMPTS=1` | `claude_code.user_prompt` 事件和 `claude_code.interaction` span 上的提示文字 |234| `OTEL_LOG_USER_PROMPTS=1` | `claude_code.user_prompt` 事件和 `claude_code.interaction` span 上的提示文字 |

236| `OTEL_LOG_TOOL_DETAILS=1` | `claude_code.tool_result` 事件上的工具輸入引數（例如檔案路徑、shell 命令和搜尋模式），以及[成本和 token 指標](https://code.claude.com/docs/zh-TW/monitoring-usage.md#cost-counter)上的真實 agent、skill、外掛和 MCP 伺服器名稱。自動模式分類器在封鎖呼叫時所指明的內建規則，會以 `claude_code.tool_decision` 和 `claude_code.safety_event` 事件上的 [`classifier_category`](https://code.claude.com/docs/zh-TW/monitoring-usage#tool-decision-event) 呈現 |235| `OTEL_LOG_TOOL_DETAILS=1` | `claude_code.tool_result` 事件上的工具輸入引數（例如檔案路徑、shell 命令和搜尋模式），以及[成本和 token 指標](https://code.claude.com/docs/zh-TW/monitoring-usage.md#cost-counter)上的真實 agent、skill、外掛和 MCP 伺服器名稱。自動模式分類器在封鎖呼叫時所指明的內建規則，會以 `claude_code.tool_decision` 事件上的 [`classifier_category`](https://code.claude.com/docs/zh-TW/monitoring-usage#tool-decision-event) 呈現 |

237| `OTEL_LOG_TOOL_CONTENT=1` | `claude_code.tool` 上的 [`tool.output` span 事件](https://code.claude.com/docs/zh-TW/monitoring-usage#tool-output-span-event)，包含檔案內容、Bash 輸出，以及 MCP 工具、WebFetch 和 WebSearch 返回的內容，預設截斷為 60 KB，可透過 `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 設定，需要 Claude Code v2.1.214 或更新版本。來自 MCP 工具、WebFetch 和 WebSearch 的結果需要 Claude Code v2.1.283 或更新版本。需要啟用[追蹤](#read-agent-traces)。Span 屬性在[其自身的閘道](https://code.claude.com/docs/zh-TW/monitoring-usage.md#new-context-gates)下攜帶工具內容 |236| `OTEL_LOG_TOOL_CONTENT=1` | `claude_code.tool` 上的 [`tool.output` span 事件](https://code.claude.com/docs/zh-TW/monitoring-usage#tool-output-span-event)，包含檔案內容、Bash 輸出，以及 MCP 工具、WebFetch 和 WebSearch 返回的內容，預設截斷為 60 KB，可透過 `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 設定，需要 Claude Code v2.1.214 或更新版本。來自 MCP 工具、WebFetch 和 WebSearch 的結果需要 Claude Code v2.1.283 或更新版本。需要啟用[追蹤](#read-agent-traces)。Span 屬性在[其自身的閘道](https://code.claude.com/docs/zh-TW/monitoring-usage.md#new-context-gates)下攜帶工具內容 |

238| `OTEL_LOG_RAW_API_BODIES` | 完整的 Anthropic Messages API 請求和回應 JSON 作為 `claude_code.api_request_body` 和 `claude_code.api_response_body` 日誌事件。設定為 `1` 以獲得截斷為 60 KB 的內聯主體（預設），或 `file:<dir>` 以在磁碟上獲得未截斷的主體，事件中有 `body_ref` 路徑。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 設定內聯截斷限制，並需要 Claude Code v2.1.214 或更新版本。主體包括整個對話歷史記錄，並且已編輯了擴展思考內容。啟用此項意味著同意上述三個變數將揭示的所有內容 |237| `OTEL_LOG_RAW_API_BODIES` | 完整的 Anthropic Messages API 請求和回應 JSON 作為 `claude_code.api_request_body` 和 `claude_code.api_response_body` 日誌事件。設定為 `1` 以獲得截斷為 60 KB 的內聯主體（預設），或 `file:<dir>` 以在磁碟上獲得未截斷的主體，事件中有 `body_ref` 路徑。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 設定內聯截斷限制，並需要 Claude Code v2.1.214 或更新版本。主體包括整個對話歷史記錄，並且已編輯了擴展思考內容。啟用此項意味著同意上述三個變數將揭示的所有內容 |

239 238 

1383| :- | :- | :- |1383| :- | :- | :- |

1384| `adaptive` | `type`、`display` | Claude 自適應決定何時思考 |1384| `adaptive` | `type`、`display` | Claude 自適應決定何時思考 |

1385| `enabled` | `type`、`budget_tokens`、`display` | 啟用具有特定 token 預算的思考 |1385| `enabled` | `type`、`budget_tokens`、`display` | 啟用具有特定 token 預算的思考 |

1386| `disabled` | `type` | 停用思考 |1386| `disabled` | `type` | 在[模型和提供者允許的情況下](https://code.claude.com/docs/zh-TW/model-config.md#where-you-cant-turn-thinking-off)停用思考 |

1387 1387 

1388選用的 `display` 欄位控制思考文字是否傳回 `"summarized"` 或 `"omitted"`。在 Claude Opus 4.7 及更新版本上，API 預設值為 `"omitted"`，因此設定 `"summarized"` 以在 [`ThinkingBlock`](#thinkingblock) 輸出中接收思考內容。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 等提供者上，Claude Code 不會針對其可辨識的較早模型傳遞 `display`。這些模型包括 Opus 4.6、Sonnet 4.6、Haiku 4.5 及更早的模型，它們會使用各自的預設值。1388選用的 `display` 欄位控制思考文字是否傳回 `"summarized"` 或 `"omitted"`。在 Claude Opus 4.7 及更新版本上，API 預設值為 `"omitted"`，因此設定 `"summarized"` 以在 [`ThinkingBlock`](#thinkingblock) 輸出中接收思考內容。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 等提供者上，Claude Code 不會針對其可辨識的較早模型傳遞 `display`。這些模型包括 Opus 4.6、Sonnet 4.6、Haiku 4.5 及更早的模型，它們會使用各自的預設值。

1389 1389 

664| `rewindFiles(userMessageId, options?)` | 將檔案還原到指定使用者訊息當時的狀態。傳入 `{ dryRun: true }` 以預覽變更。需要 `enableFileCheckpointing: true`。請參閱[檔案檢查點功能](https://code.claude.com/docs/zh-TW/agent-sdk/file-checkpointing.md) |664| `rewindFiles(userMessageId, options?)` | 將檔案還原到指定使用者訊息當時的狀態。傳入 `{ dryRun: true }` 以預覽變更。需要 `enableFileCheckpointing: true`。請參閱[檔案檢查點功能](https://code.claude.com/docs/zh-TW/agent-sdk/file-checkpointing.md) |

665| `setPermissionMode()` | 變更權限模式（僅在串流輸入模式下可用） |665| `setPermissionMode()` | 變更權限模式（僅在串流輸入模式下可用） |

666| `setModel()` | 變更模型（僅在串流輸入模式下可用）。傳入 `undefined` 或字串 `"default"` 會重設為 [Claude Code 的預設模型](https://code.claude.com/docs/zh-TW/model-config.md)。若新模型不支援自動模式，處於 `auto` 模式的工作階段會[變更為 `default` 模式](https://code.claude.com/docs/zh-TW/agent-sdk/permissions#auto-mode-auto) |666| `setModel()` | 變更模型（僅在串流輸入模式下可用）。傳入 `undefined` 或字串 `"default"` 會重設為 [Claude Code 的預設模型](https://code.claude.com/docs/zh-TW/model-config.md)。若新模型不支援自動模式，處於 `auto` 模式的工作階段會[變更為 `default` 模式](https://code.claude.com/docs/zh-TW/agent-sdk/permissions#auto-mode-auto) |

667| `setMaxThinkingTokens()` | *已淘汰：* 請改用 `thinking` 選項。變更最大思考 token 數。傳入 `null` 會將思考重設為工作階段預設值：清除工作階段中途的覆寫，且對於已停用思考的工作階段，思考仍保持關閉 |667| `setMaxThinkingTokens()` | *已棄用：* 請改用 `thinking` 選項。變更最大思考 token 數。傳遞 `null` 以撤銷先前的呼叫，並還原工作階段啟動時的 `thinking` 或 `maxThinkingTokens` 選項 |

668| `applyFlagSettings(settings)` | 在執行時期將設定合併到工作階段的旗標設定層（僅在串流輸入模式下可用）。請參閱 [`applyFlagSettings()`](#applyflagsettings) |668| `applyFlagSettings(settings)` | 在執行時期將設定合併到工作階段的旗標設定層（僅在串流輸入模式下可用）。請參閱 [`applyFlagSettings()`](#applyflagsettings) |

669| `updateSettings(source, settings)` | 將一個允許清單中的鍵寫入專案的本機設定檔或您的使用者設定檔，讓該值在之後的工作階段中持續生效。請參閱 [`updateSettings()`](#updatesettings)。需要 TypeScript SDK v0.3.257 或更新版本，其隨附 Claude Code v2.1.257 |669| `updateSettings(source, settings)` | 將一個允許清單中的鍵寫入專案的本機設定檔或您的使用者設定檔，讓該值在之後的工作階段中持續生效。請參閱 [`updateSettings()`](#updatesettings)。需要 TypeScript SDK v0.3.257 或更新版本，其隨附 Claude Code v2.1.257 |

670| `initializationResult()` | 傳回完整的初始化結果，包括支援的命令、模型、帳戶資訊和輸出風格設定 |670| `initializationResult()` | 傳回完整的初始化結果，包括支援的命令、模型、帳戶資訊和輸出風格設定 |

5431type ThinkingConfig =5431type ThinkingConfig =

5432 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)5432 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)

5433 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget5433 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget

5434 | { type: "disabled" }; // No extended thinking5434 | { type: "disabled" }; // Turn thinking off where the model and provider allow it

5435```5435```

5436 5436 

5437關於 `disabled`，請參閱[無法關閉思考的情況](https://code.claude.com/docs/zh-TW/model-config.md#where-you-cant-turn-thinking-off)。

5438 

5437可選的 `display` 欄位控制思考文字是否以 `"summarized"` 或 `"omitted"` 傳回。在 Claude Opus 4.7 及更新版本上，API 預設為 `"omitted"`，因此設定 `"summarized"` 以在 `thinking` 區塊中接收思考內容。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 等提供者上，Claude Code 不會為其可辨識的較早模型傳遞 `display`。這些模型是 Opus 4.6、Sonnet 4.6、Haiku 4.5 及更早的模型，它們會使用各自的預設值。5439可選的 `display` 欄位控制思考文字是否以 `"summarized"` 或 `"omitted"` 傳回。在 Claude Opus 4.7 及更新版本上，API 預設為 `"omitted"`，因此設定 `"summarized"` 以在 `thinking` 區塊中接收思考內容。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 等提供者上，Claude Code 不會為其可辨識的較早模型傳遞 `display`。這些模型是 Opus 4.6、Sonnet 4.6、Haiku 4.5 及更早的模型，它們會使用各自的預設值。

5438 5440 

5439### `SpawnedProcess`5441### `SpawnedProcess`

169 169 

170當清單 [按目錄分組](#organize-the-list) 時，摘要會以彩色文字顯示的工作階段狀態開頭，例如 `Needs input · double jump or wall climb?`。在預設的狀態分組中，群組標題已標示狀態，因此列只會顯示摘要。170當清單 [按目錄分組](#organize-the-list) 時，摘要會以彩色文字顯示的工作階段狀態開頭，例如 `Needs input · double jump or wall climb?`。在預設的狀態分組中，群組標題已標示狀態，因此列只會顯示摘要。

171 171 

172回合結束摘要和每次回合中途的重寫，都是透過您的一般提供者發送的一個簡短 Haiku 級請求，並依照與工作階段本身相同的 [資料使用條款](https://code.claude.com/docs/zh-TW/data-usage.md) 計費和處理。模型重寫之間的 15 秒更新會重複使用工作階段自身的輸出，不會發送請求。在未設定 Haiku 級模型的第三方提供者或閘道上，請求會改用工作階段的主要模型；設定 [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/zh-TW/model-config#environment-variables) 即可選擇一個模型。172#### 列摘要的成本

173 

174回合結束摘要和每次回合中途的重寫，都是透過您的一般提供者發送的一個簡短請求，並依照與工作階段本身相同的 [資料使用條款](https://code.claude.com/docs/zh-TW/data-usage.md) 計費和處理。在第三方提供者或閘道上，摘要會使用您在 [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/zh-TW/model-config#environment-variables) 中設定的模型。若未設定，則會使用您的提供者用於背景任務的模型：請參閱 [Amazon Bedrock](https://code.claude.com/docs/zh-TW/amazon-bedrock.md#4-pin-model-versions)、[Google Cloud 的 Agent Platform](https://code.claude.com/docs/zh-TW/google-vertex-ai.md#5-pin-model-versions)、[Microsoft Foundry](https://code.claude.com/docs/zh-TW/microsoft-foundry.md#4-pin-model-versions) 或您的 [閘道](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#requests-and-defaults-by-connection-method)。

173 175 

174### Pull request 狀態176### Pull request 狀態

175 177 

128 128 

129### plan mode 中的瀏覽器工具129### plan mode 中的瀏覽器工具

130 130 

131在 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 中，Claude 錄製 GIF、開啟新分頁或執行捷徑之前，會出現權限提示。在互動式 CLI 工作階段中，如果[略過權限模式可用](https://code.claude.com/docs/zh-TW/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)且[功能旗標擷取](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)已關閉，這些呼叫會在沒有提示的情況下執行。131在 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 中，Claude 錄製 GIF 或開啟新分頁之前，會出現權限提示。在互動式 CLI 工作階段中，如果[略過權限模式可用](https://code.claude.com/docs/zh-TW/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)且[功能旗標擷取](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)已關閉，這些呼叫會在沒有提示的情況下執行。

132 132 

133設定了 `createIfEmpty` 的 `tabs_context_mcp` 呼叫也會出現提示，包含上述任一動作的 `browser_batch` 呼叫亦同。133設定了 `createIfEmpty` 的 `tabs_context_mcp` 呼叫也會出現提示，包含上述任一動作的 `browser_batch` 呼叫亦同。

134 134 

313>313>

314> `gatewayInternalNetworks` 適用於恰好以公用位址空間編號的內部網路。它並不會讓將閘道暴露在網際網路上變得安全：受信任的閘道可以推送在開發人員電腦上執行命令的設定。314> `gatewayInternalNetworks` 適用於恰好以公用位址空間編號的內部網路。它並不會讓將閘道暴露在網際網路上變得安全：受信任的閘道可以推送在開發人員電腦上執行命令的設定。

315>315>

316> 請透過防火牆或負載平衡器規則，讓閘道無法從您的網路外部存取。將閘道的 [`access_control.allow_cidrs`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#http-tuning) 設定為您在此宣告的相同區塊，讓閘道本身拒絕來自其他任何地方的用戶端。若位於負載平衡器或 ingress 之後，也請將 `listen.trusted_proxies` 設定為該前端，否則閘道會以前端本身的位址而非開發人員的位址來比對 `allow_cidrs`。316> 請透過防火牆或負載平衡器規則，讓閘道無法從您的網路外部存取。將閘道的 [`access_control.allow_cidrs`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#http-tuning) 設定為您在此宣告的相同區塊。若負載平衡器或 ingress [應列於 `listen.trusted_proxies` 中](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#listen)，也請將其列在該處，否則閘道會以前端本身的位址而非開發人員的位址來比對 `allow_cidrs`。

317 317 

318請將此鍵加入與登入鍵相同的受管設定來源：受管設定檔、MDM 設定描述檔或登錄原則。Claude Code 會忽略使用者、專案及伺服器受管設定中的此鍵。318請將此鍵加入與登入鍵相同的受管設定來源：受管設定檔、MDM 設定描述檔或登錄原則。Claude Code 會忽略使用者、專案及伺服器受管設定中的此鍵。

319 319 

57| `port` | 否 | 繫結連接埠。預設 `8080`。 |57| `port` | 否 | 繫結連接埠。預設 `8080`。 |

58| `public_url` | 除非 `host` 是環回 | 外部可見的 `https://` 來源，用於建立 IdP `redirect_uri` 和發現中繼資料。在 `host` 不是環回位址時為必需，無論 TLS 是在代理伺服器（例如 ALB、Ingress 或 Cloud Run）還是在閘道本身透過 `tls` 終止，因為閘道永遠不會從 `X-Forwarded-*` 標頭衍生自己的來源；它們是用戶端可偽造的。沒有它啟動會失敗。下面的 `trusted_proxies` 僅控制用戶端 IP 解析。啟用[遙測](#telemetry)時也是必需的，因為閘道從此 URL 建立它推送給用戶端的 OTLP 端點。 |58| `public_url` | 除非 `host` 是環回 | 外部可見的 `https://` 來源，用於建立 IdP `redirect_uri` 和發現中繼資料。在 `host` 不是環回位址時為必需，無論 TLS 是在代理伺服器（例如 ALB、Ingress 或 Cloud Run）還是在閘道本身透過 `tls` 終止，因為閘道永遠不會從 `X-Forwarded-*` 標頭衍生自己的來源；它們是用戶端可偽造的。沒有它啟動會失敗。下面的 `trusted_proxies` 僅控制用戶端 IP 解析。啟用[遙測](#telemetry)時也是必需的，因為閘道從此 URL 建立它推送給用戶端的 OTLP 端點。 |

59| `tls.cert` / `tls.key` | 否 | 如果閘道自己終止 TLS，則為 PEM 路徑 |59| `tls.cert` / `tls.key` | 否 | 如果閘道自己終止 TLS，則為 PEM 路徑 |

60| `trusted_proxies` | 否 | 閘道前面的負載平衡器的 CIDR 或 IP。設定時，閘道僅信任來自這些對等方的 `X-Forwarded-For`，並記錄真實用戶端 IP 以進行每 IP 速率限制和稽核。等同於 nginx `set_real_ip_from`。`X-Forwarded-For` 項目寫成 `ipv4:port` 或 `[ipv6]:port`（如某些負載平衡器所做），會以連接埠被刪除的方式讀取。附加連接埠且沒有括號的 IPv6 位址可能被讀取為不同位址或根本不被讀取，因此在任何寫入該形式的代理伺服器上關閉連接埠選項。 |60| `trusted_proxies` | 否 | 要信任的前端 CIDR 或 IP。設定後，閘道只信任來自這些對端的 `X-Forwarded-For`，並記錄真實的用戶端 IP，以用於依 IP 的速率限制與稽核。 |

61 

62只有當某個前端所轉送的最後一個 `X-Forwarded-For` 項目並非由任何開發人員寫入時，才將其列入 `trusted_proxies`。請勿列入任何開發人員連線來源的位址或範圍。會附加其收到之每個連線位址的前端符合資格。按照開發人員傳送的原樣轉送該標頭的前端則不符合。

63 

64以 `ipv4:port` 或 `[ipv6]:port` 形式寫入的 `X-Forwarded-For` 項目（部分負載平衡器會這樣寫）在讀取時會捨棄連接埠。附加了連接埠但沒有方括號的 IPv6 位址可能會被讀成其他位址，或完全無法讀取。請在任何會寫出該形式的代理伺服器上關閉連接埠選項。

61 65 

62### `oidc`66### `oidc`

63 67 

1657 1661 

1658兩個信號都使用 gateway 解析的用戶端位址。如果負載平衡器、連接埠轉發或隧道轉發流量且未列在 `listen.trusted_proxies` 中，gateway 看到轉發位址，通常是私有的，因此執行時警告和私有允許清單都不捕捉透過它轉發的流量。1662兩個信號都使用 gateway 解析的用戶端位址。如果負載平衡器、連接埠轉發或隧道轉發流量且未列在 `listen.trusted_proxies` 中，gateway 看到轉發位址，通常是私有的，因此執行時警告和私有允許清單都不捕捉透過它轉發的流量。

1659 1663 

1660在這樣的前端後面，首先設定 [`listen.trusted_proxies`](#listen)，以便 gateway 看到真實用戶端位址，並無論如何保持 gateway 和其前面的所有東西無法從公開網際網路到達。1664若轉送端[屬於 `listen.trusted_proxies`](#listen)，請將其列在該處。無論如何，請確保閘道及其前方的所有元件都無法從公用網際網路連線。

1661 1665 

1662### `load_test_mode`1666### `load_test_mode`

1663 1667 

131 131 

132登入按用戶端 IP 地址進行速率限制，預設值適合小型團隊。每個地址在每 10 分鐘內獲得 30 次登入開始和 10 次代碼提交。向數千名開發人員的推出可能在第一個早上達到這些限制，原因有兩個：132登入按用戶端 IP 地址進行速率限制，預設值適合小型團隊。每個地址在每 10 分鐘內獲得 30 次登入開始和 10 次代碼提交。向數千名開發人員的推出可能在第一個早上達到這些限制，原因有兩個：

133 133 

134* **閘道無法看到您的負載平衡器之外。** 沒有 [`listen.trusted_proxies`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#listen)，每個開發人員似乎都來自負載平衡器的地址並共享一個限制。首先設定它。閘道在第一次忽略 `X-Forwarded-For` 標頭時記錄警告。134* **閘道無法看到您的負載平衡器之外。** 沒有 [`listen.trusted_proxies`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#listen)，每個開發人員似乎都來自負載平衡器的地址並共享一個限制。閘道在第一次忽略 `X-Forwarded-For` 標頭時記錄警告。如果負載平衡器[應列在 `listen.trusted_proxies` 中](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#listen)，請先將其列出，再變更其他任何項目。如果開發人員仍然共享一個地址，請提高 [`rate_limits`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#http-tuning)。

135* **許多開發人員共享幾個 NAT 或 VPN 出口地址。** 即使 `trusted_proxies` 正確，他們也共享這些地址的限制。提高 [`rate_limits`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#http-tuning) 以適應。135* **許多開發人員共享幾個 NAT 或 VPN 出口地址。** 即使 `trusted_proxies` 正確，他們也共享這些地址的限制。提高 [`rate_limits`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#http-tuning) 以適應。

136 136 

137要調整 `max`，將開發人員數除以他們共享的出口地址。估計在一個 `window_seconds` 期間內有多少人登入，預設為 10 分鐘。然後將其加倍以涵蓋重試和登入到 Claude Code 和 Claude Desktop 的開發人員。137要調整 `max`，將開發人員數除以他們共享的出口地址。估計在一個 `window_seconds` 期間內有多少人登入，預設為 10 分鐘。然後將其加倍以涵蓋重試和登入到 Claude Code 和 Claude Desktop 的開發人員。

418| 啟動顯示 `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | 已安裝的 Claude Code 建置早於 gateway 支援 | 讓開發者將 Claude Code 更新到包含 Cloud gateway 支援的版本 |418| 啟動顯示 `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | 已安裝的 Claude Code 建置早於 gateway 支援 | 讓開發者將 Claude Code 更新到包含 Cloud gateway 支援的版本 |

419| 啟動結束，顯示 `Administrator policy requires a Cloud gateway sign-in on this machine` | 開發者的環境設定了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`、其設定中指定了 [`apiKeyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#apikeyhelper)，或來自較早 Claude Console 登入的 API 金鑰仍然被儲存 | 讓開發者清除每個適用的項目：取消設定變數、移除 `apiKeyHelper` 項目，或執行 `claude auth logout` 以移除已儲存的金鑰。之後，使用 `CLAUDE_CODE_USE_*` 選擇雲端供應商的工作階段會在不登入的情況下啟動；對於其他所有工作階段，請讓他們啟動 `claude` 並使用 `/login` 登入。另請參閱[系統管理員原則要求 Cloud gateway 登入](https://code.claude.com/docs/zh-TW/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in)。 |419| 啟動結束，顯示 `Administrator policy requires a Cloud gateway sign-in on this machine` | 開發者的環境設定了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`、其設定中指定了 [`apiKeyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#apikeyhelper)，或來自較早 Claude Console 登入的 API 金鑰仍然被儲存 | 讓開發者清除每個適用的項目：取消設定變數、移除 `apiKeyHelper` 項目，或執行 `claude auth logout` 以移除已儲存的金鑰。之後，使用 `CLAUDE_CODE_USE_*` 選擇雲端供應商的工作階段會在不登入的情況下啟動；對於其他所有工作階段，請讓他們啟動 `claude` 並使用 `/login` 登入。另請參閱[系統管理員原則要求 Cloud gateway 登入](https://code.claude.com/docs/zh-TW/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in)。 |

420| 啟動或 `/login` 在受管設定載入時出現 403 後報告 `Claude Code may not be enabled for your organization` | gateway 或其前面的某個東西以 403 回應了 `/managed/settings` 請求。gateway 自己的設定路由永遠不會回應 403。狀態來自 [`access_control`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#http-tuning) IP 檢查或來自 gateway 前面的代理伺服器或 WAF。稽核日誌將 IP 檢查拒絕記錄為 `access.denied`，並附上原因。開發者保持登入狀態。 | 檢查稽核日誌中失敗時的 `access.denied`，並修正 `access_control` 清單或前端，然後讓開發者再次啟動 `claude` |420| 啟動或 `/login` 在受管設定載入時出現 403 後報告 `Claude Code may not be enabled for your organization` | gateway 或其前面的某個東西以 403 回應了 `/managed/settings` 請求。gateway 自己的設定路由永遠不會回應 403。狀態來自 [`access_control`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#http-tuning) IP 檢查或來自 gateway 前面的代理伺服器或 WAF。稽核日誌將 IP 檢查拒絕記錄為 `access.denied`，並附上原因。開發者保持登入狀態。 | 檢查稽核日誌中失敗時的 `access.denied`，並修正 `access_control` 清單或前端，然後讓開發者再次啟動 `claude` |

421| CLI `/login`：`The gateway is limiting sign-in attempts right now`，或在較舊版本上 `Request failed with status code 429`。`/device` 頁面可能對尚未嘗試過的開發者顯示 `Too many attempts` | 達到了每個 IP 的登入速率限制。要麼 `listen.trusted_proxies` 不涵蓋負載平衡器，所以每個開發者共享其位址，要麼許多開發者共享 NAT 或 VPN 出口位址。具有 `result: rate_limited` 的稽核事件顯示相同的一個或幾個 `client_ip` 值。 | 首先將 `listen.trusted_proxies` 設定為負載平衡器的來源範圍，然後如果開發者仍然共享位址，請提高 `rate_limits`。請參閱[大規模推出](#large-rollouts)。 |421| CLI `/login`：`The gateway is limiting sign-in attempts right now`，或在較舊版本上 `Request failed with status code 429`。`/device` 頁面可能對尚未嘗試過的開發者顯示 `Too many attempts` | 達到了每個 IP 的登入速率限制。要麼 `listen.trusted_proxies` 不涵蓋負載平衡器，所以每個開發者共享其位址，要麼許多開發者共享 NAT 或 VPN 出口位址。具有 `result: rate_limited` 的稽核事件顯示相同的一個或幾個 `client_ip` 值。 | 如果負載平衡器[應列於 `listen.trusted_proxies` 中](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#listen)，請先將它列入。接著，如果開發者仍然共享位址，請提高 `rate_limits`。請參閱[大規模推出](#large-rollouts)。 |

422| CLI `/login`：`Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | gateway 主機名稱解析為至少一個公開 IP 位址。Claude Code 檢查每個已解析的位址，並要求每個位址都是私有的。常見原因是雙堆疊名稱，其中一個系列解析為公開位址，包括 AWS 內部雙堆疊負載平衡器，它們傳回公開範圍的 AAAA 位址。 | 讓 gateway 名稱在開發者機器上只解析為私有位址。對於雙堆疊名稱，請刪除公開範圍記錄或提供單獨的僅限內部 DNS 名稱。請參閱[私有網路先決條件](https://code.claude.com/docs/zh-TW/claude-apps-gateway#prerequisites)。如果位址是您的組織擁有並在內部使用的公開空間，請改為[宣告該區塊](https://code.claude.com/docs/zh-TW/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)。 |422| CLI `/login`：`Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | gateway 主機名稱解析為至少一個公開 IP 位址。Claude Code 檢查每個已解析的位址，並要求每個位址都是私有的。常見原因是雙堆疊名稱，其中一個系列解析為公開位址，包括 AWS 內部雙堆疊負載平衡器，它們傳回公開範圍的 AAAA 位址。 | 讓 gateway 名稱在開發者機器上只解析為私有位址。對於雙堆疊名稱，請刪除公開範圍記錄或提供單獨的僅限內部 DNS 名稱。請參閱[私有網路先決條件](https://code.claude.com/docs/zh-TW/claude-apps-gateway#prerequisites)。如果位址是您的組織擁有並在內部使用的公開空間，請改為[宣告該區塊](https://code.claude.com/docs/zh-TW/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)。 |

423| CLI `/login`：`Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` 或 `HTTP_PROXY` 適用於 gateway 主機，且代理伺服器的主機名稱解析為公開位址。主機名稱只解析為私有位址的代理伺服器是允許的，不會觸發此錯誤 | 在開發者的機器上將 gateway 主機新增到 `NO_PROXY`，以便連線是直接的，或使用主機名稱解析為私有位址的代理伺服器。訊息會命名要新增的確切 `NO_PROXY` 項目 |423| CLI `/login`：`Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` 或 `HTTP_PROXY` 適用於 gateway 主機，且代理伺服器的主機名稱解析為公開位址。主機名稱只解析為私有位址的代理伺服器是允許的，不會觸發此錯誤 | 在開發者的機器上將 gateway 主機新增到 `NO_PROXY`，以便連線是直接的，或使用主機名稱解析為私有位址的代理伺服器。訊息會命名要新增的確切 `NO_PROXY` 項目 |

424| CLI `/login`：`Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | gateway 位於 [`gatewayInternalNetworks`](https://code.claude.com/docs/zh-TW/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) 中宣告的區塊上，開發者的機器從該區塊外的位址到達它：VPN 位址池、容器或 WSL2 NAT 區段，或不是您的網路 | 讓開發者從您網路上的主機 OS 執行 `/login`。如果顯示的位址也是您組織自己的公開空間，請將 gateway 的項目替換為涵蓋兩者的區塊，最多 `/8`；第二個重疊項目會被拒絕。如果沒有區塊能涵蓋兩者，請參閱[為 gateway 選擇位址](#choose-an-address-for-the-gateway) |424| CLI `/login`：`Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | gateway 位於 [`gatewayInternalNetworks`](https://code.claude.com/docs/zh-TW/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) 中宣告的區塊上，開發者的機器從該區塊外的位址到達它：VPN 位址池、容器或 WSL2 NAT 區段，或不是您的網路 | 讓開發者從您網路上的主機 OS 執行 `/login`。如果顯示的位址也是您組織自己的公開空間，請將 gateway 的項目替換為涵蓋兩者的區塊，最多 `/8`；第二個重疊項目會被拒絕。如果沒有區塊能涵蓋兩者，請參閱[為 gateway 選擇位址](#choose-an-address-for-the-gateway) |

36 36 

37每個雲端工作階段都在一個[雲端環境](https://code.claude.com/docs/zh-TW/cloud-environments.md)中執行，這是一個已保存的設定，控制網路存取、環境變數和設定指令碼。37每個雲端工作階段都在一個[雲端環境](https://code.claude.com/docs/zh-TW/cloud-environments.md)中執行，這是一個已保存的設定，控制網路存取、環境變數和設定指令碼。

38 38 

39* **您的第一個環境**：如果您還沒有環境，上線會設定一個**預設**環境，具有[**信任**網路存取](https://code.claude.com/docs/zh-TW/cloud-environments.md#access-levels)，要麼為您建立它，要麼要求您建立它。請參閱[預設環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#the-default-environment)，了解在您的計畫上會發生哪種情況39* **您的第一個環境**：如果您還沒有環境，上線會設定一個**預設**環境，具有[**受限**網路存取](https://code.claude.com/docs/zh-TW/cloud-environments.md#access-levels)。請參閱[預設環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#the-default-environment)，了解這在您的計畫上如何運作

40* **工作階段使用哪個環境**：請參閱[預設環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#the-default-environment)，了解當您有多個環境時工作階段如何選擇環境40* **工作階段使用哪個環境**：請參閱[預設環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#the-default-environment)，了解當您有多個環境時工作階段如何選擇環境

41* **變更工作階段在啟動時可以存取或執行的內容**：請參閱[設定雲端環境](https://code.claude.com/docs/zh-TW/cloud-environments.md)41* **變更工作階段在啟動時可以存取或執行的內容**：請參閱[設定雲端環境](https://code.claude.com/docs/zh-TW/cloud-environments.md)

42* **在沒有任何設定的情況下已安裝的內容**：請參閱[已安裝的工具](https://code.claude.com/docs/zh-TW/cloud-environments.md#installed-tools)42* **在沒有任何設定的情況下已安裝的內容**：請參閱[已安裝的工具](https://code.claude.com/docs/zh-TW/cloud-environments.md#installed-tools)

146* **自動記憶**：掃描不會刪除專案 [自動記憶](https://code.claude.com/docs/zh-TW/memory.md#auto-memory) 目錄 `projects/<project>/memory/` 中的記憶檔案。Claude Code 只有在整個保留期間該目錄一直為空時才會移除它。在 v2.1.228 之前，掃描將記憶目錄內的資料夾視為工作階段資料，可能會刪除其下的舊檔案。146* **自動記憶**：掃描不會刪除專案 [自動記憶](https://code.claude.com/docs/zh-TW/memory.md#auto-memory) 目錄 `projects/<project>/memory/` 中的記憶檔案。Claude Code 只有在整個保留期間該目錄一直為空時才會移除它。在 v2.1.228 之前，掃描將記憶目錄內的資料夾視為工作階段資料，可能會刪除其下的舊檔案。

147* **Claude Desktop 和 Cowork 逐字稿**：對於您在 Claude Desktop 或 Cowork 中啟動或最近繼續的工作階段，Claude Code 會保留其逐字稿，無論年齡如何。若要為這些逐字稿設定年齡限制，請設定 [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/zh-TW/settings-reference#desktopsessioncleanupperioddays)。需要 Claude Code v2.1.248 或更新版本；較早版本會在 `cleanupPeriodDays` 後刪除它們。147* **Claude Desktop 和 Cowork 逐字稿**：對於您在 Claude Desktop 或 Cowork 中啟動或最近繼續的工作階段，Claude Code 會保留其逐字稿，無論年齡如何。若要為這些逐字稿設定年齡限制，請設定 [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/zh-TW/settings-reference#desktopsessioncleanupperioddays)。需要 Claude Code v2.1.248 或更新版本；較早版本會在 `cleanupPeriodDays` 後刪除它們。

148 148 

149 在下列任一情況下，Claude Code 會改為在 `cleanupPeriodDays` 後刪除這些逐字稿：149 在以下這類情況下，Claude Code 則會在 `cleanupPeriodDays` 之後刪除這些逐字稿：

150 150 

151 * [受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)設定了 `cleanupPeriodDays`151 * [受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)設定了 `cleanupPeriodDays`

152 * [HIPAA 設定套用於您的工作階段](https://code.claude.com/docs/zh-TW/hipaa-setup.md#check-how-developers-sign-in-and-connect)152 * [HIPAA 設定適用於您的工作階段](https://code.claude.com/docs/zh-TW/hipaa-setup.md#check-how-developers-sign-in-and-connect)

153 153 

154Claude Code 在這些情況下跳過基於年齡的掃描：154Claude Code 在這些情況下跳過基於年齡的掃描：

155 155 

170* **Linux**：`/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`，或當你的系統設定 `$TMPDIR` 時在其下的相同形狀170* **Linux**：`/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`，或當你的系統設定 `$TMPDIR` 時在其下的相同形狀

171* **Windows**：`%TEMP%\claude\<project>\<session-id>\scratchpad\`171* **Windows**：`%TEMP%\claude\<project>\<session-id>\scratchpad\`

172 172 

173`<project>` 是你的工作目錄路徑，其中除字母和數字外的每個字元都被替換為 `-`，例如 `-Users-you-my-project`。如果你設定 [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/zh-TW/env-vars)，樹會改為移到該目錄下。Hooks 接收目前工作階段的路徑作為 [`scratchpad_dir`](https://code.claude.com/docs/zh-TW/hooks#common-input-fields)。173`<project>` 是您的工作目錄路徑，其中除字母和數字外的每個字元都被替換為 `-`，例如 `-Users-you-my-project`。在 Windows 上，`<project>` 是該字串的 16 字元雜湊值，例如 `73295dabccd14c56`。在 Desktop 應用程式工作階段中，它可能是字串本身。若要取得確切路徑，請詢問 Claude。如果您設定了 [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/zh-TW/env-vars)，整個目錄樹會改為移到該目錄下。hook 會以 [`scratchpad_dir`](https://code.claude.com/docs/zh-TW/hooks#common-input-fields) 接收目前工作階段的路徑。

174 174 

175暫存簿檔案的存續時間與工作階段的逐字稿相同：[保留掃描](#cleaned-up-automatically)在刪除逐字稿時會刪除該目錄，而 [`claude purge`](#clear-local-data) 不會觸及暫存目錄。由於該目錄位於系統暫存位置下，您的作業系統也可能清除它，例如在重新啟動時。若要保留 Claude 在那裡寫入的內容，請要求 Claude 將其移到您的專案中。175暫存簿檔案的存續時間與工作階段的逐字稿相同：[保留掃描](#cleaned-up-automatically)在刪除逐字稿時會刪除該目錄，而 [`claude purge`](#clear-local-data) 不會觸及暫存目錄。由於該目錄位於系統暫存位置下，您的作業系統也可能清除它，例如在重新啟動時。若要保留 Claude 在那裡寫入的內容，請要求 Claude 將其移到您的專案中。

176 176 

8 8 

9AWS 上的 Claude Platform 是 Anthropic 營運的 Claude API，具有 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。請求直接到達 Anthropic 的 API，因此您可以獲得與 [Claude API](https://platform.claude.com/docs) 相同的模型和 API 功能，並遵循相同的發佈時程表。您使用 AWS 認證或工作區 API 金鑰進行驗證，並透過 AWS Marketplace 付款。9AWS 上的 Claude Platform 是 Anthropic 營運的 Claude API，具有 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。請求直接到達 Anthropic 的 API，因此您可以獲得與 [Claude API](https://platform.claude.com/docs) 相同的模型和 API 功能，並遵循相同的發佈時程表。您使用 AWS 認證或工作區 API 金鑰進行驗證，並透過 AWS Marketplace 付款。

10 10 

11Claude Code 透過 Anthropic 的功能旗標服務啟用的用戶端功能預設為關閉，且 [advisor 工具](https://code.claude.com/docs/zh-TW/advisor.md) 無法使用。請參閱 [功能可用性矩陣](https://code.claude.com/docs/zh-TW/feature-availability.md#summary-by-provider) 以取得完整清單。

12 

13使用本指南將 Claude Code 指向您已透過 AWS 上的 Claude Platform 佈建的工作區。有關在此之前的 AWS 訂閱和工作區設定，請參閱 [AWS 上的 Claude Platform 文件](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)。11使用本指南將 Claude Code 指向您已透過 AWS 上的 Claude Platform 佈建的工作區。有關在此之前的 AWS 訂閱和工作區設定，請參閱 [AWS 上的 Claude Platform 文件](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)。

14 12 

15> [!NOTE]13> [!NOTE]

16>14>

17> 透過 AWS Marketplace 訂閱會佈建一個與您的 AWS 帳戶相關聯的新 Anthropic 組織。此組織與您已有的任何 Anthropic 組織分開，認證不會在它們之間轉移。使用來自 AWS 連結組織的工作區 ID 和 API 金鑰，而不是來自預先存在的 Claude Console 帳戶。15> 透過 AWS Marketplace 訂閱會佈建一個與您的 AWS 帳戶相關聯的新 Anthropic 組織。此組織與您已有的任何 Anthropic 組織分開，認證不會在它們之間轉移。使用來自 AWS 連結組織的工作區 ID 和 API 金鑰，而不是來自預先存在的 Claude Console 帳戶。

18 16 

17部分 Claude Code 功能在 AWS 上的 Claude Platform 上無法使用或運作方式不同。請參閱 [功能可用性矩陣](https://code.claude.com/docs/zh-TW/feature-availability.md#summary-by-provider) 以及 [需要擷取功能旗標的功能](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)。

18 

19## 先決條件19## 先決條件

20 20 

21在設定 Claude Code 之前，您需要：21在設定 Claude Code 之前，您需要：

37 37 

38**Default** 本身不帶有任何設定：38**Default** 本身不帶有任何設定：

39 39 

40* [**Trusted** 網路存取](#access-levels)：工作階段可以到達套件登錄檔和其他[允許清單中的網域](#default-allowed-domains)，但無法透過工作階段的網路到達其他任何內容。40* [**Limited** 網路存取](#access-levels)：工作階段可以到達套件登錄檔和其他[允許清單中的網域](#default-allowed-domains)。

41* 無其他設定：**Default** 不定義任何環境變數或設定指令碼，因此工作階段只會以[預先安裝的工具](#installed-tools)開始。41* 無其他設定：**Default** 不定義任何環境變數或設定指令碼，因此工作階段只會以[預先安裝的工具](#installed-tools)開始。

42 42 

43只有 **Default** 可用時，每個工作階段都在其中執行。當您有多個環境時，工作階段會根據介面選擇一個：43只有 **Default** 可用時，每個工作階段都在其中執行。當您有多個環境時，工作階段會根據介面選擇一個：

198 198 

199## 網路存取199## 網路存取

200 200 

201每個環境設定一個網路存取層級，控制其工作階段可以進行的出站連線。預設層級 **Trusted** 允許套件登錄和其他[允許清單中的網域](#default-allowed-domains)；**Custom** 採用您自己的網域清單。201每個環境設定一個網路存取層級，控制其工作階段可以進行的出站連線。新環境以 **Limited** 開始，並勾選 **Allow package managers**，因此其工作階段可以到達套件登錄和其他[允許清單中的網域](#default-allowed-domains)。

202 202 

203若要變更環境的網路存取，[開啟它進行編輯](#configure-your-environment)並在對話框中使用 **Network access** 選擇器。[共用環境](#organization-shared-environments)在該處以唯讀方式開啟，因此擁有者改為從[管理設定](https://claude.ai/admin-settings)中的 **Cloud environments** 頁面變更其網路存取。開啟選擇器的控制項出現在[預設環境](#the-default-environment)下列出的應用程式使用介面上，以及在[雲端排程任務編輯器](https://code.claude.com/docs/zh-TW/routines.md#environments-and-network-access)中。個人環境在您的 claude.ai 帳戶設定中沒有單獨的頁面。203若要變更環境的網路存取，[開啟它進行編輯](#configure-your-environment)並在對話框中使用 **Network access** 選擇器。[共用環境](#organization-shared-environments)在該處以唯讀方式開啟，因此擁有者改為從[管理設定](https://claude.ai/admin-settings)中的 **Cloud environments** 頁面變更其網路存取。開啟選擇器的控制項出現在[預設環境](#the-default-environment)下列出的應用程式使用介面上，以及在[雲端排程任務編輯器](https://code.claude.com/docs/zh-TW/routines.md#environments-and-network-access)中。個人環境在您的 claude.ai 帳戶設定中沒有單獨的頁面。

204 204 

210 210 

211### 存取層級211### 存取層級

212 212 

213[環境對話框](#configure-your-environment)中的 **Network access** 欄位採用以下四個層級之一：213[環境對話框](#configure-your-environment)中的 **Network access** 欄位採用以下三個層級之一：

214 214 

215| 層級 | 出站連線 |215| 層級 | 出站連線 |

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

217| **None** | 透過工作階段網路沒有出站網路存取 |217| **None** | 透過工作階段網路沒有出站網路存取 |

218| **Trusted** | 僅[允許清單中的網域](#default-allowed-domains)：套件登錄、GitHub、雲端 SDK |218| **Limited** | 勾選 **Allow package managers** 時的[預設允許清單](#default-allowed-domains)（套件登錄、GitHub 和雲端 SDK），加上任何[您列出的網域](#allow-specific-domains)。請參閱[被封鎖的請求看起來如何](https://code.claude.com/docs/zh-TW/errors.md#host-not-allowed-in-a-cloud-session)。 |

219| **Full** | 任何網域 |219| **Full** | 任何網域 |

220| **Custom** | 您自己的允許清單，可選擇包括預設值 |

221 220 

222無論您選擇哪個層級，工作階段仍然可以到達這些，因為每個都採用不通過工作階段網路允許清單的路徑：221無論您選擇哪個層級，工作階段仍然可以到達這些，因為每個都採用不通過工作階段網路允許清單的路徑：

223 222 

226* 您在環境的[網路密鑰](#add-network-secrets)上列出的主機，除了[永遠不會取得密鑰的主機](#requests-that-never-get-the-credential)225* 您在環境的[網路密鑰](#add-network-secrets)上列出的主機，除了[永遠不會取得密鑰的主機](#requests-that-never-get-the-credential)

227* Anthropic API，用於 Claude Code 自己的請求，即使在 **None** 時，如[安全性和隔離](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#security-and-isolation)下所述226* Anthropic API，用於 Claude Code 自己的請求，即使在 **None** 時，如[安全性和隔離](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#security-and-isolation)下所述

228 227 

228儲存為 **Trusted** 或 **Custom** 的環境會繼續到達相同的主機，並以下列方式開啟：

229 

230* **儲存為 Trusted**：以 **Limited** 開啟，並勾選 **Allow package managers**

231* **儲存為 Custom**：以 **Limited** 開啟，其 **Allowed domains** 清單和 **Allow package managers** 維持您設定的狀態；若清單包含單獨的 `*`，則以 **Full** 開啟

232 

229### 允許特定網域233### 允許特定網域

230 234 

231若要允許不在 Trusted 清單中的網域，在環境的網路存取設定中選擇 **Custom**，然後在 **Allowed domains** 欄位中每行列出一個網域。此範例允許內部專案可能需要的三個主機。235若要允許不在[預設允許清單](#default-allowed-domains)中的網域，在環境的 **Network access** 選擇器中選擇 **Limited**，然後在 **Allowed domains** 欄位中每行列出一個網域。前導 `*.` 符合每個子網域。此範例允許內部專案可能需要的三個主機。

232 236 

233```text theme={null}237```text theme={null}

234api.example.com238api.example.com

236registry.example.com240registry.example.com

237```241```

238 242 

239此環境中的工作階段現在可以到達 `api.example.com`、`internal.example.com` 的任何子網域和 `registry.example.com`，以及透過工作階段網路沒有其他網域。[GitHub 流量](#github-proxy)、[MCP 連接器流量](#network-access)和對環境[網路密鑰](#add-network-secrets)主機的請求（除了[永遠不會取得密鑰的主機](#requests-that-never-get-the-credential)）不通過此允許清單。前導 `*.` 符合每個子網域。若要也保留[Trusted 網域](#default-allowed-domains)，請勾選 **Also include default list of common package managers**；取消勾選以僅允許您列出的內容。243勾選 **Allow package managers** 時，此環境中的工作階段除了您列出的網域之外，也可以到達[預設允許清單](#default-allowed-domains)。取消勾選以排除預設允許清單。[GitHub 流量](#github-proxy)、[MCP 連接器流量](#network-access)和對環境[網路密鑰](#add-network-secrets)主機的請求（除了[永遠不會取得密鑰的主機](#requests-that-never-get-the-credential)）不通過此允許清單。

240 244 

241如果您的組織使用 [artifact](https://code.claude.com/docs/zh-TW/artifacts.md#availability)，工作階段讀取它們不需要 `*.frame.claudeusercontent.com` 在清單中。當清單省略該主機時，Claude Code 改為透過工作階段與 Anthropic 的連線讀取 artifact 內容。在兩種情況下將主機保留在允許清單中：245如果您的組織使用 [artifact](https://code.claude.com/docs/zh-TW/artifacts.md#availability)，工作階段讀取它們不需要 `*.frame.claudeusercontent.com` 在清單中。當清單省略該主機時，Claude Code 改為透過工作階段與 Anthropic 的連線讀取 artifact 內容。在兩種情況下將主機保留在允許清單中：

242 246 

243* **此環境中的工作階段開啟另一個組織的公開 artifact**：Claude Code 直接從主機擷取這些，因此將其新增到此清單。247* **此環境中的工作階段開啟另一個組織的公開 artifact**：Claude Code 直接從主機擷取這些，因此將其新增到此清單。

244* **您正在設定本機 CLI 或自託管執行器**：將主機保留在該允許清單中。請參閱[網路存取需求](https://code.claude.com/docs/zh-TW/network-config.md#network-access-requirements)和自託管[網路需求](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#network-requirements)。248* **您正在設定本機 CLI 或自託管執行器**：將主機保留在該允許清單中。請參閱[網路存取需求](https://code.claude.com/docs/zh-TW/network-config.md#network-access-requirements)和自託管[網路需求](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#network-requirements)。

245 249 

246每個環境都有自己的允許網域清單；沒有組織層級的允許清單，管理員可以推送到每個成員的環境。沒有[伺服器管理的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)將網域新增到環境的網路允許清單。若要為團隊提供一個標準清單，擁有者可以建立一個具有 **Custom** 網路存取和該清單的[組織共用環境](#organization-shared-environments)。250每個環境都有自己的允許網域清單；沒有可供管理員推送到每個成員環境的組織層級允許清單。也沒有任何[伺服器管理的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)會將網域新增到環境的網路允許清單。若要為團隊提供一個標準清單，擁有者可以建立一個具有 **Limited** 網路存取和該清單的[組織共用環境](#organization-shared-environments)。

247 251 

248### GitHub 代理伺服器252### GitHub 代理伺服器

249 253 

255* **儲存庫範圍**：代理伺服器為附加到工作階段的儲存庫提供 GitHub API 請求服務。針對其他儲存庫的 API 請求會收到 403，其訊息以 `GitHub access to` 開頭並包含 `is not enabled for this session`。當儲存庫未附加時，您透過 `github.com/{owner}/{repo}/archive/` 或 `codeload.github.com` URL 擷取的原始碼封存檔也會收到相同的 403，即使是公開儲存庫也一樣。259* **儲存庫範圍**：代理伺服器為附加到工作階段的儲存庫提供 GitHub API 請求服務。針對其他儲存庫的 API 請求會收到 403，其訊息以 `GitHub access to` 開頭並包含 `is not enabled for this session`。當儲存庫未附加時，您透過 `github.com/{owner}/{repo}/archive/` 或 `codeload.github.com` URL 擷取的原始碼封存檔也會收到相同的 403，即使是公開儲存庫也一樣。

256* **GraphQL 限制**：代理伺服器會以 403 拒絕對 GitHub GraphQL 端點的請求，其訊息以 `GitHub GraphQL is not available from Claude Code sessions` 開頭，並指出 REST 備援 `gh api repos/{owner}/{repo}/...`。使用 GraphQL 的 `gh` 子命令（例如 `gh pr` 和 `gh issue`）會收到相同的 403。限制適用於通過代理伺服器的每個請求，無論您提供的憑證如何，因此您設定的 `GH_TOKEN` 會收到相同的 403。Claude 無法通過代理伺服器到達僅存在於 GraphQL 中的 GitHub API，例如 Projects v2。260* **GraphQL 限制**：代理伺服器會以 403 拒絕對 GitHub GraphQL 端點的請求，其訊息以 `GitHub GraphQL is not available from Claude Code sessions` 開頭，並指出 REST 備援 `gh api repos/{owner}/{repo}/...`。使用 GraphQL 的 `gh` 子命令（例如 `gh pr` 和 `gh issue`）會收到相同的 403。限制適用於通過代理伺服器的每個請求，無論您提供的憑證如何，因此您設定的 `GH_TOKEN` 會收到相同的 403。Claude 無法通過代理伺服器到達僅存在於 GraphQL 中的 GitHub API，例如 Projects v2。

257 261 

258來自公開儲存庫的已提交檔案通過 `raw.githubusercontent.com` 到達，[安全代理伺服器](#security-proxy)改為處理。該網域在預設[Trusted 清單](#default-allowed-domains)中，因此除非環境的[存取層級](#access-levels)排除它，否則這些檔案保持可到達。262來自公開儲存庫的已提交檔案通過 `raw.githubusercontent.com` 到達，[安全代理伺服器](#security-proxy)改為處理。該網域在[預設允許清單](#default-allowed-domains)中，因此只要環境的[網路存取](#access-levels)允許該清單，這些檔案就保持可到達。

259 263 

260### 安全代理伺服器264### 安全代理伺服器

261 265 

391service redis-server start395service redis-server start

392```396```

393 397 

394Docker 可用於執行容器化服務。要求 Claude 執行 `docker compose up` 以啟動您專案的服務。拉取映像的網路存取遵循您環境的[存取層級](#access-levels)，[受信任的預設值](#default-allowed-domains)包括 Docker Hub 和其他常見登錄。398Docker 可用於執行容器化服務。要求 Claude 執行 `docker compose up` 以啟動您專案的服務。拉取映像的網路存取遵循您環境的[存取層級](#access-levels)，[預設允許清單](#default-allowed-domains)包括 Docker Hub 和其他常見登錄。

395 399 

396如果您的映像很大或拉取速度很慢，請將 `docker compose pull` 或 `docker compose build` 新增到您的[設定指令碼](#setup-scripts)。[環境快取](#environment-caching)會保留拉取的映像，因此每個新工作階段都會在磁碟上擁有它們。快取只儲存檔案，不儲存執行中的程序，因此 Claude 仍會在每個工作階段中啟動容器。400如果您的映像很大或拉取速度很慢，請將 `docker compose pull` 或 `docker compose build` 新增到您的[設定指令碼](#setup-scripts)。[環境快取](#environment-caching)會保留拉取的映像，因此每個新工作階段都會在磁碟上擁有它們。快取只儲存檔案，不儲存執行中的程序，因此 Claude 仍會在每個工作階段中啟動容器。

397 401 

445 449 

446* **Exit zero**：如果指令碼以非零狀態結束，工作階段將[無法啟動](https://code.claude.com/docs/zh-TW/web-quickstart.md#setup-script-failed)，或在啟動時缺少指令碼未能安裝的任何內容。在非關鍵命令後附加 `|| true`，以便間歇性安裝失敗不會導致指令碼失敗。450* **Exit zero**：如果指令碼以非零狀態結束，工作階段將[無法啟動](https://code.claude.com/docs/zh-TW/web-quickstart.md#setup-script-failed)，或在啟動時缺少指令碼未能安裝的任何內容。在非關鍵命令後附加 `|| true`，以便間歇性安裝失敗不會導致指令碼失敗。

447* **在五分鐘內完成**：將指令碼的總執行時間保持在大約五分鐘以內，以便[環境快取](#environment-caching)可以建立。當設定耗時超過五分鐘時，環境不會被快取。使用 `&` 和 `wait` 並行執行獨立安裝，並將任何無法納入的單一下載移至[SessionStart hook](#setup-scripts-vs-sessionstart-hooks)，在背景中啟動它。如果新工作階段在設定期間停滯或失敗，請參閱[新工作階段在設定期間掛起或逾時](https://code.claude.com/docs/zh-TW/web-quickstart.md#new-sessions-hang-or-time-out-during-setup)。451* **在五分鐘內完成**：將指令碼的總執行時間保持在大約五分鐘以內，以便[環境快取](#environment-caching)可以建立。當設定耗時超過五分鐘時，環境不會被快取。使用 `&` 和 `wait` 並行執行獨立安裝，並將任何無法納入的單一下載移至[SessionStart hook](#setup-scripts-vs-sessionstart-hooks)，在背景中啟動它。如果新工作階段在設定期間停滯或失敗，請參閱[新工作階段在設定期間掛起或逾時](https://code.claude.com/docs/zh-TW/web-quickstart.md#new-sessions-hang-or-time-out-during-setup)。

448* **安裝的網路存取**：套件安裝需要連接到登錄檔。預設的 **Trusted** 層級涵蓋[常見套件登錄檔](#default-allowed-domains)，包括 npm、PyPI、RubyGems 和 crates.io；使用 **None** 網路存取時，安裝會失敗。452* **安裝的網路存取**：套件安裝需要連接到登錄檔。預設的 **Limited** 層級在勾選 **Allow package managers** 時，涵蓋[常見套件登錄檔](#default-allowed-domains)，包括 npm、PyPI、RubyGems 和 crates.io。使用 **None** 網路存取時，安裝會失敗。

449* **環境的變數尚未設定**：指令碼會在工作階段設定環境的[環境變數](#set-environment-variables)之前執行。請在指令碼本身中設定指令碼所需的任何值。453* **環境的變數尚未設定**：指令碼會在工作階段設定環境的[環境變數](#set-environment-variables)之前執行。請在指令碼本身中設定指令碼所需的任何值。

450 454 

451### 環境快取455### 環境快取

541* **每個工作階段一個儲存庫**：在 Anthropic 託管環境中，具有多個儲存庫的工作階段不會從任何儲存庫的 `.claude/settings.json` 載入 hooks，因此您在其中定義的 SessionStart hook 不會執行。請改用[設定指令碼](#setup-scripts)為這些工作階段安裝相依性。若為自託管環境，請參閱[適用哪個儲存庫的設定](https://code.claude.com/docs/zh-TW/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)。545* **每個工作階段一個儲存庫**：在 Anthropic 託管環境中，具有多個儲存庫的工作階段不會從任何儲存庫的 `.claude/settings.json` 載入 hooks，因此您在其中定義的 SessionStart hook 不會執行。請改用[設定指令碼](#setup-scripts)為這些工作階段安裝相依性。若為自託管環境，請參閱[適用哪個儲存庫的設定](https://code.claude.com/docs/zh-TW/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)。

542* **不適用於專案的雲端討論串**：[專案](https://code.claude.com/docs/zh-TW/claude-projects.md#what-threads-pick-up-from-your-repositories)中的雲端討論串不會執行來自儲存庫 `.claude/settings.json` 的 hooks，無論儲存庫數量為何。在 Anthropic 託管環境中，請使用[設定指令碼](#setup-scripts)為討論串安裝相依性。在自託管環境中，請改用[執行器主機設定](https://code.claude.com/docs/zh-TW/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)中的 hook。546* **不適用於專案的雲端討論串**：[專案](https://code.claude.com/docs/zh-TW/claude-projects.md#what-threads-pick-up-from-your-repositories)中的雲端討論串不會執行來自儲存庫 `.claude/settings.json` 的 hooks，無論儲存庫數量為何。在 Anthropic 託管環境中，請使用[設定指令碼](#setup-scripts)為討論串安裝相依性。在自託管環境中，請改用[執行器主機設定](https://code.claude.com/docs/zh-TW/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)中的 hook。

543* **無雲端專用範圍**：hooks 在本機和雲端工作階段中執行。若要跳過本機執行，請在 `CLAUDE_CODE_REMOTE` 環境變數不為 `true` 時提前結束，如[相依性安裝指令碼](#install-dependencies-with-a-sessionstart-hook)所示。547* **無雲端專用範圍**：hooks 在本機和雲端工作階段中執行。若要跳過本機執行，請在 `CLAUDE_CODE_REMOTE` 環境變數不為 `true` 時提前結束，如[相依性安裝指令碼](#install-dependencies-with-a-sessionstart-hook)所示。

544* **需要網路存取**：安裝命令需要連接到套件登錄檔。如果您的環境使用 **None** 網路存取，這些 hooks 會失敗。**Trusted** 下的[預設允許清單](#default-allowed-domains)涵蓋 npm、PyPI、RubyGems 和 crates.io。548* **需要網路存取**：安裝命令需要連接到套件登錄檔。如果您的環境使用 **None** 網路存取，這些 hook 會失敗。在預設的 **Limited** 層級下勾選 **Allow package managers** 時，[預設允許清單](#default-allowed-domains)涵蓋 npm、PyPI、RubyGems 和 crates.io。

545* **Proxy 相容性**：在 Anthropic 託管環境中，所有出站流量都通過[安全 proxy](#security-proxy)，某些套件管理員無法與此 proxy 正確搭配運作；Bun 是一個已知的範例。在[自託管環境](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#default-deny-egress)中，出站流量通過您自己的網路邊界。549* **Proxy 相容性**：在 Anthropic 託管環境中，所有出站流量都通過[安全 proxy](#security-proxy)，某些套件管理員無法與此 proxy 正確搭配運作；Bun 是一個已知的範例。在[自託管環境](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#default-deny-egress)中，出站流量通過您自己的網路邊界。

546* **增加啟動延遲**：hook 在每次工作階段啟動或恢復時執行，不同於設定指令碼，設定指令碼受益於[環境快取](#environment-caching)。透過跳過已完成的工作來保持安裝指令碼快速，如[相依性安裝指令碼](#install-dependencies-with-a-sessionstart-hook)所示。550* **增加啟動延遲**：hook 在每次工作階段啟動或恢復時執行，不同於設定指令碼，設定指令碼受益於[環境快取](#environment-caching)。透過跳過已完成的工作來保持安裝指令碼快速，如[相依性安裝指令碼](#install-dependencies-with-a-sessionstart-hook)所示。

547 551 

549 553 

550## 預設允許的網域554## 預設允許的網域

551 555 

552使用 **Trusted** 網路存取，工作階段預設可以到達以下網域。標記為 `*` 的網域表示萬用字元子網域符合，因此 `*.gcr.io` 允許 `gcr.io` 的任何子網域。556當在 **Limited** 網路存取下勾選 **Allow package managers** 時（新環境預設即是如此），工作階段可以到達以下網域。標記為 `*` 的網域表示萬用字元子網域符合，因此 `*.gcr.io` 允許 `gcr.io` 的任何子網域。

553 557 

554> [accordion] Anthropic 服務558> [accordion] Anthropic 服務

555>559>

65| `/bug [report]` | 報告錯誤或分享您的對話。您選擇要包含多少工作階段歷史記錄，並在發送任何內容之前在同意螢幕上確認。當您在第一方連線上登入 Anthropic 時，報告會發送給 Anthropic；在第三方提供者上，或沒有 Anthropic 憑證，Claude Code 會將報告寫入[`~/.claude/feedback-bundles/` 下的本地存檔](https://code.claude.com/docs/zh-TW/data-usage#telemetry-services)，您可以自己轉發。在 [VS Code 擴充功能](https://code.claude.com/docs/zh-TW/vs-code.md#use-the-prompt-box)中，`/bug` 改為打開擴充功能自己的回饋對話框；需要 Claude Code v2.1.229 或更新版本。當您在 Claude 回應時運行它時，Claude Code 會立即打開對話框。在 v2.1.232 之前，Claude Code 會將命令排隊直到該回合完成。別名：`/share`。在 v2.1.212 之前，`/bug` 和 `/share` 是 `/feedback` 的別名 |65| `/bug [report]` | 報告錯誤或分享您的對話。您選擇要包含多少工作階段歷史記錄，並在發送任何內容之前在同意螢幕上確認。當您在第一方連線上登入 Anthropic 時，報告會發送給 Anthropic；在第三方提供者上，或沒有 Anthropic 憑證，Claude Code 會將報告寫入[`~/.claude/feedback-bundles/` 下的本地存檔](https://code.claude.com/docs/zh-TW/data-usage#telemetry-services)，您可以自己轉發。在 [VS Code 擴充功能](https://code.claude.com/docs/zh-TW/vs-code.md#use-the-prompt-box)中，`/bug` 改為打開擴充功能自己的回饋對話框；需要 Claude Code v2.1.229 或更新版本。當您在 Claude 回應時運行它時，Claude Code 會立即打開對話框。在 v2.1.232 之前，Claude Code 會將命令排隊直到該回合完成。別名：`/share`。在 v2.1.212 之前，`/bug` 和 `/share` 是 `/feedback` 的別名 |

66| `/cd <path>` | 將此工作階段移動到新的工作目錄，保持對話。輸入部分路徑以查看匹配的目錄建議；按 `Tab` 接受一個。有關 Claude Code 從新目錄立即應用的內容以及 `/cd` 與 `/add-dir` 的區別，請參閱[將工作階段移動到另一個目錄](https://code.claude.com/docs/zh-TW/permissions.md#move-the-session-to-another-directory) |66| `/cd <path>` | 將此工作階段移動到新的工作目錄，保持對話。輸入部分路徑以查看匹配的目錄建議；按 `Tab` 接受一個。有關 Claude Code 從新目錄立即應用的內容以及 `/cd` 與 `/add-dir` 的區別，請參閱[將工作階段移動到另一個目錄](https://code.claude.com/docs/zh-TW/permissions.md#move-the-session-to-another-directory) |

67| `/chrome` | 設定 [Claude in Chrome](https://code.claude.com/docs/zh-TW/chrome.md) 設定 |67| `/chrome` | 設定 [Claude in Chrome](https://code.claude.com/docs/zh-TW/chrome.md) 設定 |

68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 為您的專案語言載入 [Claude API](https://platform.claude.com/docs/en/api/overview) 和 [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) 參考資料。當您的程式碼匯入 `anthropic` 或 `@anthropic-ai/sdk` 時也會自動啟動。有關每個子命令的作用以及它需要的版本，請參閱[在 Claude API 專案上工作](https://code.claude.com/docs/zh-TW/skills.md#work-on-claude-api-projects) |68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|latency-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 為您的專案語言載入 [Claude API](https://platform.claude.com/docs/en/api/overview) 和 [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) 參考資料。當您的程式碼匯入 `anthropic` 或 `@anthropic-ai/sdk` 時也會自動啟動。有關每個子命令的作用以及它需要的版本，請參閱[在 Claude API 專案上工作](https://code.claude.com/docs/zh-TW/skills.md#work-on-claude-api-projects) |

69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 讓 Claude 通過 [Claude in Chrome](https://code.claude.com/docs/zh-TW/chrome.md) 在您的瀏覽器中執行任務，例如測試頁面、填充表單或讀取控制台日誌。在為工作階段啟用 Chrome 整合時可用，例如使用 `claude --chrome`，或當 Claude Code 可以提供[安裝擴充功能](https://code.claude.com/docs/zh-TW/chrome.md#install-the-extension-when-claude-asks)時 |69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 讓 Claude 通過 [Claude in Chrome](https://code.claude.com/docs/zh-TW/chrome.md) 在您的瀏覽器中執行任務，例如測試頁面、填充表單或讀取控制台日誌。在為工作階段啟用 Chrome 整合時可用，例如使用 `claude --chrome`，或當 Claude Code 可以提供[安裝擴充功能](https://code.claude.com/docs/zh-TW/chrome.md#install-the-extension-when-claude-asks)時 |

70| `/clear [name]` | 使用空上下文啟動新對話。傳遞名稱以在 `/resume` 選擇器中標記先前的對話。要在繼續相同對話的同時釋放上下文，請改用 `/compact`。使用 `/resume` 恢復先前的對話，或在同一 Claude Code 程序中，從[倒帶選單的上一個工作階段項目](https://code.claude.com/docs/zh-TW/checkpointing.md#rewind-past-a-cleared-conversation)恢復它。別名：`/reset`、`/new` |70| `/clear [name]` | 使用空上下文啟動新對話。傳遞名稱以在 `/resume` 選擇器中標記先前的對話。要在繼續相同對話的同時釋放上下文，請改用 `/compact`。使用 `/resume` 恢復先前的對話，或在同一 Claude Code 程序中，從[倒帶選單的上一個工作階段項目](https://code.claude.com/docs/zh-TW/checkpointing.md#rewind-past-a-cleared-conversation)恢復它。別名：`/reset`、`/new` |

71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 檢查目前差異或您傳遞的 PR 編號、分支或路徑，以查找正確性錯誤。根據您的模型和 effort 等級，檢查也涵蓋清理機會。傳遞 `--fix` 以應用發現，`--comment` 以在 GitHub PR 或 GitLab merge request 上發佈它們，或 `ultra` 以運行深度[雲端審查](https://code.claude.com/docs/zh-TW/ultrareview.md)。發佈到 GitLab merge request 需要 Claude Code v2.1.257 或更新版本。在 `github.com` PR 目標上使用 `ultra` 時，傳遞 `--post` 以在啟動對話框中預先選擇[將完成的發現發佈到 PR](https://code.claude.com/docs/zh-TW/ultrareview.md#post-findings-to-the-pull-request)；`--post` 需要 Claude Code v2.1.227 或更新版本。有關 effort 等級、目標設定以及它與 `/simplify` 的關係，請參閱[使用 `/code-review` 在本地檢查](https://code.claude.com/docs/zh-TW/code-review-local)。別名：`/review` |71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 檢查目前差異或您傳遞的 PR 編號、分支或路徑，以查找正確性錯誤。根據您的模型和 effort 等級，檢查也涵蓋清理機會。傳遞 `--fix` 以應用發現，`--comment` 以在 GitHub PR 或 GitLab merge request 上發佈它們，或 `ultra` 以運行深度[雲端審查](https://code.claude.com/docs/zh-TW/ultrareview.md)。發佈到 GitLab merge request 需要 Claude Code v2.1.257 或更新版本。在 `github.com` PR 目標上使用 `ultra` 時，傳遞 `--post` 以在啟動對話框中預先選擇[將完成的發現發佈到 PR](https://code.claude.com/docs/zh-TW/ultrareview.md#post-findings-to-the-pull-request)；`--post` 需要 Claude Code v2.1.227 或更新版本。有關 effort 等級、目標設定以及它與 `/simplify` 的關係，請參閱[使用 `/code-review` 在本地檢查](https://code.claude.com/docs/zh-TW/code-review-local)。別名：`/review` |

466claude --worktree feature-auth466claude --worktree feature-auth

467```467```

468 468 

469在第二個終端中使用不同的名稱執行相同的命令以啟動隔離的平行會話。在沒有提交的儲存庫中，命令失敗並顯示 `Failed to resolve base branch "HEAD": git rev-parse failed`。有關清理、`.worktreeinclude` 和非 git VCS 支援，請參閱 [Worktrees](https://code.claude.com/docs/zh-TW/worktrees.md)。要從一個螢幕而不是單獨的終端監視平行會話，請參閱[背景代理](https://code.claude.com/docs/zh-TW/agent-view.md)。469在第二個終端機中使用不同的名稱執行相同的命令以啟動隔離的平行工作階段。有關清理、`.worktreeinclude` 和非 git VCS 支援，請參閱 [Worktrees](https://code.claude.com/docs/zh-TW/worktrees.md)。要從一個螢幕而不是單獨的終端機監視平行工作階段，請參閱[背景 agents](https://code.claude.com/docs/zh-TW/agent-view.md)。

470 470 

471## 編輯前規劃471## 編輯前規劃

472 472 

19 19 

20## 壓縮後保留的內容20## 壓縮後保留的內容

21 21 

22當長時間的工作階段進行壓縮時，Claude Code 會總結對話歷史以適應上下文視窗。自 v2.1.198 起，總結請求會繼承您工作階段的[延伸思考](https://code.claude.com/docs/zh-TW/model-config.md#extended-thinking)設定，因此當您的工作階段啟用思考時，它會在啟用思考的情況下進行推理，否則保持關閉。思考只會影響摘要的生成方式；您的工作階段設定在之後保持不變。每種內容發生的情況取決於它的載入方式：22當長時間的工作階段進行壓縮時，Claude Code 會總結對話歷史以適應上下文視窗。

23 23 

24| 機制 | 壓縮後 |24| 機制 | 壓縮後 |

25| :- | :- |25| :- | :- |

243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 設定為 `1` 可停用 Claude Code 隨附的 [skill](https://code.claude.com/docs/zh-TW/skills.md) 與工作流程：隨附的 skill 與工作流程會被完全移除，而 `/init` 等內建命令仍可輸入，但會對模型隱藏。`/doctor` 與內建命令一樣仍可輸入；請改用 `DISABLE_DOCTOR_COMMAND` 將其隱藏。來自外掛、`.claude/skills/` 與 `.claude/commands/` 的 skill 不受影響。等同於 [`disableBundledSkills`](https://code.claude.com/docs/zh-TW/settings-reference#disablebundledskills) 設定 |243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 設定為 `1` 可停用 Claude Code 隨附的 [skill](https://code.claude.com/docs/zh-TW/skills.md) 與工作流程：隨附的 skill 與工作流程會被完全移除，而 `/init` 等內建命令仍可輸入，但會對模型隱藏。`/doctor` 與內建命令一樣仍可輸入；請改用 `DISABLE_DOCTOR_COMMAND` 將其隱藏。來自外掛、`.claude/skills/` 與 `.claude/commands/` 的 skill 不受影響。等同於 [`disableBundledSkills`](https://code.claude.com/docs/zh-TW/settings-reference#disablebundledskills) 設定 |

244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | 適用於嵌入 Claude Code 並提供自有瀏覽器指引的主機。設為 `1` 可保留 [Claude in Chrome](https://code.claude.com/docs/zh-TW/chrome.md) 瀏覽器工具，同時省略系統提示詞中的 Chrome 區段以及 `/claude-in-chrome` [隨附 skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。在 VS Code 中，v2.1.314 或更新版本的擴充功能也會從工作階段的訊息中省略 Claude in Chrome 指令。需要 Claude Code v2.1.257 或更新版本 |244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | 適用於嵌入 Claude Code 並提供自有瀏覽器指引的主機。設為 `1` 可保留 [Claude in Chrome](https://code.claude.com/docs/zh-TW/chrome.md) 瀏覽器工具，同時省略系統提示詞中的 Chrome 區段以及 `/claude-in-chrome` [隨附 skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。在 VS Code 中，v2.1.314 或更新版本的擴充功能也會從工作階段的訊息中省略 Claude in Chrome 指令。需要 Claude Code v2.1.257 或更新版本 |

245| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 設定為 `1` 可防止將任何 CLAUDE.md 記憶檔案載入上下文，包括使用者、專案與自動記憶檔案 |245| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 設定為 `1` 可防止將任何 CLAUDE.md 記憶檔案載入上下文，包括使用者、專案與自動記憶檔案 |

246| `CLAUDE_CODE_DISABLE_CRON` | 設定為 `1` 可停用[工作階段範圍的排程任務](https://code.claude.com/docs/zh-TW/scheduled-tasks.md)。`/loop` skill 與 cron 工具將無法使用，任何已排程的任務都會停止觸發，包括已在工作階段中途執行的任務 |246| `CLAUDE_CODE_DISABLE_CRON` | 設為 `1` 可停用[工作階段範圍的排程任務](https://code.claude.com/docs/zh-TW/scheduled-tasks.md#disable-scheduled-tasks)。`/loop` skill 與 `CronCreate` 將無法使用，任何已排程的任務都會停止觸發，包括已在工作階段中途執行的任務 |

247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | 設為 `1` 可關閉 `auto` 和 `bypassPermissions` 模式對關鍵路徑刪除所施加的[時間限制與拒絕](https://code.claude.com/docs/zh-TW/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes)。這些刪除接著在 `auto` 模式中會交由分類器處理，在 `bypassPermissions` 模式中則會在 Claude Code 能顯示提示的地方出現無時間限制的提示。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本 |247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | 設為 `1` 可關閉 `auto` 和 `bypassPermissions` 模式對關鍵路徑刪除所施加的[時間限制與拒絕](https://code.claude.com/docs/zh-TW/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes)。這些刪除接著在 `auto` 模式中會交由分類器處理，在 `bypassPermissions` 模式中則會在 Claude Code 能顯示提示的地方出現無時間限制的提示。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本 |

248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 設定為 `1` 可從 API 請求中移除預先發行的 `anthropic-beta` 請求標頭、與其搭配的本文欄位，以及 `defer_loading` 與 `eager_input_streaming` 等 beta 工具結構描述欄位。當代理伺服器閘道因 `anthropic-beta` 標頭而以 `Unexpected value(s)` 錯誤拒絕請求，或出現 `Extra inputs are not permitted` 錯誤時使用。[停用預先發行功能](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#disable-pre-release-capabilities)列出此變數移除的項目（包括 [MCP tool search](https://code.claude.com/docs/zh-TW/mcp.md#scale-with-mcp-tool-search)）以及 Claude Code 持續傳送的項目 |248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 設定為 `1` 可從 API 請求中移除預先發行的 `anthropic-beta` 請求標頭、與其搭配的本文欄位，以及 `defer_loading` 與 `eager_input_streaming` 等 beta 工具結構描述欄位。當代理伺服器閘道因 `anthropic-beta` 標頭而以 `Unexpected value(s)` 錯誤拒絕請求，或出現 `Extra inputs are not permitted` 錯誤時使用。[停用預先發行功能](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#disable-pre-release-capabilities)列出此變數移除的項目（包括 [MCP tool search](https://code.claude.com/docs/zh-TW/mcp.md#scale-with-mcp-tool-search)）以及 Claude Code 持續傳送的項目 |

249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 設定為 `1` 可停用內建的 [Explore 與 Plan subagent](https://code.claude.com/docs/zh-TW/sub-agents.md#built-in-subagents)。Claude 會改用其搜尋工具或 general-purpose subagent 進行探索，而 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 會直接讀取檔案，而非啟動 Explore 與 Plan agent。名為 `Explore` 或 `Plan` 的自訂 subagent 不受影響。若要在 Agent SDK 或非互動模式中移除所有內建 subagent 類型，請改用 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`。需要 Claude Code v2.1.198 或更新版本 |249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 設定為 `1` 可停用內建的 [Explore 與 Plan subagent](https://code.claude.com/docs/zh-TW/sub-agents.md#built-in-subagents)。Claude 會改用其搜尋工具或 general-purpose subagent 進行探索，而 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 會直接讀取檔案，而非啟動 Explore 與 Plan agent。名為 `Explore` 或 `Plan` 的自訂 subagent 不受影響。若要在 Agent SDK 或非互動模式中移除所有內建 subagent 類型，請改用 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`。需要 Claude Code v2.1.198 或更新版本 |

250| `CLAUDE_CODE_DISABLE_FAST_MODE` | 設定為 `1` 可停用[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md) |250| `CLAUDE_CODE_DISABLE_FAST_MODE` | 設定為 `1` 可停用[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md) |

251| `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` | 設為 `1` 可關閉功能旗標擷取。需要 Claude Code v2.1.319 或更新版本。設定此變數後，[Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md#requirements) 和其他[需要功能旗標擷取的功能](#features-that-need-feature-flag-fetching)將無法使用。除非也設定了 `DISABLE_TELEMETRY`，否則遙測事件日誌記錄仍會保持開啟。舊名稱 `DISABLE_GROWTHBOOK` 仍然有效，且它是 v2.1.124 至 v2.1.318 唯一會讀取的名稱 |

251| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 設定為 `1` 可停用「How is Claude doing?」工作階段品質問卷。當設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 時，問卷也會停用，除非 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` 重新選擇加入。若要設定取樣率而非直接停用，請使用 [`feedbackSurveyRate`](https://code.claude.com/docs/zh-TW/settings-reference#feedbacksurveyrate) 設定。請參閱[工作階段品質問卷](https://code.claude.com/docs/zh-TW/data-usage.md#session-quality-surveys) |252| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 設定為 `1` 可停用「How is Claude doing?」工作階段品質問卷。當設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 時，問卷也會停用，除非 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` 重新選擇加入。若要設定取樣率而非直接停用，請使用 [`feedbackSurveyRate`](https://code.claude.com/docs/zh-TW/settings-reference#feedbacksurveyrate) 設定。請參閱[工作階段品質問卷](https://code.claude.com/docs/zh-TW/data-usage.md#session-quality-surveys) |

252| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 設定為 `1` 可停用檔案[檢查點功能](https://code.claude.com/docs/zh-TW/checkpointing.md)。`/rewind` 命令將無法還原程式碼變更。覆寫 [`fileCheckpointingEnabled`](https://code.claude.com/docs/zh-TW/settings-reference#filecheckpointingenabled) 設定 |253| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 設定為 `1` 可停用檔案[檢查點功能](https://code.claude.com/docs/zh-TW/checkpointing.md)。`/rewind` 命令將無法還原程式碼變更。覆寫 [`fileCheckpointingEnabled`](https://code.claude.com/docs/zh-TW/settings-reference#filecheckpointingenabled) 設定 |

253| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | 設為 `1` 可阻止 Claude Code 展開檔案和目錄的 [`@` 提及](https://code.claude.com/docs/zh-TW/common-workflows#reference-files-and-directories)。Claude 會改為取得所提及的路徑，並附上請它使用檔案工具讀取這些路徑的說明。在[專案和本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略。需要 Claude Code v2.1.299 或更新版本 |254| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | 設為 `1` 可阻止 Claude Code 展開檔案和目錄的 [`@` 提及](https://code.claude.com/docs/zh-TW/common-workflows#reference-files-and-directories)。Claude 會改為取得所提及的路徑，並附上請它使用檔案工具讀取這些路徑的說明。在[專案和本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略。需要 Claude Code v2.1.299 或更新版本 |

451| `DISABLE_ERROR_REPORTING` | 設定為任何非空值（例如 `1`）可選擇退出錯誤回報。**與大多數開關變數不同，設定為 `0` 或 `false` 仍會選擇退出**；取消設定此變數即可重新開啟錯誤回報 |452| `DISABLE_ERROR_REPORTING` | 設定為任何非空值（例如 `1`）可選擇退出錯誤回報。**與大多數開關變數不同，設定為 `0` 或 `false` 仍會選擇退出**；取消設定此變數即可重新開啟錯誤回報 |

452| `DISABLE_EXTRA_USAGE_COMMAND` | 設定為 `1` 可隱藏讓使用者購買超出速率限制之額外用量的 `/usage-credits` 命令 |453| `DISABLE_EXTRA_USAGE_COMMAND` | 設定為 `1` 可隱藏讓使用者購買超出速率限制之額外用量的 `/usage-credits` 命令 |

453| `DISABLE_FEEDBACK_COMMAND` | 設定為 `1` 可停用 `/feedback` 命令與 [Claude 草擬的意見回饋](https://code.claude.com/docs/zh-TW/tools-reference.md#sendfeedback-tool-behavior)。也會停用透過相同路徑回報的 `/bug` 與 `/share`；在 v2.1.212 之前，它們是 `/feedback` 的別名，因此該命令的每個名稱都會被停用。也接受較舊的名稱 `DISABLE_BUG_COMMAND` |454| `DISABLE_FEEDBACK_COMMAND` | 設定為 `1` 可停用 `/feedback` 命令與 [Claude 草擬的意見回饋](https://code.claude.com/docs/zh-TW/tools-reference.md#sendfeedback-tool-behavior)。也會停用透過相同路徑回報的 `/bug` 與 `/share`；在 v2.1.212 之前，它們是 `/feedback` 的別名，因此該命令的每個名稱都會被停用。也接受較舊的名稱 `DISABLE_BUG_COMMAND` |

454| `DISABLE_GROWTHBOOK` | 設定為 `1` 或 `true` 可停用功能旗標擷取，並對每個旗標使用程式碼預設值。這會使 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md#requirements) 和其他[需要功能旗標擷取的功能](#features-that-need-feature-flag-fetching)無法使用。將其設定為 `0` 或 `false` 會保持擷取開啟。除非也設定了 `DISABLE_TELEMETRY`，否則遙測事件日誌會保持開啟 |455| `DISABLE_GROWTHBOOK` | 設為 `1` 可關閉[功能旗標擷取](#features-that-need-feature-flag-fetching)。需要 Claude Code v2.1.124 或更新版本。已由需要 v2.1.319 或更新版本的 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 取代：請使用該名稱，除非有執行 v2.1.318 或更早版本的機器會讀取此設定。此名稱仍可使用 |

455| `DISABLE_INSTALLATION_CHECKS` | 設定為 `1` 可停用安裝警告。僅在手動管理安裝位置時使用，因為這可能會掩蓋標準安裝的問題 |456| `DISABLE_INSTALLATION_CHECKS` | 設定為 `1` 可停用安裝警告。僅在手動管理安裝位置時使用，因為這可能會掩蓋標準安裝的問題 |

456| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | 設定為 `1` 可隱藏 `/install-github-app` 命令。使用第三方提供者（Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry）時已經隱藏 |457| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | 設定為 `1` 可隱藏 `/install-github-app` 命令。使用第三方提供者（Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry）時已經隱藏 |

457| `DISABLE_INTERLEAVED_THINKING` | 設定為 `1` 可避免傳送 interleaved-thinking beta 標頭。當您的 LLM 閘道或提供者不支援[交錯思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)時很有用 |458| `DISABLE_INTERLEAVED_THINKING` | 設定為 `1` 可避免傳送 interleaved-thinking beta 標頭。當您的 LLM 閘道或提供者不支援[交錯思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)時很有用 |

569 570 

570Claude Code 會透過從 Anthropic 擷取的功能旗標來啟用部分功能。在下列工作階段中，Claude Code 會略過該擷取：571Claude Code 會透過從 Anthropic 擷取的功能旗標來啟用部分功能。在下列工作階段中，Claude Code 會略過該擷取：

571 572 

572* 設定了 `DISABLE_GROWTHBOOK`、`DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 的工作階段；[變數表](#variables)中每個變數的列會說明哪些值會關閉擷取573* 設定了 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`、`DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 的工作階段；[變數表](#variables)中每個變數的列會說明哪些值會關閉擷取

573* 使用[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry）的工作階段，除非嵌入 Claude Code 的主機平台設定了 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`574* 使用[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry）的工作階段，除非嵌入 Claude Code 的主機平台設定了 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`

574* [Claude apps 閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway)工作階段575* [Claude apps 閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway)工作階段

575 576 

576關閉擷取時，您無法：577關閉擷取時，您無法：

577 578 

578* 在設定了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK` 的情況下使用 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md)。關於 `DISABLE_TELEMETRY` 和 `DO_NOT_TRACK`，請參閱 [Remote Control 需求](https://code.claude.com/docs/zh-TW/remote-control.md#requirements)579* 在設定了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](#variables) 的情況下使用 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md)。關於 `DISABLE_TELEMETRY` 和 `DO_NOT_TRACK`，請參閱 [Remote Control 需求](https://code.claude.com/docs/zh-TW/remote-control.md#requirements)

579* 在 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md#requirements) 無法使用時，[傳送訊息給此機器以外的工作階段](https://code.claude.com/docs/zh-TW/cross-session-messaging.md#message-sessions-on-other-machines)。關閉擷取時，此機器上工作階段之間的訊息傳送仍可運作580* 在 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md#requirements) 無法使用時，[傳送訊息給此機器以外的工作階段](https://code.claude.com/docs/zh-TW/cross-session-messaging.md#message-sessions-on-other-machines)。關閉擷取時，此機器上工作階段之間的訊息傳送仍可運作

580* 執行 [`claude import` 或 `/import` 命令](https://code.claude.com/docs/zh-TW/cli-reference#cli-commands)581* 執行 [`claude import` 或 `/import` 命令](https://code.claude.com/docs/zh-TW/cli-reference#cli-commands)

581* 執行 [`/skill-doctor`](https://code.claude.com/docs/zh-TW/skills#find-unused-skills)，或在 `/plugin` 的 **Stats** 分頁中開啟其報告582* 執行 [`/skill-doctor`](https://code.claude.com/docs/zh-TW/skills#find-unused-skills)，或在 `/plugin` 的 **Stats** 分頁中開啟其報告

582* 在 Pro、Max 和 Ultra 方案上執行 [`/restart`](https://code.claude.com/docs/zh-TW/commands)583* 在 Pro、Max 和 Ultra 方案上執行 [`/restart`](https://code.claude.com/docs/zh-TW/commands)

583* 將您的 claude.ai 帳戶所啟用的 [skills](https://code.claude.com/docs/zh-TW/skills.md#where-synced-skills-load) 和[外掛](https://code.claude.com/docs/zh-TW/plugins/loading.md#synced-plugins)同步到您的終端機工作階段584* 將您的 claude.ai 帳戶所啟用的 [skills](https://code.claude.com/docs/zh-TW/skills.md#where-synced-skills-load) 和[外掛](https://code.claude.com/docs/zh-TW/plugins/loading.md#synced-plugins)同步到您的終端機工作階段

584* 啟用 [You should know mod](https://code.claude.com/docs/zh-TW/interactive-mode.md#you-should-know-suggestions)585* 啟用 [You should know mod](https://code.claude.com/docs/zh-TW/interactive-mode.md#you-should-know-suggestions)

585* 使用 [advisor 工具](https://code.claude.com/docs/zh-TW/advisor.md#requirements)586* 使用 [advisor 工具](https://code.claude.com/docs/zh-TW/advisor.md#requirements)，但在 Claude Platform on AWS 上使用 Claude Code v2.1.300 或更新版本時除外

586* 使用 [MCP tasks](https://code.claude.com/docs/zh-TW/mcp.md#mcp-tasks-that-run-on-the-server)587* 使用 [MCP tasks](https://code.claude.com/docs/zh-TW/mcp.md#mcp-tasks-that-run-on-the-server)

587* 閱讀或回覆 [artifact 上的留言](https://code.claude.com/docs/zh-TW/artifacts.md#collect-comments-on-an-artifact)588* 閱讀或回覆 [artifact 上的留言](https://code.claude.com/docs/zh-TW/artifacts.md#collect-comments-on-an-artifact)

588* 讓 Claude 讀取[其他組織的公開 artifact](https://code.claude.com/docs/zh-TW/artifacts.md#read-an-artifact-shared-with-you)589* 讓 Claude 讀取[其他組織的公開 artifact](https://code.claude.com/docs/zh-TW/artifacts.md#read-an-artifact-shared-with-you)

562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 500 | API 以 `529` 過載錯誤拒絕的請求，其重試之間退避的起始延遲（毫秒）。當 API 容量已滿時，可提高此值（最高 32000），以將重試分散在較長的時間範圍內。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或被拒絕的請求是以[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)發送時，此設定無效。需要 Claude Code v2.1.292 或更新版本。 |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 500 | API 以 `529` 過載錯誤拒絕的請求，其重試之間退避的起始延遲（毫秒）。當 API 容量已滿時，可提高此值（最高 32000），以將重試分散在較長的時間範圍內。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或被拒絕的請求是以[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)發送時，此設定無效。需要 Claude Code v2.1.292 或更新版本。 |

563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 32000 | API 以 `529` 過載錯誤拒絕的請求，其重試之間退避的上限（毫秒）。當 API 容量已滿時，可提高此值（最高 64000），讓後續的重試間隔持續拉長。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或被拒絕的請求是以[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)發送時，此設定無效。需要 Claude Code v2.1.296 或更新版本。 |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 32000 | API 以 `529` 過載錯誤拒絕的請求，其重試之間退避的上限（毫秒）。當 API 容量已滿時，可提高此值（最高 64000），讓後續的重試間隔持續拉長。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或被拒絕的請求是以[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)發送時，此設定無效。需要 Claude Code v2.1.296 或更新版本。 |

564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 600000 | 每次請求嘗試接收其回應標頭的可用時間（毫秒）。它不會限制串流回應在此之後持續執行的時間。在慢速網路或代理伺服器上請提高此值。關於它如何限制首位元組截止時間，請參閱 [No response from API](#no-response-from-api)。 |564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 600000 | 每次請求嘗試接收其回應標頭的可用時間（毫秒）。它不會限制串流回應在此之後持續執行的時間。在慢速網路或代理伺服器上請提高此值。關於它如何限制首位元組截止時間，請參閱 [No response from API](#no-response-from-api)。 |

565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 逾時的[非串流請求](#streaming-response-ended-before-any-complete-data-was-received)重新發送次數上限。達到上限時，請求會失敗。Claude 產生時間超過逾時的回應在每次重新發送時都會再次逾時，因此請設定較低的數字（例如 `0`）以便更快失敗。在本機工作階段中，每次非串流嘗試會在 300 秒後逾時，或當您設定正值時在 `API_TIMEOUT_MS` 後逾時。需要 Claude Code v2.1.285 或更新版本。 |565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 逾時的[非串流請求](#streaming-response-ended-before-any-complete-data-was-received)重新發送次數上限。達到上限時，請求會失敗。Claude 產生時間超過逾時的回應在每次重新發送時都會再次逾時，因此請設定較低的數字（例如 `0`）以便更快失敗。關於每次嘗試的逾時，請參閱[非串流嘗試的等待時間](#how-long-a-non-streaming-attempt-waits)。需要 Claude Code v2.1.285 或更新版本。 |

566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 串流請求的第一個回應位元組的截止時間（毫秒）。需要 Claude Code v2.1.242 或更新版本。關於當此未設定時 Claude Code 如何選擇截止時間，請參閱 [No response from API](#no-response-from-api)。 |566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 串流請求的第一個回應位元組的截止時間（毫秒）。需要 Claude Code v2.1.242 或更新版本。關於當此未設定時 Claude Code 如何選擇截止時間，請參閱 [No response from API](#no-response-from-api)。 |

567 567 

568#### 非串流嘗試的等待時間

569 

570非串流嘗試會在其請求逾時或主體閒置逾時時結束，以先到者為準：

571 

572* **請求逾時**：當您設定正值時為 `API_TIMEOUT_MS`，否則在本機工作階段中為 300 秒。

573* **[主體閒置逾時](https://code.claude.com/docs/zh-TW/network-config.md#streaming-idle-watchdogs)**：5 到 6 分鐘沒有回應，無論您將 `API_TIMEOUT_MS` 設得多高；適用於其執行且您未將其關閉的情況。

574 

568## 伺服器錯誤575## 伺服器錯誤

569 576 

570這些錯誤大多來自推論供應商：在 Anthropic API 上是 Anthropic 的服務；在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自訂閘道上，則是該供應商端點背後的服務。[Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) 與 [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) 也涵蓋了您這一端的原因，例如無法呼叫分類器模型的 Amazon Bedrock 帳戶，或達到用量上限的 subagent。577這些錯誤大多來自推論供應商：在 Anthropic API 上是 Anthropic 的服務；在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自訂閘道上，則是該供應商端點背後的服務。[Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) 與 [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) 也涵蓋了您這一端的原因，例如無法呼叫分類器模型的 Amazon Bedrock 帳戶，或達到用量上限的 subagent。

2212此錯誤不是用戶端網路問題。雲端工作階段和[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)在沙箱 VM 內執行，其透過工作階段網路的出站流量被過濾到[雲端環境的](https://code.claude.com/docs/zh-TW/cloud-environments.md)允許清單：2219此錯誤不是用戶端網路問題。雲端工作階段和[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)在沙箱 VM 內執行，其透過工作階段網路的出站流量被過濾到[雲端環境的](https://code.claude.com/docs/zh-TW/cloud-environments.md)允許清單：

2213 2220 

2214* **GitHub 和連接器流量**：[GitHub 操作](https://code.claude.com/docs/zh-TW/cloud-environments.md#github-proxy)和 MCP 連接器流量使用單獨的通道，這就是為什麼它們可以在其他主機被阻止時繼續工作2221* **GitHub 和連接器流量**：[GitHub 操作](https://code.claude.com/docs/zh-TW/cloud-environments.md#github-proxy)和 MCP 連接器流量使用單獨的通道，這就是為什麼它們可以在其他主機被阻止時繼續工作

2215* **預設環境**：**預設**環境使用**信任**存取，允許[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)的套件登錄、雲端提供者 API、容器登錄和常見開發網域，並阻止該路徑上的其他網域2222* **預設環境**：**預設**環境使用**有限**存取，並勾選**允許套件管理員**。其工作階段可以到達[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)中的套件登錄、雲端提供者 API、容器登錄和常見開發網域。

2216 2223 

2217**該怎麼做：**2224**該怎麼做：**

2218 2225 

2219這些步驟會變更您自己的環境之一。[組織共享環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#organization-shared-environments)在選擇器中以唯讀方式開啟，因此請要求擁有者從[管理設定](https://claude.ai/admin-settings)中的**雲端環境**頁面變更其網路存取。2226這些步驟會變更您自己的環境之一。[組織共享環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#organization-shared-environments)在選擇器中以唯讀方式開啟，因此請要求擁有者從[管理設定](https://claude.ai/admin-settings)中的**雲端環境**頁面變更其網路存取。

2220 2227 

2221* 開啟您的環境進行編輯，可從[雲端排程任務的表單](https://code.claude.com/docs/zh-TW/routines.md#environments-and-network-access)，或從您啟動雲端工作階段的[環境選擇器](https://code.claude.com/docs/zh-TW/cloud-environments.md#configure-your-environment)開啟。2228* 開啟您的環境進行編輯，可從[雲端排程任務的表單](https://code.claude.com/docs/zh-TW/routines.md#environments-and-network-access)，或從您啟動雲端工作階段的[環境選擇器](https://code.claude.com/docs/zh-TW/cloud-environments.md#configure-your-environment)開啟。

2222* 在**編輯雲端環境**對話方塊中，將**網路存取**從**信任**變更為**自訂**，然後將被阻止的網域新增到**允許的網域**。每行輸入一個網域。勾選**也包括常見套件管理員的預設清單**以在您的自訂網域旁邊保留[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)。如果您想要不受限制的存取，請改為選擇**完整**。2229* 在**編輯雲端環境**對話方塊中，在**網路存取**下選擇**有限**，然後將被阻止的網域新增到**允許的網域**。每行輸入一個網域。勾選**允許套件管理員**，以在您自己的網域之外一併允許[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)。如果您想要不受限制的存取，請改為選擇**完整**。

2223* 按一下**儲存變更**。下一次執行使用更新的允許清單。對於已開啟的雲端工作階段，請參閱[網路存取變更何時到達現有工作階段](https://code.claude.com/docs/zh-TW/cloud-environments.md#network-access)。2230* 按一下**儲存變更**。下一次執行使用更新的允許清單。對於已開啟的雲端工作階段，請參閱[網路存取變更何時到達現有工作階段](https://code.claude.com/docs/zh-TW/cloud-environments.md#network-access)。

2224 2231 

2225請參閱[網路存取](https://code.claude.com/docs/zh-TW/cloud-environments.md#network-access)以了解存取層級和預設允許清單。本機 CLI 工作階段不受此原則影響。2232請參閱[網路存取](https://code.claude.com/docs/zh-TW/cloud-environments.md#network-access)以了解存取層級和預設允許清單。本機 CLI 工作階段不受此原則影響。

2342**該怎麼做：**2349**該怎麼做：**

2343 2350 

2344* **未登入**：訊息接著顯示 `: not signed in. Run /login, then retry.`。執行 `/login`，然後再次傳送2351* **未登入**：訊息接著顯示 `: not signed in. Run /login, then retry.`。執行 `/login`，然後再次傳送

2345* **您組織的拒絕**：例如 `: Feedback has not been enabled for your organization.` 或 `: Feedback collection is not available for organizations with custom data retention policies.`。如果訊息附加 `To report a bug, open an issue`，請在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交 issue。之後七天內，`/feedback` 可能會回應它已[被您組織的原則停用](#feedback-is-disabled-by-your-organizations-policy)。佇列中的草稿會保留在佇列中，並仍會[依排程過期](https://code.claude.com/docs/zh-TW/tools-reference.md#discard-or-keep-a-draft)2352* **您組織的拒絕**：例如 `: Feedback has not been enabled for your organization.` 或 `: Feedback collection is not available for organizations with custom data retention policies.`。之後七天內，`/feedback` 可能會回應它已[被您組織的原則停用](#feedback-is-disabled-by-your-organizations-policy)。佇列中的草稿會保留在佇列中，並仍會[依排程過期](https://code.claude.com/docs/zh-TW/tools-reference.md#discard-or-keep-a-draft)

2346* **憑證遭拒**：訊息接著顯示 `: the sign-in this session uses is not allowed to send feedback` 或 `: the server did not accept the credentials this session uses`。在 Claude Code 提示字元執行 `/status`，以查看此工作階段傳送的是哪個登入、token 或 API 金鑰2353* **憑證遭拒**：訊息接著顯示 `: the sign-in this session uses is not allowed to send feedback` 或 `: the server did not accept the credentials this session uses`。在 Claude Code 提示字元執行 `/status`，以查看此工作階段傳送的是哪個登入、token 或 API 金鑰

2347* **`Couldn't send feedback` 後緊接著 `(request timed out)` 或 `(couldn't reach the service)`**：再次傳送報告或佇列中的草稿。對話方塊會保留您的文字，而佇列中草稿的訊息會顯示 `The draft is still queued.`。如果其他請求也失敗，請檢查您的網路連線並查看 [Unable to connect to API](#unable-to-connect-to-api)。如果持續失敗，請在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交報告2354* **`Couldn't send feedback` 後緊接著 `(request timed out)` 或 `(couldn't reach the service)`**：再次傳送報告或佇列中的草稿。對話方塊會保留您的文字，而佇列中草稿的訊息會顯示 `The draft is still queued.`。如果其他請求也失敗，請檢查您的網路連線並查看 [Unable to connect to API](#unable-to-connect-to-api)。如果持續失敗，請在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交報告

2348* **`Couldn't send feedback` 後緊接著 `(server returned <status>)`，或沒有任何原因**：狀態是服務的回應代碼。當服務有傳送自己的訊息時，該訊息會接在狀態之後，例如 `(server returned 403: Access Forbidden)`。如果持續失敗，請在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交報告2355* **`Couldn't send feedback` 後緊接著 `(server returned <status>)`，或沒有任何原因**：狀態是服務的回應代碼。當服務有傳送自己的訊息時，該訊息會接在狀態之後，例如 `(server returned 403: Access Forbidden)`。如果持續失敗，請在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交報告

3492* **`Error: Workspace not trusted. <folder> is your home directory`**：由於對家目錄的信任永遠不會被儲存，先在那裡執行 `claude` 並沒有幫助。請改從專案目錄執行 `claude ultrareview`（事先在那裡執行一次 `claude` 以接受信任對話框），或附加 `--trust-workspace`。3499* **`Error: Workspace not trusted. <folder> is your home directory`**：由於對家目錄的信任永遠不會被儲存，先在那裡執行 `claude` 並沒有幫助。請改從專案目錄執行 `claude ultrareview`（事先在那裡執行一次 `claude` 以接受信任對話框），或附加 `--trust-workspace`。

3493* **`No answer in time.` 後接 `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` 問題在 5 分鐘內未獲回答。請再次執行 `claude ultrareview` 並回答它。3500* **`No answer in time.` 後接 `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` 問題在 5 分鐘內未獲回答。請再次執行 `claude ultrareview` 並回答它。

3494* **`Ultrareview did not start: <folder> is not trusted`**：您在 `Trust <folder>? [y/N]` 問題中拒絕了，例如回答 `n` 或按下 Enter。若要啟動審查，請再次執行 `claude ultrareview` 並回答 `y`。3501* **`Ultrareview did not start: <folder> is not trusted`**：您在 `Trust <folder>? [y/N]` 問題中拒絕了，例如回答 `n` 或按下 Enter。若要啟動審查，請再次執行 `claude ultrareview` 並回答 `y`。

3495* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` 後面接了旗標以外的內容，例如 PR 編號或 `false`。若您不信任該資料夾，請省略此旗標。若要在此次執行中信任它，請將 PR 編號或基礎分支放在旗標之前：`claude ultrareview 1234 --trust-workspace`。3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` 後面接了旗標以外的內容，例如 PR 編號或 `false`。若您不信任該資料夾，請省略此旗標。若要在本次執行中信任它，請將 PR 編號或基底分支放在旗標之前：`claude ultrareview 1234 --trust-workspace`。

3496 3503 

3497在 v2.1.309 之前，`claude ultrareview` 不接受 `--trust-workspace`。3504在 v2.1.309 之前，`claude ultrareview` 不接受 `--trust-workspace`。

3498 3505 

3557 3564 

3558* 您在安裝後尚未啟動過工作階段，因此 Claude Code 尚未擷取該旗標。即使您可以使用此功能，第一次執行 `claude import` 時也可能列印此訊息。3565* 您在安裝後尚未啟動過工作階段，因此 Claude Code 尚未擷取該旗標。即使您可以使用此功能，第一次執行 `claude import` 時也可能列印此訊息。

3559* 您透過 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 Claude Platform on AWS 使用 Claude Code，或透過 [Claude apps 閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway#availability-and-limitations)使用。Claude Code 在這些工作階段中不會擷取功能旗標，因此 `claude import` 會一直無法使用。3566* 您透過 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 Claude Platform on AWS 使用 Claude Code，或透過 [Claude apps 閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway#availability-and-limitations)使用。Claude Code 在這些工作階段中不會擷取功能旗標，因此 `claude import` 會一直無法使用。

3560* 您設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK` 或 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/zh-TW/env-vars)，這些會關閉功能旗標的擷取，因此 `claude import` 會一直無法使用。3567* 您設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、[`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/zh-TW/env-vars#variables)、`DISABLE_GROWTHBOOK` 或 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/zh-TW/env-vars)，這些會關閉功能旗標擷取，因此 `claude import` 會維持無法使用。

3561 3568 

3562**處理方式：**3569**處理方式：**

3563 3570 

3799 3806 

3800以下同類字串會在命令執行之前就觸發：3807以下同類字串會在命令執行之前就觸發：

3801 3808 

3802* `Shell command permission check failed for pattern "..."`：該命令的權限檢查不允許它。[注入命令的權限檢查](https://code.claude.com/docs/zh-TW/skills.md#permission-checks-on-injected-commands)說明了在各權限模式下哪些結果會中止，以及如何以 `allowed-tools` 預先核准命令3809* `Shell command permission check failed for pattern "..."`：命令的權限檢查未允許它。[注入命令的權限檢查](https://code.claude.com/docs/zh-TW/skills.md#permission-checks-on-injected-commands)說明了在各權限模式下哪些結果會中止，以及如何以 `allowed-tools` 預先核准命令

3803* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：該 skill 的 frontmatter 要求在沒有 bash 的電腦上使用 bash。請安裝 Git for Windows，或將 frontmatter 改為 `shell: powershell`。請參閱[注入命令的執行方式](https://code.claude.com/docs/zh-TW/skills.md#how-injected-commands-run)3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：skill 的 frontmatter 要求 bash，但機器上沒有 bash。請安裝 Git for Windows，或將 frontmatter 改為 `shell: powershell`。請參閱[注入命令的執行方式](https://code.claude.com/docs/zh-TW/skills.md#how-injected-commands-run)

3804 3811 

3805**處理方式：**3812**處理方式：**

3806 3813 

3953 3960 

3954* **您沒有傳入基底分支**：Claude Code 與儲存庫的預設分支進行比較，並建議您明確傳入基底分支，如上例所示3961* **您沒有傳入基底分支**：Claude Code 與儲存庫的預設分支進行比較，並建議您明確傳入基底分支，如上例所示

3955* **您傳入的基底分支已存在於您的複製中**：提示內容為 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3962* **您傳入的基底分支已存在於您的複製中**：提示內容為 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3956* **您傳入的基礎分支不在您的複製中**：Claude Code 在比較前會先從 origin 擷取該分支。提示內容為 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``；當 Claude Code 無法判斷您的複製是否為淺層複製時，會改為建議 `git fetch --unshallow origin`。在 v2.1.221 之前，提示會針對每個擷取的基礎分支建議 `git fetch --unshallow origin`，而在完整的複製上，該命令會以 `fatal: --unshallow on a complete repository does not make sense` 失敗。3963* **您傳入的基礎分支不在您的複製中**：Claude Code 在比較前從 origin 擷取了該分支。提示內容為 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``；當 Claude Code 無法判斷您的複製是否為淺層複製時，會改為建議 `git fetch --unshallow origin`。在 v2.1.221 之前，對於每個擷取的基礎分支，提示都會建議 `git fetch --unshallow origin`，而在完整的複製上，該命令會失敗並顯示 `fatal: --unshallow on a complete repository does not make sense`。

3957 3964 

3958**處理方式：**3965**處理方式：**

3959 3966 

6615 6622 

6616**2. 更新共用家目錄的每一台主機**6623**2. 更新共用家目錄的每一台主機**

6617 6624 

6618若多台主機共用此家目錄，請先將每台主機上的 Claude Code 更新至訊息所指的版本或更新版本。較舊的版本可能會將已移走的 `.config.json` 寫回。6625若多台主機共用此家目錄，請先將每台主機上的 Claude Code 更新至訊息所指的版本或更新版本。

6619 6626 

6620**3. 停止 Claude Code**6627**3. 停止 Claude Code**

6621 6628 

112 <td>✓</td>112 <td>✓</td>

113 <td>✓</td>113 <td>✓</td>

114 <td>✗</td>114 <td>✗</td>

115 <td>✗</td>115 <td>✓（Claude Code v2.1.300 或更新版本）</td>

116 <td>✗</td>116 <td>✗</td>

117 <td>✗</td>117 <td>✗</td>

118 </tr>118 </tr>

221 221 

222> [!NOTE]222> [!NOTE]

223>223>

224> 若您透過 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)進行身分驗證，功能可用性會與閘道所轉送的底層供應商相同，但 Claude Code 本身關閉的功能除外。只要 `ANTHROPIC_BASE_URL` 指向 `api.anthropic.com` 以外的主機，無論閘道轉送至何處，Claude Code 都會關閉 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md#requirements) 與[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md#platform-availability)等功能。部分 Anthropic 專屬功能（例如 [Advisor](https://code.claude.com/docs/zh-TW/advisor.md)）僅在閘道將請求完整轉送至 Anthropic API 時才能運作。224> 若您透過 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)進行身分驗證，功能可用性會與閘道所轉送的底層供應商相同，但 Claude Code 本身關閉的功能除外。只要 `ANTHROPIC_BASE_URL` 指向 `api.anthropic.com` 以外的主機，無論閘道轉送至何處，Claude Code 都會關閉 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md#requirements) 與[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md#platform-availability)等功能。部分功能（例如 [Advisor](https://code.claude.com/docs/zh-TW/advisor.md#requirements)）僅在閘道完整轉送請求時才能運作。

225>225>

226> 如需了解 Claude Code 在 Amazon Bedrock 或 Agent Platform 格式的閘道、`ANTHROPIC_BASE_URL` 閘道，以及 Claude apps 閘道登入之間所傳送的請求有何不同，請參閱[依連線方式區分的用戶端行為](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior)。226> 如需了解 Claude Code 在 Amazon Bedrock 或 Agent Platform 格式的閘道、`ANTHROPIC_BASE_URL` 閘道，以及 Claude apps 閘道登入之間所傳送的請求有何不同，請參閱[依連線方式區分的用戶端行為](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior)。

227 227 

244 244 

245> [tab] Claude Platform on AWS245> [tab] Claude Platform on AWS

246>246>

247> \*\*無法使用：\*\*所有[需要 Claude 訂閱的功能](#features-that-require-a-claude-subscription)，以及[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)、[Advisor](https://code.claude.com/docs/zh-TW/advisor.md)、[頻道](https://code.claude.com/docs/zh-TW/channels.md)、[GitHub Actions](https://code.claude.com/docs/zh-TW/github-actions.md)、[分析儀表板](https://code.claude.com/docs/zh-TW/analytics.md)、[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)，以及 [`/design-sync` 與 `/import` 命令](https://code.claude.com/docs/zh-TW/commands#all-commands)。247> \*\*無法使用：\*\*所有[需要 Claude 訂閱的功能](#features-that-require-a-claude-subscription)，以及[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)、[頻道](https://code.claude.com/docs/zh-TW/channels.md)、[GitHub Actions](https://code.claude.com/docs/zh-TW/github-actions.md)、[分析儀表板](https://code.claude.com/docs/zh-TW/analytics.md)、[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)，以及 [`/design-sync` 與 `/import` 命令](https://code.claude.com/docs/zh-TW/commands#all-commands)。

248>248>

249> **Amazon Bedrock 不支援但此處可用：**[網頁搜尋](https://code.claude.com/docs/zh-TW/tools-reference.md#websearch-tool-behavior)。249> **Amazon Bedrock 不支援但此處可用：**[網頁搜尋](https://code.claude.com/docs/zh-TW/tools-reference.md#websearch-tool-behavior)，以及 Claude Code v2.1.300 或更新版本中的 [Advisor](https://code.claude.com/docs/zh-TW/advisor.md)。

250>250>

251> **部分支援：**251> **部分支援：**

252>252>

54 54 

55### Auto mode55### Auto mode

56 56 

57一種 [permission mode](#permission-mode)，其中單獨的分類器模型審查動作而不是您，因此 Claude Code 可以在不詢問您的情況下執行大多數動作。Claude Code 仍會在您的明確 ask 規則相符的動作之前詢問您。分類器會阻止範圍升級、不受信任的基礎設施和 [prompt injection](#prompt-injection)。工具結果會從它看到的內容中移除，因此檔案或網頁中的惡意內容無法直接操縱它。57一種 [權限模式](#permission-mode)，其中由單獨的分類器模型代替您審查動作，因此 Claude Code 可以在不詢問您的情況下執行大多數動作。Claude Code 仍會在您的明確 ask 規則相符的動作之前詢問您。分類器會阻止範圍升級、不受信任的基礎設施和 [提示詞注入](#prompt-injection)。

58 58 

59* **Claude Code v2.1.283 或更新版本**：自動模式是互動式終端機和 VS Code 工作階段的[內建起始權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md#which-mode-a-session-starts-in)59* **Claude Code v2.1.283 或更新版本**：自動模式是互動式終端機和 VS Code 工作階段的[內建起始權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md#which-mode-a-session-starts-in)

60* **較早版本**：自動模式僅在 Pro、Max、Ultra 和 Team 方案上才是內建起始權限模式60* **較早版本**：自動模式僅在 Pro、Max、Ultra 和 Team 方案上才是內建起始權限模式

261 261 

262### Prompt injection262### Prompt injection

263 263 

264嵌入在檔案、網頁或工具結果中的敵對指令，試圖將 Claude 重定向到您從未要求的動作。Claude Code 的防禦包括權限系統、命令黑名單和信任驗證。[Auto mode](#auto-mode) 添加了一個伺服器端探針，掃描工具結果中的可疑內容，以及一個分類器，在去除工具結果後檢查動作，因此注入的文字無法直接操縱它。264嵌入在檔案、網頁或工具結果中的敵對指令，試圖將 Claude 導向您未要求的動作。Claude Code 的防禦包括權限系統、命令注入偵測和信任驗證。在[自動模式](#auto-mode)中，伺服器端探針會掃描工具結果中的可疑內容，並由分類器審查動作。

265 265 

266了解更多：[防止 prompt injection](https://code.claude.com/docs/zh-TW/security.md#protect-against-prompt-injection)266了解更多：[防止 prompt injection](https://code.claude.com/docs/zh-TW/security.md#protect-against-prompt-injection)

267 267 

2341 2341 

2342#### 為自動模式分類器註記結果2342#### 為自動模式分類器註記結果

2343 2343 

2344回傳 `classifierContext`，即可將關於工具呼叫結果的簡短註記傳送給[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)分類器，而非傳送給 Claude。分類器[永遠不會接收工具結果本身](https://code.claude.com/docs/zh-TW/permission-modes.md#how-the-classifier-evaluates-actions)，因此此欄位是在分類器審查後續動作之前，告知它呼叫回傳內容的受支援方式。此欄位需要 Claude Code v2.1.236 或更新版本。2344傳回 `classifierContext`，即可將關於工具呼叫結果的簡短附註傳送給[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)分類器，而非傳送給 Claude。此附註供分類器審查後續動作時使用。此欄位需要 Claude Code v2.1.236 或更新版本。

2345 2345 

2346以下範例告訴分類器查詢輸出的來源：2346以下範例告訴分類器查詢輸出的來源：

2347 2347 

47 47 

48當[gateway 憑證變數](https://code.claude.com/docs/zh-TW/llm-gateway-connect.md#set-the-credential-variable)或 `apiKeyHelper` 處於活動狀態時，請求會使用該憑證，而不是開發人員的 claude.ai 訂閱登錄，且訂閱的使用限制不適用於這些請求。Claude Code 在機器上保存了 claude.ai 登錄，但不會在這些請求中發送它。該流量按令牌計費給擁有 gateway 轉發的憑證的人，例如您的組織的 Anthropic Console 帳戶，或當 gateway 路由到那裡時您的 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 帳戶。48當[gateway 憑證變數](https://code.claude.com/docs/zh-TW/llm-gateway-connect.md#set-the-credential-variable)或 `apiKeyHelper` 處於活動狀態時，請求會使用該憑證，而不是開發人員的 claude.ai 訂閱登錄，且訂閱的使用限制不適用於這些請求。Claude Code 在機器上保存了 claude.ai 登錄，但不會在這些請求中發送它。該流量按令牌計費給擁有 gateway 轉發的憑證的人，例如您的組織的 Anthropic Console 帳戶，或當 gateway 路由到那裡時您的 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 帳戶。

49 49 

50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-TW/llm-gateway-connect#set-the-base-url-and-credential)是指向 Claude Code 指向 gateway 的變數。僅設置該變數而不設置 gateway 憑證不會替換訂閱。請求仍然透過 gateway 路由，但保存的 claude.ai 登錄保持活動憑證，因此其使用限制和計費適用。將此流量轉發給 Anthropic 的 gateway 必須轉發 `anthropic-beta` 中的 OAuth 功能；請參閱[請求標頭參考](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#request-headers)。50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-TW/llm-gateway-connect#set-the-base-url-and-credential) 是讓 Claude Code 指向閘道的變數。僅設定該變數而未設定閘道憑證，並不會取代訂閱。請求仍會透過閘道路由，但已儲存的 claude.ai 登入仍是作用中的憑證，因此會套用其用量上限與計費。將此流量轉送給 Anthropic 的閘道必須轉送 `Authorization` 以及 `anthropic-beta` 中的 OAuth 功能；請參閱[請求標頭參考](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#request-headers)。

51 51 

52## 相關頁面52## 相關頁面

53 53 

40 40 

41| 格式 | 選擇者 | 端點 | 轉發不變 |41| 格式 | 選擇者 | 端點 | 轉發不變 |

42| :- | :- | :- | :- |42| :- | :- | :- | :- |

43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`、`/v1/messages/count_tokens`（選用） | `anthropic-beta` 和 `anthropic-version` 請求標頭 |43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`、`/v1/messages/count_tokens`（選用） | `anthropic-beta` 和 `anthropic-version` 請求標頭，以及當 [claude.ai 登入](#request-headers)向 Anthropic 驗證請求時的 `Authorization` |

44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` 搭配 `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`、`/model/{model}/invoke-with-response-stream`、`/model/{model}/count-tokens`（選用） | `anthropic_beta` 和 `anthropic_version` 請求本體欄位 |44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` 搭配 `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`、`/model/{model}/invoke-with-response-stream`、`/model/{model}/count-tokens`（選用） | `anthropic_beta` 和 `anthropic_version` 請求本體欄位 |

45| Google Cloud 的 Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` 搭配 `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`、`:streamRawPredict`、`count-tokens:rawPredict`（選用） | `anthropic-beta` 和 `anthropic-version` 請求標頭，以及 `anthropic_version` 請求本體欄位 |45| Google Cloud 的 Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` 搭配 `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`、`:streamRawPredict`、`count-tokens:rawPredict`（選用） | `anthropic-beta` 和 `anthropic-version` 請求標頭，以及 `anthropic_version` 請求本體欄位 |

46 46 

115 115 

116## 請求標頭116## 請求標頭

117 117 

118Claude Code 在 API 請求上包含這些標頭。標頭名稱在線路上不區分大小寫。轉發 `anthropic-version` 和 `anthropic-beta` 不變，加上當上游是 [AWS 上的 Claude Platform](https://code.claude.com/docs/zh-TW/claude-platform-on-aws.md) 時的 `anthropic-workspace-id`；其餘的 gateway 可以使用以進行路由、歸屬和追蹤，不需要轉發。118Claude Code 在 API 請求上包含這些標頭。標頭名稱在線路上不區分大小寫。請原封不動地轉發 `anthropic-version` 和 `anthropic-beta`，當上游是 [AWS 上的 Claude Platform](https://code.claude.com/docs/zh-TW/claude-platform-on-aws.md) 時，也要轉發 `anthropic-workspace-id`。當您的閘道使用開發人員的 claude.ai 登入（而非閘道自己的金鑰）向 Anthropic 進行身分驗證時，也請轉發 `Authorization`。其餘標頭閘道可以用於路由、歸屬和追蹤，不需要轉發。

119 119 

120| 標頭 | 描述 |120| 標頭 | 描述 |

121| :- | :- |121| :- | :- |

122| `Authorization`、`x-api-key` | 開發人員的 gateway 認證，根據他們設定的[認證變數](https://code.claude.com/docs/zh-TW/llm-gateway-connect.md#set-the-credential-variable)在一個或兩個標頭中 |122| `Authorization`、`x-api-key` | 開發人員的閘道憑證，根據他們設定的[憑證變數](https://code.claude.com/docs/zh-TW/llm-gateway-connect.md#set-the-credential-variable)放在其中一個或兩個標頭中。若使用 claude.ai 登入且沒有閘道憑證，`Authorization` 會攜帶該登入的 token |

123| `anthropic-version` | API 版本，目前為 `2023-06-01`。Amazon Bedrock 和 Google Cloud 的 Agent Platform 格式請求也攜帶 `anthropic_version` 請求體欄位，其值是提供者方言字串，而不是此標頭的值 |123| `anthropic-version` | API 版本，目前為 `2023-06-01`。Amazon Bedrock 和 Google Cloud 的 Agent Platform 格式請求也攜帶 `anthropic_version` 請求體欄位，其值是提供者方言字串，而不是此標頭的值 |

124| `anthropic-beta` | 請求的逗號分隔功能值。逐字轉發標頭；不要將個別值列入允許清單，因為該集合隨 Claude Code 版本而變化。當開發人員使用 claude.ai 登入進行驗證時（當設定 `ANTHROPIC_BASE_URL` 而沒有 gateway 認證變數時可能），此標頭也會攜帶上游需要的 OAuth 功能，移除它會導致這些請求失敗並出現 `401` |124| `anthropic-beta` | 請求的逗號分隔功能值。逐字轉發標頭；不要將個別值列入允許清單，因為該集合隨 Claude Code 版本而變化。當開發人員使用 claude.ai 登入進行驗證時（當設定 `ANTHROPIC_BASE_URL` 而沒有 gateway 認證變數時可能），此標頭也會攜帶上游需要的 OAuth 功能，移除它會導致這些請求失敗並出現 `401` |

125| `x-claude-code-session-id` | 目前 Claude Code 工作階段的唯一識別碼。使用它來聚合來自一個工作階段的所有請求，而無需解析請求體 |125| `x-claude-code-session-id` | 目前 Claude Code 工作階段的唯一識別碼。使用它來聚合來自一個工作階段的所有請求，而無需解析請求體 |

52* **傳遞控制**：[`policyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#policyhelper)、[`wslInheritsWindowsSettings`](https://code.claude.com/docs/zh-TW/settings-reference#wslinheritswindowssettings) 和 [`managedSourcesBehavior`](https://code.claude.com/docs/zh-TW/settings-reference#managedsourcesbehavior)52* **傳遞控制**：[`policyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#policyhelper)、[`wslInheritsWindowsSettings`](https://code.claude.com/docs/zh-TW/settings-reference#wslinheritswindowssettings) 和 [`managedSourcesBehavior`](https://code.claude.com/docs/zh-TW/settings-reference#managedsourcesbehavior)

53* **閘道登入鍵**：[`forceLoginGatewayUrl`](https://code.claude.com/docs/zh-TW/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](https://code.claude.com/docs/zh-TW/settings-reference#gatewayinternalnetworks)，以及 [`forceLoginMethod`](https://code.claude.com/docs/zh-TW/settings-reference#forceloginmethod) 的 `"gateway"` 值53* **閘道登入鍵**：[`forceLoginGatewayUrl`](https://code.claude.com/docs/zh-TW/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](https://code.claude.com/docs/zh-TW/settings-reference#gatewayinternalnetworks)，以及 [`forceLoginMethod`](https://code.claude.com/docs/zh-TW/settings-reference#forceloginmethod) 的 `"gateway"` 值

54 54 

55受管設定檔、MDM 設定描述檔或 claude.ai 主控台會將同一套政策套用到其涵蓋的每個人。若要為某一群開發人員提供不同的政策，請將不同的檔案或描述檔部署到該群組；claude.ai 主控台[目前還無法以群組為目標](https://code.claude.com/docs/zh-TW/server-managed-settings.md#current-limitations)，而自行託管的 [Claude apps 閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway)則可依 IdP 群組傳遞受管設定。55使用受管設定檔或 MDM 設定描述檔時，其涵蓋的每個人都會獲得同一套政策。若要為某一群開發人員提供不同的政策，請將不同的檔案或描述檔部署到該群組。在 Enterprise 方案中，您也可以在伺服器受管設定中[為每個群組提供各自的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md#give-groups-different-settings)。自行託管的 [Claude apps 閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway)可依 IdP 群組傳遞受管設定。

56 56 

57當多個機制將政策傳遞到同一台機器時，Claude Code 預設只會使用其中一個並忽略其他機制。[Claude Code 如何組合受管來源](#how-claude-code-combines-managed-sources)說明了其順序，以及讓 Claude Code 套用所有來源的選擇性啟用設定。57當多個機制將政策傳遞到同一台機器時，Claude Code 預設只會使用其中一個並忽略其他機制。[Claude Code 如何組合受管來源](#how-claude-code-combines-managed-sources)說明了其順序，以及讓 Claude Code 套用所有來源的選擇性啟用設定。

58 58 

163 163 

164內聯形式在 Bash 或 Zsh 中為該次啟動設定變數。若要在每個工作階段中保持它開啟，請將它新增至 `~/.claude/settings.json` 中的 `env` 區塊，如 [設定環境變數](https://code.claude.com/docs/zh-TW/env-vars.md#set-environment-variables) 中所示。164內聯形式在 Bash 或 Zsh 中為該次啟動設定變數。若要在每個工作階段中保持它開啟，請將它新增至 `~/.claude/settings.json` 中的 `env` 區塊，如 [設定環境變數](https://code.claude.com/docs/zh-TW/env-vars.md#set-environment-variables) 中所示。

165 165 

166這會從其他目錄載入 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 和 `CLAUDE.local.md`。如果您從 [`--setting-sources`](https://code.claude.com/docs/zh-TW/cli-reference) 排除 `local`，則會跳過 `CLAUDE.local.md`。166設定此變數後，Claude Code 會載入其他目錄的 `CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md` 和 `.claude/rules/*.md` 檔案，但設定了 [`paths` 欄位](#path-specific-rules) 的規則除外。如果您從 [`--setting-sources`](https://code.claude.com/docs/zh-TW/cli-reference) 排除 `local`，則會跳過 `CLAUDE.local.md`。

167 167 

168### 使用 `.claude/rules/` 組織規則168### 使用 `.claude/rules/` 組織規則

169 169 

168 168 

169關於相關訊息，請參閱 [Model is not a recognized model id](https://code.claude.com/docs/zh-TW/errors.md#model-is-not-a-recognized-model-id) 和 [Model not found](https://code.claude.com/docs/zh-TW/errors.md#model-not-found)。169關於相關訊息，請參閱 [Model is not a recognized model id](https://code.claude.com/docs/zh-TW/errors.md#model-is-not-a-recognized-model-id) 和 [Model not found](https://code.claude.com/docs/zh-TW/errors.md#model-not-found)。

170 170 

171如果您以 `--model` 旗標、`ANTHROPIC_MODEL` 環境變數或 `model` 設定來設定模型，Claude Code 不會事先拒絕輸入錯誤的值。工作階段會正常啟動，而第一次請求會產生 [There's an issue with the selected model](https://code.claude.com/docs/zh-TW/errors.md#theres-an-issue-with-the-selected-model)。在 Anthropic API 上，不以 `claude-` 開頭且拼寫與某個模型名稱或別名相近的值，也可能產生[建議正確名稱的啟動警告](#fix-a-mistyped-model-name)。171如果您以 `--model` 旗標、`ANTHROPIC_MODEL` 環境變數或 `model` 設定來設定模型，Claude Code 不會事先拒絕輸入錯誤的值。工作階段會正常啟動，而第一次請求會產生 [There's an issue with the selected model](https://code.claude.com/docs/zh-TW/errors.md#theres-an-issue-with-the-selected-model)。在 Anthropic API 上，如果該值的拼寫與某個模型名稱或別名相近且不以 `claude-` 開頭，您可能會看到[建議最接近名稱的警告](#fix-a-mistyped-model-name)。

172 172 

173當所請求的模型有預定的停用日期，或會自動重新對應至較新版本時，Claude Code 會顯示一則指出所請求模型的警告。互動式工作階段會將其顯示為啟動通知。自 v2.1.182 起，在使用預設文字輸出格式時，相同的警告也會在[非互動模式](https://code.claude.com/docs/zh-TW/headless.md)中寫入 stderr。此檢查也涵蓋在 [subagent frontmatter](https://code.claude.com/docs/zh-TW/sub-agents.md) 中設定的 `model`。對於 `--output-format json` 和 `stream-json`，stderr 警告會被隱藏；請改從[結果訊息](https://code.claude.com/docs/zh-TW/headless.md#get-structured-output)的 `modelUsage` 欄位讀取實際模型。173當所請求的模型有預定的停用日期，或會自動重新對應至較新版本時，Claude Code 會顯示一則指出所請求模型的警告。互動式工作階段會將其顯示為啟動通知。自 v2.1.182 起，在使用預設文字輸出格式時，相同的警告也會在[非互動模式](https://code.claude.com/docs/zh-TW/headless.md)中寫入 stderr。此檢查也涵蓋在 [subagent frontmatter](https://code.claude.com/docs/zh-TW/sub-agents.md) 中設定的 `model`。對於 `--output-format json` 和 `stream-json`，stderr 警告會被隱藏；請改從[結果訊息](https://code.claude.com/docs/zh-TW/headless.md#get-structured-output)的 `modelUsage` 欄位讀取實際模型。

174 174 

195}195}

196```196```

197 197 

198#### 修正輸入錯誤的模型名稱

199 

200以下任一警告都表示 Claude Code 無法辨識您設定的模型 ID，而該 ID 的拼寫與 Claude Code 能辨識的某個模型名稱或別名相近：

201 

202```text theme={null}

203⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

204Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

205```

206 

207* **您輸入錯誤了 ID**：在[您設定模型的位置](#setting-your-model)將其改為建議值

208* **該 ID 是刻意設定的**：保持原樣即可。工作階段會依您撰寫的內容傳送它。如果 Claude Code 為其假設的上下文視窗不正確，請[修正視窗](#correct-the-window-for-a-gateway-or-custom-model-id)

209 

198#### 為新工作階段設定預設模型210#### 為新工作階段設定預設模型

199 211 

200設定 `ANTHROPIC_DEFAULT_MODEL=<alias|name>` 以選擇您的工作階段預設啟動時使用的模型。需要 Claude Code v2.1.236 或更新版本。212設定 `ANTHROPIC_DEFAULT_MODEL=<alias|name>` 以選擇您的工作階段預設啟動時使用的模型。需要 Claude Code v2.1.236 或更新版本。

772| :- | :- |784| :- | :- |

773| 切換目前工作階段 | 在 macOS 上按 `Option+T`，在 Windows 和 Linux 上按 `Alt+T` |785| 切換目前工作階段 | 在 macOS 上按 `Option+T`，在 Windows 和 Linux 上按 `Alt+T` |

774| 設定全域預設值 | 執行 `/config` 並切換思考模式。儲存為 `~/.claude/settings.json` 中的 `alwaysThinkingEnabled` |786| 設定全域預設值 | 執行 `/config` 並切換思考模式。儲存為 `~/.claude/settings.json` 中的 `alwaysThinkingEnabled` |

775| 透過環境變數停用 | 設定 [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/zh-TW/env-vars)，這會在 Anthropic API 上關閉思考，但 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 模型除外。在[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)上，Claude Code 會改為省略 `thinking` 參數，自適應推理模型仍可能進行思考 |787| 透過環境變數停用 | 設定 [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/zh-TW/env-vars) |

788 

789Claude Code 預設會收合思考輸出。按 `Ctrl+O` 切換詳細模式，即可看到以灰色斜體文字顯示的推理。Anthropic API 上的互動式工作階段預設會收到經過編修的思考區塊，因此如果您希望展開時能看到完整摘要，請在設定中設定 [`showThinkingSummaries: true`](https://code.claude.com/docs/zh-TW/settings-reference#showthinkingsummaries)。即使思考內容被收合或編修，您仍需為所有產生的思考 token 付費。

790 

791#### 無法關閉思考的情況

776 792 

777您無法在 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型上關閉思考。對於這些模型，工作階段切換開關和 `/config` 列會顯示 `Thinking can't be turned off`，而不提供切換選項，且已儲存的 `alwaysThinkingEnabled: false` 或 `MAX_THINKING_TOKENS=0` 在這些模型上無效。在這些模型上，模型會根據 effort 等級決定每個步驟的思考量。當您切換至接受該設定的模型時，已儲存的設定會再次適用。793您無法在 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型上關閉思考。對於這些模型，工作階段切換開關和 `/config` 列會顯示 `Thinking can't be turned off`，而不提供切換選項，且已儲存的 `alwaysThinkingEnabled: false` 或 `MAX_THINKING_TOKENS=0` 在這些模型上無效。在這些模型上，模型會根據 effort 等級決定每個步驟的思考量。當您切換至接受該設定的模型時，已儲存的設定會再次適用。

778 794 

779Claude Code 預設會收合思考輸出。按 `Ctrl+O` 切換詳細模式，即可看到以灰色斜體文字顯示的推理。Anthropic API 上的互動式工作階段預設會收到經過編修的思考區塊，因此如果您希望展開時能看到完整摘要，請在[設定](https://code.claude.com/docs/zh-TW/settings.md)中設定 `showThinkingSummaries: true`。即使思考內容被收合或編修，您仍需為所有產生的思考 token 付費。795若要停止或減少思考，請依您的供應商採取對應步驟：

796 

797* **Anthropic API**：您可以在 `claude-opus-5`、`claude-sonnet-5` 和 `claude-haiku-4-5` 等模型上關閉思考。`sonnet` 等[別名](#model-aliases)會選擇無法關閉思考的模型，因此請依其 ID [設定模型](#setting-your-model)。

798* **[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)**：在 Amazon Bedrock 和 Microsoft Foundry 等供應商上，具有[自適應推理](#adaptive-reasoning-and-fixed-thinking-budgets)的模型即使關閉思考仍可能進行思考。請[降低 effort 等級](#set-the-effort-level)以減少思考。

780 799 

781### 延伸上下文800### 延伸上下文

782 801 

900 919 

901一旦 Claude Code 辨識出該 ID 或使用您提供的視窗，當您以該 ID 啟動工作階段時，就不會再出現此警告。920一旦 Claude Code 辨識出該 ID 或使用您提供的視窗，當您以該 ID 啟動工作階段時，就不會再出現此警告。

902 921 

903#### 修正輸入錯誤的模型名稱

904 

905出現下列任一警告，都表示 Claude Code 無法辨識您設定的模型 ID，且該 ID 的拼寫與其可辨識的某個模型名稱或別名幾乎相同：

906 

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911 

912* **您輸入了錯誤的 ID**：[在您設定模型之處](#setting-your-model)將其變更為建議的名稱

913* **該 ID 是刻意設定的**：保持原樣即可。工作階段會依您撰寫的內容傳送該 ID。若 Claude Code 為其假定的上下文視窗有誤，請[修正視窗](#correct-the-window-for-a-gateway-or-custom-model-id)

914 

915#### `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 適用於哪些 ID922#### `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 適用於哪些 ID

916 923 

917在 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)或其他自訂部署上，無論 Claude Code 是否將模型 ID 解析為 Claude 模型，它為該 ID 假定的上下文視窗都可能與模型的實際視窗不同。請將 [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/zh-TW/env-vars) 設為 Claude Code 應改為假定的視窗。924在 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)或其他自訂部署上，無論 Claude Code 是否將模型 ID 解析為 Claude 模型，它為該 ID 假定的上下文視窗都可能與模型的實際視窗不同。請將 [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/zh-TW/env-vars) 設為 Claude Code 應改為假定的視窗。

710* `skill.name`：請求當下啟用的 skill，由 Skill 工具或 `/` 命令設定，或由產生的 subagent 繼承。內建、隨附、使用者定義以及官方市集外掛的 skill 名稱會原樣顯示。第三方外掛的 skill 名稱會被替換為 `"third-party"`。沒有啟用的 skill 時不存在。710* `skill.name`：請求當下啟用的 skill，由 Skill 工具或 `/` 命令設定，或由產生的 subagent 繼承。內建、隨附、使用者定義以及官方市集外掛的 skill 名稱會原樣顯示。第三方外掛的 skill 名稱會被替換為 `"third-party"`。沒有啟用的 skill 時不存在。

711* `plugin.name`：當啟用的 skill 或 subagent 由外掛提供時，為所屬的外掛。官方市集外掛名稱會原樣顯示。第三方外掛名稱會被替換為 `"third-party"`。當 skill 與 subagent 都沒有所屬外掛時不存在。711* `plugin.name`：當啟用的 skill 或 subagent 由外掛提供時，為所屬的外掛。官方市集外掛名稱會原樣顯示。第三方外掛名稱會被替換為 `"third-party"`。當 skill 與 subagent 都沒有所屬外掛時不存在。

712* `marketplace.name`：所屬外掛的安裝來源市集。即使設定了 `OTEL_LOG_TOOL_DETAILS=1`，也只會針對官方市集外掛發出。否則不存在。712* `marketplace.name`：所屬外掛的安裝來源市集。即使設定了 `OTEL_LOG_TOOL_DETAILS=1`，也只會針對官方市集外掛發出。否則不存在。

713* `mcp_server.name`：此請求所使用之工具結果的 MCP 伺服器。內建、claude.ai 代理以及官方登錄中的伺服器名稱會原樣顯示。使用者設定的伺服器名稱會被替換為 `"custom"`。當請求未使用任何 MCP 工具結果時不存在。在 v2.1.222 之前，Claude Code 會在 MCP 工具呼叫之後的每個請求上設定此屬性，而不只是在使用了工具結果的請求上，因此彙總此屬性的儀表板在您升級後會出現下降。713* `mcp_server.name`：此請求所使用之工具結果的 MCP 伺服器。內建、經 claude.ai 代理以及官方登錄的伺服器名稱會原樣顯示。使用者設定的伺服器名稱會被替換為 `"custom"`。當請求未使用任何 MCP 工具結果時不存在。在 v2.1.222 之前，Claude Code 會在 MCP 工具呼叫之後的每個請求上設定此屬性，而不僅限於使用了工具結果的請求，因此彙總此屬性的儀表板在您升級後會顯示下降。

714* `mcp_tool.name`：此請求所使用之結果的 MCP 工具，遮蔽與版本行為與 `mcp_server.name` 相同。當請求未使用任何 MCP 工具結果時不存在。714 * 從 v2.1.312 起，由 Anthropic 官方市集外掛所宣告、具有固定 URL 之遠端伺服器的名稱也會原樣顯示，格式為 `plugin_<plugin>_<server>`。當該外掛的市集副本並非來自 Anthropic 的註冊來源時（例如在雲端工作階段中從種子目錄掛載的副本），該名稱會被替換為 `"custom"`。

715* `mcp_tool.name`：此請求所使用之結果的 MCP 工具，其遮蔽和版本行為與 `mcp_server.name` 相同，但當 `mcp_server.name` 顯示 `plugin_<plugin>_<server>` 名稱時，此屬性可能顯示 `"custom"`。當請求未使用任何 MCP 工具結果時不存在。

715 716 

716#### Token 計數器717#### Token 計數器

717 718 

998 * 在同一互動式 CLI 工作階段中，於較早的權限提示時授予的剩餘工作階段授權999 * 在同一互動式 CLI 工作階段中，於較早的權限提示時授予的剩餘工作階段授權

999 * 工具本身即屬安全1000 * 工具本身即屬安全

1000 1001 

1001 `source` 值不會指出是哪一個來源相符。若要找出是哪一個來源拒絕了某次呼叫，請尋找具有相同 `tool_use_id` 的[安全事件](#safety-event)，並讀取其 `category` 與 `rule_source` 屬性。部分遭拒絕的呼叫[沒有安全事件](#calls-without-a-safety-event)。1002 `source` 值不會指出是這些來源中的哪一個符合。當 `classifier_verdict` 存在時，它會提供決定此呼叫的分類器結果。沒有任何 `tool_decision` 屬性會指出拒絕此呼叫的權限規則或設定。

1002 1003 

1003 當權限提示請求本身失敗時，Claude Code 也會回報 `"config"`。例如，當 Agent SDK 的 [`canUseTool`](https://code.claude.com/docs/zh-TW/agent-sdk/typescript#canusetool) 回呼或 [`--permission-prompt-tool`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 工具傳回無效結果，或在請求待處理期間輸入串流關閉時，該請求就會失敗。1004 當權限提示請求本身失敗時，Claude Code 也會回報 `"config"`。例如，當 Agent SDK 的 [`canUseTool`](https://code.claude.com/docs/zh-TW/agent-sdk/typescript#canusetool) 回呼或 [`--permission-prompt-tool`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 工具傳回無效結果，或在請求待處理期間輸入串流關閉時，該請求就會失敗。

1004 * `"hook"`：由 `PreToolUse` 或 `PermissionRequest` hook 傳回決策。1005 * `"hook"`：由 `PreToolUse` 或 `PermissionRequest` hook 傳回決策。

1046 1047 

1047#### 安全事件1048#### 安全事件

1048 1049 

1049在檢查拒絕工具呼叫或需要權限提示時記錄，[沒有安全事件的呼叫](#calls-without-a-safety-event)除外。當[沙箱的網路代理伺服器](https://code.claude.com/docs/zh-TW/sandboxing.md#network-isolation)拒絕連線或請求，以及 hook 封鎖結果時也會記錄。需要 Claude Code v2.1.307 或更新版本。1050Claude Code 已停止傳送 `claude_code.safety_event`：

1051 

1052* **v2.1.312 及更新版本**：這些版本不會傳送此事件，也沒有任何設定可以開啟它

1053* **v2.1.307 至 v2.1.311**：工作階段會在下一次功能旗標重新整理時停止傳送此事件。不[擷取功能旗標](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)的工作階段（例如在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上）可能會持續傳送此事件。

1054 

1055若要查看被拒絕的工具呼叫，請查詢 [`tool_decision`](#tool-decision-event) 事件，這些事件會顯示呼叫被拒絕，但不一定會顯示是哪項檢查拒絕了它。

1056 

1057此處的事件詳細資訊描述的是 v2.1.307 至 v2.1.311 的事件，其中安全事件會記錄以下這類[情況](#safety-event-categories)：

1058 

1059* 某項檢查拒絕了工具呼叫或要求顯示權限提示，但[沒有安全事件的呼叫](#calls-without-a-safety-event)除外

1060* [沙箱的網路代理伺服器](https://code.claude.com/docs/zh-TW/sandboxing.md#network-isolation)拒絕了連線或請求

1061* hook 封鎖了結果或回合結束

1050 1062 

1051此事件會與其他事件一起匯出，沒有獨立的設定。事件本身的屬性不包含命令文字、檔案路徑、主機名稱，或 MCP 伺服器與工具名稱。該記錄也會攜帶每個事件都有的[標準屬性](#standard-attributes)，其中可能包括 `workspace.host_paths` 與[儲存庫屬性](#repository-attributes)。若要查看事件背後的命令或 MCP 工具，請設定 `OTEL_LOG_TOOL_DETAILS=1`，並讀取相符之 `tool_decision` 事件上的 `tool_parameters`。1063此事件會與其他事件一起匯出，沒有獨立的設定。事件本身的屬性不包含命令文字、檔案路徑、主機名稱，或 MCP 伺服器與工具名稱。該記錄也會攜帶每個事件都有的[標準屬性](#standard-attributes)，其中可能包括 `workspace.host_paths` 與[儲存庫屬性](#repository-attributes)。若要查看事件背後的命令或 MCP 工具，請設定 `OTEL_LOG_TOOL_DETAILS=1`，並讀取相符之 `tool_decision` 事件上的 `tool_parameters`。

1052 1064 

1663 1675 

1664### 將安全問題對應到事件1676### 將安全問題對應到事件

1665 1677 

1678`safety_event` 的各列僅適用於 v2.1.307 至 v2.1.311 版本中[仍會傳送該事件](#safety-event)的工作階段。

1679 

1666建立偵測規則時，查詢您想要監控的訊號並查詢您的後端以取得相應的事件和屬性：1680建立偵測規則時，查詢您想要監控的訊號並查詢您的後端以取得相應的事件和屬性：

1667 1681 

1668| 訊號 | 事件 | 關鍵屬性 |1682| 訊號 | 事件 | 關鍵屬性 |

1672| 自動模式分類器允許或封鎖了工具呼叫，或 Claude Code 在沒有分類器判定的情況下拒絕了呼叫 | 含有 `classifier_verdict` 的 [`tool_decision`](#tool-decision-event)。對於沒有判定的拒絕，`classifier_verdict` 為 `"no_verdict"` 或 `"unavailable"` | `classifier_verdict`、`permission_mode`、`tool_name`；設定 `OTEL_LOG_TOOL_DETAILS=1` 時另有 `classifier_category` |1686| 自動模式分類器允許或封鎖了工具呼叫，或 Claude Code 在沒有分類器判定的情況下拒絕了呼叫 | 含有 `classifier_verdict` 的 [`tool_decision`](#tool-decision-event)。對於沒有判定的拒絕，`classifier_verdict` 為 `"no_verdict"` 或 `"unavailable"` | `classifier_verdict`、`permission_mode`、`tool_name`；設定 `OTEL_LOG_TOOL_DETAILS=1` 時另有 `classifier_category` |

1673| 權限模式升級 | `permission_mode_changed` | `from_mode`、`to_mode`、`trigger` |1687| 權限模式升級 | `permission_mode_changed` | `from_mode`、`to_mode`、`trigger` |

1674| 每個工具呼叫是在哪個權限模式下檢查的，包括 subagent 發出的呼叫 | [`tool_decision`](#tool-decision-event) | `permission_mode`、`session.id` |1688| 每個工具呼叫是在哪個權限模式下檢查的，包括 subagent 發出的呼叫 | [`tool_decision`](#tool-decision-event) | `permission_mode`、`session.id` |

1675| 原則 hook 阻止了操作 | `hook_execution_complete` | `hook_event`、`num_blocking` |1689| 原則 hook 阻止了操作 | `hook_execution_complete`，它不與特定呼叫或 `tool_use_id` 綁定 | `hook_event`、`num_blocking` |

1676| hook 拒絕了哪個工具呼叫，以及 hook 封鎖了哪個結果或回合結束 | [`safety_event`](#safety-event)，其中對於被拒絕的呼叫，`category` 為 `"hook"` 且 `decision` 為 `"reject"`；對於被封鎖的結果或回合結束，`category` 為 `"hook_review"` | `category`、`decision`、`hook_event`；工具呼叫另有 `tool_use_id` |1690| hook 拒絕的工具呼叫 | [`tool_decision`](#tool-decision-event)，其中 `decision` 為 `"reject"` 且 `source` 為 `"hook"` | `decision`、`source`、`tool_use_id` |

1691| hook 封鎖了哪個結果或回合結束 | [`safety_event`](#safety-event)，其中 `category` 為 `"hook_review"` | `category`、`hook_event`；工具呼叫另有 `tool_use_id` |

1677| 沙箱的網路代理伺服器拒絕了來自 Bash 或 PowerShell 命令的連線或請求 | [`safety_event`](#safety-event)，其中 `sandbox_violation_count` 存在且不為 `"0"` | `sandbox_violation_count`、`category`、`sandbox_enabled`、`tool_use_id` |1692| 沙箱的網路代理伺服器拒絕了來自 Bash 或 PowerShell 命令的連線或請求 | [`safety_event`](#safety-event)，其中 `sandbox_violation_count` 存在且不為 `"0"` | `sandbox_violation_count`、`category`、`sandbox_enabled`、`tool_use_id` |

1678| 登入、登出和身份驗證失敗 | `auth` | `action`、`success`、`error_category` |1693| 登入、登出和身份驗證失敗 | `auth` | `action`、`success`、`error_category` |

1679| MCP 伺服器連線或失敗 | `mcp_server_connection` | `status`、`server_name`、`is_plugin`、`error_code` |1694| MCP 伺服器連線或失敗 | `mcp_server_connection` | `status`、`server_name`、`is_plugin`、`error_code` |

25 25 

26審查每項操作的模式在 CLI、`claude --help`、VS Code 與 JetBrains 擴充功能，以及桌面應用程式中稱為 **Manual**。其設定值為 `default`，這是 hook 與 SDK 整合所使用的值。在任何需要輸入該值的地方，CLI 都接受 `manual` 作為別名，例如 `claude --permission-mode manual` 或 `"defaultMode": "manual"`。26審查每項操作的模式在 CLI、`claude --help`、VS Code 與 JetBrains 擴充功能，以及桌面應用程式中稱為 **Manual**。其設定值為 `default`，這是 hook 與 SDK 整合所使用的值。在任何需要輸入該值的地方，CLI 都接受 `manual` 作為別名，例如 `claude --permission-mode manual` 或 `"defaultMode": "manual"`。

27 27 

28對[受保護路徑](#protected-paths)的寫入永遠不會被自動核准，唯一的例外是 `bypassPermissions` 模式，以及可使用略過權限的 plan mode 工作階段；後者指的是以[將 `bypassPermissions` 加入模式循環](#switch-permission-modes)的方式啟動的互動式終端機工作階段。28每種模式對[受保護路徑](#protected-paths)的寫入各有其規則。

29 29 

30模式設定的是基準。您可以在其上疊加[權限規則](https://code.claude.com/docs/zh-TW/permissions.md#manage-permissions)，以預先核准或封鎖特定工具。拒絕規則在每種模式中都會生效，包括 `bypassPermissions`。只要 Claude 仍至少有一個其他可呼叫的工具，拒絕規則與詢問規則就不適用於 [`EndConversation`](https://code.claude.com/docs/zh-TW/tools-reference#endconversation-tool-behavior)。允許規則在 `bypassPermissions` 中沒有作用。30模式設定的是基準。您可以在其上疊加[權限規則](https://code.claude.com/docs/zh-TW/permissions.md#manage-permissions)，以預先核准或封鎖特定工具。拒絕規則在每種模式中都會生效，包括 `bypassPermissions`。只要 Claude 仍至少有一個其他可呼叫的工具，拒絕規則與詢問規則就不適用於 [`EndConversation`](https://code.claude.com/docs/zh-TW/tools-reference#endconversation-tool-behavior)。允許規則在 `bypassPermissions` 中沒有作用。

31 31 

484* 對不同的儲存庫或組織開啟 pull request、使用 `gh repo fork` 進行分叉，或推送到第三方儲存庫，除非您指明了該外部目標484* 對不同的儲存庫或組織開啟 pull request、使用 `gh repo fork` 進行分叉，或推送到第三方儲存庫，除非您指明了該外部目標

485* 來自敏感本機儲存區，或來自名稱、路徑或類型標示其為敏感之檔案的內容，進入提交、推送、PR 或 issue 文字、gist 或貼文，或套件發佈，除非您同時指明了來源和目的地。工作階段逐字稿和對話日誌、憑證和設定點資料夾（例如 SSH 金鑰、雲端憑證、瀏覽器設定檔和 shell 歷史記錄）以及使用者資料匯出都包含在內，且儲存庫為私人並不會解除此限制485* 來自敏感本機儲存區，或來自名稱、路徑或類型標示其為敏感之檔案的內容，進入提交、推送、PR 或 issue 文字、gist 或貼文，或套件發佈，除非您同時指明了來源和目的地。工作階段逐字稿和對話日誌、憑證和設定點資料夾（例如 SSH 金鑰、雲端憑證、瀏覽器設定檔和 shell 歷史記錄）以及使用者資料匯出都包含在內，且儲存庫為私人並不會解除此限制

486* 寫入 Claude Code 工作階段逐字稿，即 `~/.claude/projects/` 或您所設定之設定目錄下的 `.jsonl` 歷史檔案，無論是直接寫入還是透過 shell 命令。此規則也涵蓋 Claude Code 為其自身檢查附加到每個逐字稿項目的中繼資料行。讀取逐字稿不會被阻止486* 寫入 Claude Code 工作階段逐字稿，即 `~/.claude/projects/` 或您所設定之設定目錄下的 `.jsonl` 歷史檔案，無論是直接寫入還是透過 shell 命令。此規則也涵蓋 Claude Code 為其自身檢查附加到每個逐字稿項目的中繼資料行。讀取逐字稿不會被阻止

487* 遞迴強制刪除，例如 `rm -rf "$VAR"` 或 `Remove-Item -Recurse -Force $dir`，其目標是在分類器看到的對話中任何地方都未被指派的 shell 變數，或以此類變數為根的 glob。該值僅來自較早的命令輸出，而分類器永遠不會收到這些輸出，因此分類器無法依據其他刪除規則驗證刪除目標。當您指明正在刪除的確切路徑，或 Claude 將解析後的字面路徑寫入命令中重新執行刪除時，此阻止即會解除。分類器可以解析其目標的刪除不受影響。487* 遞迴強制刪除，例如 `rm -rf "$VAR"` 或 `Remove-Item -Recurse -Force $dir`，其目標是在分類器看到的對話中未被指派的 shell 變數，或以此類變數為根的 glob。缺少該指派時，分類器無法判斷該命令會刪除什麼。

488 488 

489 直接位於變數下的 glob，如 `rm -rf "$VAR"/*`，則屬於[關鍵路徑](#critical-paths)。目標為單獨的 `*` 或以 `/*` 或 `\*` 結尾的 `Remove-Item` 永遠不會送到分類器：Claude Code 會[直接拒絕它們](#remove-item-in-powershell)。489 當您指明正在刪除的確切路徑，或 Claude 將解析後的字面路徑寫入命令中重新執行刪除時，此阻止即會解除。分類器可以解析其目標的刪除不受影響。

490 

491 直接位於變數下的 glob，如 `rm -rf "$VAR"/*`，則屬於[關鍵路徑](#critical-paths)。對於目標為單獨的 `*` 或以 `/*` 或 `\*` 結尾的 `Remove-Item`，請參閱 [PowerShell 中的 Remove-Item](#remove-item-in-powershell)：Claude Code 會直接拒絕該命令。

490 492 

491其中幾個類別取決於[環境](https://code.claude.com/docs/zh-TW/auto-mode-config.md#define-trusted-infrastructure)項目，例如敏感遠端目標和受保護的 IaC 範圍，您可以將其縮小到具體名稱。493其中幾個類別取決於[環境](https://code.claude.com/docs/zh-TW/auto-mode-config.md#define-trusted-infrastructure)項目，例如敏感遠端目標和受保護的 IaC 範圍，您可以將其縮小到具體名稱。

492 494 

730 732 

731## 受保護的路徑733## 受保護的路徑

732 734 

733對於一小組路徑的寫入操作永遠不會自動批准，唯一的例外是 `bypassPermissions` 模式，以及可使用[略過權限](#skip-all-checks-with-bypasspermissions-mode)的計畫模式互動式終端工作階段。這可以防止意外損壞儲存庫狀態和 Claude 自身的設定。735一小組路徑存放著儲存庫狀態和 Claude 自身的設定，因此每種模式對寫入這些路徑都有各自的規則：

734 736 

735| 模式 | 受保護路徑寫入 |737| 模式 | 受保護路徑寫入 |

736| :- | :- |738| :- | :- |

737| `default`、`acceptEdits` | 提示 |739| `default`、`acceptEdits` | 提示 |

738| `plan` | 在[略過權限](#skip-all-checks-with-bypasspermissions-mode)可用的互動式終端工作階段中允許。否則，當[自動模式](#eliminate-prompts-with-auto-mode)在規劃期間可用時路由到分類器，當它不可用時提示 |740| `plan` | 在[略過權限](#skip-all-checks-with-bypasspermissions-mode)可用的互動式終端工作階段中允許。否則，當[自動模式](#eliminate-prompts-with-auto-mode)在規劃期間可用時路由到分類器，當它不可用時提示 |

739| `auto` | 路由至分類器 |741| `auto` | 路由至分類器，由分類器決定 |

740| `dontAsk` | 拒絕 |742| `dontAsk` | 拒絕 |

741| `bypassPermissions` | 允許 |743| `bypassPermissions` | 允許 |

742 744 

185| `disableSideloadFlags` | 在啟動時拒絕 `--plugin-dir`、`--plugin-url`、`--agents`、Agent SDK `plugins` 選項以及[`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/zh-TW/env-vars#variables)變數中命名的資料夾，也會拒絕 `--mcp-config`，除非其中的每個伺服器都是處理程序內的 `type: "sdk"` 項目。拒絕 Agent SDK 應用程式在工作階段中途透過[`addPlugins`](https://code.claude.com/docs/zh-TW/agent-sdk/typescript#load-more-plugin-folders-with-addplugins)新增的外掛程式資料夾 | 不限制 `.mcp.json`、`claude mcp add` 或 SDK 提供的伺服器。將其與[`allowedMcpServers`](https://code.claude.com/docs/zh-TW/managed-mcp)配對 |185| `disableSideloadFlags` | 在啟動時拒絕 `--plugin-dir`、`--plugin-url`、`--agents`、Agent SDK `plugins` 選項以及[`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/zh-TW/env-vars#variables)變數中命名的資料夾，也會拒絕 `--mcp-config`，除非其中的每個伺服器都是處理程序內的 `type: "sdk"` 項目。拒絕 Agent SDK 應用程式在工作階段中途透過[`addPlugins`](https://code.claude.com/docs/zh-TW/agent-sdk/typescript#load-more-plugin-folders-with-addplugins)新增的外掛程式資料夾 | 不限制 `.mcp.json`、`claude mcp add` 或 SDK 提供的伺服器。將其與[`allowedMcpServers`](https://code.claude.com/docs/zh-TW/managed-mcp)配對 |

186| `disableCommandPluginSources` | 阻止具有 `command` 來源的外掛程式安裝、更新或載入。`command` 來源是其外掛程式目錄由在機器上執行命令產生的來源。未設定時，它採用 `allowManagedHooksOnly` 的值 | 不影響其他來源類型 |186| `disableCommandPluginSources` | 阻止具有 `command` 來源的外掛程式安裝、更新或載入。`command` 來源是其外掛程式目錄由在機器上執行命令產生的來源。未設定時，它採用 `allowManagedHooksOnly` 的值 | 不影響其他來源類型 |

187| `allowManagedHooksOnly` | 限制哪些 hooks 執行。請參閱[`allowManagedHooksOnly`](https://code.claude.com/docs/zh-TW/settings-reference#allowmanagedhooksonly) | 不信任使用者自己啟用的外掛程式中的 hooks |187| `allowManagedHooksOnly` | 限制哪些 hooks 執行。請參閱[`allowManagedHooksOnly`](https://code.claude.com/docs/zh-TW/settings-reference#allowmanagedhooksonly) | 不信任使用者自己啟用的外掛程式中的 hooks |

188| `strictPluginOnlyCustomization` | 封鎖不來自外掛程式、受管設定或 Claude Code 內建功能的 skill、agent、hook 和 MCP 伺服器。它也會阻止[skill 目錄外掛程式](#keep-skills-directory-plugins-loading)載入。設定 `true` 以涵蓋全部四種類型，或設定由 `skills`、`agents`、`hooks` 和 `mcp` 值組成的陣列（例如 `["skills", "hooks"]`）以涵蓋其中部分類型 | 不會限制使用者安裝哪些外掛程式。將其與 `strictKnownMarketplaces` 搭配使用 |188| `strictPluginOnlyCustomization` | 封鎖來自使用者和專案來源的 skill、agent、hook 和 MCP 伺服器。它也會阻止[skill 目錄外掛程式](#keep-skills-directory-plugins-loading)載入。設定 `true` 以涵蓋全部四種類型，或設定由 `skills`、`agents`、`hooks` 和 `mcp` 值組成的陣列（例如 `["skills", "hooks"]`）以涵蓋其中部分類型 | 不會限制使用者安裝哪些外掛程式，也不會拒絕側載外掛程式、agent 和 MCP 伺服器的 CLI 旗標。將其與 `strictKnownMarketplaces` 和 `disableSideloadFlags` 搭配使用 |

189| `pluginSuggestionMarketplaces` | 其外掛程式可能作為安裝建議出現在終端機中的市集。請參閱[推薦外掛程式](#recommend-plugins) | 不影響內建提示 |189| `pluginSuggestionMarketplaces` | 其外掛程式可能作為安裝建議出現在終端機中的市集。請參閱[推薦外掛程式](#recommend-plugins) | 不影響內建提示 |

190| `pluginTrustMessage` | 將您的文字附加到 `/plugin` 在外掛程式安裝前顯示的信任警告 | 不改變警告自己的文字 |190| `pluginTrustMessage` | 將您的文字附加到 `/plugin` 在外掛程式安裝前顯示的信任警告 | 不改變警告自己的文字 |

191| `allowedChannelPlugins` | 替換允許推送頻道訊息的預設外掛程式清單。需要 `channelsEnabled: true` | 請參閱[限制哪些頻道外掛程式可以執行](https://code.claude.com/docs/zh-TW/channels.md#restrict-which-channel-plugins-can-run) |191| `allowedChannelPlugins` | 替換允許推送頻道訊息的預設外掛程式清單。需要 `channelsEnabled: true` | 請參閱[限制哪些頻道外掛程式可以執行](https://code.claude.com/docs/zh-TW/channels.md#restrict-which-channel-plugins-can-run) |

336 336 

337### 將發佈頻道指派給使用者群組337### 將發佈頻道指派給使用者群組

338 338 

339若要執行穩定和早期存取頻道，請託管兩個指向相同外掛程式的不同 ref 的市場。然後透過單獨的端點受管設定或閘道政策為每個使用者群組提供自己的市場。來自管理員主控台的伺服器受管設定[適用於組織中的每個使用者](https://code.claude.com/docs/zh-TW/server-managed-settings.md#current-limitations)，因此它們無法為不同的群組指派不同的設定。339若要執行穩定和早期存取通道，請託管兩個指向相同外掛程式的不同 ref 的市集。然後透過單獨的端點受管設定或閘道政策為每個使用者群組提供自己的市集。若使用 Enterprise 方案，您也可以使用來自管理員主控台的伺服器受管設定。

340 340 

341* 將單獨的[端點受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md#delivery-mechanisms)（例如受管設定檔案或 MDM 設定檔）部署到每個群組的裝置。若要檢查每個群組檔案或設定檔是否適用於也有組織範圍來源的裝置，請參閱[Claude Code 如何組合受管來源](https://code.claude.com/docs/zh-TW/managed-settings.md#precedence-within-the-managed-tier)。341* 將單獨的[端點受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md#delivery-mechanisms)（例如受管設定檔案或 MDM 設定檔）部署到每個群組的裝置。若要檢查每個群組檔案或設定檔是否適用於也有組織範圍來源的裝置，請參閱[Claude Code 如何組合受管來源](https://code.claude.com/docs/zh-TW/managed-settings.md#precedence-within-the-managed-tier)。

342* 為每個群組定義一個 [Claude 應用程式閘道政策](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config.md#managed)。預設情況下，閘道會套用第一個其匹配規則符合使用者的政策，因此請排序政策，讓每個使用者都能到達其群組的政策。該政策的 `extraKnownMarketplaces` 對應不會與任何其他政策的對應合併，因此請在其中列出群組需要的每個市集，而不僅僅是其通道市集。342* 為每個群組定義一個 [Claude 應用程式閘道政策](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config.md#managed)。預設情況下，閘道會套用第一個其匹配規則符合使用者的政策，因此請排序政策，讓每個使用者都能到達其群組的政策。該政策的 `extraKnownMarketplaces` 對應不會與任何其他政策的對應合併，因此請在其中列出群組需要的每個市集，而不僅僅是其通道市集。

343* 若使用 Enterprise 方案，請在管理員主控台中[為每個群組提供其專屬設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md#give-groups-different-settings)。群組的設定不會與組織範圍的設定合併，因此請將群組需要的每項設定（包括每個市集）都放入該群組自己的設定中。

343 344 

344使用任一機制，穩定群組接收此配置：345使用上述任一機制，穩定群組都會接收此設定：

345 346 

346```json theme={null}347```json theme={null}

347{348{

383 384 

384這些來自安全檢視的請求在目前設定架構中沒有專用金鑰。最接近的現有控制項是：385這些來自安全檢視的請求在目前設定架構中沒有專用金鑰。最接近的現有控制項是：

385 386 

386* **按使用者或按群組目標**：每個外掛程式金鑰適用於接收設定的每個使用者。伺服器受管設定為每個組織提供一個配置。對於按群組政策，使用單獨的端點受管設定或閘道政策，如[將發佈頻道指派給使用者群組](#assign-release-channels-to-user-groups)下所述。387* **按使用者或按群組目標**：每個外掛設定鍵都適用於接收這些設定的每位使用者。對於按群組政策，請為每個群組提供各自的設定，如[將發布通道指派給使用者群組](#assign-release-channels-to-user-groups)中所述。

387* **限制允許市場內的項目**：允許清單匹配市場來源。若要從允許的市場阻止一個外掛程式，請在受管 `enabledPlugins` 中將其設定為 `false`。388* **限制允許市場內的項目**：允許清單匹配市場來源。若要從允許的市場阻止一個外掛程式，請在受管 `enabledPlugins` 中將其設定為 `false`。

388* **隱藏 `/plugin`**：沒有金鑰禁用命令。最接近的等效項結合僅命名您的市場的允許清單、您提供的外掛程式的受管 `enabledPlugins` 項目和 `disableSideloadFlags`。389* **隱藏 `/plugin`**：沒有金鑰禁用命令。最接近的等效項結合僅命名您的市場的允許清單、您提供的外掛程式的受管 `enabledPlugins` 項目和 `disableSideloadFlags`。

389* **透過允許清單控制 `--plugin-dir`**：允許清單不涵蓋 `--plugin-dir`。`disableSideloadFlags` 執行。390* **透過允許清單控制 `--plugin-dir`**：允許清單不涵蓋 `--plugin-dir`。`disableSideloadFlags` 執行。

31>31>

32> **macOS、Linux、WSL：**32> **macOS、Linux、WSL：**

33>33>

34> ```bash theme={null}34> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

35> curl -fsSL https://claude.ai/install.sh | bash35> curl -fsSL https://claude.ai/install.sh | bash

36> ```36> ```

37>37>

39>39>

40> **Windows PowerShell：**40> **Windows PowerShell：**

41>41>

42> ```powershell theme={null}42> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

43> irm https://claude.ai/install.ps1 | iex43> irm https://claude.ai/install.ps1 | iex

44> ```44> ```

45>45>

46> **Windows CMD：**46> **Windows CMD：**

47>47>

48> ```batch theme={null}48> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50> ```50> ```

51>51>

63 63 

64> [tab] Homebrew64> [tab] Homebrew

65>65>

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

67> brew install --cask claude-code67> brew install --cask claude-code

68> ```68> ```

69>69>

75 75 

76> [tab] WinGet76> [tab] WinGet

77>77>

78> ```powershell theme={null}78> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

79> winget install Anthropic.ClaudeCode79> winget install Anthropic.ClaudeCode

80> ```80> ```

81>81>

257 257 

258| 命令 | 功能 | 範例 |258| 命令 | 功能 | 範例 |

259| - | - | - |259| - | - | - |

260| `/clear` | 清除對話歷史 | `/clear` |260| `/clear` | 開始新的對話。可使用 `/resume` 恢復先前的對話。 | `/clear` |

261| `/help` | 顯示可用命令 | `/help` |261| `/help` | 顯示可用命令 | `/help` |

262| `/exit` 或 Ctrl+D 兩次 | 退出 Claude Code | `/exit` |262| `/exit` 或 Ctrl+D 兩次 | 退出 Claude Code | `/exit` |

263 263 

33 * 您將 [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-TW/env-vars) 指向 `api.anthropic.com` 以外的主機，例如 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)或代理。取消設定該變數以使用遠端控制。33 * 您將 [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-TW/env-vars) 指向 `api.anthropic.com` 以外的主機，例如 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)或代理。取消設定該變數以使用遠端控制。

34 * 您透過企業 [Claude 應用程式閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway)登入。34 * 您透過企業 [Claude 應用程式閘道](https://code.claude.com/docs/zh-TW/claude-apps-gateway)登入。

35* **功能旗標評估**：如果您設定了[關閉功能旗標評估的環境變數](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)，Remote Control 是否可用取決於您設定的是哪一個：35* **功能旗標評估**：如果您設定了[關閉功能旗標評估的環境變數](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)，Remote Control 是否可用取決於您設定的是哪一個：

36 * 如果您設定了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK`，Remote Control 將不可用。在您的 shell 環境或 [`settings.json` 檔案](https://code.claude.com/docs/zh-TW/settings-reference#all-settings)的 `env` 區塊中取消設定該變數，以使用 Remote Control。36 * 如果您設定了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/zh-TW/env-vars#variables)，Remote Control 將不可用。無論該變數設定在何處，無論是在您的 shell 環境中，還是在 [`settings.json` 檔案](https://code.claude.com/docs/zh-TW/settings-reference#all-settings)的 `env` 區塊中，都請取消設定，以使用 Remote Control。

37 * 如果您只設定了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`，Remote Control 保持可用，除非您的組織要求[受信任的裝置](#trusted-devices)。如果是這樣，請取消設定該變數以使用 Remote Control。在設定任一變數的情況下使用 Remote Control，需要 Claude Code v2.1.283 或更新版本，若在 Claude Desktop 應用程式中則需要 v2.1.304 或更新版本。37 * 如果您只設定了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`，Remote Control 保持可用，除非您的組織要求[受信任的裝置](#trusted-devices)。如果是這樣，請取消設定該變數以使用 Remote Control。在設定任一變數的情況下使用 Remote Control，需要 Claude Code v2.1.283 或更新版本，若在 Claude Desktop 應用程式中則需要 v2.1.304 或更新版本。

38* **工作區信任**：在您尚未信任的目錄中，`claude remote-control` 會列印信任該目錄會啟用的功能，並在啟動前詢問 `Trust <directory>? [y/N]`。回答 `y` 會儲存該選擇，但在您的主目錄中除外，該目錄中信任永遠不會被儲存，每次執行時都會重新詢問。當其標準輸入或輸出不是終端機時，該命令無法詢問並會以 [`Workspace not trusted`](https://code.claude.com/docs/zh-TW/errors#workspace-not-trusted-when-starting-remote-control) 錯誤結束。38* **工作區信任**：在您尚未信任的目錄中，`claude remote-control` 會列印信任該目錄會啟用的功能，並在啟動前詢問 `Trust <directory>? [y/N]`。回答 `y` 會儲存該選擇，但在您的主目錄中除外，該目錄中信任永遠不會被儲存，每次執行時都會重新詢問。當其標準輸入或輸出不是終端機時，該命令無法詢問並會以 [`Workspace not trusted`](https://code.claude.com/docs/zh-TW/errors#workspace-not-trusted-when-starting-remote-control) 錯誤結束。

39 39 

217 217 

218#### 在設定 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 時自動連線218#### 在設定 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 時自動連線

219 219 

220若僅設定了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`，您的工作階段不會透過組織的管理員預設值或 Claude Code 本身的預設值自動連線。若有其他因素導致您無法使用 Remote Control，例如 `DISABLE_GROWTHBOOK` 或 LLM 閘道，請改從[需求](#requirements)開始。220若僅設定了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`，您的工作階段不會透過組織的管理員預設值或 Claude Code 本身的預設值自動連線。若有其他因素導致您無法使用 Remote Control，例如 [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/zh-TW/env-vars#variables) 或 LLM 閘道，請改從[需求](#requirements)開始。

221 221 

222在僅設定 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 的情況下開啟自動連線之前，請確認您的 Claude Code 版本符合[這些變數的需求](#requirements)。接著確認您的組織是否要求 [Trusted Devices](#trusted-devices)：222在僅設定 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 的情況下開啟自動連線之前，請確認您的 Claude Code 版本符合[這些變數的需求](#requirements)。接著確認您的組織是否要求 [Trusted Devices](#trusted-devices)：

223 223 

458 458 

459設定了[環境變數](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)以關閉功能旗標評估，完整訊息會命名 Claude Code 找到的變數。在 2.1.154 之前的版本上，相同的設定會改為產生「Remote Control is not yet enabled for your account」。要執行的操作取決於訊息命名的變數：459設定了[環境變數](https://code.claude.com/docs/zh-TW/env-vars.md#features-that-need-feature-flag-fetching)以關閉功能旗標評估，完整訊息會命名 Claude Code 找到的變數。在 2.1.154 之前的版本上，相同的設定會改為產生「Remote Control is not yet enabled for your account」。要執行的操作取決於訊息命名的變數：

460 460 

461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK`**：在設定的位置取消設定變數，在您的 shell 環境或 [`settings.json` 檔案](https://code.claude.com/docs/zh-TW/settings-reference#all-settings)的 `env` 區塊中。461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 或 `DISABLE_GROWTHBOOK`**：在設定的位置取消設定變數，在您的 shell 環境或 [`settings.json` 檔案](https://code.claude.com/docs/zh-TW/settings-reference#all-settings)的 `env` 區塊中。

462* **`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`**：在 Pro、Max、Ultra、Team 或 Enterprise 計畫上且 `DISABLE_GROWTHBOOK` 未設定的情況下，這些變數會保持 Remote Control 可用，除非您的組織需要[信任裝置](#trusted-devices)。如果需要，在設定的位置取消設定變數以使用 Remote Control。在 v2.1.154 到 v2.1.282 上，設定任一變數時都會看到此訊息，因此請將 Claude Code 更新至符合[這些變數需求](#requirements)的版本。462* **`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`**：在 Pro、Max、Ultra、Team 或 Enterprise 計畫上，且 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 和 `DISABLE_GROWTHBOOK` 均未設定的情況下，即使設定了這些變數，Remote Control 仍保持可用，除非您的組織需要[信任裝置](#trusted-devices)。如果需要，在設定的位置取消設定變數以使用 Remote Control。在 v2.1.154 到 v2.1.282 上，設定任一變數時都會看到此訊息，因此請將 Claude Code 更新至符合[這些變數需求](#requirements)的版本。

463 463 

464### "Remote Control is only available when using Claude via api.anthropic.com"464### "Remote Control is only available when using Claude via api.anthropic.com"

465 465 

111* **Environment variables**：提供 Claude 在每次執行期間可以使用的值。這些值[對使用該環境的任何人都可見](https://code.claude.com/docs/zh-TW/cloud-environments.md#what-carries-over-from-your-setup)，因此在 Anthropic 託管的環境中，請改將 Claude 在執行期間所呼叫 API 的金鑰儲存為[網路機密](https://code.claude.com/docs/zh-TW/cloud-environments.md#add-network-secrets)。該章節也列出了永遠不會取得機密的請求111* **Environment variables**：提供 Claude 在每次執行期間可以使用的值。這些值[對使用該環境的任何人都可見](https://code.claude.com/docs/zh-TW/cloud-environments.md#what-carries-over-from-your-setup)，因此在 Anthropic 託管的環境中，請改將 Claude 在執行期間所呼叫 API 的金鑰儲存為[網路機密](https://code.claude.com/docs/zh-TW/cloud-environments.md#add-network-secrets)。該章節也列出了永遠不會取得機密的請求

112* **Setup script**：安裝任務所需的相依套件和工具。結果會被[快取](https://code.claude.com/docs/zh-TW/cloud-environments.md#environment-caching)，因此指令碼不會在每個工作階段重新執行112* **Setup script**：安裝任務所需的相依套件和工具。結果會被[快取](https://code.claude.com/docs/zh-TW/cloud-environments.md#environment-caching)，因此指令碼不會在每個工作階段重新執行

113 113 

114系統提供具有 **Trusted** 網路存取的 **Default** 環境，它只允許[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)中的套件登錄、雲端供應商 API、容器登錄和常見開發網域透過工作階段的網路存取。您新增到任務的連接器會透過 Anthropic 的伺服器存取其服務，因此不需要變更允許清單。114系統提供 **Default** 環境，其網路存取為 **Limited**，並已勾選 **Allow package managers**。其執行可以存取[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)中的項目：套件登錄、雲端供應商 API、容器登錄和常見開發網域。您新增到任務的連接器會透過 Anthropic 的伺服器存取其服務，因此不需要變更允許清單。

115 115 

116如果您的任務需要直接存取您自己的服務，或該清單以外的網域，請在執行前編輯環境的[網路存取](https://code.claude.com/docs/zh-TW/cloud-environments.md#network-access)。若要使用另一個環境，請先[建立一個](https://code.claude.com/docs/zh-TW/cloud-environments.md#configure-your-environment)。116如果您的任務需要直接存取您自己的服務，或該清單以外的網域，請在執行前編輯環境的[網路存取](https://code.claude.com/docs/zh-TW/cloud-environments.md#network-access)。若要使用另一個環境，請先[建立一個](https://code.claude.com/docs/zh-TW/cloud-environments.md#configure-your-environment)。

117 117 

431 431 

432每個排程任務都使用一個[雲端環境](https://code.claude.com/docs/zh-TW/cloud-environments.md)，用來控制網路存取、環境變數和設定指令碼。任務在每次執行時都會繼承環境的網路政策。432每個排程任務都使用一個[雲端環境](https://code.claude.com/docs/zh-TW/cloud-environments.md)，用來控制網路存取、環境變數和設定指令碼。任務在每次執行時都會繼承環境的網路政策。

433 433 

434**Default** 環境使用 **Trusted** 網路存取，只允許[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)透過工作階段的網路存取。在該路徑上對允許清單以外主機的請求會失敗，並傳回 `403` 和 `x-deny-reason: host_not_allowed`。MCP 連接器的流量會經由 Anthropic 的伺服器路由，而不是走該路徑，因此您新增到任務的連接器無需將其主機加入 **Allowed domains** 即可運作。請在[連接器](#connectors)下移除您不需要的連接器。434**Default** 環境使用 **Limited** 存取，並已勾選 **Allow package managers**，因此其執行可以連線到[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)中的主機。對遭封鎖主機的請求會失敗，並傳回 `403` 和 `x-deny-reason: host_not_allowed`。MCP 連接器的流量會經由 Anthropic 的伺服器路由，因此您新增到任務的連接器無需將其主機加入 **Allowed domains** 即可運作。請在[連接器](#connectors)下移除您不需要的連接器。

435 435 

436若要在您自己的某個環境上允許其他網域，請依照以下步驟操作。[組織共用環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#organization-shared-environments)在此處會以唯讀方式開啟，因此改由擁有者從[管理設定](https://claude.ai/admin-settings)中的 **Cloud environments** 頁面變更其網路存取。436若要在您自己的某個環境上允許其他網域，請依照以下步驟操作。[組織共用環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#organization-shared-environments)在此處會以唯讀方式開啟，因此改由擁有者從[管理設定](https://claude.ai/admin-settings)中的 **Cloud environments** 頁面變更其網路存取。

437 437 

447 447 

448將滑鼠游標停留在清單中的環境上，然後按一下右側出現的設定圖示。448將滑鼠游標停留在清單中的環境上，然後按一下右側出現的設定圖示。

449 449 

450**4. 變更網路存取層級**450**4. 新增網域**

451 451 

452在 **Edit cloud environment** 對話方塊中，將 **Network access** 變更為 **Custom**，並在 **Allowed domains** 中輸入您的網域。勾選 **Also include default list of common package managers**，即可在自訂網域之外保留[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)。若需要不受限制的存取，請改為選擇 **Full**。452在 **Edit cloud environment** 對話方塊中，於 **Network access** 下選擇 **Limited**，並在 **Allowed domains** 中輸入您的網域。勾選 **Allow package managers**，即可在您自己的網域之外一併允許[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)。若需要不受限制的存取，請改為選擇 **Full**。

453 453 

454**5. 儲存**454**5. 儲存**

455 455 

6 6 

7> 比較 Claude Code 沙箱選項：內建的沙箱化 Bash 工具、sandbox runtime、dev containers、Docker 和虛擬機。為您的威脅模型選擇適當的隔離。7> 比較 Claude Code 沙箱選項：內建的沙箱化 Bash 工具、sandbox runtime、dev containers、Docker 和虛擬機。為您的威脅模型選擇適當的隔離。

8 8 

9隔離 Claude Code 會限制一個會話可以讀取、寫入和在網路上存取的內容。當您讓 Claude 在較少的權限提示下工作、無人值守地執行它，或將其指向您不完全信任的程式碼時，這一點最為重要。9隔離 Claude Code 會限制一個工作階段可以讀取、寫入和在網路上存取的內容。當您讓 Claude 在較少的權限提示下工作，或無人值守地執行它時，這一點最為重要。

10 10 

11Claude Code 可以在多種隔離環境中執行，範圍從輕量級的每個命令沙箱到完全獨立的虛擬機。本頁涵蓋如何比較它們隔離的內容和所需條件，幫助您為威脅模型選擇一個，並展示如何在整個組織中強制執行該選擇。11Claude Code 可以在多種隔離環境中執行，範圍從輕量級的每個命令沙箱到完全獨立的虛擬機。本頁涵蓋如何比較它們隔離的內容和所需條件，幫助您為威脅模型選擇一個，並展示如何在整個組織中強制執行該選擇。

12 12 

44| 在您自己的機器上減少日常工作中的權限提示 | [沙箱化 Bash 工具](https://code.claude.com/docs/zh-TW/sandboxing.md)，使用 `/sandbox` 設定 |44| 在您自己的機器上減少日常工作中的權限提示 | [沙箱化 Bash 工具](https://code.claude.com/docs/zh-TW/sandboxing.md)，使用 `/sandbox` 設定 |

45| 讓 Claude 使用 `--dangerously-skip-permissions` 或自動模式無人值守工作 | 預先設定的 [開發容器](https://code.claude.com/docs/zh-TW/devcontainer.md)、任何容器或虛擬機，或 [沙箱執行時](#sandbox-runtime) |45| 讓 Claude 使用 `--dangerously-skip-permissions` 或自動模式無人值守工作 | 預先設定的 [開發容器](https://code.claude.com/docs/zh-TW/devcontainer.md)、任何容器或虛擬機，或 [沙箱執行時](#sandbox-runtime) |

46| 隔離 MCP 伺服器和 hooks 以及 Bash，無需 Docker | 沙箱執行時 |46| 隔離 MCP 伺服器和 hooks 以及 Bash，無需 Docker | 沙箱執行時 |

47| 在不受信任的儲存庫上工作 | 專用虛擬機，或 [雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)（如果您有 Claude 訂閱）；使用 `claude --cloud` 啟動時不需要 GitHub |

48| 在團隊中標準化沙箱化環境 | 預先設定的 [開發容器](https://code.claude.com/docs/zh-TW/devcontainer.md)，複製到您的儲存庫中 |47| 在團隊中標準化沙箱化環境 | 預先設定的 [開發容器](https://code.claude.com/docs/zh-TW/devcontainer.md)，複製到您的儲存庫中 |

49| 從沒有本機設定的裝置使用 Claude Code | [雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)，需要 Claude 訂閱；若要複製 GitHub 儲存庫，還需要已連接的 GitHub 帳戶 |48| 從沒有本機設定的裝置使用 Claude Code | [雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)，需要 Claude 訂閱；若要複製 GitHub 儲存庫，還需要已連接的 GitHub 帳戶 |

50| 為組織中的每位開發人員要求隔離 | [在整個組織中強制隔離](#enforce-isolation-across-an-organization) |49| 為組織中的每位開發人員要求隔離 | [在整個組織中強制隔離](#enforce-isolation-across-an-organization) |

157 156 

158## Virtual machine157## Virtual machine

159 158 

160專用虛擬機提供最強的分離，具有自己的核心，在雲或 microVM 部署中，具有自己的虛擬化硬體。選項包括雲實例、本地虛擬機管理程式和 microVM（如 Firecracker）。當您評估不受信任的程式碼、當您的安全策略要求代理和主機之間的核心級分離，或當沒有主機級方法滿足您的合規要求時，使用此方法。159專用虛擬機提供最強的分離，具有自己的核心，在雲或 microVM 部署中，具有自己的虛擬化硬體。選項包括雲實例、本地虛擬機管理程式和 microVM（如 Firecracker）。當您的安全策略要求 agent 和主機之間的核心級分離，或當沒有主機級方法滿足您的合規要求時，使用此方法。

161 160 

162[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) 提供了一個具有自己的 Docker daemon 和工作區同步的 microVM，可以在任何安裝了 Docker Sandboxes 的主機上執行 Claude Code。它是來自 Docker 的免費獨立產品，不需要 Docker Desktop。161[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) 提供了一個具有自己的 Docker daemon 和工作區同步的 microVM，可以在任何安裝了 Docker Sandboxes 的主機上執行 Claude Code。它是來自 Docker 的免費獨立產品，不需要 Docker Desktop。

163 162 

739 739 

740沙箱無法在原生 Windows 上執行，因此設定 `failIfUnavailable` 時，Claude Code 會在這些機器上於啟動時結束。如果您的機隊包括 Windows 主機，您可以：740沙箱無法在原生 Windows 上執行，因此設定 `failIfUnavailable` 時，Claude Code 會在這些機器上於啟動時結束。如果您的機隊包括 Windows 主機，您可以：

741 741 

742* **依作業系統傳遞設定**：僅在 macOS 和 Linux 機器上透過您的 MDM 或以[受管設定檔](https://code.claude.com/docs/zh-TW/managed-settings.md#delivery-mechanisms)部署。[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md#current-limitations)會套用至組織中的所有使用者742* **依作業系統傳遞設定**：僅在 macOS 和 Linux 機器上透過您的 MDM 或以[受管設定檔](https://code.claude.com/docs/zh-TW/managed-settings.md#delivery-mechanisms)部署。[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md#give-groups-different-settings)會跟隨成員，而非裝置。

743* **將 Windows 使用者移至受支援的環境**：讓他們在 WSL2 或容器內執行 Claude Code743* **將 Windows 使用者移至受支援的環境**：讓他們在 WSL2 或容器內執行 Claude Code

744 744 

745### 防止開發人員擴大策略745### 防止開發人員擴大策略

92* 處理目前分支的 pull request：審查留言、失敗的 CI 執行、合併衝突92* 處理目前分支的 pull request：審查留言、失敗的 CI 執行、合併衝突

93* 在沒有其他待處理事項時，執行清理作業，例如尋找錯誤或簡化程式碼93* 在沒有其他待處理事項時，執行清理作業，例如尋找錯誤或簡化程式碼

94 94 

95Claude 不會在此範圍之外啟動新的工作項目，而推送或刪除等不可逆的動作，只有在延續逐字稿中已授權的事項時才會執行。95每次執行在推送或刪除任何內容之前，都會經過工作階段的[權限檢查](https://code.claude.com/docs/zh-TW/permissions.md)。

96 

97單獨的 `/loop` 會以[動態選擇的間隔](#let-claude-choose-the-interval)執行此提示詞：

96 98 

97```text theme={null}99```text theme={null}

98/loop100/loop

99```101```

100 102 

101單獨的 `/loop` 會以[動態選擇的間隔](#let-claude-choose-the-interval)執行此提示詞。加上間隔，例如 `/loop 15m`，即可改為依固定排程執行。若要以您自己的預設提示詞取代內建提示詞，請參閱[使用 loop.md 自訂預設提示詞](#customize-the-default-prompt-with-loop-md)。103加上間隔，例如 `/loop 15m`，即可改為依固定排程執行。若要以您自己的預設提示詞取代內建提示詞，請參閱[使用 loop.md 自訂預設提示詞](#customize-the-default-prompt-with-loop-md)。

102 104 

103### 使用 loop.md 自訂預設提示詞105### 使用 loop.md 自訂預設提示詞

104 106 

227 229 

228## 停用工作階段範圍的排程任務230## 停用工作階段範圍的排程任務

229 231 

230在您的環境中設定 `CLAUDE_CODE_DISABLE_CRON=1` 以完全停用排程器。cron 工具和 `/loop` 變得不可用，任何已排程的任務都停止執行。請參閱 [環境變數](https://code.claude.com/docs/zh-TW/env-vars.md) 以取得完整的停用標誌清單。232在您的環境中設定 `CLAUDE_CODE_DISABLE_CRON=1` 以完全停用排程器。`CronCreate` 和 `/loop` 變得不可用，任何已排程的任務都停止執行。當專案的 `.claude/scheduled_tasks.json` 檔案中仍有任務時，`CronList` 和 `CronDelete` 仍可使用，因此您仍然可以要求 Claude 列出或取消這些任務。請參閱 [環境變數](https://code.claude.com/docs/zh-TW/env-vars.md) 以取得完整的停用旗標清單。

231 233 

232## 限制234## 限制

233 235 

183 183 

184* **工作階段會推送結果的儲存庫**：執行器會使工作階段失敗，並在非零結束時將指令碼 stderr 的結尾部分呈現給使用者。請將原因以簡短的一行寫入 stderr，並放在最後輸出，然後以非零狀態結束。請勿將機密資訊輸出到 stderr，並在部署 hook 之前移除 `set -x`。184* **工作階段會推送結果的儲存庫**：執行器會使工作階段失敗，並在非零結束時將指令碼 stderr 的結尾部分呈現給使用者。請將原因以簡短的一行寫入 stderr，並放在最後輸出，然後以非零狀態結束。請勿將機密資訊輸出到 stderr，並在部署 hook 之前移除 `set -x`。

185 185 

186 如果 git 的 `couldn't find remote ref` 出現在 hook stderr 約最後 4 KB 內，執行器會改為回報分支已被刪除。此時工作階段的錯誤訊息會說明該分支已不存在於遠端，並請使用者將其還原。如果該分支確實存在，請參閱[工作階段因 `no longer exists on the remote` 或 `couldn't find remote ref` 而失敗](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy#no-longer-exists-on-the-remote)。186 如果 git 的 `couldn't find remote ref` 出現在 hook stderr 約最後 4 KB 內，執行器會改為回報分支不存在。如果該分支確實存在，請參閱[工作階段因 `couldn't be found in the remote repository` 或 `couldn't find remote ref` 而失敗](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy#no-longer-exists-on-the-remote)。

187* **工作階段只會讀取的儲存庫**，例如新增到執行中工作階段的儲存庫：執行器會略過它，並繼續處理其餘儲存庫。執行器會向工作階段發佈 `Skipped` 步驟，並移除 hook 在簽出路徑留下的任何內容。187* **工作階段只會讀取的儲存庫**，例如新增到執行中工作階段的儲存庫：執行器會略過它，並繼續處理其餘儲存庫。執行器會向工作階段發佈 `Skipped` 步驟，並移除 hook 在簽出路徑留下的任何內容。

188 188 

189 當 `Skipped` 步驟提及 checkout hook 時，請在執行器日誌中的 `[runner:warn] checkout hook failed` 這一行找到失敗詳細資訊。當該步驟指出某個來源參照 `no longer exists on remote` 時，請參閱[工作階段因 `no longer exists on the remote` 或 `couldn't find remote ref` 而失敗](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy#no-longer-exists-on-the-remote)。如果略過後工作階段完全沒有任何儲存庫，執行器仍會使工作階段失敗。189 當 `Skipped` 步驟提及 checkout hook 時，請在執行器日誌中的 `[runner:warn] checkout hook failed` 這一行找到失敗詳細資訊。當該步驟指出某個來源參照 `no longer exists on remote` 時，請參閱[工作階段因 `couldn't be found in the remote repository` 或 `couldn't find remote ref` 而失敗](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy#no-longer-exists-on-the-remote)。如果略過後工作階段完全沒有任何儲存庫，執行器仍會使工作階段失敗。

190 190 

191當 hook 成功時，執行器會在工作階段結束後移除簽出路徑。191當 hook 成功時，執行器會在工作階段結束後移除簽出路徑。

192 192 

638 638 

639* 位於標準系統路徑的企業範圍[受管 MCP 檔案](https://code.claude.com/docs/zh-TW/managed-mcp.md)：Linux runner 主機上為 `/etc/claude-code/managed-mcp.json`，macOS 主機上為 `/Library/Application Support/ClaudeCode/managed-mcp.json`。適用於僅允許載入管理員所列伺服器的鎖定機群。優先順序規則請參閱[使用 managed-mcp.json 進行獨占控制](https://code.claude.com/docs/zh-TW/managed-mcp.md#exclusive-control-with-managed-mcp-json)。當此檔案存在於 runner 主機上時，Claude Code 會略過 Anthropic 控制平面傳遞給工作階段的 MCP 伺服器（包括 claude.ai 連接器），並在工作階段子程序的 stderr 上以警告列出它們，runner 會以 `debug` 日誌層級記錄這些警告。在 v2.1.229 之前，這些工作階段會在啟動時以 `You cannot dynamically configure MCP servers when an enterprise MCP config is present` 結束。639* 位於標準系統路徑的企業範圍[受管 MCP 檔案](https://code.claude.com/docs/zh-TW/managed-mcp.md)：Linux runner 主機上為 `/etc/claude-code/managed-mcp.json`，macOS 主機上為 `/Library/Application Support/ClaudeCode/managed-mcp.json`。適用於僅允許載入管理員所列伺服器的鎖定機群。優先順序規則請參閱[使用 managed-mcp.json 進行獨占控制](https://code.claude.com/docs/zh-TW/managed-mcp.md#exclusive-control-with-managed-mcp-json)。當此檔案存在於 runner 主機上時，Claude Code 會略過 Anthropic 控制平面傳遞給工作階段的 MCP 伺服器（包括 claude.ai 連接器），並在工作階段子程序的 stderr 上以警告列出它們，runner 會以 `debug` 日誌層級記錄這些警告。在 v2.1.229 之前，這些工作階段會在啟動時以 `You cannot dynamically configure MCP servers when an enterprise MCP config is present` 結束。

640* runner 主機上[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)中的 [`managedMcpServers`](https://code.claude.com/docs/zh-TW/settings-reference#managedmcpservers) 鍵：提供 HTTP 和 SSE 伺服器而不取得獨占控制，因此來自其他來源的伺服器仍會載入。需要 Claude Code v2.1.259 或更新版本。640* runner 主機上[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)中的 [`managedMcpServers`](https://code.claude.com/docs/zh-TW/settings-reference#managedmcpservers) 鍵：提供 HTTP 和 SSE 伺服器而不取得獨占控制，因此來自其他來源的伺服器仍會載入。需要 Claude Code v2.1.259 或更新版本。

641* `<repo>/.mcp.json`：專案範圍。在[專案](https://code.claude.com/docs/zh-TW/claude-projects.md#what-threads-pick-up-from-your-repositories)對話串之外，將此檔案提交到儲存庫，其伺服器在雲端工作階段中即會自動核准。在包含多個儲存庫的工作階段中，[最多只會載入一個儲存庫的檔案](#repository-settings-in-sessions-with-several-repositories)。641* `<repo>/.mcp.json`：專案範圍。在[專案](https://code.claude.com/docs/zh-TW/claude-projects.md#what-threads-pick-up-from-your-repositories)對話串之外，將此檔案提交到儲存庫，其伺服器在雲端工作階段中即會自動核准。在包含多個儲存庫的工作階段中，[最多只會載入一個儲存庫的檔案](#repository-settings-in-sessions-with-several-repositories)。使用 [`--trust-workspace false`](https://code.claude.com/docs/zh-TW/self-hosted-environments-reference#runner-cli-flags) 時，工作階段會略過此檔案中的伺服器，除非有未提交至儲存庫的設定核准它們，例如主機 `~/.claude/settings.json` 中的 [`enabledMcpjsonServers`](https://code.claude.com/docs/zh-TW/settings-reference#enabledmcpjsonservers)。需要 Claude Code v2.1.319 或更新版本。

642* 來自您包裝腳本的 [`--mcp-config`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 檔案：將此旗標附加在 `"$@"` 之後，例如 `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`。若要在工作階段所傳遞的伺服器於工作階段中途更新時，讓該檔案中的伺服器持續執行，請讓您的包裝腳本將[完整環境](#wrapper-scripts)傳遞給子程序，如同 `exec` 的做法。在 v2.1.299 之前，該檔案中的 stdio、HTTP 和 SSE 伺服器會在第一次未列出它們的此類更新時關閉。642* 來自您包裝腳本的 [`--mcp-config`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 檔案：將此旗標附加在 `"$@"` 之後，例如 `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`。若要在工作階段所傳遞的伺服器於工作階段中途更新時，讓該檔案中的伺服器持續執行，請讓您的包裝腳本將[完整環境](#wrapper-scripts)傳遞給子程序，如同 `exec` 的做法。在 v2.1.299 之前，該檔案中的 stdio、HTTP 和 SSE 伺服器會在第一次未列出它們的此類更新時關閉。

643 643 

644當您的組織啟用連接器傳遞時，Anthropic 的控制平面會透過伺服器提供的 MCP 設定，將您在 claude.ai 上設定的連接器傳遞給以互動方式建立的工作階段，並經由 `api.anthropic.com` 路由。以程式化方式建立的工作階段（例如 [CLI 派送](https://code.claude.com/docs/zh-TW/self-hosted-environments-testing.md#run-the-test-loop)）不會接收連接器傳遞；請改為透過本節列出的任何其他來源為它們提供 MCP 伺服器。子程序的 OAuth token 不具備直接擷取連接器的範圍，因此子程序本身不會嘗試該擷取；傳遞是由伺服器驅動的。644當您的組織啟用連接器傳遞時，Anthropic 的控制平面會透過伺服器提供的 MCP 設定，將您在 claude.ai 上設定的連接器傳遞給以互動方式建立的工作階段，並經由 `api.anthropic.com` 路由。以程式化方式建立的工作階段（例如 [CLI 派送](https://code.claude.com/docs/zh-TW/self-hosted-environments-testing.md#run-the-test-loop)）不會接收連接器傳遞；請改為透過本節列出的任何其他來源為它們提供 MCP 伺服器。子程序的 OAuth token 不具備直接擷取連接器的範圍，因此子程序本身不會嘗試該擷取；傳遞是由伺服器驅動的。

908 908 

909在其他任何包含多個儲存庫的工作階段中，Claude Code 會從工作階段啟動時所在的目錄讀取專案設定，因此最多只有一個儲存庫的 `.claude/settings.json` 會作為專案設定生效。在其他儲存庫檔案中定義的 hook 不會執行，其中的拒絕規則不會套用，其 `env` 也不會被設定。909在其他任何包含多個儲存庫的工作階段中，Claude Code 會從工作階段啟動時所在的目錄讀取專案設定，因此最多只有一個儲存庫的 `.claude/settings.json` 會作為專案設定生效。在其他儲存庫檔案中定義的 hook 不會執行，其中的拒絕規則不會套用，其 `env` 也不會被設定。

910 910 

911* **`--capacity 1`（預設值）搭配內建簽出**：工作階段會在其儲存庫清單中的第一個儲存庫啟動。該儲存庫的 `.claude/settings.json` 會作為專案設定生效，其 `.mcp.json` 也會載入，其他儲存庫的則不會。911* **`--capacity 1`（預設值）搭配內建簽出**：工作階段會在其儲存庫清單中的第一個儲存庫啟動。該儲存庫的 `.claude/settings.json` 會作為專案設定生效，其 [`.mcp.json`](#mcp-servers) 也會載入，其他儲存庫的則不會。

912* **`--capacity` 大於一，或使用 [`checkout` hook](#checkout)**：工作階段會在包含各簽出內容的個別工作階段目錄中啟動。沒有任何儲存庫的 `.claude/settings.json` 會作為專案設定生效，沒有任何儲存庫的 `.mcp.json` 會載入，且 hook 命令中的 [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/zh-TW/hooks#reference-scripts-by-path) 為該目錄，而非某個簽出內容。912* **`--capacity` 大於一，或使用 [`checkout` hook](#checkout)**：工作階段會在包含各簽出內容的個別工作階段目錄中啟動。沒有任何儲存庫的 `.claude/settings.json` 會作為專案設定生效，沒有任何儲存庫的 `.mcp.json` 會載入，且 hook 命令中的 [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/zh-TW/hooks#reference-scripts-by-path) 為該目錄，而非某個簽出內容。

913 913 

914無論工作階段在何處啟動，每個儲存庫的 `CLAUDE.md` 都會載入。在專案討論串以外，其 skill 也會載入。執行器會將每個儲存庫作為[額外目錄](https://code.claude.com/docs/zh-TW/permissions.md#additional-directories-grant-file-access-not-configuration)傳遞給 Claude Code，因此 Claude Code 也會從每個儲存庫的 `.claude/settings.json` 讀取 `enabledPlugins` 和 `extraKnownMarketplaces` 設定鍵。914無論工作階段在何處啟動，每個儲存庫的 `CLAUDE.md` 都會載入。在專案討論串以外，其 skill 也會載入。執行器會將每個儲存庫作為[額外目錄](https://code.claude.com/docs/zh-TW/permissions.md#additional-directories-grant-file-access-not-configuration)傳遞給 Claude Code，因此 Claude Code 也會從每個儲存庫的 `.claude/settings.json` 讀取 `enabledPlugins` 和 `extraKnownMarketplaces` 設定鍵。

916* **Runner 記錄包含 `rejecting the malformed poll response` 的 `Poll failed` 行**：runner 收到的工作輪詢回應本文並非佇列預期的 JSON。其中一個原因是攔截式代理伺服器或強制入口網頁以其自己的頁面作出回應。如果 runner 透過代理伺服器連線，請設定代理伺服器，讓來自 `api.anthropic.com` 的回應原封不動地通過。916* **Runner 記錄包含 `rejecting the malformed poll response` 的 `Poll failed` 行**：runner 收到的工作輪詢回應本文並非佇列預期的 JSON。其中一個原因是攔截式代理伺服器或強制入口網頁以其自己的頁面作出回應。如果 runner 透過代理伺服器連線，請設定代理伺服器，讓來自 `api.anthropic.com` 的回應原封不動地通過。

917 917 

918 Runner 會拒絕該格式錯誤的回應，將其計入 `claude_code_self_hosted_runner_poll_errors_total` [指標](https://code.claude.com/docs/zh-TW/self-hosted-environments-reference.md#prometheus-metrics)的 `transport` 類別，並依照[工作階段生命週期](https://code.claude.com/docs/zh-TW/self-hosted-environments#session-lifecycle)中所述的輪詢失敗排程重試。Runner 會繼續服務其進行中的工作階段。在 v2.1.246 之前，runner 會將這類回應讀作空的工作佇列，這可能會結束其進行中的工作階段或使其結束。918 Runner 會拒絕該格式錯誤的回應，將其計入 `claude_code_self_hosted_runner_poll_errors_total` [指標](https://code.claude.com/docs/zh-TW/self-hosted-environments-reference.md#prometheus-metrics)的 `transport` 類別，並依照[工作階段生命週期](https://code.claude.com/docs/zh-TW/self-hosted-environments#session-lifecycle)中所述的輪詢失敗排程重試。Runner 會繼續服務其進行中的工作階段。在 v2.1.246 之前，runner 會將這類回應讀作空的工作佇列，這可能會結束其進行中的工作階段或使其結束。

919* **工作階段以 `no longer exists on the remote` 或 `couldn't find remote ref` 失敗**：runner 會將 git 的 `couldn't find remote ref` 解讀為分支已刪除。但該分支可能仍然存在。請在您的 git 主機上以訊息中的確切名稱尋找該分支，然後檢查每個符合的原因：919* **工作階段以 `couldn't be found in the remote repository` 或 `couldn't find remote ref` 失敗**：請在您的 git 主機上尋找該分支。請以訊息中的確切名稱進行搜尋。

920 920 

921 * **分支已不存在**：請依訊息的要求還原分支。921 工作階段的錯誤包含 `Retrying will fail the same way until you fix the missing branch described below.`。當錯誤指名該分支時，`Last output before exit:` 下方的文字如下：

922 

923 ```text theme={null}

924 The branch '<ref>' couldn't be found in the remote repository <repo>. If it was never pushed, push it. If it was deleted after a merge, restore it from its pull request. Then send a new message, or start a new session from a branch that has been pushed. (couldn't find remote ref)

925 ```

926 

927 * **分支不在主機上**：如果該分支從未推送過，請推送它；如果它在合併後被刪除，請從其 pull request 還原。

922 * **分支存在，且您不是 runner 的管理員**：將完整訊息傳送給 runner 的管理員，並告知該分支存在。928 * **分支存在，且您不是 runner 的管理員**：將完整訊息傳送給 runner 的管理員，並告知該分支存在。

923 * **分支存在，且 runner 有 `checkout` hook**：您 hook 中的 git 命令可能會在 hook 以非零值結束之前，將 `couldn't find remote ref` 輸出至 stderr。請找出該命令，並修正其請求的 ref 或其擷取來源的遠端。Runner 會以 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/zh-TW/self-hosted-environments-configuration#checkout) 將工作階段所要求的修訂版本傳遞給您的 hook。929 * **分支存在，且 runner 有 `checkout` hook**：您 hook 中的 git 命令可能會在 hook 以非零值結束之前，將 `couldn't find remote ref` 輸出至 stderr。請找出該命令，並修正其請求的 ref 或其擷取來源的遠端。Runner 會以 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/zh-TW/self-hosted-environments-configuration#checkout) 將工作階段所要求的修訂版本傳遞給您的 hook。

924 * **分支存在，且 runner 沒有 `checkout` hook**：runner 會自行擷取分支。如果有 [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks) 套用於該儲存庫，請確認其改寫後的目標主機上有同名的分支，若沒有，請將分支推送至該處。930 * **分支存在，且 runner 沒有 `checkout` hook**：runner 會自行擷取分支。如果有 [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks) 套用於該儲存庫，請確認其改寫後的目標主機上有同名的分支，若沒有，請將分支推送至該處。

925 * **分支存在，且 runner 早於 v2.1.301**：請依[固定版本](#pin-the-version)中所述升級 runner，讓其他失敗能顯示其自身的錯誤。在 v2.1.301 之前，錯誤輸出中包含 `couldn't find remote ref` 的其他失敗也會被回報為分支已刪除。931 * **分支存在，且 runner 早於 v2.1.301**：請依[固定版本](#pin-the-version)中所述升級 runner，讓其他失敗能顯示其自身的錯誤。在 v2.1.301 之前，錯誤輸出中包含 `couldn't find remote ref` 的其他失敗也會被回報為分支已刪除。

926 932 

927 Runner 升級或原因修正後，請重試該工作階段或啟動新的工作階段。如果以上檢查都找不到原因，請[回報問題](#report-an-issue)。933 Runner 升級或原因修正後，請傳送新訊息給該工作階段，或從已推送的分支啟動新的工作階段。如果以上檢查都找不到原因，請[回報問題](#report-an-issue)。在 v2.1.314 之前，訊息會指出分支 `no longer exists on the remote`。遇到該訊息時，請依照相同的檢查進行。

928 934 

929 對於工作階段推送結果的來源，已刪除的分支會使工作階段失敗。對於工作階段只讀取的 git 來源，runner 會略過該來源並繼續處理其餘來源。當略過會使工作階段完全沒有儲存庫時，runner 會使工作階段失敗。在 v2.1.228 之前，這類工作階段會在空目錄中啟動。935 對於工作階段推送結果的來源，已刪除的分支會使工作階段失敗。對於工作階段只讀取的 git 來源，runner 會略過該來源並繼續處理其餘來源。當略過會使工作階段完全沒有儲存庫時，runner 會使工作階段失敗。在 v2.1.228 之前，這類工作階段會在空目錄中啟動。

930* **Claude Tag 有時不會在 Slack 中張貼其回覆**：回覆提醒是[控制平面所提供的 hook](https://code.claude.com/docs/zh-TW/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled)。請以 `claude --version` 確認 runner 為 Claude Code v2.1.229 或更新版本，因為較舊的 runner 會忽略所提供的 hook；確認 `python3 --version` 能在 runner 映像中成功執行，因為這些 hook 會執行 `python3`；並確認沒有任何設定檔關閉 hook，無論是 `managed-settings.json`、runner 使用者的 `~/.claude/settings.json`，或儲存庫的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的 `disableAllHooks`，或是受管設定中的 `allowManagedHooksOnly` 或涵蓋 hook 的 [`strictPluginOnlyCustomization`](https://code.claude.com/docs/zh-TW/settings-reference#strictpluginonlycustomization)。936* **Claude Tag 有時不會在 Slack 中張貼其回覆**：回覆提醒是[控制平面所提供的 hook](https://code.claude.com/docs/zh-TW/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled)。請以 `claude --version` 確認 runner 為 Claude Code v2.1.229 或更新版本，因為較舊的 runner 會忽略所提供的 hook；確認 `python3 --version` 能在 runner 映像中成功執行，因為這些 hook 會執行 `python3`；並確認沒有任何設定檔關閉 hook，無論是 `managed-settings.json`、runner 使用者的 `~/.claude/settings.json`，或儲存庫的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的 `disableAllHooks`，或是受管設定中的 `allowManagedHooksOnly` 或涵蓋 hook 的 [`strictPluginOnlyCustomization`](https://code.claude.com/docs/zh-TW/settings-reference#strictpluginonlycustomization)。

125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | 執行器在工作階段達到其 `--kill-session-after-min` 限制後等待的時間，以便執行中的轉向完成或釋放完成，然後才終止工作階段 |125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | 執行器在工作階段達到其 `--kill-session-after-min` 限制後等待的時間，以便執行中的轉向完成或釋放完成，然後才終止工作階段 |

126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | 執行器在轉向完成後計算工作階段忙碌的上限時間，用於 `--drain-wait-sec` 排空，而工作階段的程序向 Anthropic 報告轉向的結束。`0` 或無法使用的值回退到預設值，因此無法關閉保持。需要 Claude Code v2.1.275 或更新版本。 |126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | 執行器在轉向完成後計算工作階段忙碌的上限時間，用於 `--drain-wait-sec` 排空，而工作階段的程序向 Anthropic 報告轉向的結束。`0` 或無法使用的值回退到預設值，因此無法關閉保持。需要 Claude Code v2.1.275 或更新版本。 |

127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | 執行器等待作業系統將 `SIGKILL` 傳遞到卡在不可中斷 I/O 中的子程序的時間，然後自己退出。下限為 `--post-session-hook-timeout-sec` 加 15 秒，以及設定 `--push-outcome-on-release` 時的 30 秒，因此有效最小值在預設值為 75 秒。 |127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | 執行器等待作業系統將 `SIGKILL` 傳遞到卡在不可中斷 I/O 中的子程序的時間，然後自己退出。下限為 `--post-session-hook-timeout-sec` 加 15 秒，以及設定 `--push-outcome-on-release` 時的 30 秒，因此有效最小值在預設值為 75 秒。 |

128| `CLAUDE_RUNNER_DISABLE_RENEWAL_WARNING` | 未設定 | 當 `1` 時，執行器不會在工作階段中張貼 `The server has refused to renew this session's access to the model`。每次遭拒後，它會等到下一次排定的續約時再次請求。需要 Claude Code v2.1.319 或更新版本。 |

128| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | 新複製的 git 提取深度。設定正整數，或 `full` 或 `0` 以進行完整提取。對於工作區中已存在的複製，請參閱[重複使用預熱的簽出](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)。 |129| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | 新複製的 git 提取深度。設定正整數，或 `full` 或 `0` 以進行完整提取。對於工作區中已存在的複製，請參閱[重複使用預熱的簽出](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)。 |

129| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | 每次嘗試中，當 git 伺服器本身的進度數字持續上升時（例如伺服器為大型儲存庫準備 pack 時），git 提取可等待第一筆資料的時間（以毫秒為單位）。`0` 或 `off` 會關閉此等待：此類提取在兩分鐘內沒有資料時即會被中斷。其他任何整數會被限制在 `120000` 到 `1800000` 之間，即 2 到 30 分鐘。需要 Claude Code v2.1.295 或更新版本。 |130| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | 每次嘗試中，當 git 伺服器本身的進度數字持續上升時（例如伺服器為大型儲存庫準備 pack 時），git 提取可等待第一筆資料的時間（以毫秒為單位）。`0` 或 `off` 會關閉此等待：此類提取在兩分鐘內沒有資料時即會被中斷。其他任何整數會被限制在 `120000` 到 `1800000` 之間，即 2 到 30 分鐘。需要 Claude Code v2.1.295 或更新版本。 |

130| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | 未設定 | 當 `1` 時，在 `checkout` 掛鉤執行後跳過 `.git` 存在檢查。當您的掛鉤具體化非 git 來源時設定此項。 |131| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | 未設定 | 當 `1` 時，在 `checkout` 掛鉤執行後跳過 `.git` 存在檢查。當您的掛鉤具體化非 git 來源時設定此項。 |

135 136 

136工作階段子程序將操作遙測傳送給 Anthropic，除非您將其關閉。不會傳送任何程式碼或存放庫內容。在執行器程序上設定遙測變數；執行器在應用伺服器提供的環境變數後重新聲稱它們，因此操作員的設定始終優先。137工作階段子程序將操作遙測傳送給 Anthropic，除非您將其關閉。不會傳送任何程式碼或存放庫內容。在執行器程序上設定遙測變數；執行器在應用伺服器提供的環境變數後重新聲稱它們，因此操作員的設定始終優先。

137 138 

138一個控制項特定於自託管環境：`CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` 選擇加入 Datadog 操作指標，在自託管環境中預設為關閉。一般 Claude Code 遙測控制項 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_ERROR_REPORTING` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 適用於工作階段子程序，如[環境變數參考](https://code.claude.com/docs/zh-TW/env-vars.md)中所述。`DISABLE_GROWTHBOOK` 相關但不同：設定 `DISABLE_GROWTHBOOK=1` 停用功能旗標提取，遙測保持開啟，除非也設定了 `DISABLE_TELEMETRY`。139一個控制項特定於自託管環境：`CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` 選擇加入 Datadog 操作指標，在自託管環境中預設為關閉。一般 Claude Code 遙測控制項 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_ERROR_REPORTING` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 適用於工作階段子程序，如[環境變數參考](https://code.claude.com/docs/zh-TW/env-vars.md)中所述。[`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/zh-TW/env-vars#variables) 相關但不同：設定 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS=1` 停用功能旗標提取，遙測保持開啟，除非也設定了 `DISABLE_TELEMETRY`。`CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 需要 Claude Code v2.1.319 或更新版本。

139 140 

140`CLAUDE_CODE_ENABLE_TELEMETRY` 無關：它啟用 OpenTelemetry 匯出到您自己的收集器，如[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md)中所述，不控制 Anthropic 的分析。141`CLAUDE_CODE_ENABLE_TELEMETRY` 無關：它啟用 OpenTelemetry 匯出到您自己的收集器，如[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md)中所述，不控制 Anthropic 的分析。

141 142 

108 108 

109在執行中的工作階段中，`/status` 在擷取失敗後會顯示相同的行，對於某些略過擷取的原因（例如第三方提供者變數或使用者 shell 中匯出的自訂 `ANTHROPIC_BASE_URL`），也會顯示。109在執行中的工作階段中，`/status` 在擷取失敗後會顯示相同的行，對於某些略過擷取的原因（例如第三方提供者變數或使用者 shell 中匯出的自訂 `ANTHROPIC_BASE_URL`），也會顯示。

110 110 

111### 為群組提供不同的設定

112 

113在 Enterprise 方案中，您可以為每個成員群組提供各自的組態，而不是使用單一的全組織組態。如果您的組織已[啟用 HIPAA](https://code.claude.com/docs/zh-TW/hipaa-setup.md)，則目前尚無法使用群組組態。每個群組都必須已經存在，可以是透過 SCIM 從您的身分識別提供者同步的群組，或是您在管理員主控台中管理的自訂群組。

114 

115每位成員最多只會收到一個組態，且在每台裝置上都相同：

116 

117* **屬於具有組態之群組的成員**：其所屬群組中排名最高的組態

118* **其他任何人**，包括唯一具有組態的所屬群組已被刪除的成員：全體適用組態（如果您有設定）

119 

120組態之間不會彼此合併，也不會與全組織組態合併，因此每個組態都必須包含您希望該群組擁有的所有設定。若要將某項限制套用到每位成員，請將其放入每個群組組態以及全體適用組態中。

121 

122在完成以下最後一個步驟之前，成員會持續收到全組織組態，因此您可以先設定並測試所有內容：

123 

124**1. 為每個群組新增組態**

125 

126在 [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) 中，按一下 **Add configuration**，選取群組，並選擇起點。若要為某個群組放寬原則，請選取由您的身分識別提供者同步的群組，如此便沒有人能在管理員主控台中將自己加入該群組。

127 

128若要保留成員目前擁有的設定並只變更少數設定，請從您的全組織組態副本開始。編輯該組態並儲存。

129 

130**2. 設定全體適用組態**

131 

132按一下 **Everyone else** 上的 **Set**，並為不符合任何群組組態的成員新增 JSON。若要讓他們保留目前擁有的設定，請貼上您的全組織組態。如果您略過此步驟，他們的本機工作階段將不會收到任何伺服器管理的設定，而裝置上的任何[端點管理設定](https://code.claude.com/docs/zh-TW/managed-settings.md#delivery-mechanisms)仍然適用。

133 

134**3. 排列群組順序**

135 

136拖曳組態以排列順序。屬於多個群組的成員只會收到排名最高的組態，因此請將限制最嚴格或最具體的群組放在最上方。

137 

138**4. 檢查每位成員會收到的內容**

139 

140在頁面底部的 **Check effective settings** 下，搜尋成員以查看他們會收到哪個組態。請檢查每個群組中的一位成員、一位屬於多個群組的成員，以及一位不符合任何群組組態的成員。

141 

142**5. 切換為以群組為基礎的模式**

143 

144按一下頁面頂端橫幅中的 **Switch to group-based configurations** 並確認。成員會在大約一小時內收到其組態，但[僅在下次啟動時才會套用的鍵](#fetch-and-caching-behavior)除外。若要切換回去，請從同一個橫幅切換為全組織模式：如果您有全組織組態，該組態會再次套用，且您的群組組態會被保留。

145 

146群組的模型限制僅在本機工作階段中有效。雲端和遠端 Cowork 工作階段會使用全體適用組態中的 [`availableModels`](https://code.claude.com/docs/zh-TW/model-config#restrict-model-selection) 清單。如果您未設定全體適用組態，則即使在您切換為以群組為基礎的模式後，該清單仍會來自您的全組織組態。如果您在全體適用組態中省略此鍵，成員在這些工作階段中將不受此清單限制。

147 

148如果您使用群組的組態來設定 API 請求的傳送目的地，這僅適用於 Claude Code，不適用於其他呼叫 API 的工具。

149 

111### 存取控制150### 存取控制

112 151 

113以下角色可以管理伺服器管理的設定：152以下角色可以管理伺服器管理的設定：

115* **主要擁有者**154* **主要擁有者**

116* **擁有者**155* **擁有者**

117 156 

118限制對受信任人員的存取，因為設定變更會套用到組織中的所有使用者。157限制對受信任人員的存取，因為設定變更可能會套用到組織中的所有使用者。

119 158 

120### 僅限受管的設定159### 僅限受管的設定

121 160 

125 164 

126伺服器管理的設定有以下限制：165伺服器管理的設定有以下限制：

127 166 

128* 設定統一套用到組織中的所有使用者。尚不支援每個群組的設定。167* 在 Team 方案中，設定統一套用到組織中的所有使用者。[群組組態](#give-groups-different-settings)需要 Enterprise 方案。

129* 您無法透過伺服器管理的設定分發 [`managed-mcp.json`](https://code.claude.com/docs/zh-TW/managed-mcp) 檔案。改為在該處傳遞 `allowedMcpServers` 和 `deniedMcpServers` 原則金鑰。在 Claude Code v2.1.259 或更新版本上，您也可以透過 [`managedMcpServers`](https://code.claude.com/docs/zh-TW/managed-mcp#provide-servers-through-managed-settings) 提供遠端伺服器，其僅接受 `http` 和 `sse` 伺服器，且不會以檔案的方式進行獨佔控制。168* 您無法透過伺服器管理的設定分發 [`managed-mcp.json`](https://code.claude.com/docs/zh-TW/managed-mcp) 檔案。改為在該處傳遞 `allowedMcpServers` 和 `deniedMcpServers` 原則金鑰。在 Claude Code v2.1.259 或更新版本上，您也可以透過 [`managedMcpServers`](https://code.claude.com/docs/zh-TW/managed-mcp#provide-servers-through-managed-settings) 提供遠端伺服器，其僅接受 `http` 和 `sse` 伺服器，且不會以檔案的方式進行獨佔控制。

130 169 

131 Claude Code 在其[系統路徑](https://code.claude.com/docs/zh-TW/managed-mcp.md#exclusive-control-with-managed-mcp-json)部署的 `managed-mcp.json` 與受管設定層級分開讀取，因此當伺服器管理的設定生效時，檔案仍然適用。170 Claude Code 在其[系統路徑](https://code.claude.com/docs/zh-TW/managed-mcp.md#exclusive-control-with-managed-mcp-json)部署的 `managed-mcp.json` 與受管設定層級分開讀取，因此當伺服器管理的設定生效時，檔案仍然適用。

245* `cleanupPeriodDays` 將工作階段記錄和其他本機資料的保留期縮短至七天245* `cleanupPeriodDays` 將工作階段記錄和其他本機資料的保留期縮短至七天

246* `companyAnnouncements` 在啟動時顯示訊息246* `companyAnnouncements` 在啟動時顯示訊息

247 247 

248管理員將這樣的檔案部署為 `managed-settings.json`，或透過 MDM 或 [伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md) 部署相同的 JSON。一個部署的檔案適用於它到達的每台機器或帳戶。要為一個群組提供不同的數值，請將不同的檔案或設定檔部署到該群組，因為 [伺服器受管設定尚不支援每個群組的政策](https://code.claude.com/docs/zh-TW/server-managed-settings.md#current-limitations)。248管理員將這樣的檔案部署為 `managed-settings.json`，或透過 MDM 或 [伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md) 部署相同的 JSON。一個部署的檔案適用於它到達的每台機器或帳戶。要為一個群組提供不同的數值，請將不同的檔案或設定檔部署到該群組。在 Enterprise 方案中，您也可以改為在伺服器受管設定中[為該群組提供專屬的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md#give-groups-different-settings)。

249 249 

250> [tab] 可複製的設定檔250> [tab] 可複製的設定檔

251>251>

91| `managed-agents-secure [<agent-id>]` | 讀取一個 Managed Agent 的設定，並回報其中哪些部分符合或不同於[保護您的 Managed Agents 部署](https://platform.claude.com/docs/en/managed-agents/secure-deployment)指南。需要 [`ant` CLI](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 或更新版本 |91| `managed-agents-secure [<agent-id>]` | 讀取一個 Managed Agent 的設定，並回報其中哪些部分符合或不同於[保護您的 Managed Agents 部署](https://platform.claude.com/docs/en/managed-agents/secure-deployment)指南。需要 [`ant` CLI](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 或更新版本 |

92| `prompt-audit` | 標記為舊版模型編寫的指示，位於您的提示、技能和工具描述中，並提議修復作為差異 | v2.1.221 或更新版本 |92| `prompt-audit` | 標記為舊版模型編寫的指示，位於您的提示、技能和工具描述中，並提議修復作為差異 | v2.1.221 或更新版本 |

93| `cost-optimize` | 分析您的專案的 Claude API 支出流向何處，並提議從提示快取、修剪不需要的輸入和輸出 token、批次處理、工作量和模型選擇等選項中節省成本，一次一個變更 | v2.1.247 或更新版本 |93| `cost-optimize` | 分析您的專案的 Claude API 支出流向何處，並提議從提示快取、修剪不需要的輸入和輸出 token、批次處理、工作量和模型選擇等選項中節省成本，一次一個變更 | v2.1.247 或更新版本 |

94| `latency-optimize` | 找出您現有 Claude API 程式碼中時間花在何處，並提議可縮短使用者等待時間的變更 | v2.1.319 或更新版本 |

94| `build-eval` | 為您的 Claude 驅動應用程式建置評估集 | v2.1.259 或更新版本 |95| `build-eval` | 為您的 Claude 驅動應用程式建置評估集 | v2.1.259 或更新版本 |

95| `hillclimb` | 根據現有評估反覆改進您的應用程式 | v2.1.259 或更新版本 |96| `hillclimb` | 根據現有評估反覆改進您的應用程式 | v2.1.259 或更新版本 |

96| `preserved-thinking-migration` | 尋找您的整合對早期輪次、其系統提示或其工具清單所做的編輯，這些編輯會使[保留的思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)區塊失效，測量每個區塊會丟棄多少推理，並提議一次修復一個，在每次變更後重新測量 | v2.1.282 或更新版本 |97| `preserved-thinking-migration` | 尋找您的整合對早期輪次、其系統提示或其工具清單所做的編輯，這些編輯會使[保留的思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)區塊失效，測量每個區塊會丟棄多少推理，並提議一次修復一個，在每次變更後重新測量 | v2.1.282 或更新版本 |

197時間限制從命令進入背景的時刻開始計算：197時間限制從命令進入背景的時刻開始計算：

198 198 

199* Claude 在背景啟動的命令獲得 30 分鐘，或 Claude 使用 `run_in_background` 傳遞的 `timeout`，最多 2 小時199* Claude 在背景啟動的命令獲得 30 分鐘，或 Claude 使用 `run_in_background` 傳遞的 `timeout`，最多 2 小時

200* 在前景啟動然後移至背景的命令，例如在其逾時時，從移動時獲得 30 分鐘200* 在前景啟動、然後在其逾時時移至背景的命令，從移動時起獲得 30 分鐘

201 201 

202在使用 `-p` 旗標、且提示詞以文字傳遞而非使用 `--input-format stream-json` 的執行中，兩個預設值都是 10 分鐘而非 30 分鐘，因為該執行會[在其結果之後等待背景命令](https://code.claude.com/docs/zh-TW/headless.md#background-tasks-at-exit)。202在使用 `-p` 旗標、且提示詞以文字傳遞而非使用 `--input-format stream-json` 的執行中，兩個預設值都是 10 分鐘而非 30 分鐘，因為該執行會[在其結果之後等待背景命令](https://code.claude.com/docs/zh-TW/headless.md#background-tasks-at-exit)。

203 203 

399 399 

400如果重新載入使 Claude 在步驟進行中被中斷，Claude 會在對話恢復時繼續該步驟，並在聊天中以通知標示此接續。需要 Claude Code v2.1.274 或更新版本。如果該步驟是在一小時以前被中斷，或工作階段在其他地方開啟，對話則會以閒置狀態恢復。400如果重新載入使 Claude 在步驟進行中被中斷，Claude 會在對話恢復時繼續該步驟，並在聊天中以通知標示此接續。需要 Claude Code v2.1.274 或更新版本。如果該步驟是在一小時以前被中斷，或工作階段在其他地方開啟，對話則會以閒置狀態恢復。

401 401 

402當聊天中的通知包含 `plan mode is now off, so Claude did not continue on its own` 時，表示該步驟是在 plan mode 中被中斷的。若要繼續規劃，請在傳送下一則訊息之前，於模式指示器中選取 **Plan**。

403 

402#### 關閉重新載入後的接續404#### 關閉重新載入後的接續

403 405 

404若要讓 Claude 在重新載入後不再繼續中斷的步驟，請開啟 [Continue After Reload 設定](vscode://settings/claudeCode.continueAfterReload)並取消勾選。406若要讓 Claude 在重新載入後不再繼續中斷的步驟，請開啟 [Continue After Reload 設定](vscode://settings/claudeCode.continueAfterReload)並取消勾選。

626 628 

627## VS Code 命令與快捷鍵629## VS Code 命令與快捷鍵

628 630 

629若要開啟命令選擇區，請在 Mac 上按 `Cmd+Shift+P`，或在 Windows/Linux 上按 `Ctrl+Shift+P`。在其中輸入「Claude Code」，即可查看 Claude Code 擴充功能所有可用的 VS Code 命令。631若要開啟命令選擇區，請在 Mac 上按 `Cmd+Shift+P`，或在 Windows/Linux 上按 `Ctrl+Shift+P`。在其中輸入「Claude Code」，即可查看此擴充功能在命令選擇區中的命令。

630 632 

631部分快捷鍵取決於目前「聚焦」的面板（接收鍵盤輸入的面板）。當游標位於程式碼檔案中時，編輯器處於聚焦狀態。當游標位於 Claude 的提示詞輸入框中時，Claude 處於聚焦狀態。使用 `Cmd+Esc` / `Ctrl+Esc` 在兩者之間切換。633部分快捷鍵取決於目前「聚焦」的面板（接收鍵盤輸入的面板）。當游標位於程式碼檔案中時，編輯器處於聚焦狀態。當游標位於 Claude 的提示詞輸入框中時，Claude 處於聚焦狀態。使用 `Cmd+Esc` / `Ctrl+Esc` 在兩者之間切換。

632 634 

651| Rename Session Tab | - | 重新命名目前 Claude 分頁中的工作階段。需要 Claude Code v2.1.257 或更新版本 |653| Rename Session Tab | - | 重新命名目前 Claude 分頁中的工作階段。需要 Claude Code v2.1.257 或更新版本 |

652| Add Session Tab to Group | - | 將目前 Claude 分頁中的工作階段加入您選取或建立的[工作階段群組](#organize-sessions-into-groups)。需要 Claude Code v2.1.257 或更新版本 |654| Add Session Tab to Group | - | 將目前 Claude 分頁中的工作階段加入您選取或建立的[工作階段群組](#organize-sessions-into-groups)。需要 Claude Code v2.1.257 或更新版本 |

653| Mark Session as Unread | - | 在工作階段清單中將目前 Claude 分頁中的工作階段標示為未讀。需要 Claude Code v2.1.257 或更新版本 |655| Mark Session as Unread | - | 在工作階段清單中將目前 Claude 分頁中的工作階段標示為未讀。需要 Claude Code v2.1.257 或更新版本 |

656| `claude-vscode.toggleDictation` | `Cmd+D` (Mac) / `Ctrl+D` (Windows/Linux) | 開始或停止[語音聽寫](https://code.claude.com/docs/zh-TW/voice-dictation.md)。此快捷鍵需要 Claude 處於聚焦狀態。此命令不在命令選擇區中 |

654| Show Logs | - | 檢視擴充功能偵錯日誌 |657| Show Logs | - | 檢視擴充功能偵錯日誌 |

655| Logout | - | 登出您的 Anthropic 帳戶 |658| Logout | - | 登出您的 Anthropic 帳戶 |

656 659 

80* **Pro、Max 和 Ultra**：您會自動取得名為**預設**的環境。80* **Pro、Max 和 Ultra**：您會自動取得名為**預設**的環境。

81* **Team 和 Enterprise**：上線流程會顯示**建立您的第一個雲端環境**表單。保持預填的名稱和網路存取權不變，然後按一下**建立並完成**以建立**預設**環境。如果擁有者已開啟[快速設定](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#quick-setup-for-team-and-enterprise)，上線流程會改為為您建立**預設**。81* **Team 和 Enterprise**：上線流程會顯示**建立您的第一個雲端環境**表單。保持預填的名稱和網路存取權不變，然後按一下**建立並完成**以建立**預設**環境。如果擁有者已開啟[快速設定](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#quick-setup-for-team-and-enterprise)，上線流程會改為為您建立**預設**。

82 82 

83**預設**使用[`Trusted` 網路存取權](https://code.claude.com/docs/zh-TW/cloud-environments#access-levels)：工作階段可以存取[常見套件登錄](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)和其他允許清單中的網域，以及透過工作階段網路的其他任何內容都無法存取。請參閱[已安裝的工具](https://code.claude.com/docs/zh-TW/cloud-environments.md#installed-tools)以了解無需任何設定即可使用的內容。83**預設**使用[**Limited** 網路存取權](https://code.claude.com/docs/zh-TW/cloud-environments.md#access-levels)：工作階段可以存取[常見套件登錄](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)和其他允許清單中的網域。請參閱[已安裝的工具](https://code.claude.com/docs/zh-TW/cloud-environments.md#installed-tools)以了解無需任何設定即可使用的內容。

84 84 

85對於第一個專案，**預設**環境可以按原樣使用。若要變更其網路存取權、新增環境變數或在工作階段啟動前執行[設定指令碼](https://code.claude.com/docs/zh-TW/cloud-environments.md#setup-scripts)，請[編輯它或建立其他環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#configure-your-environment)。85對於第一個專案，**預設**環境可以按原樣使用。若要變更其網路存取權、新增環境變數或在工作階段啟動前執行[設定指令碼](https://code.claude.com/docs/zh-TW/cloud-environments.md#setup-scripts)，請[編輯它或建立其他環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#configure-your-environment)。

86 86 

116/web-setup116/web-setup

117```117```

118 118 

119確認提示以將您的 `gh` 權杖傳送到您的 Claude 帳戶。成功時，Claude Code 會列印 `Connected as <your-github-username>` 並在您的瀏覽器中開啟 [claude.ai/code](https://claude.ai/code)。如果您還沒有雲端環境，`/web-setup` 會建立一個具有信任網路存取權且沒有設定指令碼的環境。您可以[稍後編輯環境或新增變數](https://code.claude.com/docs/zh-TW/cloud-environments.md#configure-your-environment)。`/web-setup` 完成後，您可以使用 [`--cloud`](https://code.claude.com/docs/zh-TW/claude-code-on-the-web#from-terminal-to-cloud) 從終端啟動雲端工作階段，或使用 [`/schedule`](https://code.claude.com/docs/zh-TW/routines) 設定定期工作。119確認提示以將您的 `gh` 權杖傳送到您的 Claude 帳戶。成功時，Claude Code 會列印 `Connected as <your-github-username>` 並在您的瀏覽器中開啟 [claude.ai/code](https://claude.ai/code)。

120 

121如果您還沒有雲端環境，`/web-setup` 會建立一個具有預設 **Limited** 網路存取權且沒有設定指令碼的環境。您可以[稍後編輯環境或新增變數](https://code.claude.com/docs/zh-TW/cloud-environments.md#configure-your-environment)。`/web-setup` 完成後，您可以使用 [`--cloud`](https://code.claude.com/docs/zh-TW/claude-code-on-the-web#from-terminal-to-cloud) 從終端機啟動雲端工作階段，或使用 [`/schedule`](https://code.claude.com/docs/zh-TW/routines) 設定定期工作。

120 122 

121#### 移除 `/web-setup` 權杖123#### 移除 `/web-setup` 權杖

122 124 

246 248 

247常見原因：249常見原因：

248 250 

249* 套件安裝失敗，因為登錄不在您的[網路存取級別](https://code.claude.com/docs/zh-TW/cloud-environments.md#access-levels)中。`Trusted` 涵蓋大多數套件管理器；`None` 阻止它們全部。251* 套件安裝失敗，因為登錄不在您的[網路存取級別](https://code.claude.com/docs/zh-TW/cloud-environments.md#access-levels)中。勾選 **Allow package managers** 的 **Limited** 涵蓋大多數套件管理器；**None** 會阻止它們全部。

250* 指令碼引用在新鮮複製中不存在的檔案或路徑。252* 指令碼引用在新鮮複製中不存在的檔案或路徑。

251* 在本地工作的命令在 Ubuntu 上需要不同的調用。253* 在本地工作的命令在 Ubuntu 上需要不同的調用。

252 254