Documentation 2026-09-29 23:58 UTC to 2026-09-30 05:01 UTC

100你可以分享給誰取決於你的方案：100你可以分享給誰取決於你的方案：

101 101 

102* **在組織內**：在 Team 和 Enterprise 方案上，授予組織中特定人員或所有人的存取權。檢視者以組織成員身分登入 claude.ai 以查看該頁面。102* **在組織內**：在 Team 和 Enterprise 方案上，授予組織中特定人員或所有人的存取權。檢視者以組織成員身分登入 claude.ai 以查看該頁面。

103* **公開**：分享一個連結，網際網路上的任何人都可以開啟，無需 claude.ai 登入。在 Pro 和 Max 方案上，公開連結是分享成品的唯一方式。在 Team 和 Enterprise 方案上，公開分享處於關閉狀態，直到擁有者[為組織啟用它](#control-public-sharing)。103* **公開**：分享一個連結，網際網路上的任何人都可以開啟，無需 claude.ai 登入。在 Team 和 Enterprise 方案上，公開分享處於關閉狀態，直到擁有者[為組織啟用它](#control-public-sharing)。

104 104 

105<h3 id="let-someone-edit-with-you">105<h3 id="let-someone-edit-with-you">

106 讓某人與你一起編輯106 讓某人與你一起編輯

122 收集成品上的評論122 收集成品上的評論

123</h2>123</h2>

124 124 

125當您在組織內分享成品時，與您分享的人可以在頁面上留下評論，您可以讓 Claude 讀取這些評論並回覆。您需要 Claude Code v2.1.221 或更新版本以及 Team 或 Enterprise 方案，因為只有您[在組織內分享](#share-an-artifact)的成品才會接收評論。Claude 在兩種情況下會讀取評論：125當您在組織內分享成品時，與您分享的人可以在頁面上留下評論，您可以讓 Claude 讀取這些評論並回覆。您需要 Claude Code v2.1.221 或更新版本。Claude 在兩種情況下會讀取評論：

126 126 

127* **您要求 Claude 讀取評論**：提供 Claude 成品的 URL 並要求查看評論。Claude 會列出每個執行緒，並標記可以編輯成品的人發送給它的評論。127* **您要求 Claude 讀取評論**：提供 Claude 成品的 URL 並要求查看評論。Claude 會列出每個執行緒，並標記可以編輯成品的人發送給它的評論。

128* **可以編輯成品的人向 Claude 發送評論**：在頁面上的執行緒中，他們使用**傳送給 Claude** 發送評論，或在其中提及 `@claude`。無論哪種方式，他們都會啟動該執行緒。128* **可以編輯成品的人向 Claude 發送評論**：在頁面上的執行緒中，他們使用**傳送給 Claude** 發送評論，或在其中提及 `@claude`。無論哪種方式，他們都會啟動該執行緒。

129 129 

130Claude 只能回覆或解決已啟動的執行緒。其他執行緒保持開啟狀態，直到某人在頁面上解決它們。檢視者會看到每個回覆都歸屬於 Claude，透過您。130Claude 只能回覆或解決已啟動的執行緒。其他執行緒保持開啟狀態，直到某人在頁面上解決它們。檢視者會看到每個回覆都歸屬於 Claude，透過您。

131 131 

132如果您公開分享成品，檢視者無法對其進行評論：頁面會顯示 `Comments aren't available while this Artifact is shared publicly.` 若要將已有評論執行緒的成品切換為公開連結，請先刪除這些執行緒。132如果您公開分享成品，只有公開連結存取的人看不到其評論，也無法新增任何評論。現有評論執行緒會保留在成品上，您和其編輯者仍然可以讀取並回覆它們。

133 133 

134若要自行要求評論，請提供 Claude URL：134若要自行要求評論，請提供 Claude URL：

135 135 

195 195 

196當您計畫共享連接器支援的頁面時，請要求 Claude 在每個即時區段中包含一個後備訊息，該訊息命名它需要的連接器。缺少連接的檢視者會看到要連接的內容，而不是空白區段。196當您計畫共享連接器支援的頁面時，請要求 Claude 在每個即時區段中包含一個後備訊息，該訊息命名它需要的連接器。缺少連接的檢視者會看到要連接的內容，而不是空白區段。

197 197 

198呼叫連接器的成品無法在任何方案上共享到公開連結。在 Team 和 Enterprise 方案上，您可以將其保持為私密或 [在您的組織內共享](#share-an-artifact)。在 Pro 和 Max 方案上（其中公開連結是唯一的共享方式），連接器支援的成品會保持為您的私密。198您可以 [在您的組織內或公開共享連接器支援的頁面](#share-an-artifact)，如您的方案和組織設定所允許。連接器呼叫不會針對未登入 claude.ai 或來自您組織外部的公開連結的檢視者執行。該檢視者會看到沒有其即時區段的頁面。

199 199 

200<h3 id="the-page-shows-no-live-data-for-a-viewer">200<h3 id="the-page-shows-no-live-data-for-a-viewer">

201 頁面對檢視者不顯示即時資料201 頁面對檢視者不顯示即時資料

202</h3>202</h3>

203 203 

204當連接器支援的頁面呈現但其即時區段對您共享的某人保持空白時，請檢查這些原因：204當連接器支援的頁面呈現但其即時區段對您組織中的檢視者保持空白時，請檢查這些原因：

205 205 

206* **檢視者尚未連接連接器**：連接器是按帳戶的，因此每個檢視者都需要自己的連接到該頁面呼叫的每個連接器。他們可以在 claude.ai 上的 **Settings > Connectors** 下新增一個，然後重新載入頁面。206* **檢視者尚未連接連接器**：連接器是按帳戶的，因此每個檢視者都需要自己的連接到該頁面呼叫的每個連接器。他們可以在 claude.ai 上的 **Settings > Connectors** 下新增一個，然後重新載入頁面。

207* **檢視者拒絕了許可要求**：拒絕會持續到該頁面載入的其餘部分。重新載入頁面會帶回許可要求。207* **檢視者拒絕了許可要求**：拒絕會持續到該頁面載入的其餘部分。重新載入頁面會帶回許可要求。

375 375 

376| 要求 | 可用時間 |376| 要求 | 可用時間 |

377| :- | :- |377| :- | :- |

378| 方案 | Pro、Max、Team 或 Enterprise。在 Pro 和 Max 方案上，成品僅供您私人使用，不適用管理員管理。在 Team 方案上，成品預設開啟。在 Enterprise 方案上，Owner 在 claude.ai 管理設定中[啟用它們](#manage-artifacts-for-your-organization)。 |378| 方案 | Pro、Max、Team 或 Enterprise。在 Pro 和 Max 方案上，成品僅供您私人使用，不適用管理員管理。在 Team 和 Enterprise 方案上，成品預設開啟，Owner 可以在 claude.ai 管理設定中[關閉它們](#manage-artifacts-for-your-organization)。 |

379| 驗證 | 工作階段由 claude.ai 帳戶支援：在 CLI 或桌面應用程式中使用 `/login` 登入。Claude Tag 工作階段透過代理程式的身分登入，因此不需要任何步驟。使用 API 金鑰、[閘道令牌](/docs/zh-TW/llm-gateway)或雲端提供者認證的工作階段無法發佈。 |379| 驗證 | 工作階段由 claude.ai 帳戶支援：在 CLI 或桌面應用程式中使用 `/login` 登入。Claude Tag 工作階段透過代理程式的身分登入，因此不需要任何步驟。使用 API 金鑰、[閘道令牌](/docs/zh-TW/llm-gateway)或雲端提供者認證的工作階段無法發佈。 |

380| 模型提供者 | Anthropic API。在 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 或 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 上不可用。 |380| 模型提供者 | Anthropic API。在 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 或 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 上不可用。 |

381| 組織政策 | 客戶管理的加密金鑰 (CMEK)、HIPAA 和[零資料保留](/docs/zh-TW/zero-data-retention)未為組織啟用。 |381| 組織政策 | 客戶管理的加密金鑰 (CMEK)、HIPAA 和[零資料保留](/docs/zh-TW/zero-data-retention)未為組織啟用。 |

408 為您的組織管理成品408 為您的組織管理成品

409</h2>409</h2>

410 410 

411Team 和 Enterprise 方案上的擁有者從 [claude.ai 管理設定](https://claude.ai/admin-settings/claude-code)控制成品。成品內容儲存在 Anthropic 營運的基礎設施上，僅對發佈組織的已驗證成員可見，除非成品是[公開分享](#control-public-sharing)。411Team 和 Enterprise 方案上的擁有者從 [claude.ai 管理設定](https://claude.ai/admin-settings/artifacts)控制成品。成品內容儲存在 Anthropic 營運的基礎設施上，僅對發佈組織的已驗證成員可見，以及他們與之分享的人員，除非成品是[公開分享](#control-public-sharing)。

412 412 

413<h3 id="enable-or-disable-artifacts">413<h3 id="enable-or-disable-artifacts">

414 啟用或停用成品414 啟用或停用成品

415</h3>415</h3>

416 416 

417要為整個組織啟用或停用成品，請前往 [**設定 > Claude Code > 功能**](https://claude.ai/admin-settings/claude-code)並使用**成品**切換。在具有角色型存取控制的 Enterprise 方案上，您還可以將成品範圍限制為特定角色：前往 [**設定 > 角色**](https://claude.ai/admin-settings/roles)、編輯角色，並在 **Claude Code** 群組下設定**成品**許可。417要為整個組織啟用或停用成品，請前往 [**組織設定 > 成品**](https://claude.ai/admin-settings/artifacts)並使用**成品**切換。在具有角色型存取控制的 Enterprise 方案上，您還可以將成品範圍限制為特定角色：前往 [**組織設定 > 角色**](https://claude.ai/admin-settings/roles)、編輯角色，並設定**成品**許可。

418 418 

419<h3 id="control-connector-calls-from-artifacts">419<h3 id="control-connector-calls-from-artifacts">

420 控制來自成品的連接器呼叫420 控制來自成品的連接器呼叫

421</h3>421</h3>

422 422 

423[來自成品的連接器呼叫](#pull-live-data-with-mcp-connectors)有自己的切換，與開啟或關閉成品的**成品**切換分開。前往 [**設定 > 功能**](https://claude.ai/admin-settings/capabilities)並使用**啟用成品連接器**切換。同一個切換控制在 claude.ai 對話中建立的成品的連接器呼叫，這就是為什麼它位於**設定 > 功能**而不是**設定 > Claude Code**。423[來自成品的連接器呼叫](#pull-live-data-with-mcp-connectors)有自己的切換，與開啟或關閉成品的**成品**切換分開。前往 [**組織設定 > 功能**](https://claude.ai/admin-settings/capabilities)並使用**啟用成品連接器**切換。同一個切換控制在 claude.ai 對話中建立的成品的連接器呼叫。

424 424 

425<h3 id="control-public-sharing">425<h3 id="control-public-sharing">

426 控制公開分享426 控制公開分享

427</h3>427</h3>

428 428 

429在 Team 和 Enterprise 方案上，公開分享預設為關閉，因此成員只能在組織內分享成品，直到擁有者開啟它。要讓成員將成品發佈到任何人都可以檢視而無需登入的公開連結，請前往**設定 > Claude Code > 功能**並在**成品**切換下開啟**外部分享**。將其關閉會阻止透過現有公開連結的存取，而不會變更每個成品的對象；如果您重新啟用它，存取將恢復。429在 Team 和 Enterprise 方案上，公開分享預設為關閉。要讓成員將成品發佈到任何人都可以檢視而無需登入的公開連結，請前往 [**組織設定 > 成品**](https://claude.ai/admin-settings/artifacts)並在**成品**切換下開啟**外部分享**。將其關閉會阻止透過現有公開連結的存取，而不會變更每個成品的對象；如果您重新啟用它，存取將恢復。

430 430 

431<h3 id="set-a-retention-policy">431<h3 id="set-a-retention-policy">

432 設定保留政策432 設定保留政策

433</h3>433</h3>

434 434 

435要設定在自動刪除之前保留成品的時間，請前往 [**設定 > 資料和隱私控制**](https://claude.ai/admin-settings/data-privacy-controls)。您可以為仍然是其作者私人的成品和已共享的成品設定單獨的保留期。435要設定在自動刪除之前保留成品的時間，請前往 [**組織設定 > 資料和隱私**](https://claude.ai/admin-settings/data-privacy-controls)。您可以為仍然是其作者私人的成品和已共享的成品設定單獨的保留期。

436 436 

437<h3 id="review-the-audit-log">437<h3 id="review-the-audit-log">

438 檢查稽核日誌438 檢查稽核日誌

163 承載作為 `<channel>` 標籤到達 Claude 的內容：163 承載作為 `<channel>` 標籤到達 Claude 的內容：

164 164 

165 ```text theme={null}165 ```text theme={null}

166 <channel source="webhook" path="/" method="POST">build failed on main: https://ci.example.com/run/1234</channel>166 <channel source="webhook" path="/" method="POST">

167 build failed on main: https://ci.example.com/run/1234

168 </channel>

167 ```169 ```

168 170 

169 您的終端機將事件呈現為單行摘要 `← webhook: build failed on main: https://ci.example.com/run/1234`，而不是原始標籤。然後您會看到 Claude 開始回應：讀取檔案、執行命令或訊息要求的任何內容。這是一個單向 channel，因此 Claude 在您的工作階段中採取行動，但不會透過 webhook 傳送任何內容回去。若要新增回覆，請參閱[公開回覆工具](#expose-a-reply-tool)。171 您的終端機將事件呈現為單行摘要 `← webhook: build failed on main: https://ci.example.com/run/1234`，而不是原始標籤。然後您會看到 Claude 開始回應：讀取檔案、執行命令或訊息要求的任何內容。這是一個單向 channel，因此 Claude 在您的工作階段中採取行動，但不會透過 webhook 傳送任何內容回去。若要新增回覆，請參閱[公開回覆工具](#expose-a-reply-tool)。

358 358 

359僅執行 Claude Desktop 的機器需要它。Claude Desktop 將模型清單和禁用工具清單應用於嵌入式會話本身，但出口允許清單僅作為父設定到達它們，形式為 `WebFetch` 網域規則和沙箱網路規則。沒有選擇加入，這些會話執行時沒有出口限制，沒有任何警告。閘道仍然拒絕原則不授予的模型的推論請求。359僅執行 Claude Desktop 的機器需要它。Claude Desktop 將模型清單和禁用工具清單應用於嵌入式會話本身，但出口允許清單僅作為父設定到達它們，形式為 `WebFetch` 網域規則和沙箱網路規則。沒有選擇加入，這些會話執行時沒有出口限制，沒有任何警告。閘道仍然拒絕原則不授予的模型的推論請求。

360 360 

361外掛程式市集允許清單也僅作為父設定到達嵌入式會話。當您在 Claude Desktop 的受管配置中關閉使用者新增的外掛程式市集時，Claude Desktop 2.16120.0 或更新版本會隱藏您的組織未佈建的市集，並拒絕從它們安裝。若要停止嵌入式會話載入已從這些市集安裝的外掛程式，它會將 `strictKnownMarketplaces` 清單作為父設定傳送給它們。沒有選擇加入，Claude Code 會忽略該清單，這些外掛程式會繼續載入。

362 

361開發人員透過 `/login` 登入的機器不需要它；每個 Claude Code 會話從閘道擷取其原則。363開發人員透過 `/login` 登入的機器不需要它；每個 Claude Code 會話從閘道擷取其原則。

362 364 

363其[`policyHelper`](/docs/zh-TW/settings-reference#policyhelper)提供受管設定的機隊無法使用它：Claude Code 在這些機隊上永遠不會合併父設定，因為它僅從助手的輸出讀取受管設定。365其[`policyHelper`](/docs/zh-TW/settings-reference#policyhelper)提供受管設定的機隊無法使用它：Claude Code 在這些機隊上永遠不會合併父設定，因為它僅從助手的輸出讀取受管設定。

453* **`forceLoginOrgUUID`**：當最高優先級管理員來源未設定組織 UUID 時，Claude Code 會接受父提供的值。閘道登入不檢查此金鑰。最高優先級管理員來源中的組織 UUID 會阻止父項的值，是 Claude Code 強制執行的值。455* **`forceLoginOrgUUID`**：當最高優先級管理員來源未設定組織 UUID 時，Claude Code 會接受父提供的值。閘道登入不檢查此金鑰。最高優先級管理員來源中的組織 UUID 會阻止父項的值，是 Claude Code 強制執行的值。

454* **`allowedMcpServers`**：當沒有管理員清單生效時，Claude Code 會接受父提供的允許清單。`allowManagedMcpServersOnly` 不會阻止它，因為鎖定強制執行無論哪個清單獲勝作為受管值，包括當沒有管理員來源提供清單時的父提供清單。最高優先級管理員來源中的清單會阻止父項的並是 Claude Code 強制執行的清單，因此在那裡設定 `allowedMcpServers`，在鎖定旁邊。在 v2.1.223 之前，任何管理員來源中任一金鑰的值都會阻止父項的。456* **`allowedMcpServers`**：當沒有管理員清單生效時，Claude Code 會接受父提供的允許清單。`allowManagedMcpServersOnly` 不會阻止它，因為鎖定強制執行無論哪個清單獲勝作為受管值，包括當沒有管理員來源提供清單時的父提供清單。最高優先級管理員來源中的清單會阻止父項的並是 Claude Code 強制執行的清單，因此在那裡設定 `allowedMcpServers`，在鎖定旁邊。在 v2.1.223 之前，任何管理員來源中任一金鑰的值都會阻止父項的。

455* **`availableModels`**：當獲勝的受管來源未設定模型清單時，Claude Code 會接受父提供的模型清單。如果您的機隊限制模型，在獲勝的來源中設定 `availableModels`。457* **`availableModels`**：當獲勝的受管來源未設定模型清單時，Claude Code 會接受父提供的模型清單。如果您的機隊限制模型，在獲勝的來源中設定 `availableModels`。

456* **`strictKnownMarketplaces`**：當獲勝的受管來源未設定外掛程式市集允許清單時，Claude Code 會接受父提供的外掛程式市集允許清單。如果您的機隊限制市集，在獲勝的來源中設定 `strictKnownMarketplaces`。需要 Claude Code v2.1.282 或更新版本。458* **`strictKnownMarketplaces`**：當獲勝的受管來源未設定外掛程式市集允許清單時，Claude Code 會接受父提供的外掛程式市集允許清單。Claude Desktop 2.16120.0 或更新版本在其受管配置關閉使用者新增的外掛程式市集時傳送一個。如果您的機隊限制市集，在獲勝的來源中設定 `strictKnownMarketplaces`。需要 Claude Code v2.1.282 或更新版本。

457* **`blockedMarketplaces`**：父提供的市集封鎖清單通過並新增至任何受管來源設定的封鎖清單，因為封鎖清單只能進一步限制。需要 Claude Code v2.1.282 或更新版本。459* **`blockedMarketplaces`**：父提供的市集封鎖清單通過並新增至任何受管來源設定的封鎖清單，因為封鎖清單只能進一步限制。需要 Claude Code v2.1.282 或更新版本。

458* **`strictPluginOnlyCustomization`**：此金鑰無論任何鎖定都通過篩選器，它使 Claude Code 忽略開發人員自己的自訂，包括保護性 hooks。沒有鎖定阻止它。460* **`strictPluginOnlyCustomization`**：此金鑰無論任何鎖定都通過篩選器，它使 Claude Code 忽略開發人員自己的自訂，包括保護性 hooks。沒有鎖定阻止它。

459 461 

566 * platform.claude.com566 * platform.claude.com

567 * code.claude.com567 * code.claude.com

568 * claude.ai568 * claude.ai

569 * claude.com

570 * support.claude.com

571 * anthropic.com

572 * [www.anthropic.com](http://www.anthropic.com)

569 </Accordion>573 </Accordion>

570 574 

571 <Accordion title="版本控制">575 <Accordion title="版本控制">

596 * hub.docker.com600 * hub.docker.com

597 * [www.docker.com](http://www.docker.com)601 * [www.docker.com](http://www.docker.com)

598 * production.cloudflare.docker.com602 * production.cloudflare.docker.com

603 * production.cloudfront.docker.com

599 * download.docker.com604 * download.docker.com

600 * gcr.io605 * gcr.io

601 * \*.gcr.io606 * \*.gcr.io

91| `/fast [on\|off]` | 切換[快速模式](/docs/zh-TW/fast-mode)開啟或關閉。在 Claude 回應時運行它，Claude Code 會切換快速模式而不等待輪次結束，儘管運行中的輪次以其原始速度完成。在 v2.1.242 之前，Claude Code 從它從 Anthropic 擷取的功能標誌決定是在中途運行命令還是將其排隊直到輪次完成，並始終在不[擷取功能標誌](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching)的工作階段中排隊。非互動模式中的可用性受限於 `-p`；請參閱[切換快速模式](/docs/zh-TW/fast-mode#toggle-fast-mode)。需要 Claude Code v2.1.205 或更新版本 |91| `/fast [on\|off]` | 切換[快速模式](/docs/zh-TW/fast-mode)開啟或關閉。在 Claude 回應時運行它，Claude Code 會切換快速模式而不等待輪次結束，儘管運行中的輪次以其原始速度完成。在 v2.1.242 之前，Claude Code 從它從 Anthropic 擷取的功能標誌決定是在中途運行命令還是將其排隊直到輪次完成，並始終在不[擷取功能標誌](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching)的工作階段中排隊。非互動模式中的可用性受限於 `-p`；請參閱[切換快速模式](/docs/zh-TW/fast-mode#toggle-fast-mode)。需要 Claude Code v2.1.205 或更新版本 |

92| `/feedback [report]` | 發送有關 Claude Code 的產品回饋。打開與 [`/bug`](#all-commands) 相同的對話框，具有相同的同意步驟、發送規則和中途行為。在具有 [Claude 草擬回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)的工作階段中，不帶引數的 `/feedback` 改為打開草稿佇列，您可以在其中檢查、編輯、發送或丟棄 Claude 排隊的草稿；佇列包括在對話框中編寫新報告的選項。使用引數，以及對於 `/bug` 始終，對話框直接打開 |92| `/feedback [report]` | 發送有關 Claude Code 的產品回饋。打開與 [`/bug`](#all-commands) 相同的對話框，具有相同的同意步驟、發送規則和中途行為。在具有 [Claude 草擬回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)的工作階段中，不帶引數的 `/feedback` 改為打開草稿佇列，您可以在其中檢查、編輯、發送或丟棄 Claude 排隊的草稿；佇列包括在對話框中編寫新報告的選項。使用引數，以及對於 `/bug` 始終，對話框直接打開 |

93| `/fewer-permission-prompts` | **[Skill](/docs/zh-TW/skills#bundled-skills)。** 掃描您的文字記錄以查找常見的唯讀 Bash 和 MCP 工具呼叫，然後將優先允許清單添加到專案 `.claude/settings.json` 以減少權限提示 |93| `/fewer-permission-prompts` | **[Skill](/docs/zh-TW/skills#bundled-skills)。** 掃描您的文字記錄以查找常見的唯讀 Bash 和 MCP 工具呼叫，然後將優先允許清單添加到專案 `.claude/settings.json` 以減少權限提示 |

94| `/focus` | 切換焦點檢視，僅顯示您的最後提示詞、帶有編輯差異統計的單行工具呼叫摘要和最終回應。工具呼叫摘要也計算在輪中啟動的子代理數量並將完成的背景任務通知摺疊為單一計數。選擇在工作階段間持續存在；在設定中設定 [`viewMode`](/docs/zh-TW/settings-reference#viewmode) 以覆蓋它。僅在[全螢幕渲染](/docs/zh-TW/fullscreen)中可用。[VS Code 擴充功能](/docs/zh-TW/vs-code#use-the-prompt-box)提供其自己的焦點檢視作為命令菜單切換，存儲為擴充功能設定，獨立於 `viewMode` |94| `/focus` | 切換焦點檢視，僅顯示您的最後提示詞、帶有編輯差異統計的單行工具呼叫摘要和最終回應。工具呼叫摘要也計算在輪中啟動的子代理數量並將完成的背景任務通知摺疊為單一計數。選擇在工作階段間持續存在；在設定中設定 [`viewMode`](/docs/zh-TW/settings-reference#viewmode) 以覆蓋它。僅在[全螢幕渲染](/docs/zh-TW/fullscreen)中可用。從[遠端控制](/docs/zh-TW/remote-control)用戶端，運行 `/focus [on\|off]` 以僅為目前工作階段打開或關閉焦點檢視，而不變更您保存的選擇；這需要 Claude Code v2.1.281 或更新版本。[VS Code 擴充功能](/docs/zh-TW/vs-code#use-the-prompt-box)提供其自己的焦點檢視作為命令菜單切換，存儲為擴充功能設定，獨立於 `viewMode` |

95| `/fork [prompt]` | [將目前對話複製](/docs/zh-TW/agent-view#copy-the-session-with-%2Ffork)到新的背景工作階段並繼續在此工作。傳遞提示詞，副本立即開始處理它；沒有它會在代理檢視中等待其第一個提示詞。除非副本[就地編輯](/docs/zh-TW/agent-view#how-file-edits-are-isolated)，Claude Code 會指示它在進行程式碼變更前建立自己的 worktree；隔離指示需要 Claude Code v2.1.221 或更新版本。要將側面任務交給子代理，其結果返回到此對話，請使用 `/subtask`；要自己切換到副本，請使用 `/branch`。需要 Claude Code v2.1.212 或更新版本；在 v2.1.161 到 v2.1.211 上，以及每當[代理檢視關閉](/docs/zh-TW/agent-view#turn-off-agent-view)時，`/fork` 改為啟動[分叉子代理](/docs/zh-TW/sub-agents#fork-the-current-conversation) |95| `/fork [prompt]` | [將目前對話複製](/docs/zh-TW/agent-view#copy-the-session-with-%2Ffork)到新的背景工作階段並繼續在此工作。傳遞提示詞，副本立即開始處理它；沒有它會在代理檢視中等待其第一個提示詞。除非副本[就地編輯](/docs/zh-TW/agent-view#how-file-edits-are-isolated)，Claude Code 會指示它在進行程式碼變更前建立自己的 worktree；隔離指示需要 Claude Code v2.1.221 或更新版本。要將側面任務交給子代理，其結果返回到此對話，請使用 `/subtask`；要自己切換到副本，請使用 `/branch`。需要 Claude Code v2.1.212 或更新版本；在 v2.1.161 到 v2.1.211 上，以及每當[代理檢視關閉](/docs/zh-TW/agent-view#turn-off-agent-view)時，`/fork` 改為啟動[分叉子代理](/docs/zh-TW/sub-agents#fork-the-current-conversation) |

96| `/goal [condition\|clear]` | 設定[目標](/docs/zh-TW/goal)：Claude 跨輪繼續工作直到條件滿足或目標[因另一個原因清除](/docs/zh-TW/goal#how-evaluation-works)。沒有引數時，顯示目前或最近達成的目標。`clear`、`stop`、`off`、`reset`、`none` 或 `cancel` 會提前移除活動目標 |96| `/goal [condition\|clear]` | 設定[目標](/docs/zh-TW/goal)：Claude 跨輪繼續工作直到條件滿足或目標[因另一個原因清除](/docs/zh-TW/goal#how-evaluation-works)。沒有引數時，顯示目前或最近達成的目標。`clear`、`stop`、`off`、`reset`、`none` 或 `cancel` 會提前移除活動目標 |

97| `/heapdump` | 寫入 JavaScript 堆快照和記憶體細目到 `~/Desktop`，或在沒有 Desktop 資料夾的 Linux 上寫入您的主目錄，以診斷高記憶體使用情況。報告記憶體問題時僅附加 `-diagnostics.json` 檔案；`.heapsnapshot` 包含您的完整對話和認證，因此不要共享它。[從命令菜單隱藏](#how-the-command-menu-matches-what-you-type)；完整輸入它。請參閱[如何處理輸出](/docs/zh-TW/troubleshooting#high-cpu-or-memory-usage) |97| `/heapdump` | 寫入 JavaScript 堆快照和記憶體細目到 `~/Desktop`，或在沒有 Desktop 資料夾的 Linux 上寫入您的主目錄，以診斷高記憶體使用情況。報告記憶體問題時僅附加 `-diagnostics.json` 檔案；`.heapsnapshot` 包含您的完整對話和認證，因此不要共享它。[從命令菜單隱藏](#how-the-command-menu-matches-what-you-type)；完整輸入它。請參閱[如何處理輸出](/docs/zh-TW/troubleshooting#high-cpu-or-memory-usage) |

96 96 

97執行 [`/insights`](/docs/zh-TW/commands#all-commands) 以取得關於您如何工作而不是您使用了多少 token 的報告。它分析您在此機器上的最近工作階段，並撰寫涵蓋您所從事工作、摩擦點（例如誤解的請求或有缺陷的程式碼）以及有關如何更有效地使用 Claude Code 的建議的 HTML 報告。單次執行分析最多 200 個它尚未看過的工作階段，並跳過非常短的工作階段。當工作階段被排除時，報告標題會顯示分析的計數，括號中為總計，例如 `200 sessions (412 total)`。97執行 [`/insights`](/docs/zh-TW/commands#all-commands) 以取得關於您如何工作而不是您使用了多少 token 的報告。它分析您在此機器上的最近工作階段，並撰寫涵蓋您所從事工作、摩擦點（例如誤解的請求或有缺陷的程式碼）以及有關如何更有效地使用 Claude Code 的建議的 HTML 報告。單次執行分析最多 200 個它尚未看過的工作階段，並跳過非常短的工作階段。當工作階段被排除時，報告標題會顯示分析的計數，括號中為總計，例如 `200 sessions (412 total)`。

98 98 

99當[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)可用於工作階段，且您最近的工作階段大多在沒有它的情況下執行時，報告還可以包括自動模式在這些工作階段中可能處理的權限提示數量的估計。

100 

99Claude Code 將最新報告寫入 `~/.claude/usage-data/report.html`，並在同一目錄中保存每次執行的時間戳記副本，因此不會覆蓋較早的報告。Claude Code 按照與其餘工作階段資料相同的時間表刪除報告：在啟動時，它會移除早於 [`cleanupPeriodDays`](/docs/zh-TW/claude-directory#cleaned-up-automatically) 的檔案，預設為 30 天。101Claude Code 將最新報告寫入 `~/.claude/usage-data/report.html`，並在同一目錄中保存每次執行的時間戳記副本，因此不會覆蓋較早的報告。Claude Code 按照與其餘工作階段資料相同的時間表刪除報告：在啟動時，它會移除早於 [`cleanupPeriodDays`](/docs/zh-TW/claude-directory#cleaned-up-automatically) 的檔案，預設為 30 天。

100 102 

101您可以在任何計畫和任何提供者上執行 `/insights`。分析通過與您的常規工作階段相同的提供者和帳戶執行，token 計入您的計畫或 API 使用情況。不包括來自其他裝置和 claude.ai 的工作階段。103您可以在任何計畫和任何提供者上執行 `/insights`。分析通過與您的常規工作階段相同的提供者和帳戶執行，token 計入您的計畫或 API 使用情況。不包括來自其他裝置和 claude.ai 的工作階段。

46 建立連結46 建立連結

47</h2>47</h2>

48 48 

49每個深層連結都以 `claude-cli://open` 開始，這是處理程式接受的唯一路徑，後面跟著可選的查詢參數。最小形式在您的主目錄中開啟 Claude Code，提示為空：49深層連結以 `claude-cli://open` 開始，後面跟著可選的查詢參數。最小形式在您的主目錄中開啟 Claude Code，提示為空：

50 50 

51```text theme={null}51```text theme={null}

52claude-cli://open52claude-cli://open

834* **遠端控制**：為您的組織啟用或停用[遠端控制](/docs/zh-TW/remote-control)834* **遠端控制**：為您的組織啟用或停用[遠端控制](/docs/zh-TW/remote-control)

835* **停用略過權限模式**：防止您組織中的使用者啟用略過權限模式835* **停用略過權限模式**：防止您組織中的使用者啟用略過權限模式

836 836 

837<Note>

838 OpenTelemetry 表單用於管理員主控台**監控**下的 Cowork，位於[資料和隱私設定](https://claude.ai/admin-settings/data-privacy-controls)，僅適用於 Cowork 會話。在此機器上的 Cowork 會話中，桌面應用程式將該收集器作為 `OTEL_*` 環境變數傳遞給 Claude Code，因此表單會生效，儘管該會話中的 Claude Code [永遠不會擷取管理員主控台設定](#managed-settings)。

839 

840 若要從 Code 標籤會話匯出遙測，請在 Claude Code 受管設定的 `env` 區塊中設定 `CLAUDE_CODE_ENABLE_TELEMETRY` 和 `OTEL_*` 變數，如[監控的管理員配置](/docs/zh-TW/monitoring-usage#administrator-configuration)所示。本機、雲端和 SSH 會話各自從不同來源讀取[受管設定](#managed-settings)。有關雲端會話可以到達的主機，請參閱[網路存取](/docs/zh-TW/cloud-environments#network-access)。有關 Code 標籤會話報告的 `service.name`，請參閱[服務資訊](/docs/zh-TW/monitoring-usage#service-information)。

841</Note>

842 

837<h3 id="managed-settings">843<h3 id="managed-settings">

838 受管設定844 受管設定

839</h3>845</h3>

110 110 

111某些行為同時具有環境變數和專用設定鍵，Claude Code 讀取哪一個的順序因鍵而異。對於 `ANTHROPIC_MODEL` 和 `CLAUDE_CODE_AUTO_CONNECT_IDE`，Claude Code 會先讀取變數，只有在變數未設定時才使用 `model` 或 `autoConnectIde` 設定。對於您要設定的配對，請檢查下方變數的列，以及 [設定參考](/docs/zh-TW/settings-reference) 上的鍵項目。111某些行為同時具有環境變數和專用設定鍵，Claude Code 讀取哪一個的順序因鍵而異。對於 `ANTHROPIC_MODEL` 和 `CLAUDE_CODE_AUTO_CONNECT_IDE`，Claude Code 會先讀取變數，只有在變數未設定時才使用 `model` 或 `autoConnectIde` 設定。對於您要設定的配對，請檢查下方變數的列，以及 [設定參考](/docs/zh-TW/settings-reference) 上的鍵項目。

112 112 

113當相同的變數同時在您的 shell 和設定檔 `env` 區塊中設定時，設定檔值會套用。Claude Code 會將每個 `env` 項目寫入程序環境，取代從 shell 繼承的值。[`env` 設定](/docs/zh-TW/settings-reference#when-claude-code-applies-env-values) 說明何時套用它們。少數變數有特殊處理；[`env` 設定](/docs/zh-TW/settings-reference#env) 列出例外。113當相同的變數同時在您的 shell 和設定檔 `env` 區塊中設定時，設定檔值會在大多數工作階段中套用。Claude Code 會將每個 `env` 項目寫入程序環境，取代從 shell 繼承的值。[`env` 值如何與您的 shell 互動](/docs/zh-TW/settings-reference#how-env-values-interact-with-your-shell) 涵蓋保留繼承值的工作階段，以及 [`env` 設定](/docs/zh-TW/settings-reference#when-claude-code-applies-env-values) 說明何時套用它們。少數變數有特殊處理；[`env` 設定](/docs/zh-TW/settings-reference#env) 列出例外。

114 114 

115在設定檔中，您可以設定變數，但無法移除變數。若要覆寫無法取消設定的變數，例如由您無法控制的 shell 設定檔匯出的過時 `CLAUDE_CODE_USE_VERTEX`，請在 `env` 區塊中將其設定為空字串：`"CLAUDE_CODE_USE_VERTEX": ""`。Claude Code 將空值視為未設定以進行提供者選擇。子程序仍會繼承空值。115在設定檔中，您可以設定變數，但無法移除變數。若要覆寫無法取消設定的變數，例如由您無法控制的 shell 設定檔匯出的過時 `CLAUDE_CODE_USE_VERTEX`，請在 `env` 區塊中將其設定為空字串：`"CLAUDE_CODE_USE_VERTEX": ""`。Claude Code 將空值視為未設定以進行提供者選擇。子程序仍會繼承空值。

116 116 

152| `There's an issue with the selected model` | [請求錯誤](#theres-an-issue-with-the-selected-model) |152| `There's an issue with the selected model` | [請求錯誤](#theres-an-issue-with-the-selected-model) |

153| `Model ... is not a recognized model id` | [請求錯誤](#model-is-not-a-recognized-model-id) |153| `Model ... is not a recognized model id` | [請求錯誤](#model-is-not-a-recognized-model-id) |

154| `Model ... not found` | [請求錯誤](#model-not-found) |154| `Model ... not found` | [請求錯誤](#model-not-found) |

155| `Couldn't confirm model ... with the API` | [請求錯誤](#couldnt-confirm-model-with-the-api) |

155| `API error: ... · model not changed` | [請求錯誤](#api-error-model-not-changed) |156| `API error: ... · model not changed` | [請求錯誤](#api-error-model-not-changed) |

156| `Claude Opus is not available with the Claude Pro plan` | [請求錯誤](#claude-opus-is-not-available-with-the-claude-pro-plan) |157| `Claude Opus is not available with the Claude Pro plan` | [請求錯誤](#claude-opus-is-not-available-with-the-claude-pro-plan) |

157| `Claude Code ... does not support this model; version ... or newer is required` | [請求錯誤](#claude-code-does-not-support-this-model) |158| `Claude Code ... does not support this model; version ... or newer is required` | [請求錯誤](#claude-code-does-not-support-this-model) |

2346 模型不是公認的模型 ID2347 模型不是公認的模型 ID

2347</h3>2348</h3>

2348 2349 

2349您傳遞給模型切換的模型字串不是模型別名、此 Claude Code 版本知道的模型 ID，也不是以 `claude-` 開頭的 ID。常見原因是 ID 中的拼寫錯誤、顯示名稱（例如 `Sonnet 5`，其中需要 ID `claude-sonnet-5`），或只有較新 Claude Code 版本識別的別名。Claude Code 立即拒絕切換。在 v2.1.200 之前，Claude Code 保存字串並在下一個請求時因[選定的模型有問題](#theres-an-issue-with-the-selected-model)而失敗。2350您傳遞給模型切換的字串不是 Claude Code 可以用作模型的字串，因此它拒絕了切換而不發送請求，工作階段保留其目前模型。當模型通過 [Agent SDK](/docs/zh-TW/agent-sdk/typescript) `setModel()` 方法設定時，您可能會收到此錯誤，由為您執行 Claude Code CLI 的應用程式（例如[桌面應用程式](/docs/zh-TW/desktop)），或當您從通過[遠端控制](/docs/zh-TW/remote-control)連接的裝置選擇模型時。在 v2.1.200 之前，Claude Code 保存了字串並在下一個請求時因[選定的模型有問題](#theres-an-issue-with-the-selected-model)而失敗。

2350 2351 

2351```text theme={null}2352```text theme={null}

2352Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2353Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

2353```2354```

2354 2355 

2355尾部提示命名最接近的匹配別名或模型 ID。當沒有足夠接近的內容時，它讀取 `Run /model to see available models.` 代替。在[桌面應用程式](/docs/zh-TW/desktop)為您啟動的工作階段中，無匹配提示讀取 `Switch to a different model.`2356在此範例中，應用程式發送了顯示名稱 `Sonnet 5`，訊息重複時沒有其空格。尾部提示命名最接近的匹配別名或模型 ID。當沒有足夠接近的內容時，它讀取 `Run /model to see available models.` 代替。在[桌面應用程式](/docs/zh-TW/desktop)為您啟動的工作階段中，無匹配提示讀取 `Switch to a different model.`

2356 2357 

2357Claude Code 在請求切換的時刻在本地產生此錯誤，在發送任何 API 請求之前。它適用於通過 [Agent SDK](/docs/zh-TW/agent-sdk/typescript) `setModel()` 方法設定模型、由[桌面應用程式](/docs/zh-TW/desktop)之類的應用程式為您執行 Claude Code CLI 時，或當您從通過[遠端控制](/docs/zh-TW/remote-control)連接的裝置選擇模型時。在 v2.1.260 之前，檢查不涵蓋遠端控制選擇，因此 Claude Code 應用了選擇，下一個請求因[選定的模型有問題](#theres-an-issue-with-the-selected-model)而失敗。2358當您通過 Agent SDK 或在 Anthropic API 上的應用程式切換時，只有無法成為模型 ID 的字串（例如顯示名稱或空字串）會收到此錯誤。

2359 

2360當您從遠端控制裝置選擇模型時，Claude Code 在本地檢查字串。任何不是模型別名、Claude Code 列出或您配置的模型，或以 `claude-` 開頭的 ID 的字串都會收到此錯誤，包括拼寫錯誤的 ID（例如 `claud-sonnet-5`）。在 v2.1.260 之前，此檢查不涵蓋遠端控制選擇，因此無法識別的字串被應用，並在下一個請求時失敗。

2358 2361 

2359**該怎麼辦：**2362**該怎麼辦：**

2360 2363 

2361* 執行 `/model` 而不帶引數以開啟選擇器並從您帳戶可用的模型中選擇，然後傳遞那裡顯示的別名或 ID2364* 執行 `/model` 而不帶引數以開啟選擇器並從您帳戶可用的模型中選擇，然後傳遞那裡顯示的別名或 ID

2362* 如果您使用了較新 Claude Code 版本支援的別名，請執行 `claude update`。以 `claude-` 開頭的完整 ID 通過此本地檢查，即使模型比您的 Claude Code 版本更新。伺服器仍然可以要求該模型的最低版本；請參閱 [Claude Code 不支援此模型](#claude-code-does-not-support-this-model)。2365* 如果您使用了較新 Claude Code 版本支援的別名，請執行 `claude update`，或傳遞模型的完整 ID 代替。伺服器仍然可以要求該模型的最低 Claude Code 版本；請參閱 [Claude Code 不支援此模型](#claude-code-does-not-support-this-model)。

2363* v2.1.200 之前保存的模型不會被此檢查修復。如果過時的值不斷出現，請從[設定您的模型](/docs/zh-TW/model-config#setting-your-model)下列出的位置移除它。2366* v2.1.200 之前保存的模型不會被此檢查修復。如果過時的值不斷出現，請從[設定您的模型](/docs/zh-TW/model-config#setting-your-model)下列出的位置移除它。

2364* 檢查僅在 Anthropic API 上執行。在任何其他提供者或閘道上，包括自訂 `ANTHROPIC_BASE_URL`，提供者定義模型名稱，因此 Claude Code 接受任何字串並將其傳遞。Claude Code 仍然可以在請求時寫入[無法識別的模型診斷行](#unrecognized-model-id-on-a-request)，在每個提供者上。2367* 在 Anthropic API 以外的任何提供者上，或在閘道或自訂 `ANTHROPIC_BASE_URL` 後面，只有空字串會收到此錯誤。Claude Code 仍然可以在請求時寫入[無法識別的模型診斷行](#unrecognized-model-id-on-a-request)，在每個提供者上。

2365 2368 

2366<h3 id="model-not-found">2369<h3 id="model-not-found">

2367 找不到模型2370 找不到模型

2368</h3>2371</h3>

2369 2372 

2370您使用 `/model <name>` 選擇了模型，Claude Code 無法確認存在具有該名稱的模型。當名稱不是 [Claude Code 在本地接受的模型別名](/docs/zh-TW/model-config#model-aliases)或其他拼寫時，`/model` 使用最小 API 請求驗證它，此錯誤通常是您的 API 端點的答案。無法成為模型 ID 的名稱（例如包含空格的名稱）會收到相同訊息。2373您使用名稱切換到模型，Claude Code 無法確認存在具有該名稱的模型。當名稱不是[模型別名](/docs/zh-TW/model-config#model-aliases)或 Claude Code 在本地接受的其他拼寫時，Claude Code 使用最小 API 請求驗證它，此錯誤通常是您的 API 端點的答案。無法成為模型 ID 的名稱（例如包含空格的名稱）會收到相同訊息。

2371 2374 

2372```text theme={null}2375```text theme={null}

2373Model 'claude-opus-9' not found2376Model 'claude-opus-9' not found

2379 2382 

2380* 執行 `/model` 而不帶引數並從您帳戶可用的模型中選擇，或使用[模型別名](/docs/zh-TW/model-config#model-aliases)（例如 `sonnet`），該別名解析為維護的預設值2383* 執行 `/model` 而不帶引數並從您帳戶可用的模型中選擇，或使用[模型別名](/docs/zh-TW/model-config#model-aliases)（例如 `sonnet`），該別名解析為維護的預設值

2381* 如果您輸入了完整 ID，請根據您提供者的模型目錄檢查它。新推出的模型可能在 Anthropic API 上可用，然後您的提供者或地區才提供它。2384* 如果您輸入了完整 ID，請根據您提供者的模型目錄檢查它。新推出的模型可能在 Anthropic API 上可用，然後您的提供者或地區才提供它。

2385* 在 Agent SDK 中，`setModel()` 因此訊息而失敗，工作階段在其先前的模型上繼續執行。在 TypeScript SDK 中，呼叫 [`supportedModels()`](/docs/zh-TW/agent-sdk/typescript#query-object) 以列出您可以切換到的模型。

2382* 在 v2.1.265 之前，`/model` 也以此錯誤拒絕了 `opusplan[1m]` 別名拼寫。在這些版本上，更新 Claude Code，或在[設定](/docs/zh-TW/model-config#setting-your-model)中或使用 `--model` 代替設定模型。2386* 在 v2.1.265 之前，`/model` 也以此錯誤拒絕了 `opusplan[1m]` 別名拼寫。在這些版本上，更新 Claude Code，或在[設定](/docs/zh-TW/model-config#setting-your-model)中或使用 `--model` 代替設定模型。

2383 2387 

2388<h3 id="couldnt-confirm-model-with-the-api">

2389 無法使用 API 確認模型

2390</h3>

2391 

2392您通過 [Agent SDK](/docs/zh-TW/agent-sdk/typescript) `setModel()` 方法或為您執行 Claude Code CLI 的應用程式（例如[桌面應用程式](/docs/zh-TW/desktop)）切換了模型，確認模型 ID 與您的 API 端點的請求在五秒內沒有得到答案。工作階段保留其目前模型。

2393 

2394```text theme={null}

2395Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.

2396```

2397 

2398在[桌面應用程式](/docs/zh-TW/desktop)為您啟動的工作階段中，訊息在 `Try again.` 結尾。

2399 

2400**該怎麼辦：**

2401 

2402* 再次切換到模型

2403* 如果切換不斷失敗，請檢查 Claude Code 是否可以到達您的 API 端點；請參閱[網路和連接錯誤](#network-and-connection-errors)

2404 

2384<h3 id="api-error-model-not-changed">2405<h3 id="api-error-model-not-changed">

2385 檢查選定模型時出現 API 錯誤2406 檢查選定模型時出現 API 錯誤

2386</h3>2407</h3>

2432API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.2453API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.

2433```2454```

2434 2455 

2456發送請求的 Claude Code 二進位檔案報告的版本是 API 檢查的版本。

2457 

2435**該怎麼辦：**2458**該怎麼辦：**

2436 2459 

2437* 執行 `claude update` 或更新 Claude 桌面應用程式，然後啟動新工作階段2460更新該二進位檔案，然後啟動新工作階段。二進位檔案的來源決定了如何，除了在[自託管環境](/docs/zh-TW/self-hosted-environments-deploy#pin-the-version)中：

2438* 對於按模型措辭，您可以通過使用 `/model` 切換到另一個模型來在目前工作階段中繼續工作2461 

2462| 發送請求的二進位檔案 | 如何更新它 |

2463| :- | :- |

2464| 您安裝的 Claude Code | 執行 `claude update` |

2465| Claude 桌面應用程式 | 更新應用程式 |

2466| [VS Code 擴充功能](/docs/zh-TW/vs-code)組合的二進位檔案 | 更新擴充功能 |

2467| Agent SDK 套件組合的二進位檔案 | [升級 SDK 套件](/docs/zh-TW/agent-sdk/hosting#runtime-dependencies)，然後重新啟動您的應用程式。在[編譯的單檔案可執行檔](/docs/zh-TW/agent-sdk/typescript#compile-to-a-single-executable)中，重建它 |

2468 

2469* 對於按模型措辭，您可以通過切換到另一個模型來在目前工作階段中繼續工作：在 CLI 中執行 `/model`，在 TypeScript SDK 的 `Query` 物件上呼叫 [`setModel()`](/docs/zh-TW/agent-sdk/typescript#query-object)（在串流輸入模式中），或在 Python SDK 的 `ClaudeSDKClient` 上呼叫 [`set_model()`](/docs/zh-TW/agent-sdk/python#claudesdkclient)

2439* 對於組織政策措辭，在繼續之前更新2470* 對於組織政策措辭，在繼續之前更新

2440 2471 

2441<h3 id="model-is-restricted-by-your-organizations-settings">2472<h3 id="model-is-restricted-by-your-organizations-settings">

72 72 

73在工作階段中輸入 `/fast on` 以開啟快速模式。它僅在該工作階段中保持開啟，不會儲存為您的預設值。[要求](#requirements)也適用於雲端工作階段。73在工作階段中輸入 `/fast on` 以開啟快速模式。它僅在該工作階段中保持開啟，不會儲存為您的預設值。[要求](#requirements)也適用於雲端工作階段。

74 74 

75在 [claude.ai/code](https://claude.ai/code) 的瀏覽器中，您也可以從訊息方塊上的模型選單開啟和關閉快速模式。當您的方案包含快速模式且選定的模型支援它時，選單會顯示切換開關。

76 

75<h2 id="understand-the-cost-tradeoff">77<h2 id="understand-the-cost-tradeoff">

76 了解成本權衡78 了解成本權衡

77</h2>79</h2>

312| [Computer use](/docs/zh-TW/computer-use) | ✓ | ✓ | ✗ | ✗ |312| [Computer use](/docs/zh-TW/computer-use) | ✓ | ✓ | ✗ | ✗ |

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

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

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

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

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

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

43 43 

44Claude Code 然後推送包含您選擇的工作流程檔案的分支，已設定為使用該密鑰，並在您的瀏覽器中開啟 GitHub，準備建立 pull request。建立並合併該 pull request，`@claude` 就可以在儲存庫中工作。44Claude Code 然後推送包含您選擇的工作流程檔案的分支，已設定為使用該密鑰，並在您的瀏覽器中開啟 GitHub，準備建立 pull request。建立並合併該 pull request，`@claude` 就可以在儲存庫中工作。

45 45 

46若要在中途停止設定，請按 Esc。已進行中的步驟會完成，之後的步驟不會開始。結束訊息會列出儲存庫中已發生的事項，例如推送的分支或已儲存的密鑰。

47 

46如果您選擇審查工作流程，Claude 會在 pull request 本身上發佈每個審查，作為它發現的每個問題的內聯評論，或在未發現任何問題時作為一個摘要評論。Claude 會跳過某些 pull request，例如草稿。[審查工作流程範例](#run-a-skill)使用相同的技能並列出它們。在 v2.1.229 之前，Claude 只將其審查寫入工作流程執行日誌。48如果您選擇審查工作流程，Claude 會在 pull request 本身上發佈每個審查，作為它發現的每個問題的內聯評論，或在未發現任何問題時作為一個摘要評論。Claude 會跳過某些 pull request，例如草稿。[審查工作流程範例](#run-a-skill)使用相同的技能並列出它們。在 v2.1.229 之前，Claude 只將其審查寫入工作流程執行日誌。

47 49 

48若要更新較早版本生成的審查工作流程，請執行以下操作之一：50若要更新較早版本生成的審查工作流程，請執行以下操作之一：

56 Artifact56 Artifact

57</h3>57</h3>

58 58 

59Claude Code 從您的會話發佈到 claude.ai 上私人 URL 的即時互動網頁，因此您可以視覺化查看輸出或與他人共享，而不是閱讀終端文字。當會話重新發佈時，頁面會就地更新。您從 Claude Code 建立的 Artifacts 會出現在與 claude.ai 對話中建立的 artifacts 相同的庫中。共享取決於您的方案：在 Pro 和 Max 上，任何人都可以開啟的公開連結；在 Team 和 Enterprise 上，在您的組織內共享，以及一旦擁有者啟用它們就可以公開連結。59Claude Code 從您的會話發佈到 claude.ai 上私人 URL 的即時互動網頁，因此您可以視覺化查看輸出或與他人共享，而不是閱讀終端文字。當會話重新發佈時，頁面會就地更新。您從 Claude Code 建立的 Artifacts 會出現在與 claude.ai 對話中建立的 artifacts 相同的庫中。共享選項取決於您的方案：請參閱 [Share an artifact](/docs/zh-TW/artifacts#share-an-artifact)。

60 60 

61了解更多：[Share session output as artifacts](/docs/zh-TW/artifacts)61了解更多：[Share session output as artifacts](/docs/zh-TW/artifacts)

62 62 

274 274 

275來自設定檔、受管理的原則設定和外掛程式的 Hooks 也在 [subagents](/docs/zh-TW/sub-agents) 內執行。當 subagent 呼叫工具時，工具事件（例如 `PreToolUse` 和 `PostToolUse`）會觸發與主要對話中相同的已配置 hooks，輸入會攜帶 `agent_id` 和 `agent_type` [通用輸入欄位](#common-input-fields) 以識別 subagent。275來自設定檔、受管理的原則設定和外掛程式的 Hooks 也在 [subagents](/docs/zh-TW/sub-agents) 內執行。當 subagent 呼叫工具時，工具事件（例如 `PreToolUse` 和 `PostToolUse`）會觸發與主要對話中相同的已配置 hooks，輸入會攜帶 `agent_id` 和 `agent_type` [通用輸入欄位](#common-input-fields) 以識別 subagent。

276 276 

277企業管理員可以使用 `allowManagedHooksOnly` 來限制哪些 hooks 執行：277企業管理員可以使用 [`allowManagedHooksOnly`](/docs/zh-TW/settings-reference#allowmanagedhooksonly) 在 [受管理設定](/docs/zh-TW/managed-settings) 中限制哪些 hooks 執行：

278 278 

279* 您的使用者、專案、本機和外掛程式 hooks 被阻止。在受管理設定 `enabledPlugins` 中強制啟用的外掛程式的 Hooks 是例外279* 您的使用者、專案、本機和外掛程式 hooks 被阻止。在受管理設定 `enabledPlugins` 中強制啟用的外掛程式的 Hooks 是例外

280* Claude Code 也將您的 [`statusLine`](/docs/zh-TW/statusline)、[`fileSuggestion`](/docs/zh-TW/settings-reference#filesuggestion) 和 [`subagentStatusLine`](/docs/zh-TW/statusline#subagent-status-lines) 設定縮小到受管理設定280* Claude Code 也將您的 [`statusLine`](/docs/zh-TW/statusline)、[`fileSuggestion`](/docs/zh-TW/settings-reference#filesuggestion) 和 [`subagentStatusLine`](/docs/zh-TW/statusline#subagent-status-lines) 設定縮小到受管理設定

1187| `resume` | `--resume`、`--continue` 或 `/resume` |1187| `resume` | `--resume`、`--continue` 或 `/resume` |

1188| `clear` | `/clear` |1188| `clear` | `/clear` |

1189| `compact` | 自動或手動壓縮 |1189| `compact` | 自動或手動壓縮 |

1190| `fork` | 從現有工作階段分支的新工作階段：`--fork-session` 搭配 `--resume` 或 `--continue`、`/fork` 背景複本或 `/branch` |1190| `fork` | 從現有工作階段分支的新工作階段：`--fork-session` 搭配 `--resume` 或 `--continue`、`/fork` 背景複本、`/branch`，或您 [移到背景](/docs/zh-TW/agent-view#from-inside-a-session) 的對話 |

1191 1191 

1192在 v2.1.214 之前，分支工作階段報告來源為 `"resume"`。1192在 v2.1.214 之前，分支工作階段報告來源為 `"resume"`。

1193 1193 

2570 2570 

2571命名代理類型的 `matcher` 不匹配空 `agent_type`。其匹配器為省略、`""`、`"*"` 或是與空字串匹配的正規表達式的 hook 也對具有空 `agent_type` 的事件執行。2571命名代理類型的 `matcher` 不匹配空 `agent_type`。其匹配器為省略、`""`、`"*"` 或是與空字串匹配的正規表達式的 hook 也對具有空 `agent_type` 的事件執行。

2572 2572 

2573在 Claude Code v2.1.271 或更新版本上，使用 [`SubagentHandback`](/docs/zh-TW/tools-reference) 工具執行的子代理在停止之前透過該工具傳遞其報告。`last_assistant_message` 欄位然後保持子代理的結束文字（如果有），這不是傳遞的報告。報告是該呼叫的 `message` 輸入，`PreToolUse` 或 `PostToolUse` hook 匹配 `SubagentHandback` 接收作為 `tool_input.message`。2573在 Claude Code v2.1.271 或更新版本上，使用 [`SubagentHandback`](/docs/zh-TW/tools-reference) 工具執行的子代理（Claude Code 在 [自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 中提供）在停止之前透過該工具傳遞其報告。`last_assistant_message` 欄位然後保持子代理的結束文字（如果有），這不是傳遞的報告。報告是該呼叫的 `message` 輸入，`PreToolUse` 或 `PostToolUse` hook 匹配 `SubagentHandback` 接收作為 `tool_input.message`。

2574 2574 

2575SubagentStop hooks 也接收 [Stop input](#stop-input) 下描述的 `background_tasks` 和 `session_crons` 陣列。兩個陣列的範圍是父工作階段，而不是子代理。2575SubagentStop hooks 也接收 [Stop input](#stop-input) 下描述的 `background_tasks` 和 `session_crons` 陣列。兩個陣列的範圍是父工作階段，而不是子代理。

2576 2576 

196| `elicitation_url_dialog` | MCP 伺服器要求您開啟瀏覽器 URL，且您未輸入約六秒 |196| `elicitation_url_dialog` | MCP 伺服器要求您開啟瀏覽器 URL，且您未輸入約六秒 |

197| `elicitation_complete` | MCP 伺服器報告[URL 模式引導](/docs/zh-TW/hooks#elicitation-input)已完成 |197| `elicitation_complete` | MCP 伺服器報告[URL 模式引導](/docs/zh-TW/hooks#elicitation-input)已完成 |

198| `elicitation_response` | MCP 引導回應被發送回伺服器 |198| `elicitation_response` | MCP 引導回應被發送回伺服器 |

199| `agent_needs_input` | 背景工作階段開始等待您的輸入，同時 [agent view](/docs/zh-TW/agent-view) 已開啟，或當前工作階段詢問您一個[代理團隊隊友的終端設定問題](/docs/zh-TW/agent-teams#choose-a-display-mode)，且您未輸入約六秒 |199| `agent_needs_input` | 背景工作階段開始等待您的輸入，同時 [agent view](/docs/zh-TW/agent-view) 已開啟。也會在終端工作階段顯示您一個[代理團隊隊友的終端設定問題](/docs/zh-TW/agent-teams#choose-a-display-mode)或自動模式的[分類器請求費用](/docs/zh-TW/auto-mode-classifier-billing)通知，且您未輸入約六秒時觸發 |

200| `agent_completed` | 背景工作階段完成或失敗。僅在 [agent view](/docs/zh-TW/agent-view) 開啟時觸發 |200| `agent_completed` | 背景工作階段完成或失敗。僅在 [agent view](/docs/zh-TW/agent-view) 開啟時觸發 |

201| `quota_auto_resume_fired` | Claude Code 在 claude.ai 使用限制暫停後繼續您的任務：在重設時，或更早當您在等待期間於 Claude Code 中執行的操作（例如新增使用額度、升級計畫或切換模型）使使用量再次可用時，但有[模型設定例外](/docs/zh-TW/interactive-mode#wait-for-a-usage-limit-to-reset) |201| `quota_auto_resume_fired` | Claude Code 在 claude.ai 使用限制暫停後繼續您的任務：在重設時，或更早當您在等待期間於 Claude Code 中執行的操作（例如新增使用額度、升級計畫或切換模型）使使用量再次可用時，但有[模型設定例外](/docs/zh-TW/interactive-mode#wait-for-a-usage-limit-to-reset) |

202| `quota_auto_resume_stale` | claude.ai 使用限制在您的電腦睡眠超過約 30 分鐘時重設。Claude Code 等待您按 `Enter` 而不是繼續。在較短的睡眠後，它會繼續並改為觸發 `quota_auto_resume_fired` |202| `quota_auto_resume_stale` | claude.ai 使用限制在您的電腦睡眠超過約 30 分鐘時重設。Claude Code 等待您按 `Enter` 而不是繼續。在較短的睡眠後，它會繼續並改為觸發 `quota_auto_resume_fired` |

31 31 

32| 模式 | 功能 | 設定 |32| 模式 | 功能 | 設定 |

33| :- | :- | :- |33| :- | :- | :- |

34| **停用 MCP** | 沒有伺服器載入，除了 [啟動工作階段的應用程式註冊的同處理程序伺服器](#exclusive-control-with-managed-mcp-json) 和任何您 [透過 `managedMcpServers` 提供的伺服器](#provide-servers-through-managed-settings) | `managed-mcp.json` 搭配空白伺服器對應 |34| **停用 MCP** | 沒有伺服器載入，除了 [在獨佔控制下載入的少數伺服器](#exclusive-control-with-managed-mcp-json) | `managed-mcp.json` 搭配空白伺服器對應 |

35| **固定部署** | 每個使用者都取得相同的伺服器，無法新增其他伺服器 | `managed-mcp.json` 搭配您想要的伺服器 |35| **固定部署** | 每個使用者都取得相同的伺服器，無法新增其他伺服器 | `managed-mcp.json` 搭配您想要的伺服器 |

36| **提供的伺服器** | 每個使用者都取得您列出的遠端伺服器，並保留他們自己的伺服器 | 受管設定中的 `managedMcpServers` |36| **提供的伺服器** | 每個使用者都取得您列出的遠端伺服器，並保留他們自己的伺服器 | 受管設定中的 `managedMcpServers` |

37| **已核准的目錄** | 發佈已核准伺服器的清單；使用者新增他們想要的伺服器，其他任何伺服器都會被封鎖 | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |37| **已核准的目錄** | 發佈已核准伺服器的清單；使用者新增他們想要的伺服器，其他任何伺服器都會被封鎖 | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |

53* 該檔案定義的伺服器53* 該檔案定義的伺服器

54* 您[透過 `managedMcpServers` 提供的伺服器](#provide-servers-through-managed-settings)54* 您[透過 `managedMcpServers` 提供的伺服器](#provide-servers-through-managed-settings)

55* 啟動工作階段的應用程式註冊的同處理程序伺服器，例如 VS Code 擴充功能自己的伺服器或[桌面應用程式提供的連接器](/docs/zh-TW/mcp#how-connectors-reach-claude-code)55* 啟動工作階段的應用程式註冊的同處理程序伺服器，例如 VS Code 擴充功能自己的伺服器或[桌面應用程式提供的連接器](/docs/zh-TW/mcp#how-connectors-reach-claude-code)

56* 內建的[Chrome 中的 Claude](/docs/zh-TW/chrome) 伺服器，如果您[允許它與受管集合並存](#allow-claude-in-chrome-alongside-the-managed-set)

56 57 

57使用者無法新增、修改或使用任何其他 MCP 伺服器，包括外掛程式提供的伺服器和透過 [`--mcp-config` CLI 旗標](/docs/zh-TW/cli-reference#cli-flags)傳遞的伺服器。該檔案也會抑制 Claude Code 自行擷取的 claude.ai 連接器，除非您[允許它們與受管集合並存](#allow-claude-ai-connectors-alongside-the-managed-set)。58使用者無法新增、修改或使用任何其他 MCP 伺服器，包括外掛程式提供的伺服器和透過 [`--mcp-config` CLI 旗標](/docs/zh-TW/cli-reference#cli-flags)傳遞的伺服器。該檔案也會抑制 Claude Code 自行擷取的 claude.ai 連接器，除非您[允許它們與受管集合並存](#allow-claude-ai-connectors-alongside-the-managed-set)。

58 59 

144 完全停用 MCP145 完全停用 MCP

145</h3>146</h3>

146 147 

147部署包含空伺服器對應的 `managed-mcp.json` 以封鎖除[啟動工作階段的應用程式註冊的同處理程序伺服器](#exclusive-control-with-managed-mcp-json)之外的每個 MCP 伺服器：148部署包含空伺服器對應的 `managed-mcp.json` 以封鎖除[在獨佔控制下載入的伺服器](#exclusive-control-with-managed-mcp-json)之外的每個 MCP 伺服器：

148 149 

149```json theme={null}150```json theme={null}

150{151{

152}153}

153```154```

154 155 

155`claude mcp add` 失敗，並顯示上述企業原則錯誤。使用者之前設定的伺服器在下次啟動工作階段時停止載入，沒有警告說明原則是原因。您透過 `managedMcpServers` 提供的伺服器仍在空對應下載入，因此也請保持該金鑰未設定以完全停用 MCP。156`claude mcp add` 失敗，並顯示上述企業原則錯誤。使用者之前設定的伺服器在下次啟動工作階段時停止載入，沒有警告說明原則是原因。您透過 `managedMcpServers` 提供的伺服器和您允許與受管集合並存的任何其他內容仍在空對應下載入，因此請保持那些金鑰未設定以完全停用 MCP。

156 157 

157<h3 id="allow-claude-ai-connectors-alongside-the-managed-set">158<h3 id="allow-claude-ai-connectors-alongside-the-managed-set">

158 允許 claude.ai 連接器與受管集合並存159 允許 claude.ai 連接器與受管集合並存

166 167 

167Claude Code 只從管理員控制的原則層級讀取 `allowAllClaudeAiMcps`：伺服器管理的設定、MDM 部署的 plist 或 HKLM 登錄機碼，或系統 `managed-settings.json` 檔案。將其放在使用者或專案設定中無效，因此使用者無法重新啟用獨佔控制抑制的連接器。168Claude Code 只從管理員控制的原則層級讀取 `allowAllClaudeAiMcps`：伺服器管理的設定、MDM 部署的 plist 或 HKLM 登錄機碼，或系統 `managed-settings.json` 檔案。將其放在使用者或專案設定中無效，因此使用者無法重新啟用獨佔控制抑制的連接器。

168 169 

170<h3 id="allow-claude-in-chrome-alongside-the-managed-set">

171 允許 Claude in Chrome 與受管集合並存

172</h3>

173 

174根據預設，當您部署 `managed-mcp.json` 時，Claude Code 會在終端機工作階段中封鎖內建的 [Claude in Chrome](/docs/zh-TW/chrome) 伺服器。使用者不會收到[擴充功能安裝提示](/docs/zh-TW/chrome#install-the-extension-when-claude-asks)，且[預設啟用 Chrome](/docs/zh-TW/chrome#enable-chrome-by-default) 的使用者啟動的工作階段會在沒有 Chrome 的情況下啟動，並且不會列印任何警告。當可以執行 Claude in Chrome 的使用者使用 `claude --chrome` 或 `CLAUDE_CODE_ENABLE_CFC=1` 啟動它時，Claude Code 在啟動時會以命名 `allowClaudeInChromeWithManagedMcp` 設定的錯誤結束。

175 

176若要讓使用者在 `managed-mcp.json` 中的伺服器旁邊執行 Claude in Chrome，請在裝置自己的受管設定中設定 `"allowClaudeInChromeWithManagedMcp": true`。將其放在 MDM 部署的 plist 或 HKLM 登錄機碼中，或系統 `managed-settings.json` 檔案中，無論 Claude Code [選擇](/docs/zh-TW/managed-settings#precedence-within-the-managed-tier)該裝置上的哪一個。需要 Claude Code v2.1.282 或更新版本。在 v2.1.282 之前，Claude Code 會忽略該設定，啟動錯誤會改為讀取 `You cannot dynamically configure MCP servers when an enterprise MCP config is present`。

177 

178Claude Code 從這些裝置來源讀取該設定，即使[伺服器管理的設定](/docs/zh-TW/server-managed-settings)傳遞您的其餘原則。它會忽略伺服器管理的設定本身、使用者可寫入的 HKCU 登錄和使用者或專案設定中的該設定。[`deniedMcpServers`](#policy-based-control-with-allowlists-and-denylists) 項目 `claude-in-chrome` 仍會使用該設定封鎖伺服器。

179 

169<h2 id="provide-servers-through-managed-settings">180<h2 id="provide-servers-through-managed-settings">

170 透過受管設定提供伺服器181 透過受管設定提供伺服器

171</h2>182</h2>

303 314 

304| 設定 | 未設定（預設） | 空陣列 `[]` | 已填入 |315| 設定 | 未設定（預設） | 空陣列 `[]` | 已填入 |

305| :- | :- | :- | :- |316| :- | :- | :- | :- |

306| `allowedMcpServers` | 允許所有伺服器 | 不允許任何伺服器，除了[組織自己的](#how-a-server-is-evaluated)外 | 僅允許比對的伺服器，除了[組織自己的](#how-a-server-is-evaluated)外 |317| `allowedMcpServers` | 允許所有伺服器 | 不允許任何伺服器，除了[那些跳過允許清單檢查的](#how-a-server-is-evaluated)外 | 僅允許比對的伺服器，除了[那些跳過允許清單檢查的](#how-a-server-is-evaluated)外 |

307| `deniedMcpServers` | 沒有伺服器被阻止 | 沒有伺服器被阻止 | 比對的伺服器被阻止 |318| `deniedMcpServers` | 沒有伺服器被阻止 | 沒有伺服器被阻止 | 比對的伺服器被阻止 |

308 319 

309請參閱[受管設定中的無效項目](/docs/zh-TW/managed-settings#invalid-entries-in-managed-settings)，了解項目未通過結構描述驗證時會發生什麼。320請參閱[受管設定中的無效項目](/docs/zh-TW/managed-settings#invalid-entries-in-managed-settings)，了解項目未通過結構描述驗證時會發生什麼。

3292. **檢查拒絕清單。** 與任何拒絕清單項目比對的伺服器（按 URL、命令或名稱）會被阻止。沒有任何東西會覆蓋拒絕清單比對。3402. **檢查拒絕清單。** 與任何拒絕清單項目比對的伺服器（按 URL、命令或名稱）會被阻止。沒有任何東西會覆蓋拒絕清單比對。

3303. **檢查允許清單。** 如果 `allowedMcpServers` 未在任何地方設定，每個通過拒絕清單的伺服器都會載入。如果已設定，伺服器必須比對的內容取決於其類型，如下表所示。3413. **檢查允許清單。** 如果 `allowedMcpServers` 未在任何地方設定，每個通過拒絕清單的伺服器都會載入。如果已設定，伺服器必須比對的內容取決於其類型，如下表所示。

331 342 

332 組織自己的伺服器會跳過此檢查：每個 `managedMcpServers` 項目，以及任何 `managed-mcp.json` 項目，其值不使用 `${VAR}` 展開。內建伺服器也會跳過它，例如 Chrome 中的 Claude、Claude Code 在執行中的 VS Code 或 JetBrains IDE 中連接的 `ide` 伺服器，以及 CLI 本身設定的伺服器。343 三組伺服器會跳過此檢查：

344 

345 * 組織自己的伺服器：每個 `managedMcpServers` 項目，以及任何 `managed-mcp.json` 項目，其值不使用 `${VAR}` 展開。

346 * 內建伺服器，例如 Chrome 中的 Claude、Claude Code 在執行中的 VS Code 或 JetBrains IDE 中連接的 `ide` 伺服器，以及 CLI 本身設定的伺服器。

347 * [Claude Tag](/docs/zh-TW/claude-tag) 工作階段的 Slack 工具：它用來讀取執行緒和發佈回覆的伺服器會在沒有允許清單項目的情況下載入。

333 348 

334 在其命令、引數、`env`、URL 或標頭中使用 `${VAR}` 展開的 `managed-mcp.json` 伺服器仍會被檢查，就像使用者、外掛程式、`--mcp-config` 或 claude.ai 新增的每個伺服器一樣。349 在其命令、引數、`env`、URL 或標頭中使用 `${VAR}` 展開的 `managed-mcp.json` 伺服器仍會被檢查。使用者、外掛程式或 claude.ai 新增的每個伺服器也會被檢查，以及使用者使用 `--mcp-config` 傳遞的每個伺服器。

335 350 

336| 伺服器類型 | 比對時允許 |351| 伺服器類型 | 比對時允許 |

337| :- | :- |352| :- | :- |

514| 限制 | 使用者看到的內容 |529| 限制 | 使用者看到的內容 |

515| :- | :- |530| :- | :- |

516| `managed-mcp.json` 存在且使用者執行 `claude mcp add` | `Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers` |531| `managed-mcp.json` 存在且使用者執行 `claude mcp add` | `Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers` |

532| `managed-mcp.json` 存在且可以在 Chrome 中執行 Claude 的使用者執行 `claude --chrome` | Claude Code 在啟動時結束，顯示 `Claude in Chrome is blocked by your organization's managed MCP configuration (managed-mcp.json). An administrator can allow it with allowClaudeInChromeWithManagedMcp in device policy.` |

517| 伺服器在拒絕清單上且使用者執行 `claude mcp add` | `Cannot add MCP server "<name>": server is explicitly blocked by enterprise policy` |533| 伺服器在拒絕清單上且使用者執行 `claude mcp add` | `Cannot add MCP server "<name>": server is explicitly blocked by enterprise policy` |

518| 伺服器不在允許清單上且使用者執行 `claude mcp add` | `Cannot add MCP server "<name>": not allowed by enterprise policy` |534| 伺服器不在允許清單上且使用者執行 `claude mcp add` | `Cannot add MCP server "<name>": not allowed by enterprise policy` |

519| 使用者在來自 `managedMcpServers` 的伺服器上執行 `claude mcp remove` | `MCP server "<name>" is provided by your organization (managed settings) and cannot be removed locally.` |535| 使用者在來自 `managedMcpServers` 的伺服器上執行 `claude mcp remove` | `MCP server "<name>" is provided by your organization (managed settings) and cannot be removed locally.` |

541| `allowedMcpServers` | 允許的伺服器允許清單 | 任何 [設定範圍](/docs/zh-TW/settings#where-settings-live)；[伺服器如何被評估](#how-a-server-is-evaluated) 說明來自多個範圍和受管來源的清單如何組合 | 為了強制執行，[受管設定來源](/docs/zh-TW/admin-setup#decide-how-settings-reach-devices)：伺服器受管設定、`managed-settings.json`、MDM 設定檔或登錄 |557| `allowedMcpServers` | 允許的伺服器允許清單 | 任何 [設定範圍](/docs/zh-TW/settings#where-settings-live)；[伺服器如何被評估](#how-a-server-is-evaluated) 說明來自多個範圍和受管來源的清單如何組合 | 為了強制執行，[受管設定來源](/docs/zh-TW/admin-setup#decide-how-settings-reach-devices)：伺服器受管設定、`managed-settings.json`、MDM 設定檔或登錄 |

542| `deniedMcpServers` | 被阻止的伺服器拒絕清單 | 任何設定範圍；[伺服器如何被評估](#how-a-server-is-evaluated) 說明來自多個範圍和受管來源的清單如何組合 | 與 `allowedMcpServers` 相同 |558| `deniedMcpServers` | 被阻止的伺服器拒絕清單 | 任何設定範圍；[伺服器如何被評估](#how-a-server-is-evaluated) 說明來自多個範圍和受管來源的清單如何組合 | 與 `allowedMcpServers` 相同 |

543| `allowManagedMcpServersOnly` | 將允許清單鎖定為僅受管來源 | 僅受管設定來源；[從每個管理來源讀取的金鑰](/docs/zh-TW/managed-settings#keys-read-from-every-admin-source) 說明哪些受管來源可以開啟它。該設定在其他範圍無效 | 與 `allowedMcpServers` 相同 |559| `allowManagedMcpServersOnly` | 將允許清單鎖定為僅受管來源 | 僅受管設定來源；[從每個管理來源讀取的金鑰](/docs/zh-TW/managed-settings#keys-read-from-every-admin-source) 說明哪些受管來源可以開啟它。該設定在其他範圍無效 | 與 `allowedMcpServers` 相同 |

560| `allowClaudeInChromeWithManagedMcp` | 讓內建的 Claude in Chrome 伺服器與 `managed-mcp.json` 一起執行 | 裝置上的受管設定：MDM 設定檔、HKLM 登錄或 `managed-settings.json`。伺服器受管設定和使用者可寫入來源無效 | MDM、GPO、艦隊管理或任何具有管理員權限的程序 |

544| `allowAllClaudeAiMcps` | 在 `managed-mcp.json` 旁邊載入 Claude Code 自行擷取的 claude.ai 連接器。[在執行雲端工作階段的主機上的 `managed-mcp.json` 仍會抑制該工作階段的連接器](#allow-claude-ai-connectors-alongside-the-managed-set) | 僅受管設定來源；該設定在其他地方無效 | 與 `allowedMcpServers` 相同 |561| `allowAllClaudeAiMcps` | 在 `managed-mcp.json` 旁邊載入 Claude Code 自行擷取的 claude.ai 連接器。[在執行雲端工作階段的主機上的 `managed-mcp.json` 仍會抑制該工作階段的連接器](#allow-claude-ai-connectors-alongside-the-managed-set) | 僅受管設定來源；該設定在其他地方無效 | 與 `allowedMcpServers` 相同 |

545 562 

546<h2 id="related-resources">563<h2 id="related-resources">

449| [`blockedMarketplaces`](/docs/zh-TW/settings-reference#blockedmarketplaces) | 市集來源的封鎖清單。在下載前檢查被封鎖的來源，因此它們永遠不會接觸檔案系統。請參閱[受管理市集限制](/docs/zh-TW/plugins/org#restrict-what-users-can-install) |449| [`blockedMarketplaces`](/docs/zh-TW/settings-reference#blockedmarketplaces) | 市集來源的封鎖清單。在下載前檢查被封鎖的來源，因此它們永遠不會接觸檔案系統。請參閱[受管理市集限制](/docs/zh-TW/plugins/org#restrict-what-users-can-install) |

450| [`channelsEnabled`](/docs/zh-TW/settings-reference#channelsenabled) | 允許組織使用[頻道](/docs/zh-TW/channels)。請參閱[企業控制](/docs/zh-TW/channels#enterprise-controls)以了解每個方案的預設值 |450| [`channelsEnabled`](/docs/zh-TW/settings-reference#channelsenabled) | 允許組織使用[頻道](/docs/zh-TW/channels)。請參閱[企業控制](/docs/zh-TW/channels#enterprise-controls)以了解每個方案的預設值 |

451| [`disableCommandPluginSources`](/docs/zh-TW/settings-reference#disablecommandpluginsources) | 當為 `true` 時，完全封鎖[`command` 外掛程式來源](/docs/zh-TW/plugins/marketplace-reference#command-plugin-source)，因此市集宣告的命令永遠不會執行。也會封鎖市集[`headersHelper` 命令](/docs/zh-TW/plugins/host-marketplace#authenticate-archive-downloads)，除了受管理設定本身宣告的市集。未設定時，遵循 `allowManagedHooksOnly`。需要 Claude Code v2.1.229 或更新版本，而 `headersHelper` 封鎖需要 v2.1.238 或更新版本 |451| [`disableCommandPluginSources`](/docs/zh-TW/settings-reference#disablecommandpluginsources) | 當為 `true` 時，完全封鎖[`command` 外掛程式來源](/docs/zh-TW/plugins/marketplace-reference#command-plugin-source)，因此市集宣告的命令永遠不會執行。也會封鎖市集[`headersHelper` 命令](/docs/zh-TW/plugins/host-marketplace#authenticate-archive-downloads)，除了受管理設定本身宣告的市集。未設定時，遵循 `allowManagedHooksOnly`。需要 Claude Code v2.1.229 或更新版本，而 `headersHelper` 封鎖需要 v2.1.238 或更新版本 |

452| [`disableSideloadFlags`](/docs/zh-TW/settings-reference#disablesideloadflags) | 在啟動時拒絕 `--plugin-dir`、`--plugin-url`、`--agents` 和 `--mcp-config` 旗標。在雲端工作階段中，Claude Code 會捨棄伺服器透過 `--mcp-config` 傳遞的 MCP 伺服器，除了同處理序 `type: "sdk"` 項目，並啟動工作階段。需要 Claude Code v2.1.193 或更新版本 |452| [`disableSideloadFlags`](/docs/zh-TW/settings-reference#disablesideloadflags) | 在啟動時拒絕 `--plugin-dir`、`--plugin-url`、`--agents` 和 `--mcp-config` 旗標。在雲端工作階段中，Claude Code 會捨棄伺服器透過 `--mcp-config` 傳遞的 MCP 伺服器，除了其[參考項目](/docs/zh-TW/settings-reference#disablesideloadflags)列出的例外。需要 Claude Code v2.1.193 或更新版本 |

453| [`forceRemoteSettingsRefresh`](/docs/zh-TW/settings-reference#forceremotesettingsrefresh) | 當為 `true` 時，會封鎖 CLI 啟動，直到遠端受管理設定被新鮮擷取，如果擷取失敗則退出。請參閱[失敗關閉強制執行](/docs/zh-TW/server-managed-settings#enforce-fail-closed-startup) |453| [`forceRemoteSettingsRefresh`](/docs/zh-TW/settings-reference#forceremotesettingsrefresh) | 當為 `true` 時，會封鎖 CLI 啟動，直到遠端受管理設定被新鮮擷取，如果擷取失敗則退出。請參閱[失敗關閉強制執行](/docs/zh-TW/server-managed-settings#enforce-fail-closed-startup) |

454| [`managedMcpServers`](/docs/zh-TW/settings-reference#managedmcpservers) | 提供給每個使用者的遠端 MCP 伺服器，與他們自己的伺服器一起。它提供伺服器而不是鎖定任何東西。請參閱[透過受管理設定提供伺服器](/docs/zh-TW/managed-mcp#provide-servers-through-managed-settings)。需要 Claude Code v2.1.259 或更新版本 |454| [`managedMcpServers`](/docs/zh-TW/settings-reference#managedmcpservers) | 提供給每個使用者的遠端 MCP 伺服器，與他們自己的伺服器一起。它提供伺服器而不是鎖定任何東西。請參閱[透過受管理設定提供伺服器](/docs/zh-TW/managed-mcp#provide-servers-through-managed-settings)。需要 Claude Code v2.1.259 或更新版本 |

455| [`managedSourcesBehavior`](/docs/zh-TW/settings-reference#managedsourcesbehavior) | Claude Code 是否只應用最高優先級的受管理來源或[組合每一個](#compose-every-managed-source) |455| [`managedSourcesBehavior`](/docs/zh-TW/settings-reference#managedsourcesbehavior) | Claude Code 是否只應用最高優先級的受管理來源或[組合每一個](#compose-every-managed-source) |

115 115 

116允許相對和絕對路徑。相對路徑相對於包含匯入的檔案解析，而不是工作目錄。匯入的檔案可以遞迴匯入其他檔案，最大深度為四個躍點。116允許相對和絕對路徑。相對路徑相對於包含匯入的檔案解析，而不是工作目錄。匯入的檔案可以遞迴匯入其他檔案，最大深度為四個躍點。

117 117 

118若要匯入路徑包含空格的檔案，請在每個空格前放置反斜線。沒有反斜線，路徑在第一個空格處結束，即使匯入在其自己的行上。用引號包裝的路徑根本不會被匯入，無論是否有反斜線。此匯入從名為 `Design Docs` 的資料夾載入檔案：

119 

120```text theme={null}

121- API conventions @Design\ Docs/api-conventions.md

122```

123 

118匯入解析會跳過 Markdown 程式碼跨度和圍欄程式碼區塊。若要在您的 CLAUDE.md 中提及路徑而不匯入它，請將其包裝在反引號中：寫入 `` `@README` `` 會保持文字為字面，而反引號外的 `@README` 會匯入檔案。124匯入解析會跳過 Markdown 程式碼跨度和圍欄程式碼區塊。若要在您的 CLAUDE.md 中提及路徑而不匯入它，請將其包裝在反引號中：寫入 `` `@README` `` 會保持文字為字面，而反引號外的 `@README` 會匯入檔案。

119 125 

120若要引入 README、package.json 和工作流程指南，請在 CLAUDE.md 中的任何位置使用 `@` 語法參考它們：126若要引入 README、package.json 和工作流程指南，請在 CLAUDE.md 中的任何位置使用 `@` 語法參考它們：

64}64}

65```65```

66 66 

67在 Claude Desktop 應用程式中，Code 標籤工作階段會從[到達每種 Desktop 工作階段的來源](/docs/zh-TW/desktop#managed-settings)讀取這些受管設定。管理員主控台[資料和隱私設定](https://claude.ai/admin-settings/data-privacy-controls)中**監控**下的 Cowork OpenTelemetry 表單僅適用於 Cowork 工作階段，因此終端 CLI 和 Code 標籤都不會匯出到您在該處設定的收集器。

68 

67Claude Code 會忽略儲存庫的 `.claude/settings.json` 和 `.claude/settings.local.json` 中的 [OpenTelemetry 匯出器變數](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)，因此儲存庫無法使用它們來開啟遙測、選擇其去向或擷取內容。請在受管設定中設定它們，或讓每個開發人員在其 shell 或 `~/.claude/settings.json` 中設定它們。儲存庫仍然可以透過將其匯出器選擇器（例如 `OTEL_LOGS_EXPORTER`）設定為 `none` 來關閉信號，除非受管設定、`--settings` 檔案或您啟動 Claude Code 的環境設定了該變數。69Claude Code 會忽略儲存庫的 `.claude/settings.json` 和 `.claude/settings.local.json` 中的 [OpenTelemetry 匯出器變數](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)，因此儲存庫無法使用它們來開啟遙測、選擇其去向或擷取內容。請在受管設定中設定它們，或讓每個開發人員在其 shell 或 `~/.claude/settings.json` 中設定它們。儲存庫仍然可以透過將其匯出器選擇器（例如 `OTEL_LOGS_EXPORTER`）設定為 `none` 來關閉信號，除非受管設定、`--settings` 檔案或您啟動 Claude Code 的環境設定了該變數。

68 70 

69Claude Code 不會將 `OTEL_*` 環境變數傳遞給它產生的子程序，包括 Bash 工具、hooks、MCP 伺服器和語言伺服器。透過 Bash 工具執行的 OpenTelemetry 檢測應用程式不會繼承 Claude Code 的匯出器端點或標頭，因此如果該應用程式需要匯出自己的遙測，請直接在命令中設定這些變數。71Claude Code 不會將 `OTEL_*` 環境變數傳遞給它產生的子程序，包括 Bash 工具、hooks、MCP 伺服器和語言伺服器。透過 Bash 工具執行的 OpenTelemetry 檢測應用程式不會繼承 Claude Code 的匯出器端點或標頭，因此如果該應用程式需要匯出自己的遙測，請直接在命令中設定這些變數。

290* **`docker` 指向另一個守護程序**：唯讀形式的 `docker` 在命令帶有選擇不同守護程序的旗標時提示，如 `-H`、`--context` 或 Podman 的 `--url` 和 `--connection`。290* **`docker` 指向另一個守護程序**：唯讀形式的 `docker` 在命令帶有選擇不同守護程序的旗標時提示，如 `-H`、`--context` 或 Podman 的 `--url` 和 `--connection`。

291* **`file` 帶有路徑開啟旗標**：`file` 在傳遞 `-m`/`--magic-file` 或 `-f`/`--files-from` 時提示，因為這些旗標使 `file` 開啟旗標值中命名的路徑。291* **`file` 帶有路徑開啟旗標**：`file` 在傳遞 `-m`/`--magic-file` 或 `-f`/`--files-from` 時提示，因為這些旗標使 `file` 開啟旗標值中命名的路徑。

292* **Windows 上的網路路徑**：其引數包括網路 (UNC) 路徑（如 `\\server\share\file`）的命令會提示，因為存取網路路徑可能會將您的 Windows 認證傳送到它命名的主機。同樣的檢查適用於 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)命令。292* **Windows 上的網路路徑**：其引數包括網路 (UNC) 路徑（如 `\\server\share\file`）的命令會提示，因為存取網路路徑可能會將您的 Windows 認證傳送到它命名的主機。同樣的檢查適用於 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)命令。

293* **寫入特殊 shell 變數**：設定、取消設定或迴圈某些特殊 shell 變數（如 `PATH` 或 `IFS`）的命令會提示，即使命令的其餘部分是唯讀的。

293* **分析無法解析的命令**：當 Claude Code 無法完全解析命令時，它會要求批准而不是將命令視為唯讀。超過 10,000 個字元的命令始終提示，因為它們超過分析解析的內容。294* **分析無法解析的命令**：當 Claude Code 無法完全解析命令時，它會要求批准而不是將命令視為唯讀。超過 10,000 個字元的命令始終提示，因為它們超過分析解析的內容。

294 295 

295`cd` 進入工作目錄或[額外目錄](#working-directories)內的路徑也是唯讀的，像 `cd packages/api && ls` 這樣的複合命令在每個部分都符合時無需提示即可執行。即使每個部分都是唯讀的，這些組合也會提示：296`cd` 進入工作目錄或[額外目錄](#working-directories)內的路徑也是唯讀的，像 `cd packages/api && ls` 這樣的複合命令在每個部分都符合時無需提示即可執行。即使每個部分都是唯讀的，這些組合也會提示：

121 121 

122在您的終端中，plugins 僅在您使用 claude.ai 帳戶登入的工作階段中同步。122在您的終端中，plugins 僅在您使用 claude.ai 帳戶登入的工作階段中同步。

123 123 

124Claude Code 在這些終端工作階段中既不下載也不載入同步 plugins，即使您使用 `/login` 登入後：

125 

126* 一個工作階段，其中 `ANTHROPIC_AUTH_TOKEN`、`CLAUDE_CODE_OAUTH_TOKEN` 或 `apiKeyHelper` 指令碼提供認證以代替該登入

127* 一個不 [從 Anthropic 擷取功能旗標](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching) 的工作階段，例如您設定 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 的工作階段

128* 一個在 [裸機模式](/docs/zh-TW/headless#start-faster-with-bare-mode) 中的工作階段或您使用 `--safe-mode` 啟動的工作階段

129* 一個您使用 [`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 列表啟動的工作階段，該列表遺漏了 `user`

130 

124如果您在較早版本的 Claude Code 上登入，該登入不涵蓋 plugins，直到 Claude Code 在背景更新它。若要更快獲得存取權，請再次執行 `/login`。Plugin 同步然後在您下次啟動 Claude Code 時開始。131如果您在較早版本的 Claude Code 上登入，該登入不涵蓋 plugins，直到 Claude Code 在背景更新它。若要更快獲得存取權，請再次執行 `/login`。Plugin 同步然後在您下次啟動 Claude Code 時開始。

125 132 

126<h4 id="control-which-synced-plugins-load">133<h4 id="control-which-synced-plugins-load">

170 170 

171如果您的 Git 主機拒絕認證，或您沒有配置認證，執行器會重試幾次，然後失敗儲存庫準備當儲存庫是工作階段推送結果的儲存庫時。對於工作階段僅從中讀取的儲存庫，[Troubleshooting](#troubleshooting) 涵蓋執行器何時改為跳過它。執行器不會將這些設定傳遞到工作階段的環境中。171如果您的 Git 主機拒絕認證，或您沒有配置認證，執行器會重試幾次，然後失敗儲存庫準備當儲存庫是工作階段推送結果的儲存庫時。對於工作階段僅從中讀取的儲存庫，[Troubleshooting](#troubleshooting) 涵蓋執行器何時改為跳過它。執行器不會將這些設定傳遞到工作階段的環境中。

172 172 

173保持您在 `GIT_SSH_COMMAND` 或 `GIT_ASKPASS` 中命名的任何程式，工作階段無法寫入它，就像[強化檢查清單](#harden-your-deployment)要求鉤子目錄和包裝器指令碼的方式一樣。該程式命令行上的任何金鑰或檔案也是如此。執行器自己的 Git 在複製或提取時執行該程式。

174 

173如果簽出目錄由與執行器程序不同的 uid 擁有，Git 拒絕對其進行操作；添加 `safe.directory`：175如果簽出目錄由與執行器程序不同的 uid 擁有，Git 拒絕對其進行操作；添加 `safe.directory`：

174 176 

175```dockerfile theme={null}177```dockerfile theme={null}

184 186 

185代理需要 `--capacity 1`，因為代理 URL 是每個工作階段的，Git 2.32 或更新版本，因為較舊的 Git 忽略代理用來隔離工作階段的配置機制。如果任一要求未滿足，執行器拒絕啟動。因為代理從 Anthropic 端提取，您的 Git 主機必須可從 Anthropic 基礎設施到達，與 Anthropic 託管工作階段相同的要求；對於僅在您的網路內可路由的 Git 主機，改用 [`checkout` 生命週期鉤子](/docs/zh-TW/self-hosted-environments-configuration#checkout)。每個執行器程序一次處理一個工作階段，因此執行更多副本以實現並行性。啟用代理後，`--git-host-rewrite` 和 `--git-ssh-rewrite` 無效：代理 URL 指向 `api.anthropic.com`，而不是您的 Git 主機。187代理需要 `--capacity 1`，因為代理 URL 是每個工作階段的，Git 2.32 或更新版本，因為較舊的 Git 忽略代理用來隔離工作階段的配置機制。如果任一要求未滿足，執行器拒絕啟動。因為代理從 Anthropic 端提取，您的 Git 主機必須可從 Anthropic 基礎設施到達，與 Anthropic 託管工作階段相同的要求；對於僅在您的網路內可路由的 Git 主機，改用 [`checkout` 生命週期鉤子](/docs/zh-TW/self-hosted-environments-configuration#checkout)。每個執行器程序一次處理一個工作階段，因此執行更多副本以實現並行性。啟用代理後，`--git-host-rewrite` 和 `--git-ssh-rewrite` 無效：代理 URL 指向 `api.anthropic.com`，而不是您的 Git 主機。

186 188 

189<Warning>

190 本頁上的 [Kubernetes](#kubernetes) 和 [Docker Compose](#docker-compose) 配方使用 `--capacity 4`。如果您在不將容量更改為 `1` 的情況下將 `--use-anthropic-git-proxy` 或 `CLAUDE_RUNNER_USE_GIT_PROXY=1` 添加到其中之一，每次您的協調器重新啟動執行器時，執行器都會在啟動時退出。設定 `--capacity 1` 並執行更多副本以實現並行性。[When the runner exits](#when-the-runner-exits) 顯示執行器列印的行。

191</Warning>

192 

187執行器也會在註冊時向 Anthropic 報告選擇加入，在啟動時列印 `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)`。報告選擇加入需要 Claude Code v2.1.267 或更新版本，較早的版本接受該旗標而不報告它或列印該行。選擇加入執行器上的每個工作階段隨後使用 Anthropic 管理的 Git 或每個工作階段的代理 URL。當工作階段使用每個工作階段的代理 URL 時，執行器記錄一行 `[runner:warn]` 說明這一點。193執行器也會在註冊時向 Anthropic 報告選擇加入，在啟動時列印 `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)`。報告選擇加入需要 Claude Code v2.1.267 或更新版本，較早的版本接受該旗標而不報告它或列印該行。選擇加入執行器上的每個工作階段隨後使用 Anthropic 管理的 Git 或每個工作階段的代理 URL。當工作階段使用每個工作階段的代理 URL 時，執行器記錄一行 `[runner:warn]` 說明這一點。

188 194 

195<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">

196 使用 Anthropic 管理的 Git 信任私有憑證授權單位

197</h4>

198 

199如果您在執行器的環境中設定 `GIT_SSL_CAINFO` 或 `GIT_SSL_NO_VERIFY`，其工作階段使用 Anthropic 管理的 Git，本部分適用。它描述的處理需要執行器執行 Claude Code v2.1.283 或更新版本。

200 

201當執行器上的 Git 必須信任私有憑證授權單位 (CA)（例如 TLS 檢查代理簽署的憑證授權單位）時，通常的方法如下所示：

202 

203* **系統憑證存放區**：在執行器主機的系統憑證存放區中安裝您的 CA，Git 無需任何變數即可信任它。

204* **`GIT_SSL_CAINFO`**：將其設定為您的 CA 的 PEM 檔案，例如 `GIT_SSL_CAINFO=/etc/ssl/corp-ca.pem`。

205* **`GIT_SSL_NO_VERIFY`**：在重新簽署代理後沒有幫助。執行器自己通過 Anthropic 管理的 Git 複製檢查憑證，即使設定了變數，因此複製失敗直到 Git 通過其他兩種方法之一信任您的 CA。

206 

207對於將工作階段令牌傳遞到 Anthropic 管理的 Git 的 Git 連線，執行器應用這兩個變數如下。[`command` 鉤子](/docs/zh-TW/self-hosted-environments-configuration#command)以工作階段的環境開始，因此它獲得 Git 在工作階段內獲得的內容：

208 

209* **`GIT_SSL_CAINFO`**：Git 檢查 Anthropic 管理的 Git 的內容取決於 Git 執行的位置：

210 * **執行器自己的複製和提取**：執行時不使用變數，並根據執行器寫入的每個工作階段憑證檔案檢查 Anthropic 管理的 Git。該檔案保存執行器主機的系統 CA 套件加上您的檔案中的憑證。

211 * **工作階段內的 Git**：獲得 `http.sslCAInfo` 配置，命名您的檔案代替變數，加上 `http.<url>.sslCAInfo` 項目，根據每個工作階段檔案檢查 Anthropic 管理的 Git。

212 * **`checkout` 和 `post-session` 鉤子**：繼承變數不變。

213* **`GIT_SSL_NO_VERIFY`**：哪些憑證檢查保持關閉取決於 Git 執行的位置：

214 * **執行器自己的複製和提取**：執行時不使用變數，並檢查它們呈現的憑證。

215 * **工作階段內的 Git**：獲得 `http.sslVerify=false` 配置代替變數，因此檢查對其他主機保持關閉。它也獲得 `http.<url>.sslVerify=true` 項目，為 Anthropic 管理的 Git 保持檢查開啟。

216 * **`checkout` 和 `post-session` 鉤子**：當工作階段在 Anthropic 管理的 Git 上有儲存庫時，獲得 `http.sslVerify=false` 配置代替變數。它們也獲得 `http.<url>.sslVerify=true` 項目，為 Anthropic 管理的 Git 保持檢查開啟。

217 

218每個工作階段憑證檔案需要在執行器主機上的 `/etc/ssl/certs/ca-certificates.crt` 或 `/etc/pki/tls/certs/ca-bundle.crt` 處的系統 CA 套件。它也需要執行器的使用者可以讀取的 `GIT_SSL_CAINFO` 檔案，保存 PEM `CERTIFICATE` 區塊，最多 1 MiB。當執行器無法建立每個工作階段檔案時，它記錄包含 `did not build the certificate file` 和原因的 `[runner:warn]` 行。Git 隨後按原樣為 Anthropic 管理的 Git 使用您的檔案。修復該行命名的內容。

219 

220對於使用 Anthropic 管理的 Git 的每個工作階段，執行器也記錄以 `governed git: GIT_SSL_CAINFO is set` 或 `governed git: GIT_SSL_NO_VERIFY is set` 開始的 `[runner:warn]` 行。該行說明執行器對其自己的 Git、工作階段內的 Git 和您的生命週期鉤子對該變數所做的操作。它以您是否需要更改任何內容結束。

221 

189<h3 id="rewrite-git-urls-for-private-networks">222<h3 id="rewrite-git-urls-for-private-networks">

190 為私有網路重寫 Git URL223 為私有網路重寫 Git URL

191</h3>224</h3>

203 236 

204Anthropic 不發佈預構建的執行器映像。在 `claude` 二進位檔案周圍構建您自己的，分層您的儲存庫需要的任何工具鏈：語言執行時、編譯器、套件管理器和 [MCP](/docs/zh-TW/mcp) 邊車。237Anthropic 不發佈預構建的執行器映像。在 `claude` 二進位檔案周圍構建您自己的，分層您的儲存庫需要的任何工具鏈：語言執行時、編譯器、套件管理器和 [MCP](/docs/zh-TW/mcp) 邊車。

205 238 

206下面的配方使用 `--capacity 4`，因此一個容器服務來自同一鎖定所有者的最多四個並發工作階段。這不提供[強化部分](#harden-your-deployment)中的每個工作階段容器隔離：在將環境連接到生產系統之前，要麼以 `--capacity 1` 執行配方，每個工作階段一個容器，要麼使用[按需執行器](/docs/zh-TW/self-hosted-environments-configuration#on-demand-runners)，它也將環境祕密保留在執行工作階段的主機之外。239下面的配方使用 `--capacity 4`，因此一個容器服務來自同一鎖定所有者的最多四個並發工作階段。這不提供[強化部分](#harden-your-deployment)中的每個工作階段容器隔離：在將環境連接到生產系統之前，要麼以 `--capacity 1` 執行配方，每個工作階段一個容器，要麼使用[按需執行器](/docs/zh-TW/self-hosted-environments-configuration#on-demand-runners)，它也將環境祕密保留在執行工作階段的主機之外。如果您將[Anthropic git 代理](#use-the-anthropic-git-proxy)新增至其中一個配方，也請將 `--capacity` 變更為 `1`。

207 240 

208此 Dockerfile 是一個最小的起點：241此 Dockerfile 是一個最小的起點：

209 242 

336 Docker Compose369 Docker Compose

337</h2>370</h2>

338 371 

339下面的 Compose 服務在執行器退出時重新啟動它，涵蓋崩潰和清空後的正常退出。Docker 重新啟動原則重新啟動同一容器及其可寫層，因此執行器以重複使用的檔案系統而不是[強化姿態](#harden-your-deployment)推薦的新鮮檔案系統回來；為評估使用此配方，對於生產環境，要麼每次執行時重新建立容器，要麼使用執行此操作的協調器。372下面的 Compose 服務會在執行器退出時重新啟動它，這涵蓋了崩潰和正常排空後的退出。Docker 重新啟動原則會使用其可寫層保持完整的方式重新啟動同一個容器，因此執行器會在重複使用的檔案系統上恢復，而不是[強化部署](#harden-your-deployment)建議的全新檔案系統；請使用此配方進行評估，而對於生產環境，請每次執行時重新建立容器，或使用執行協調器。

373 

374Docker 在容器不斷退出時，會在每次重新啟動之前等待更長的時間，直到達到上限，因此無法啟動的執行器在此配方下不會在緊密迴圈中持續重新啟動。[當執行器退出時](#when-the-runner-exits)描述了發生這種情況時要檢查的內容。

340 375 

341```yaml theme={null}376```yaml theme={null}

342services:377services:

451 486 

452每個工作階段的子 Claude Code 程序執行執行器自己的二進位檔案，執行器在它生成的工作階段內關閉自動更新，因此每個工作階段執行您在主機上安裝或構建到映像中的版本。主機級更新在執行器下次啟動時生效。487每個工作階段的子 Claude Code 程序執行執行器自己的二進位檔案，執行器在它生成的工作階段內關閉自動更新，因此每個工作階段執行您在主機上安裝或構建到映像中的版本。主機級更新在執行器下次啟動時生效。

453 488 

489您的工作階段使用的模型可能需要比它們執行的版本更新的 Claude Code 版本。伺服器隨後會以 [Claude Code 不支援此模型](/docs/zh-TW/errors#claude-code-does-not-support-this-model) 拒絕該模型的請求。在您固定版本之前，請檢查[模型所需的 Claude Code 版本](/docs/zh-TW/model-config#available-models)，以確保您的工作階段使用的每個模型都符合要求。

490 

454* **將群保持在一個版本上**：使用固定版本構建映像，或在裸主機上安裝特定版本並[禁用自動更新](/docs/zh-TW/setup#disable-auto-updates)491* **將群保持在一個版本上**：使用固定版本構建映像，或在裸主機上安裝特定版本並[禁用自動更新](/docs/zh-TW/setup#disable-auto-updates)

455* **升級**：安裝較新版本或重建映像，然後重新啟動執行器492* **升級**：安裝較新版本或重建映像，然後重新啟動執行器

456* **外掛程式**：外掛程式市場也不自動更新；在執行器的環境中設定 `FORCE_AUTOUPDATE_PLUGINS=1` 以讓外掛程式自動更新，同時二進位檔案保持固定493* **外掛程式**：外掛程式市場也不自動更新；在執行器的環境中設定 `FORCE_AUTOUPDATE_PLUGINS=1` 以讓外掛程式自動更新，同時二進位檔案保持固定

554 591 

555每個工作階段的子程序寫入單獨的調試日誌。失敗時執行器在 claude.ai/code 中的工作階段旁邊顯示日誌的尾部。除非您使用 [`--remove-session-state`](/docs/zh-TW/self-hosted-environments-reference#runner-cli-flags) 啟動執行器，否則它也會在磁碟上保留失敗工作階段的日誌，並在執行器日誌中列印其路徑。592每個工作階段的子程序寫入單獨的調試日誌。失敗時執行器在 claude.ai/code 中的工作階段旁邊顯示日誌的尾部。除非您使用 [`--remove-session-state`](/docs/zh-TW/self-hosted-environments-reference#runner-cli-flags) 啟動執行器，否則它也會在磁碟上保留失敗工作階段的日誌，並在執行器日誌中列印其路徑。

556 593 

594<h3 id="when-the-runner-exits">

595 當執行器退出時

596</h3>

597 

598不要重新啟動[按需執行器](/docs/zh-TW/self-hosted-environments-configuration#on-demand-runners)，因為其工作訂單是一次性的。執行器在啟動後立即退出需要與因任何其他原因退出的執行器不同的處理。

599 

600* **正常退出**：執行器完成了其工作階段並清空、達到其退休時間或被告知停止。重新啟動它以便環境再次具有容量。[執行器生命週期](/docs/zh-TW/self-hosted-environments#runner-lifecycle)描述這些退出。

601* **失敗的啟動**：執行器無法使用給定的設定或主機啟動，因此它在啟動後幾秒鐘退出，每次您重新啟動它時都以相同的方式退出。更快地重新啟動它沒有幫助。有人需要閱讀其輸出並修復原因。

602 

603配置您的監督程序以在執行器退出時重新啟動它，在執行器持續在啟動後立即退出時等待更長時間再重新啟動，並在這種情況持續發生時告知某人。

604 

605<h4 id="recognize-a-failed-start">

606 識別失敗的啟動

607</h4>

608 

609當執行器無法啟動時，它會列印一行說明原因，然後退出。對於大多數原因，該行包含 `[runner:fatal]`。對於某些原因，該行以 `error:` 開頭，包括當執行器無法解析其旗標、無法讀取環境祕密或無法建立或寫入基本目錄時。下一行然後指向 `--help`。

610 

611大多數日誌行以時間戳和 `[self-hosted-runner]` 開頭，下面的範例省略了。例如，使用 Anthropic Git 代理和容量大於 1 啟動的執行器會列印如下一行：

612 

613```text theme={null}

614[runner:fatal] --use-anthropic-git-proxy requires --capacity 1 (the proxy URL is per-session and linked worktrees share origin). Omit --use-anthropic-git-proxy or set --capacity 1.

615```

616 

617在執行器的標準輸出和標準錯誤、您的平台的容器日誌或您使用 [`--log-file`](/docs/zh-TW/self-hosted-environments-reference#runner-cli-flags) 設定的檔案中尋找該行。執行器在打開日誌檔案之前列印 `error:` 行，因此在終端或您的容器日誌中尋找它，如[故障排除](#troubleshooting)所述。

618 

619當您閱讀失敗的啟動時，這些也有幫助：

620 

621* **根本沒有行**：主機殺死的執行器不會列印任何一個。如果輸出以沒有 `[runner:fatal]` 行和沒有 `error:` 行結束，檢查主機或您的協調器是否停止了程序，例如超過記憶體限制。

622* **退出代碼**：執行器不會為在每次啟動時重複的錯誤預留退出代碼。它對配置錯誤（例如不支援的旗標組合）和可以自行清除的失敗（例如 API 通過執行器自己的重試保持無法到達）以相同的代碼退出。根據執行器退出的速度快慢來決定是否等待更長時間，並閱讀執行器的輸出以了解原因。

623* **看起來健康的環境**：某些啟動步驟在執行器向您的環境註冊後執行，例如 [`--configure-git`](#let-the-runner-configure-git) 和 Anthropic Git 代理的認證設定。如果其中一個步驟失敗，環境可以在程序退出後幾分鐘內繼續列出該執行器，**雲端環境**頁面可以讀取**健康**，而沒有執行器拾取工作。如果工作階段在看起來健康的環境中保持排隊，檢查您的監督程序是否在重新啟動執行器。

624 

625<h4 id="restart-with-a-wait-that-grows">

626 使用增長的等待時間重新啟動

627</h4>

628 

629您如何獲得增長的等待時間取決於您的監督程序。

630 

631* **Kubernetes**：此頁面上的 [Deployment](#kubernetes) 不需要更改。容器退出後，kubelet 預設會在重新啟動容器之前等待，並且等待時間在每次重新啟動時增長到上限。一旦容器運行了一段時間而沒有退出，等待時間就會重新開始。

632 

633 kubelet 在容器運行時間很短時的正常退出後應用相同的等待。經常清空的執行器因此也可以顯示 `CrashLoopBackOff` 狀態，因此在得出執行器無法啟動的結論之前閱讀輸出。下面的命令從 Deployment 的一個 pod 讀取上次運行的輸出：

634 

635 ```bash theme={null}

636 kubectl logs --previous -n claude-runners deploy/claude-runner

637 ```

638 

639 當上次運行是失敗的啟動時，`[runner:fatal]` 或 `error:` 行在輸出的最後幾行中。要讀取另一個 pod 的上次運行，在 `deploy/claude-runner` 的位置命名該 pod。

640* **Docker 和 Docker Compose**：此頁面上的 [Compose 配方](#docker-compose)不需要更改。使用 `restart: always`，Docker 在持續退出的容器的每次重新啟動之前等待更長時間，直到上限。在下面的命令中用容器的名稱替換 `<container>`，該命令讀取 Docker 重新啟動容器的次數：

641 

642 ```bash theme={null}

643 docker inspect --format '{{.RestartCount}}' <container>

644 ```

645 

646 該命令列印一個數字。持續增長的數字意味著 Docker 持續重新啟動執行器。

647* **systemd 單位**：預設情況下，systemd 在每次重新啟動之前等待相同的 `RestartSec`，並且不會延長它，因此具有 `Restart=always` 的單位以相同的間隔重新啟動無法啟動的執行器。當啟動速度足夠快以達到單位的啟動速率限制時（預設為 10 秒內 5 次啟動），systemd 停止重新啟動該單位。該單位保持停止狀態，直到有人再次啟動它，systemd 允許在速率限制的間隔已過或在 `systemctl reset-failed` 之後。因為 `RestartSec` 適用於每次重新啟動，更長的值也會延遲正常退出後的重新啟動。選擇一個平衡兩者的值，並對單位的重新啟動計數發出警報。

648* **shell 迴圈或您自己的監督程序**：自己應用相同的規則。從 5 秒的等待開始。在每次在一分鐘內結束的運行之後，將下一次重新啟動的等待加倍，最多 5 分鐘。在運行持續一分鐘或更長時間後，回到 5 秒。

649 

650<h4 id="check-why-the-runner-keeps-exiting">

651 檢查執行器為什麼持續退出

652</h4>

653 

654當執行器連續多次在啟動後立即退出時，停止並在重新啟動之前檢查這些。

655 

656* **最後的 `[runner:fatal]` 或 `error:` 行**：它說明執行器停止的原因。[故障排除](#troubleshooting)列出常見原因。

657* **旗標的組合**：[Anthropic Git 代理](#use-the-anthropic-git-proxy)需要 `--capacity 1`。此頁面上的配方使用更高的容量，因此在將代理添加到其中一個時降低它。

658* **服務的環境可以到達什麼**：如果執行器手動啟動並在您的監督程序下失敗，比較使用者、主目錄、`PATH` 和記憶體限制。`--configure-git` 和 Anthropic Git 代理需要 `PATH` 上的 Git 和可寫的 `~/.gitconfig`。

659* **環境祕密**：如果您撤銷了祕密或輸入錯誤，執行器會列印包含 `RegisterRunner auth failed` 的行。

660* **環境的活動標籤**：打開環境並選擇**活動**。如果新執行器持續出現在那裡，沒有任何執行器拾取工作，您的監督程序正在重新啟動執行器。

661 

662為了在執行器主機上進行引導式診斷，執行 [doctor 子命令](#troubleshooting)。

663 

557<h2 id="what’s-next">664<h2 id="what’s-next">

558 下一步665 下一步

559</h2>666</h2>

105 </Step>105 </Step>

106</Steps>106</Steps>

107 107 

108執行器在其活動工作階段完成後按設計退出；請參閱[執行器生命週期](/docs/zh-TW/self-hosted-environments#runner-lifecycle)。對於生產環境，在編排器下部署它，該編排器在退出時重新啟動它。請參閱[部署到生產環境](/docs/zh-TW/self-hosted-environments-deploy)。108執行器在其活動工作階段完成後按設計退出；請參閱[執行器生命週期](/docs/zh-TW/self-hosted-environments#runner-lifecycle)。對於生產環境，在編排器下部署它，該編排器在退出時重新啟動它，並在執行器啟動後立即持續退出時等待更長的時間再重新啟動。請參閱[部署到生產環境](/docs/zh-TW/self-hosted-environments-deploy)和[當執行器退出時](/docs/zh-TW/self-hosted-environments-deploy#when-the-runner-exits)。

109 109 

110<h2 id="send-a-follow-up-message-to-a-running-session">110<h2 id="send-a-follow-up-message-to-a-running-session">

111 傳送後續訊息到執行中的工作階段111 傳送後續訊息到執行中的工作階段

595| [`agent`](#agent) | 以命名的[子代理](/docs/zh-TW/sub-agents)及其提示、工具和模型開始每個工作階段 | 代理、工作階段和 worktrees | Any file |595| [`agent`](#agent) | 以命名的[子代理](/docs/zh-TW/sub-agents)及其提示、工具和模型開始每個工作階段 | 代理、工作階段和 worktrees | Any file |

596| [`agentPushNotifEnabled`](#agentpushnotifenabled) | 讓 Claude 在決定時傳送[推播通知到您的手機](/docs/zh-TW/remote-control#mobile-push-notifications) | 遠端、桌面和通知 | Any file |596| [`agentPushNotifEnabled`](#agentpushnotifenabled) | 讓 Claude 在決定時傳送[推播通知到您的手機](/docs/zh-TW/remote-control#mobile-push-notifications) | 遠端、桌面和通知 | Any file |

597| [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | 載入 Claude Code 自行擷取的 [claude.ai 連接器](/docs/zh-TW/mcp)，以及已部署的 [`managed-mcp.json`](/docs/zh-TW/managed-mcp#exclusive-control-with-managed-mcp-json) | MCP | Managed |597| [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | 載入 Claude Code 自行擷取的 [claude.ai 連接器](/docs/zh-TW/mcp)，以及已部署的 [`managed-mcp.json`](/docs/zh-TW/managed-mcp#exclusive-control-with-managed-mcp-json) | MCP | Managed |

598| [`allowClaudeInChromeWithManagedMcp`](#allowclaudeinchromewithmanagedmcp) | 讓內建的[Chrome 中的 Claude](/docs/zh-TW/chrome) 伺服器與已部署的 [`managed-mcp.json`](/docs/zh-TW/managed-mcp#exclusive-control-with-managed-mcp-json) 並行執行 | MCP | Managed |

598| [`allowedChannelPlugins`](#allowedchannelplugins) | 取代[頻道外掛程式](/docs/zh-TW/channels#restrict-which-channel-plugins-can-run)的預設允許清單，該清單可以推送訊息 | 外掛程式和技能 | Managed |599| [`allowedChannelPlugins`](#allowedchannelplugins) | 取代[頻道外掛程式](/docs/zh-TW/channels#restrict-which-channel-plugins-can-run)的預設允許清單，該清單可以推送訊息 | 外掛程式和技能 | Managed |

599| [`allowedHttpHookUrls`](#allowedhttphookurls) | 限制[HTTP hooks](/docs/zh-TW/hooks)可以針對的 URL | Hooks 和自動化 | Any file |600| [`allowedHttpHookUrls`](#allowedhttphookurls) | 限制[HTTP hooks](/docs/zh-TW/hooks)可以針對的 URL | Hooks 和自動化 | Any file |

600| [`allowedMcpServers`](#allowedmcpservers) | 允許清單，其中列出使用者可以新增的 [MCP 伺服器](/docs/zh-TW/mcp) | MCP | Any file |601| [`allowedMcpServers`](#allowedmcpservers) | 允許清單，其中列出使用者可以新增的 [MCP 伺服器](/docs/zh-TW/mcp) | MCP | Any file |

3064</h4>3065</h4>

3065 3066 

3066* 此處的值會覆蓋在您的 shell 中匯出的相同變數，當多個設定檔設定一個變數時，[最高優先級](/docs/zh-TW/settings#settings-precedence)的值適用。[Claude Code 在 `env` 中忽略的變數](#variables-claude-code-ignores-in-env)列出專案和本機設定的例外。3067* 此處的值會覆蓋在您的 shell 中匯出的相同變數，當多個設定檔設定一個變數時，[最高優先級](/docs/zh-TW/settings#settings-precedence)的值適用。[Claude Code 在 `env` 中忽略的變數](#variables-claude-code-ignores-in-env)列出專案和本機設定的例外。

3068* 當 Claude Desktop 應用程式或[自託管環境](/docs/zh-TW/self-hosted-environments)執行器啟動工作階段時，它建置的啟動環境優先：Claude Code 忽略任何設定檔中的 `env` 值，用於啟動環境已經設定的變數。[偵錯日誌](/docs/zh-TW/debug-your-config)命名每個被忽略的變數。

3067* 要取消 shell 匯出，請將變數設定為 `""`。Claude Code 將空值視為未設定以進行提供者選擇，子程序繼承空值。3069* 要取消 shell 匯出，請將變數設定為 `""`。Claude Code 將空值視為未設定以進行提供者選擇，子程序繼承空值。

3068* `NO_COLOR` 和 `FORCE_COLOR` 在此設定只到達子程序。要更改 Claude Code 自己的介面顏色，請在啟動 `claude` 之前在您的 shell 中設定它們。3070* `NO_COLOR` 和 `FORCE_COLOR` 在此設定只到達子程序。要更改 Claude Code 自己的介面顏色，請在啟動 `claude` 之前在您的 shell 中設定它們。

3069* 此處的值是設定檔中的純文字，到達 Claude Code 啟動的每個子程序。對於輪換的 OTLP 持有人令牌，使用 [`otelHeadersHelper`](#otelheadershelper)；對於 API 認證，使用 [`apiKeyHelper`](#apikeyhelper)。3071* 此處的值是設定檔中的純文字，到達 Claude Code 啟動的每個子程序。對於輪換的 OTLP 持有人令牌，使用 [`otelHeadersHelper`](#otelheadershelper)；對於 API 認證，使用 [`apiKeyHelper`](#apikeyhelper)。

5157 5159 

5158[`allowedMcpServers`](#allowedmcpservers) 和 [`deniedMcpServers`](#deniedmcpservers) 仍然適用於此金鑰載入的連接器。傳遞到[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)的連接器，其主機帶有 `managed-mcp.json`（例如自託管執行器），會保持被抑制。請參閱[允許 claude.ai 連接器與受管集合並存](/docs/zh-TW/managed-mcp#allow-claude-ai-connectors-alongside-the-managed-set)。5160[`allowedMcpServers`](#allowedmcpservers) 和 [`deniedMcpServers`](#deniedmcpservers) 仍然適用於此金鑰載入的連接器。傳遞到[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)的連接器，其主機帶有 `managed-mcp.json`（例如自託管執行器），會保持被抑制。請參閱[允許 claude.ai 連接器與受管集合並存](/docs/zh-TW/managed-mcp#allow-claude-ai-connectors-alongside-the-managed-set)。

5159 5161 

5162<h3 id="allowclaudeinchromewithmanagedmcp">

5163 `allowClaudeInChromeWithManagedMcp`

5164</h3>

5165 

5166讓內建的 [Chrome 中的 Claude](/docs/zh-TW/chrome) 伺服器在部署的 `managed-mcp.json` 旁邊執行。沒有此金鑰，部署的 `managed-mcp.json` 會在終端工作階段中阻止 Chrome 中的 Claude。需要 Claude Code v2.1.282 或更新版本。

5167 

5168* **範圍**：[`Managed`](#scopes)，僅來自裝置自己的受管設定：MDM 部署的 plist 或 HKLM 登錄機碼，或系統 `managed-settings.json` 檔案。Claude Code 在伺服器受管設定、使用者可寫入的 HKCU 登錄和使用者或專案設定中忽略它。

5169* **類型**：布林值

5170 * `true`：內建的 Chrome 中的 Claude 伺服器可以在部署的 `managed-mcp.json` 旁邊執行

5171 * `false`：部署的 `managed-mcp.json` 會在終端工作階段中阻止 Chrome 中的 Claude

5172* **預設**：`false`，因此部署的 `managed-mcp.json` 會在終端工作階段中阻止 Chrome 中的 Claude

5173 

5174```json managed-settings.json theme={null}

5175{

5176 "allowClaudeInChromeWithManagedMcp": true

5177}

5178```

5179 

5180[`deniedMcpServers`](#deniedmcpservers) 中的 `claude-in-chrome` 條目仍然會在此金鑰開啟時阻止伺服器。請參閱[允許 Chrome 中的 Claude 與受管集合並存](/docs/zh-TW/managed-mcp#allow-claude-in-chrome-alongside-the-managed-set)。

5181 

5160<h3 id="allowedmcpservers">5182<h3 id="allowedmcpservers">

5161 `allowedMcpServers`5183 `allowedMcpServers`

5162</h3>5184</h3>

5163 5185 

5164允許清單列出人員可以新增的 MCP 伺服器。Claude Code 會阻止任何不符合條目的伺服器，無論在何處定義，包括外掛程式伺服器、使用 `--mcp-config` 傳遞的伺服器，以及來自 claude.ai 的伺服器。5186允許清單列出人員可以新增的 MCP 伺服器。Claude Code 會阻止任何不符合條目的伺服器，無論在何處定義，包括外掛程式伺服器、使用 `--mcp-config` 傳遞的伺服器，以及來自 claude.ai 的伺服器。

5165 5187 

5166內建伺服器（例如 Chrome 中的 Claude、Claude Code 在執行中的 [VS Code](/docs/zh-TW/vs-code#the-built-in-ide-mcp-server) 或 [JetBrains](/docs/zh-TW/jetbrains#the-built-in-ide-mcp-server) IDE 中連接的 `ide` 伺服器，以及 CLI 本身設定的伺服器）不受允許清單限制，拒絕清單仍然適用於它們。同處理程序 `type: "sdk"` 伺服器不受兩個清單的限制；[啟動工作階段的應用程式](/docs/zh-TW/mcp#how-connectors-reach-claude-code)會註冊它們。5188內建伺服器（例如 Chrome 中的 Claude、Claude Code 在執行中的 [VS Code](/docs/zh-TW/vs-code#the-built-in-ide-mcp-server) 或 [JetBrains](/docs/zh-TW/jetbrains#the-built-in-ide-mcp-server) IDE 中連接的 `ide` 伺服器，以及 CLI 本身設定的伺服器）不受允許清單限制，拒絕清單仍然適用於它們。在 Claude Code v2.1.268 或更新版本上，[Claude Tag](/docs/zh-TW/claude-tag) 工作階段的 Slack 工具也不受允許清單限制，拒絕清單仍然適用於它們。同處理程序 `type: "sdk"` 伺服器不受兩個清單的限制；[啟動工作階段的應用程式](/docs/zh-TW/mcp#how-connectors-reach-claude-code)會註冊它們。

5167 5189 

5168您的組織提供的伺服器也不受允許清單限制，拒絕清單仍然適用於它們。豁免涵蓋每個 [`managedMcpServers`](#managedmcpservers) 條目，以及任何 [`managed-mcp.json`](/docs/zh-TW/managed-mcp#exclusive-control-with-managed-mcp-json) 條目，其值不使用 `${VAR}` 擴展。請參閱[如何評估伺服器](/docs/zh-TW/managed-mcp#how-a-server-is-evaluated)以了解完整的檢查順序。在 v2.1.259 之前，來自 `managed-mcp.json` 的伺服器也必須符合。5190您的組織提供的伺服器也不受允許清單限制，拒絕清單仍然適用於它們。豁免涵蓋每個 [`managedMcpServers`](#managedmcpservers) 條目，以及任何 [`managed-mcp.json`](/docs/zh-TW/managed-mcp#exclusive-control-with-managed-mcp-json) 條目，其值不使用 `${VAR}` 擴展。請參閱[如何評估伺服器](/docs/zh-TW/managed-mcp#how-a-server-is-evaluated)以了解完整的檢查順序。在 v2.1.259 之前，來自 `managed-mcp.json` 的伺服器也必須符合。

5169 5191 

6304 `disableSideloadFlags`6326 `disableSideloadFlags`

6305</h3>6327</h3>

6306 6328 

6307在啟動時拒絕 `--plugin-dir`、`--plugin-url`、`--agents` 和 `--mcp-config` CLI 旗標，使用者否則可能會傳遞這些旗標來繞過 [`strictKnownMarketplaces`](#strictknownmarketplaces) 進行單次執行。Claude Code 會以錯誤結束並列出被拒絕的旗標，並對在內部使用這些旗標啟動 CLI 的介面套用相同檢查，目前在桌面應用程式中的 [Cowork](/docs/zh-TW/desktop) 本機工作階段。在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中，Claude Code 會捨棄伺服器透過 `--mcp-config` 傳遞的 MCP 伺服器，除了進程內 `type: "sdk"` 項目外，並啟動工作階段。需要 Claude Code v2.1.193 或更新版本。6329在啟動時拒絕 `--plugin-dir`、`--plugin-url`、`--agents` 和 `--mcp-config` CLI 旗標，使用者否則可能會傳遞這些旗標來繞過 [`strictKnownMarketplaces`](#strictknownmarketplaces) 進行單次執行。Claude Code 會以錯誤結束並列出被拒絕的旗標，並對在內部使用這些旗標啟動 CLI 的介面套用相同檢查，目前在桌面應用程式中的 [Cowork](/docs/zh-TW/desktop) 本機工作階段。在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中，Claude Code 會啟動工作階段並捨棄伺服器傳遞的每個 `--mcp-config` 項目，除了進程內 `type: "sdk"` 項目和 [Claude Tag](/docs/zh-TW/claude-tag) 工作階段的 Slack 工具外。需要 Claude Code v2.1.193 或更新版本。

6308 6330 

6309* **範圍**: [`Managed`](#scopes)6331* **範圍**: [`Managed`](#scopes)

6310* **類型**: 布林值6332* **類型**: 布林值

6311 * `true`: Claude Code 在啟動時拒絕 `--plugin-dir`、`--plugin-url`、`--agents` 和 `--mcp-config`，並以錯誤結束並列出它們，除了在雲端工作階段中它會捨棄伺服器透過 `--mcp-config` 傳遞的 MCP 伺服器（除了進程內 `type: "sdk"` 項目外），並啟動工作階段6333 * `true`: Claude Code 在啟動時拒絕 `--plugin-dir`、`--plugin-url`、`--agents` 和 `--mcp-config`，並以錯誤結束並列出它們。在雲端工作階段中，它會啟動工作階段並捨棄伺服器傳遞的每個 `--mcp-config` 項目，除了進程內 `type: "sdk"` 項目和 Claude Tag 工作階段的 Slack 工具外

6312 * `false`: Claude Code 接受這些旗標6334 * `false`: Claude Code 接受這些旗標

6313* **預設**: `false`6335* **預設**: `false`

6314 6336 

6322 6344 

6323相同的檢查涵蓋在 [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/zh-TW/env-vars#variables) 環境變數中命名的外掛程式資料夾，這需要 Claude Code v2.1.280 或更新版本。當變數命名資料夾時，Claude Code 會以相同的錯誤結束，且錯誤會說明要取消設定變數。6345相同的檢查涵蓋在 [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/zh-TW/env-vars#variables) 環境變數中命名的外掛程式資料夾，這需要 Claude Code v2.1.280 或更新版本。當變數命名資料夾時，Claude Code 會以相同的錯誤結束，且錯誤會說明要取消設定變數。

6324 6346 

6325在雲端工作階段中，Claude Code 也會忽略伺服器傳遞的中途 MCP 更新，即雲端工作階段設定和 SDK `setMcpServers()` 呼叫背後的路徑，這些呼叫會到達這些工作階段。進程內 `type: "sdk"` 項目在那裡也保持豁免。在 v2.1.239 之前，伺服器傳遞的 `--mcp-config` 會阻止雲端工作階段啟動。6347在雲端工作階段中，Claude Code 也會忽略伺服器傳遞的中途 MCP 更新，即雲端工作階段設定和 SDK `setMcpServers()` 呼叫背後的路徑，這些呼叫會到達這些工作階段。進程內 `type: "sdk"` 項目和 Claude Tag 工作階段的 Slack 工具在那裡也保持豁免。在 v2.1.268 之前，此捨棄和啟動捨棄也移除了 Claude Tag 工作階段的 Slack 工具。在 v2.1.239 之前，伺服器傳遞的 `--mcp-config` 會阻止雲端工作階段啟動。

6326 6348 

6327<h3 id="forceremotesettingsrefresh">6349<h3 id="forceremotesettingsrefresh">

6328 `forceRemoteSettingsRefresh`6350 `forceRemoteSettingsRefresh`

1178**Context 百分比顯示意外值**1178**Context 百分比顯示意外值**

1179 1179 

1180* 使用 `used_percentage` 以取得最簡單的準確 context 狀態1180* 使用 `used_percentage` 以取得最簡單的準確 context 狀態

1181* Context 百分比可能與 `/context` 輸出不同，因為每個計算時間不同1181* 狀態列報告來自最後一次 API 回應的計數，而 `/context` 新增自該回應以來新增的訊息的估計值，因此 `/context` 在下一次回應前可能讀取更高的值

1182 1182 

1183**OSC 8 連結不可點擊**1183**OSC 8 連結不可點擊**

1184 1184 

30 內建 subagents30 內建 subagents

31</h2>31</h2>

32 32 

33Claude Code 包括內建 subagents，Claude 在適當時會自動使用。每個都繼承父對話的權限；大多數以受限的工具集執行。33Claude Code 包括內建 subagents，Claude 在適當時會自動使用。每個都繼承父對話的權限規則；大多數以受限的工具集執行。

34 34 

35Explore 和 Plan 會跳過您的 CLAUDE.md 檔案和 git status 快照，以保持研究快速且經濟高效。其他所有內建和[自訂 subagent](#configure-subagents) 都會載入兩者，除非其定義設定 [`omitClaudeMd`](#supported-frontmatter-fields) 欄位以跳過使用者、專案和本機 CLAUDE.md 檔案。如需了解到達 subagent 的完整詳細資訊，請參閱[啟動時載入的內容](#what-loads-at-startup)。35Explore 和 Plan 會跳過您的 CLAUDE.md 檔案和 git status 快照，以保持研究快速且經濟高效。其他所有內建和[自訂 subagent](#configure-subagents) 都會載入兩者，除非其定義設定 [`omitClaudeMd`](#supported-frontmatter-fields) 欄位以跳過使用者、專案和本機 CLAUDE.md 檔案。如需了解到達 subagent 的完整詳細資訊，請參閱[啟動時載入的內容](#what-loads-at-startup)。

36 36 

802 - matcher: "Bash"802 - matcher: "Bash"

803 hooks:803 hooks:

804 - type: command804 - type: command

805 command: "./scripts/validate-command.sh $TOOL_INPUT"805 command: "./scripts/validate-command.sh"

806 PostToolUse:806 PostToolUse:

807 - matcher: "Edit|Write"807 - matcher: "Edit|Write"

808 hooks:808 hooks:

122 122 

123 <tr>123 <tr>

124 <td>計費</td>124 <td>計費</td>

125 <td><strong>Teams：</strong> \$150/座位（Premium）提供 PAYG<br /><strong>Enterprise：</strong> <a href="https://claude.com/contact-sales?utm_source=claude_code&utm_medium=docs&utm_content=third_party_enterprise">聯絡銷售</a></td>125 <td><strong>Teams：</strong> 每座位訂閱，提供 PAYG，請參閱 <a href="https://claude.com/pricing?utm_source=claude_code&utm_medium=docs&utm_content=third_party_pricing#team-&-enterprise">定價</a><br /><strong>Enterprise：</strong> <a href="https://claude.com/contact-sales?utm_source=claude_code&utm_medium=docs&utm_content=third_party_enterprise">聯絡銷售</a></td>

126 <td>PAYG</td>126 <td>PAYG</td>

127 <td>通過 AWS 的 PAYG</td>127 <td>通過 AWS 的 PAYG</td>

128 <td>通過 AWS Marketplace 的 PAYG</td>128 <td>通過 AWS Marketplace 的 PAYG</td>

445 TLS 或 SSL 連線錯誤445 TLS 或 SSL 連線錯誤

446</h3>446</h3>

447 447 

448錯誤如 `curl: (35) TLS connect error`、`schannel: next InitializeSecurityContext failed` 或 PowerShell 的 `Could not establish trust relationship for the SSL/TLS secure channel` 表示 TLS 握手失敗。448錯誤如 `curl: (35) TLS connect error`、`schannel: next InitializeSecurityContext failed`、PowerShell 的 `Could not create SSL/TLS secure channel` 或 PowerShell 的 `Could not establish trust relationship for the SSL/TLS secure channel` 表示 TLS 握手失敗。

449 449 

450**解決方案：**450**解決方案：**

451 451 

465 irm https://claude.ai/install.ps1 | iex465 irm https://claude.ai/install.ps1 | iex

466 ```466 ```

467 467 

4683. **檢查代理或防火牆干擾**：執行 TLS 檢查的公司代理可能導致這些錯誤，包括 `unable to get local issuer certificate` 和 `SELF_SIGNED_CERT_IN_CHAIN`。對於安裝步驟，使用 `--cacert` 將 curl 指向您的公司 CA 套件：4683. **檢查代理或防火牆干擾**：執行 TLS 檢查的公司代理可能導致這些錯誤，包括 `unable to get local issuer certificate` 和 `SELF_SIGNED_CERT_IN_CHAIN`。對於安裝步驟，使 install 下載信任您的公司代理的 CA：

469 469 

470 <Tabs>470 <Tabs>

471 <Tab title="macOS/Linux">471 <Tab title="macOS/Linux">

52 `.heapsnapshot` 檔案包含程序中的每個字串，包括您的完整對話和認證。請勿將其附加到公開問題或分享。52 `.heapsnapshot` 檔案包含程序中的每個字串，包括您的完整對話和認證。請勿將其附加到公開問題或分享。

53</Warning>53</Warning>

54 54 

55該命令也會在對話中列印摘要，顯示常駐集合大小、JS 堆積、陣列緩衝區和未計算的原生記憶體，以及它偵測到的任何洩漏指標，例如高記憶體成長率或異常高的開啟控制代碼數量。摘要會說明大部分記憶體是在 JS 堆積中（快照會擷取），還是在原生記憶體中（快照不會擷取）。55該命令也會在對話中列印摘要，顯示程序的總記憶體、其中有多少在 JS 堆積中，以及有多少在堆積外。摘要也會列出任何洩漏指標，例如高記憶體成長率或異常高的開啟控制代碼數量。摘要會說明大部分記憶體是在 JS 堆積中（快照會擷取），還是在原生記憶體中（快照不會擷取）。

56 56 

57對輸出執行以下兩項操作之一：57對輸出執行以下兩項操作之一：

58 58 

91 監視執行91 監視執行

92</h3>92</h3>

93 93 

94工作流程在背景中執行，因此工作階段在代理工作時保持回應。隨時執行 `/workflows` 以列出執行中和已完成的工作流程，然後選擇一個以開啟其進度檢視。94工作流程在背景中執行，因此工作階段在代理工作時保持回應。隨時執行 `/workflows` 以列出執行中和已完成的工作流程，然後選擇一個以開啟其進度檢視。若要停止執行中的工作流程而不開啟它，請在清單中選擇它並按 `x`。

95 95 

96進度檢視顯示每個階段及其代理計數、令牌總計和經過時間。頁腳列出每個動作的鍵：96進度檢視顯示每個階段及其代理計數、令牌總計和經過時間。頁腳列出每個動作的鍵：

97 97