Documentation 2026-11-11 22:59 UTC to 2026-11-12 23:02 UTC

254| 來源 | 何時加載 | 影響 |254| 來源 | 何時加載 | 影響 |

255| :- | :- | :- |255| :- | :- | :- |

256| **系統提示** | 每個請求 | 小的固定成本，始終存在 |256| **系統提示** | 每個請求 | 小的固定成本，始終存在 |

257| **CLAUDE.md 檔案** | 工作階段開始，透過 [`settingSources`](https://code.claude.com/docs/zh-TW/agent-sdk/claude-code-features) | 每個請求中的完整內容（但提示快取，因此只有第一個請求支付完整成本） |257| **CLAUDE.md 檔案** | 工作階段開始，透過 [`settingSources`](https://code.claude.com/docs/zh-TW/agent-sdk/claude-code-features) | 每個請求中的完整內容（但有提示快取） |

258| **工具定義** | Bash、Read 和 Edit 等核心內建工具在每個請求時載入；MCP 工具和其他內建工具則依需求載入，[工具搜尋](https://code.claude.com/docs/zh-TW/agent-sdk/mcp.md#mcp-tool-search) 預設會延遲這些工具 | 在 [設定工具搜尋](https://code.claude.com/docs/zh-TW/agent-sdk/tool-search.md#configure-tool-search) 所列的情況下，每個 schema 都會預先載入 |258| **工具定義** | Bash、Read 和 Edit 等核心內建工具在每個請求時載入；MCP 工具和其他內建工具則依需求載入，[工具搜尋](https://code.claude.com/docs/zh-TW/agent-sdk/mcp.md#mcp-tool-search) 預設會延遲這些工具 | 在 [設定工具搜尋](https://code.claude.com/docs/zh-TW/agent-sdk/tool-search.md#configure-tool-search) 所列的情況下，每個 schema 都會預先載入 |

259| **對話歷史記錄** | 在回合中累積 | 隨著每個回合增長：提示、回應、工具輸入、工具輸出 |259| **對話歷史記錄** | 在回合中累積 | 隨著每個回合增長：提示、回應、工具輸入、工具輸出 |

260| **技能描述** | 工作階段開始，透過設定來源 | 簡短摘要；完整內容僅在呼叫時加載 |260| **技能描述** | 工作階段開始，透過設定來源 | 簡短摘要；完整內容僅在呼叫時加載 |

298 298 

299### 鏡像寫入採盡力而為299### 鏡像寫入採盡力而為

300 300 

301如果 `append()` 拒絕，SDK 會以短暫的退避再重試該批次最多兩次，總共最多嘗試三次。逾時的呼叫不會重試，因為原始呼叫可能仍會送達。如果批次仍然失敗，SDK 會將錯誤寫入日誌，向迭代器發出 `{ type: "system", subtype: "mirror_error" }` 訊息，捨棄該批次，並繼續查詢。由於重試的批次可能重新傳遞已經送達的條目，請在您的 `append()` 實作中依 `entry.uuid` 進行去重。301如果 `append()` 拒絕，SDK 會以短暫的退避再重試該批次最多兩次，總共最多嘗試三次。逾時的呼叫不會重試，因為原始呼叫可能仍會送達。由於重試的批次可能重新傳遞已經送達的條目，請在您的 `append()` 實作中依 `entry.uuid` 進行去重，並保留每個沒有 `uuid` 的條目。

302 302 

303儲存區中斷不會中斷 agent，因為子程序會先在本機寫入。如果您需要偵測儲存區資料遺失，請監控 `mirror_error`。在[從儲存區恢復](#resume-from-the-store)的執行中，被捨棄的批次在執行結束後不會留下任何副本。303如果批次仍然失敗，SDK 會將錯誤寫入日誌，向迭代器發出 `{ type: "system", subtype: "mirror_error" }` 訊息，捨棄該批次，並繼續查詢。儲存區中斷不會中斷 agent，因為子程序會先在本機寫入。請監控 `mirror_error` 以偵測儲存區資料遺失。在[從儲存區恢復](#resume-from-the-store)的執行中，被捨棄的批次在執行結束後不會留下任何副本。

304 304 

305### `getSessionMessages` 傳回壓縮後的鏈305### `getSessionMessages` 傳回壓縮後的鏈

306 306 

512 512 

513### 與 Invoke API 並行執行 Mantle513### 與 Invoke API 並行執行 Mantle

514 514 

515您在 Mantle 上可用的模型可能不包括您今天使用的每個模型。設定 `CLAUDE_CODE_USE_BEDROCK` 和 `CLAUDE_CODE_USE_MANTLE` 可讓 Claude Code 從同一工作階段呼叫兩個端點。符合 Mantle 格式的模型 ID 會路由到 Mantle，所有其他模型 ID 會進入 Amazon Bedrock Invoke API。515您在 Mantle 上可用的模型可能不包括您今天使用的每個模型。如果您不透過閘道連線，請同時設定 `CLAUDE_CODE_USE_BEDROCK` 和 `CLAUDE_CODE_USE_MANTLE`，以便從同一工作階段呼叫 Mantle 和 Invoke API。符合 Mantle 格式的模型 ID 會路由到 Mantle，所有其他模型 ID 會進入 Amazon Bedrock Invoke API。

516 516 

517```bash theme={null}517```bash theme={null}

518export CLAUDE_CODE_USE_BEDROCK=1518export CLAUDE_CODE_USE_BEDROCK=1

618* 如果錯誤命名 `bedrock-mantle:` 動作，請授予您的 IAM 身分該動作。618* 如果錯誤命名 `bedrock-mantle:` 動作，請授予您的 IAM 身分該動作。

619* 如果錯誤未命名任何動作且您的認證有效，您的 AWS 帳戶尚未被授予存取您要求的模型的權限。請聯絡您的 AWS 帳戶團隊以要求存取。619* 如果錯誤未命名任何動作且您的認證有效，您的 AWS 帳戶尚未被授予存取您要求的模型的權限。請聯絡您的 AWS 帳戶團隊以要求存取。

620 620 

621命名模型 ID 的 `400` 表示該模型未在 Mantle 上提供。Mantle 有其自己的模型陣容，與標準 Amazon Bedrock 目錄分開，因此推論設定檔 ID（例如 `us.anthropic.claude-sonnet-4-6`）將無法運作。使用 Mantle 格式的 ID，或啟用[兩個端點](#run-mantle-alongside-the-invoke-api)，以便 Claude Code 將推論設定檔 ID 傳送至 Invoke API。621指出模型 ID 的 `400` 表示該模型未在 Mantle 上提供。Mantle 有其自己的模型陣容，與標準 Amazon Bedrock 目錄分開，因此推論設定檔 ID（例如 `us.anthropic.claude-sonnet-4-6`）將無法運作。

622 

623若要排除此錯誤：

624 

625* **不使用閘道時**：使用 Mantle 提供的 [Mantle 格式 ID](#select-a-mantle-model)，或[同時執行 Mantle 與 Invoke API](#run-mantle-alongside-the-invoke-api)，以將其他格式的 ID 傳送至該 API。

626* **透過閘道時**：請向其營運者詢問應使用哪些模型 ID。

622 627 

623## 其他資源628## 其他資源

624 629 

148 148 

149#### 為您的組織關閉 SSH 和 WSL 預覽中的指令碼149#### 為您的組織關閉 SSH 和 WSL 預覽中的指令碼

150 150 

151若要讓 [SSH 和 WSL 工作階段中的 HTML 預覽](#preview-html-files-in-ssh-and-wsl-sessions)不執行指令碼，請將 [`disableBrowserExternalNavigation` 受管設定](#managed-settings)設定為 `true`。使用此設定後，使用者也無法在「瀏覽器」窗格中[瀏覽外部網站](#restrict-external-browsing-for-your-organization)。151若要讓 [SSH 和 WSL 工作階段中的 HTML 預覽](#preview-html-files-in-ssh-and-wsl-sessions)不執行指令碼，請將 [`disableRemotePreviewScripts` 受管設定](#managed-settings)設定為 `true`。使用者仍然可以瀏覽外部網站。需要 Claude Desktop v5.1231.0 或更新版本。

152 152 

153請在您的[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)中設定它，或在執行 Desktop 的電腦上的 [Claude Code MDM 政策或受管設定檔](https://code.claude.com/docs/zh-TW/managed-settings.md#where-each-mechanism-stores-the-policy)中設定它。Desktop 不會從遠端機器或 WSL 發行版讀取此設定。使用[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)時，請使用 MDM 政策或該檔案。153> [!NOTE]

154>

155> 較早的版本會忽略 `disableRemotePreviewScripts`。若要在這些版本中停止指令碼，請更新 Desktop，或同時將 `disableBrowserExternalNavigation` 設定為 `true`。如此一來，在任何接收到 `disableBrowserExternalNavigation` 的電腦上，使用者都[無法瀏覽外部網站](#restrict-external-browsing-for-your-organization)。

156 

157請在您的[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)中設定每個鍵，或在執行 Desktop 的電腦上的 [Claude Code MDM 政策或受管設定檔](https://code.claude.com/docs/zh-TW/managed-settings.md#where-each-mechanism-stores-the-policy)中設定。Desktop 不會從遠端機器、WSL 發行版、[`policyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#policyhelper) 或 [Desktop 自身的政策](#device-management-policies)讀取這些鍵。使用[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)時，請使用 MDM 政策或該檔案。

154 158 

155> [!WARNING]159> [!WARNING]

156>160>

160 164 

161接著請使用者重新啟動 Desktop 以確保設定生效，並告知他們預期的情況：165接著請使用者重新啟動 Desktop 以確保設定生效，並告知他們預期的情況：

162 166 

163* **他們開啟的檔案**：預覽不會執行指令碼，因此由指令碼繪製的圖表和表格會保持空白167* **他們開啟的檔案**：預覽不會執行指令碼，因此由指令碼繪製的圖表和表格會保持空白。其通知以 `This preview doesn't run scripts` 開頭。

164* **正在執行指令碼的預覽**：如果 Desktop 在重新啟動之前就套用了此設定，這些預覽會關閉。使用者會看到 `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`168* **正在執行指令碼的預覽**：如果 Desktop 在重新啟動之前就套用了此設定，這些預覽會關閉。使用者會看到 `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`

165* **他們匯出的檔案**：如果使用者[匯出檔案](#preview-html-files-in-ssh-and-wsl-sessions)並在瀏覽器中開啟，無論是否有此設定，其指令碼都會在那裡執行169* **他們匯出的檔案**：如果使用者[匯出檔案](#preview-html-files-in-ssh-and-wsl-sessions)並在瀏覽器中開啟，無論是否有此設定，其指令碼都會在那裡執行

166 170 

171##### 檢查電腦上是否仍有指令碼在執行

172 

173重新啟動後，在該電腦上從 SSH 或 WSL 工作階段開啟一個 HTML 檔案。如果預覽上方的通知以 `This preview doesn't load anything from the web` 開頭，表示指令碼在該電腦上仍會執行。請檢查 [Desktop 的版本](#check-your-version)、您放置該鍵的位置，以及其值是否為 JSON Boolean `true`。

174 

167### 瀏覽外部網站175### 瀏覽外部網站

168 176 

169「瀏覽器」窗格是一個標籤式瀏覽器，因此您可以在執行中的應用程式旁邊開啟文件、問題追蹤器或任何其他網站。若要開啟「瀏覽器」，請在 macOS 上按 **Cmd+Shift+B**，或在 Windows 上按 **Ctrl+Shift+B**，或點擊工作階段標題列中的**瀏覽器**。您可以登入窗格中的網站，包括彈出式登入流程，例如 Google OAuth。177「瀏覽器」窗格是一個標籤式瀏覽器，因此您可以在執行中的應用程式旁邊開啟文件、問題追蹤器或任何其他網站。若要開啟「瀏覽器」，請在 macOS 上按 **Cmd+Shift+B**，或在 Windows 上按 **Ctrl+Shift+B**，或點擊工作階段標題列中的**瀏覽器**。您可以登入窗格中的網站，包括彈出式登入流程，例如 Google OAuth。

2037| `browserExternalPageTools` | 設定為 `"disabled"` 以防止 Claude 使用工具來讀取或操作[瀏覽器窗格](#browse-external-sites)中的外部頁面。使用者仍然可以自行瀏覽外部網站，本機開發伺服器預覽不受影響。 |2045| `browserExternalPageTools` | 設定為 `"disabled"` 以防止 Claude 使用工具來讀取或操作[瀏覽器窗格](#browse-external-sites)中的外部頁面。使用者仍然可以自行瀏覽外部網站，本機開發伺服器預覽不受影響。 |

2038| `disableMobileSimulatorTools` | 設定為 `true` 以封鎖 Claude 在 [iOS Simulator 窗格](https://code.claude.com/docs/zh-TW/desktop-ios-simulator.md#turn-off-simulator-access)中控制和擷取裝置的工具。該窗格仍可供使用者自行點擊使用；只有 Claude 的存取被移除。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。 |2046| `disableMobileSimulatorTools` | 設定為 `true` 以封鎖 Claude 在 [iOS Simulator 窗格](https://code.claude.com/docs/zh-TW/desktop-ios-simulator.md#turn-off-simulator-access)中控制和擷取裝置的工具。該窗格仍可供使用者自行點擊使用；只有 Claude 的存取被移除。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。 |

2039| `disableBrowserExternalNavigation` | 設定為 `true` 以完全關閉[瀏覽器窗格](#browse-external-sites)中的外部瀏覽。使用者和 Claude 都無法瀏覽外部網站，localhost 開發伺服器預覽不受影響。SSH 和 WSL 工作階段中的 HTML 預覽[不會執行指令碼](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。 |2047| `disableBrowserExternalNavigation` | 設定為 `true` 以完全關閉[瀏覽器窗格](#browse-external-sites)中的外部瀏覽。使用者和 Claude 都無法瀏覽外部網站，localhost 開發伺服器預覽不受影響。SSH 和 WSL 工作階段中的 HTML 預覽[不會執行指令碼](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。 |

2048| `disableRemotePreviewScripts` | 設定為 `true` 以[僅關閉 SSH 和 WSL 工作階段中 HTML 預覽的指令碼](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)。Desktop 不會從遠端機器或 WSL 發行版讀取此鍵。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。需要 Claude Desktop v5.1231.0 或更新版本。 |

2040| `sshConfigs` | 預先設定顯示在環境下拉式選單中的 [SSH 連線](#pre-configure-ssh-connections-for-your-team)。使用者無法刪除受管連線，除了自己的 **Worktree folder** 之外也無法編輯任何內容。 |2049| `sshConfigs` | 預先設定顯示在環境下拉式選單中的 [SSH 連線](#pre-configure-ssh-connections-for-your-team)。使用者無法刪除受管連線，除了自己的 **Worktree folder** 之外也無法編輯任何內容。 |

2041| `sshHostCommands` | 為使用者提供[主機來自命令的 SSH 連線](#distribute-commands-to-your-team)，與使用者自己的連線並存。Desktop 從電腦上的受管設定檔案或 MDM 原則讀取此鍵，並在[伺服器管理的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)中忽略它。需要在 macOS 或 Linux 上使用 Claude Desktop v3.6556.0 或更新版本，或在 Windows 上使用 v4.16336.0 或更新版本，並以 Claude 帳戶登入。在 Windows 上，Desktop 還必須[透過 OpenSSH 用戶端連線](#use-your-ssh-configuration)。 |2050| `sshHostCommands` | 為使用者提供[主機來自命令的 SSH 連線](#distribute-commands-to-your-team)，與使用者自己的連線並存。Desktop 從電腦上的受管設定檔案或 MDM 原則讀取此鍵，並在[伺服器管理的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)中忽略它。需要在 macOS 或 Linux 上使用 Claude Desktop v3.6556.0 或更新版本，或在 Windows 上使用 v4.16336.0 或更新版本，並以 Claude 帳戶登入。在 Windows 上，Desktop 還必須[透過 OpenSSH 用戶端連線](#use-your-ssh-configuration)。 |

2042| `sshHostAllowlist` | 將 [SSH 工作階段](#restrict-which-ssh-hosts-users-can-connect-to)限制在已解析主機名稱符合這些模式之一的主機。僅從受管設定讀取。 |2051| `sshHostAllowlist` | 將 [SSH 工作階段](#restrict-which-ssh-hosts-users-can-connect-to)限制在已解析主機名稱符合這些模式之一的主機。僅從受管設定讀取。 |

2044| `disableSshSavedPasswords` | 設定為 `true` 以停止 Desktop 提供記住 SSH 密碼的選項，並停止使用或顯示先前已儲存的密碼。開啟此設定不會刪除這些密碼。僅從受管設定讀取。需要 Claude Desktop v1.49585.0 或更新版本。 |2053| `disableSshSavedPasswords` | 設定為 `true` 以停止 Desktop 提供記住 SSH 密碼的選項，並停止使用或顯示先前已儲存的密碼。開啟此設定不會刪除這些密碼。僅從受管設定讀取。需要 Claude Desktop v1.49585.0 或更新版本。 |

2045| `managedMcpServers` | 將 MCP 伺服器設定推送給所有使用者。僅在第三方 (3P) Desktop 部署中可用。在每個項目中，設定 `"http"`、`"sse"` 或 `"stdio"` 的傳輸方式、連線詳細資訊，以及可選的 `toolPolicy` 對應，以限制使用者可以叫用該伺服器的哪些工具。請透過受管設定檔案、MDM 或 Claude apps gateway 原則的 [`desktop` 區塊](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#claude-desktop-overlay)傳遞，因為第三方部署不會收到管理員主控台設定。若要透過閘道傳遞，您需要在閘道伺服器上使用 Claude Code v2.1.232 或更新版本。這是桌面應用程式自己的鍵；Claude Code 會讀取自己的[同名受管設定](https://code.claude.com/docs/zh-TW/managed-mcp.md#provide-servers-through-managed-settings)，其項目結構不同。 |2054| `managedMcpServers` | 將 MCP 伺服器設定推送給所有使用者。僅在第三方 (3P) Desktop 部署中可用。在每個項目中，設定 `"http"`、`"sse"` 或 `"stdio"` 的傳輸方式、連線詳細資訊，以及可選的 `toolPolicy` 對應，以限制使用者可以叫用該伺服器的哪些工具。請透過受管設定檔案、MDM 或 Claude apps gateway 原則的 [`desktop` 區塊](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#claude-desktop-overlay)傳遞，因為第三方部署不會收到管理員主控台設定。若要透過閘道傳遞，您需要在閘道伺服器上使用 Claude Code v2.1.232 或更新版本。這是桌面應用程式自己的鍵；Claude Code 會讀取自己的[同名受管設定](https://code.claude.com/docs/zh-TW/managed-mcp.md#provide-servers-through-managed-settings)，其項目結構不同。 |

2046 2055 

2047如果您在電腦的[最高順位 MDM 原則或受管設定檔案](https://code.claude.com/docs/zh-TW/managed-settings.md#how-claude-code-combines-managed-sources)中使用 `browserExternalPageTools`、`disableMobileSimulatorTools` 或 `disableBrowserExternalNavigation` 關閉某項功能，該功能在該電腦上會保持關閉。即使您的[伺服器管理的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)未設定該鍵或允許該功能，它仍會保持關閉。請勿為此使用使用者層級的 `HKCU` 登錄值。若要重新開啟該功能，請在您設定該值的任何位置將其移除。需要 Claude Desktop v4.4212.0 或更新版本。2056如果您在電腦的[最高順位 MDM 原則或受管設定檔案](https://code.claude.com/docs/zh-TW/managed-settings.md#how-claude-code-combines-managed-sources)中使用下列四個鍵之一關閉某項功能，該功能在該電腦上會保持關閉：

2057 

2058* **`browserExternalPageTools`、`disableMobileSimulatorTools`、`disableBrowserExternalNavigation`**：需要 Claude Desktop v4.4212.0 或更新版本

2059* **`disableRemotePreviewScripts`**：需要 Claude Desktop v5.1231.0 或更新版本

2060 

2061即使您的[伺服器管理的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)未設定該鍵或允許該功能，它仍會保持關閉。請勿為此使用使用者層級的 `HKCU` 登錄值。若要重新開啟該功能，請在您設定該值的任何位置將其移除。

2048 2062 

2049哪些受管設定會套用到 Desktop 工作階段，取決於該工作階段執行的位置。模型限制（例如 [`availableModels`](https://code.claude.com/docs/zh-TW/model-config#restrict-model-selection)）在 Desktop 的 Claude Code 工作階段中的強制方式與終端機 CLI 相同；請參閱[使用介面涵蓋範圍](https://code.claude.com/docs/zh-TW/model-config.md#surface-coverage)。2063哪些受管設定會套用到 Desktop 工作階段，取決於該工作階段執行的位置。模型限制（例如 [`availableModels`](https://code.claude.com/docs/zh-TW/model-config#restrict-model-selection)）在 Desktop 的 Claude Code 工作階段中的強制方式與終端機 CLI 相同；請參閱[使用介面涵蓋範圍](https://code.claude.com/docs/zh-TW/model-config.md#surface-coverage)。

2050 2064 

2109>2123>

2110> 部署之前，請先檢查 `forceLoginOrgUUID` 的值。如果該 ID 不是您組織的 ID，您組織中的成員將無法使用 Claude Desktop，除非他們也屬於具有該 ID 的組織。若要復原，請部署正確的 ID，並請他們重新啟動 Claude Desktop。2124> 部署之前，請先檢查 `forceLoginOrgUUID` 的值。如果該 ID 不是您組織的 ID，您組織中的成員將無法使用 Claude Desktop，除非他們也屬於具有該 ID 的組織。若要復原，請部署正確的 ID，並請他們重新啟動 Claude Desktop。

2111 2125 

2112如果您在 Claude Code 的[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)中設定 `forceLoginMethod` 和 `forceLoginOrgUUID`，並不會改變 Claude Desktop 的登入畫面。2126如果您在 Claude Code 的[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)中設定 `forceLoginMethod` 和 `forceLoginOrgUUID`，並不會改變 Claude Desktop 的登入畫面。使用者仍然可以透過自己的 Claude API 金鑰或 [Claude Console 帳戶](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in)使用 Claude Desktop，並以這種方式執行 Code 分頁工作階段。

2127 

2128若要防止這種情況，請同時在 Claude Desktop 原則中（Windows 上位於 `HKLM`）部署 `forceLoginOrgUUID`，並設為您的 claude.ai 組織 ID。除非原則本身[選擇了 Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api#choose-an-authentication-approach)，否則 Claude Desktop 會在應用程式下次啟動時停止使用個人自己的 API 金鑰或 Console 帳戶。

2129 

2130部署之前，請先檢查兩種情況：

2131 

2132* **Claude Console 組織**：請勿單獨以 Claude Console 組織的 ID 部署 `forceLoginOrgUUID`，否則您組織的成員將無法使用 Claude Desktop。請改為參閱[哪些裝置提供 Claude API 帳戶登入](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in)。

2133* **Enterprise Admin Console**：如果它負責傳遞您電腦的 Claude Desktop 設定，請先將這些電腦更新至 Claude Desktop v2.37337.0 或更新版本，因為一旦設定此鍵，較早的版本就會忽略它。請參閱[讓裝置保持使用其受管設定檔](https://claude.com/docs/third-party/claude-desktop/admin-console#keep-a-device-on-its-managed-profile)。

2113 2134 

2114### 網路存取需求2135### 網路存取需求

2115 2136 

5466This conversation is already open in another running Claude session — use that one, or close it and try again5466This conversation is already open in another running Claude session — use that one, or close it and try again

5467```5467```

5468 5468 

5469* **`running in another terminal`**：終端機持有該對話，例如您使用 `claude --resume` 或 `/resume` 繼續它的終端機。列也會顯示 `Open in a terminal`。5469* **`running in another terminal`**：背景工作階段以外的程序持有該對話，例如 `claude -p` 執行，或您使用 `claude --resume` 或 `/resume` 繼續它的終端機。列也會顯示 `Open in a terminal`。

5470* **`already open in another running Claude session`**：另一個非互動式 Claude Code 程序持有它，例如相同對話中尚未退出的[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md#the-supervisor-process)程序。5470* **`already open in another running Claude session`**：另一個[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md#the-supervisor-process)持有它。

5471 5471 

5472**該怎麼做：**5472**該怎麼做：**

5473 5473 

5474* 在開啟該對話的程序中繼續對話，或退出該程序並再次開啟列5474* 對於 `running in another terminal`：在該終端機中繼續，或退出該程序或讓它執行完成，然後再試一次

5475* 對於 `already open in another running Claude session`：使用該工作階段，或將其停止，然後再試一次

5475 5476 

5476在 v2.1.248 之前，只有 `already open in another running Claude session` 拒絕存在：在終端機中繼續的對話不計為開啟，開啟列會啟動寫入相同對話的第二個 Claude Code 程序。5477在 v2.1.248 之前，只有 `already open in another running Claude session` 拒絕存在：在終端機中繼續的對話不計為開啟，開啟列會啟動寫入相同對話的第二個 Claude Code 程序。

5477 5478 

98 98 

99* **Pro、Max 和 Ultra**：您從用量點數中支付快速模式費用。前往 claude.ai 上的 [**設定 > 使用情況**](https://claude.ai/settings/usage)，其中 **用量點數** 部分顯示您本月在用量點數中花費了多少。該數字包括快速模式，但不會單獨列出。99* **Pro、Max 和 Ultra**：您從用量點數中支付快速模式費用。前往 claude.ai 上的 [**設定 > 使用情況**](https://claude.ai/settings/usage)，其中 **用量點數** 部分顯示您本月在用量點數中花費了多少。該數字包括快速模式，但不會單獨列出。

100* **Team 和 Enterprise**：您的組織從其使用額度中支付您的快速模式使用費用。若要查看您自己的使用額度支出，請執行 [`/usage`](https://code.claude.com/docs/zh-TW/costs#check-your-usage-credits-spend)。如需了解您的組織在何處查看該支出，請參閱 [Claude for Teams and Enterprise](https://code.claude.com/docs/zh-TW/costs.md#claude-for-teams-and-enterprise)。100* **Team 和 Enterprise**：您的組織從其使用額度中支付您的快速模式使用費用。若要查看您自己的使用額度支出，請執行 [`/usage`](https://code.claude.com/docs/zh-TW/costs#check-your-usage-credits-spend)。如需了解您的組織在何處查看該支出，請參閱 [Claude for Teams and Enterprise](https://code.claude.com/docs/zh-TW/costs.md#claude-for-teams-and-enterprise)。

101* **Claude Console**：您的組織使用其 API 使用的其餘部分支付快速模式費用。在 Console [使用情況](https://platform.claude.com/usage) 和 [成本](https://platform.claude.com/cost) 頁面上，在 **分組依據** 選單中選擇 **Speed (research preview)** 以將快速模式與標準速度使用分開。只有當選定的日期範圍包括快速模式使用時，您才會看到該選項。101* **Claude Console**：您的組織使用其 API 使用的其餘部分支付快速模式費用。在 Console [使用情況](https://platform.claude.com/usage) 和 [成本](https://platform.claude.com/cost) 頁面上，在 **分組依據** 選單中選擇 **Speed** 以將快速模式與標準速度使用分開。只有當選定的日期範圍包括快速模式使用時，您才會看到該選項。

102 102 

103## 決定何時使用快速模式103## 決定何時使用快速模式

104 104 

218 218 

219## 內建於 Claude Code 的 Mods219## 內建於 Claude Code 的 Mods

220 220 

221Claude Code 的某些功能是 mods。若要查看您的工作階段擁有的功能，請在 Claude Code 提示處執行 `/plugin` 並前往**已安裝**標籤，該標籤在**內建**下列出它們。您無法更新或解除安裝內建 mod，表格的最後一欄說明如何關閉每一個。[`mods active` 行](#see-which-mods-a-session-loaded)排除內建 mods。221Claude Code 自身的某些功能是 mod。若要查看您的工作階段擁有的 mod，請在 Claude Code 提示處執行 `/plugin` 並前往**已安裝**標籤，該標籤在**內建**下列出它們。您無法更新或解除安裝內建 mod。[`mods active` 行](#see-which-mods-a-session-loaded)排除內建 mod。

222 222 

223此表按 `/plugin` 顯示的名稱列出每個項目：223此表按 `/plugin` 顯示的名稱列出部分**內建**項目：

224 224 

225| `/plugin` 中的名稱 | 它的功能 | 它在哪裡開啟 | 如何關閉它 |225| `/plugin` 中的名稱 | 它的功能 | 它在哪裡開啟 | 如何關閉它 |

226| :- | :- | :- | :- |226| :- | :- | :- | :- |

231| `cc-plugin-telemetry` | 傳送 Claude Code 及其內建 mods 記錄的分析記錄 | 無論 Claude Code 自己的分析在哪裡開啟 | 在 `/plugin` 中停用它，或關閉分析，例如使用 [`DISABLE_TELEMETRY`](https://code.claude.com/docs/zh-TW/env-vars) |231| `cc-plugin-telemetry` | 傳送 Claude Code 及其內建 mods 記錄的分析記錄 | 無論 Claude Code 自己的分析在哪裡開啟 | 在 `/plugin` 中停用它，或關閉分析，例如使用 [`DISABLE_TELEMETRY`](https://code.claude.com/docs/zh-TW/env-vars) |

232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/zh-TW/interactive-mode.md#you-should-know-suggestions)：當側邊 agent 發現您可能錯過的內容時，會在提示上方顯示一則備註 | 保持關閉，直到您[將其開啟](https://code.claude.com/docs/zh-TW/interactive-mode.md#you-should-know-suggestions) | 在 `/plugin` 中停用它 |232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/zh-TW/interactive-mode.md#you-should-know-suggestions)：當側邊 agent 發現您可能錯過的內容時，會在提示上方顯示一則備註 | 保持關閉，直到您[將其開啟](https://code.claude.com/docs/zh-TW/interactive-mode.md#you-should-know-suggestions) | 在 `/plugin` 中停用它 |

233 233 

234對於不在表中的**內建**外掛，請[在 `/plugin` 中開啟其詳細資訊](https://code.claude.com/docs/zh-TW/plugins/install#manage-installed-plugins)，以了解其功能或將其停用。

235 

234停止已安裝 mods 的設定和旗標，例如 `disableAllHooks`、`--bare` 和 `--safe-mode`，不會停止內建 mods。236停止已安裝 mods 的設定和旗標，例如 `disableAllHooks`、`--bare` 和 `--safe-mode`，不會停止內建 mods。

235 237 

236### 讀取內建 mods 的來源238### 讀取內建 mods 的來源

194| `session.receive` | `($, e) => ({ text: e.text })`。使用 `$.session.receive({ origin: { kind: 'peer-send-message' }, text })` 觸發它。 |194| `session.receive` | `($, e) => ({ text: e.text })`。使用 `$.session.receive({ origin: { kind: 'peer-send-message' }, text })` 觸發它。 |

195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |

196 196 

197`expect` 有斷言 `toBe`、`toEqual`、`toMatch`、`toMatchObject`、`toContain`、`toBeDefined`、`toBeUndefined` 和 `toThrow`，以及任何斷言之前的 `.not`。197### 使用 `expect` 檢查結果

198 

199套件提供以下斷言，您選用的斷言放在要檢查的值之後，例如 `expect(answer.text).toBe('ok')`：

200 

201* **相等**：`toBe` 用於相同的值或物件，`toEqual` 用於結構，`toStrictEqual` 用於結構加上 `undefined` 欄位與原型，`toMatchObject` 用於您指定的欄位

202* **文字**：`toMatch`（接受正規表示式或子字串）、`toStartWith` 和 `toEndWith`

203* **數字**：`toBeGreaterThan`、`toBeGreaterThanOrEqual`、`toBeLessThan`、`toBeLessThanOrEqual`

204* **內容**：`toContain` 用於子字串或成員，`toContainEqual` 用於依結構比較的成員，以及 `toHaveLength` 和 `toHaveProperty`

205* **存在與型別**：`toBeDefined`、`toBeUndefined`、`toBeNull`、`toBeTruthy`、`toBeFalsy`、`toBeNaN`、`toBeInstanceOf`

206* **拋出**：`toThrow`，用於由 `expect` 呼叫的函式，或用於您以 `.rejects` 檢查的 promise

207 

208在斷言前加上 `.not` 可檢查相反的情況，加上 `.resolves` 或 `.rejects` 則可檢查 promise 最終的結果。

198 209 

199當 `expect` 在您以一般函數（而非非同步生成器）傳給 `on` 的 stub 或 hook 內失敗時，測試會失敗。引擎會跳過該 hook，失敗輸出會指出它，例如 `in the test's store.set hook`。210當 `expect` 在您以一般函數（而非非同步生成器）傳給 `on` 的 stub 或 hook 內失敗時，測試會失敗。引擎會跳過該 hook，失敗輸出會指出它，例如 `in the test's store.set hook`。

200 211 

26| 專案上下文 | CLAUDE.md、自動記憶、未限定範圍的規則 | 工作階段開始時，或在 `/clear` 或 `/compact` 之後 |26| 專案上下文 | CLAUDE.md、自動記憶、未限定範圍的規則 | 工作階段開始時，或在 `/clear` 或 `/compact` 之後 |

27| 對話 | 您的訊息、Claude 的回應、工具結果 | 每個回合 |27| 對話 | 您的訊息、Claude 的回應、工具結果 | 每個回合 |

28 28 

29對對話層的變更會保留系統提示詞和專案上下文的快取。對系統提示詞的變更會使所有內容失效，因為所有後續內容現在位於不同的前綴後面。第三欄提供常見的觸發器，而不是詳盡的清單，下面的章節涵蓋完整的集合。29在對話層新增內容會保留系統提示詞和專案上下文的快取。對系統提示詞的變更會使所有內容失效，因為所有後續內容現在位於不同的前綴後面。第三欄提供常見的觸發器，而不是詳盡的清單，下面的章節涵蓋完整的集合。

30 30 

31前綴比對規則解釋了此頁面上的大多數行為。例如，[plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 和 [skill loading](https://code.claude.com/docs/zh-TW/skills.md) 會將其指示附加為對話訊息，因此快取的前綴保持完整。31前綴比對規則解釋了此頁面上的大多數行為。例如，[plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 和 [skill loading](https://code.claude.com/docs/zh-TW/skills.md) 會將其指示附加為對話訊息，因此快取的前綴保持完整。

32 32 

174 174 

175### 壓縮對話175### 壓縮對話

176 176 

177[壓縮](https://code.claude.com/docs/zh-TW/context-window.md#what-survives-compaction)會用摘要取代您的訊息歷史記錄。根據設計，這會使對話層失效：下一個請求具有新的、較短的歷史記錄，不與舊歷史記錄共享前綴。系統提示詞層和專案上下文層可以保持快取：177[壓縮](https://code.claude.com/docs/zh-TW/context-window.md#what-survives-compaction)會用摘要取代您的訊息歷史記錄。根據設計，這會使對話層失效：下一個請求具有新的、較短的歷史記錄，不與舊歷史記錄共享前綴。

178 178 

179* **系統提示詞**：下一個請求會從快取讀取此層，除非[繼續的對話](#resuming-a-session)保留了現已過時的系統提示詞。該對話第一次被壓縮時，Claude Code 會將其切換為目前的提示詞，下一個請求會重建此層的快取一次。179* **系統提示詞**：下一個請求會從快取讀取此層，除非[繼續的對話](#resuming-a-session)保留了現已過時的系統提示詞。該對話第一次被壓縮時，Claude Code 會將其切換為目前的提示詞，下一個請求會重建此層的快取一次。

180* **專案上下文**：Claude Code 會從磁碟重新載入此層。只有在工作階段開始以來 CLAUDE.md 和記憶未變更時，下一個請求才會從快取讀取它。180* **專案上下文**：Claude Code 會從磁碟重新載入此層。它與對話一起快取，因此在 `/compact` 或自動壓縮之後，即使其檔案未變更，其快取也會重建。

181 181 

182為了產生摘要，Claude Code 會傳送一個單獨的請求。該請求會重複您對話的系統提示詞、工具以及要摘要的歷史記錄，並以一則摘要指令作結。當快取溫暖時，該請求會從快取讀取您的前綴。因此，工作階段中途的 `/compact` 成本只是上下文大小所暗示的一小部分，並且大部分時間花在產生摘要上。182為了產生摘要，Claude Code 會傳送一個單獨的請求。該請求會重複您對話的系統提示詞、工具以及要摘要的歷史記錄，並以一則摘要指令作結。當快取溫暖時，該請求會從快取讀取您的前綴。因此，工作階段中途的 `/compact` 成本只是上下文大小所暗示的一小部分，並且大部分時間花在產生摘要上。

183 183 

184在超過[快取生命週期](#cache-lifetime)的中斷後，沒有快取可讀取，因此摘要請求會將該歷史記錄重新處理為未快取的輸入。這就是為什麼當您[繼續舊工作階段](https://code.claude.com/docs/zh-TW/sessions.md#resume-a-session)時 `/compact` 成本最高。在溫暖和冷的情況下，壓縮後的回合只會為更短的摘要重建對話快取，因此該回合不是較慢的部分。184在超過[快取生命週期](#cache-lifetime)的中斷後，沒有快取可讀取，因此摘要請求會將該歷史記錄重新處理為未快取的輸入。這就是為什麼當您[繼續舊工作階段](https://code.claude.com/docs/zh-TW/sessions.md#resume-a-session)時 `/compact` 成本最高。在溫暖和冷的情況下，壓縮後的回合只會為短得多的歷史記錄重建對話快取，因此該回合不是較慢的部分。

185 185 

186> [!TIP]186> [!TIP]

187>187>

31>31>

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

33>33>

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}34> ```bash 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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}42> ```powershell 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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}48> ```batch 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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}66> ```bash 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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}78> ```powershell theme={null}

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

80> ```80> ```

81>81>

86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | 拒絕專案 [`.mcp.json`](https://code.claude.com/docs/zh-TW/mcp#project-scope) 中的特定伺服器 | MCP | 任何檔案 |86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | 拒絕專案 [`.mcp.json`](https://code.claude.com/docs/zh-TW/mcp#project-scope) 中的特定伺服器 | MCP | 任何檔案 |

87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | 在[桌面版](https://code.claude.com/docs/zh-TW/desktop.md) iOS Simulator 窗格中封鎖 Claude 的工具 | 工具 | 受管 |87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | 在[桌面版](https://code.claude.com/docs/zh-TW/desktop.md) iOS Simulator 窗格中封鎖 Claude 的工具 | 工具 | 受管 |

88| [`disableRemoteControl`](#disableremotecontrol) | 在所有可啟動 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md) 的地方將其關閉 | 遠端、桌面與通知 | 任何檔案 |88| [`disableRemoteControl`](#disableremotecontrol) | 在所有可啟動 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md) 的地方將其關閉 | 遠端、桌面與通知 | 任何檔案 |

89| [`disableRemotePreviewScripts`](#disableremotepreviewscripts) | 關閉[桌面版](https://code.claude.com/docs/zh-TW/desktop.md#preview-html-files-in-ssh-and-wsl-sessions)應用程式在 SSH 和 WSL 工作階段中 HTML 預覽內的指令碼 | 遠端、桌面與通知 | 受管 |

89| [`disableSideloadFlags`](#disablesideloadflags) | 拒絕側載[外掛](https://code.claude.com/docs/zh-TW/plugins/overview.md)、[subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 和 [MCP 伺服器](https://code.claude.com/docs/zh-TW/mcp.md)的 CLI 旗標 | 企業與受管設定 | 受管 |90| [`disableSideloadFlags`](#disablesideloadflags) | 拒絕側載[外掛](https://code.claude.com/docs/zh-TW/plugins/overview.md)、[subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 和 [MCP 伺服器](https://code.claude.com/docs/zh-TW/mcp.md)的 CLI 旗標 | 企業與受管設定 | 受管 |

90| [`disableSkillShellExecution`](#disableskillshellexecution) | 阻止 [skill](https://code.claude.com/docs/zh-TW/skills.md) 和自訂命令執行內嵌 shell | 外掛與 skill | 任何檔案 |91| [`disableSkillShellExecution`](#disableskillshellexecution) | 阻止 [skill](https://code.claude.com/docs/zh-TW/skills.md) 和自訂命令執行內嵌 shell | 外掛與 skill | 任何檔案 |

91| [`disableWorkflows`](#disableworkflows) | 為所有人關閉[動態工作流程](https://code.claude.com/docs/zh-TW/workflows.md)；若只針對您自己，請使用 `enableWorkflows` | Hook 與自動化 | 任何檔案 |92| [`disableWorkflows`](#disableworkflows) | 為所有人關閉[動態工作流程](https://code.claude.com/docs/zh-TW/workflows.md)；若只針對您自己，請使用 `enableWorkflows` | Hook 與自動化 | 任何檔案 |

147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | 讓 `Write`、`Edit` 和 `NotebookEdit` 工具在每種權限模式下都拒絕[工作目錄](https://code.claude.com/docs/zh-TW/permissions.md#working-directories)以外的路徑，但 [Claude Code 本身的部分檔案](#what-the-write-block-refuses-and-what-stays-writable)除外 | 權限設定 | 任何檔案 |148| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | 讓 `Write`、`Edit` 和 `NotebookEdit` 工具在每種權限模式下都拒絕[工作目錄](https://code.claude.com/docs/zh-TW/permissions.md#working-directories)以外的路徑，但 [Claude Code 本身的部分檔案](#what-the-write-block-refuses-and-what-stays-writable)除外 | 權限設定 | 任何檔案 |

148| [`permissions.defaultMode`](#permissions-defaultmode) | 設定新工作階段的預設[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md#which-mode-a-session-starts-in) | 權限設定 | 任何檔案 |149| [`permissions.defaultMode`](#permissions-defaultmode) | 設定新工作階段的預設[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md#which-mode-a-session-starts-in) | 權限設定 | 任何檔案 |

149| [`permissions.deny`](#permissions-deny) | 封鎖列出的[工具使用](https://code.claude.com/docs/zh-TW/permissions.md#permission-rule-syntax)，包括讀取存放機密的檔案 | 權限設定 | 任何檔案 |150| [`permissions.deny`](#permissions-deny) | 封鎖列出的[工具使用](https://code.claude.com/docs/zh-TW/permissions.md#permission-rule-syntax)，包括讀取存放機密的檔案 | 權限設定 | 任何檔案 |

151| [`permissions.denyInsteadOfPrompting`](#permissions-denyinsteadofprompting) | 拒絕會等待[權限提示](https://code.claude.com/docs/zh-TW/permissions.md#permission-system)的工具呼叫，讓無人看管的工作階段能持續運作 | 權限設定 | 使用者或受管 |

150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 防止任何人進入 [bypassPermissions 模式](https://code.claude.com/docs/zh-TW/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | 權限設定 | 任何檔案 |152| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 防止任何人進入 [bypassPermissions 模式](https://code.claude.com/docs/zh-TW/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | 權限設定 | 任何檔案 |

151| [`plansDirectory`](#plansdirectory) | 選擇 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 寫入計畫檔案的位置 | 記憶與上下文 | 任何檔案 |153| [`plansDirectory`](#plansdirectory) | 選擇 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 寫入計畫檔案的位置 | 記憶與上下文 | 任何檔案 |

152| [`pluginConfigs`](#pluginconfigs) | 儲存您在[外掛](https://code.claude.com/docs/zh-TW/plugins/overview.md)設定對話方塊中提供的答案 | 外掛與 skill | 使用者或受管 |154| [`pluginConfigs`](#pluginconfigs) | 儲存您在[外掛](https://code.claude.com/docs/zh-TW/plugins/overview.md)設定對話方塊中提供的答案 | 外掛與 skill | 使用者或受管 |

228| [`statusLine`](#statusline) | 執行您自己的命令，在提示下方呈現[狀態列](https://code.claude.com/docs/zh-TW/statusline.md) | 介面與終端機 | 任何檔案 |230| [`statusLine`](#statusline) | 執行您自己的命令，在提示下方呈現[狀態列](https://code.claude.com/docs/zh-TW/statusline.md) | 介面與終端機 | 任何檔案 |

229| [`strictKnownMarketplaces`](#strictknownmarketplaces) | 以允許清單限定使用者可以新增並從中安裝的[市集](https://code.claude.com/docs/zh-TW/plugins/overview.md)來源 | 外掛與 skill | 受管 |231| [`strictKnownMarketplaces`](#strictknownmarketplaces) | 以允許清單限定使用者可以新增並從中安裝的[市集](https://code.claude.com/docs/zh-TW/plugins/overview.md)來源 | 外掛與 skill | 受管 |

230| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | 封鎖來自使用者和專案來源的 [skill](https://code.claude.com/docs/zh-TW/skills.md)、[agent](https://code.claude.com/docs/zh-TW/sub-agents.md)、[hook](https://code.claude.com/docs/zh-TW/hooks.md) 和 [MCP 伺服器](https://code.claude.com/docs/zh-TW/mcp.md) | 外掛與 skill | 受管 |232| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | 封鎖來自使用者和專案來源的 [skill](https://code.claude.com/docs/zh-TW/skills.md)、[agent](https://code.claude.com/docs/zh-TW/sub-agents.md)、[hook](https://code.claude.com/docs/zh-TW/hooks.md) 和 [MCP 伺服器](https://code.claude.com/docs/zh-TW/mcp.md) | 外掛與 skill | 受管 |

231| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | 將 [agent](https://code.claude.com/docs/zh-TW/sub-agents.md) 鎖定為外掛和受管來源 | 外掛與 skill | 受管 |233| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | 封鎖來自使用者和專案來源的 [agent](https://code.claude.com/docs/zh-TW/sub-agents.md) | 外掛與 skill | 受管 |

232| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | 將 [hook](https://code.claude.com/docs/zh-TW/hooks.md) 鎖定為外掛和受管來源 | 外掛與 skill | 受管 |234| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | 封鎖來自使用者和專案來源的 [hook](https://code.claude.com/docs/zh-TW/hooks.md) | 外掛與 skill | 受管 |

233| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | 將 [MCP 伺服器](https://code.claude.com/docs/zh-TW/mcp.md)鎖定為外掛和受管來源 | 外掛與 skill | 受管 |235| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | 封鎖來自使用者和專案來源的 [MCP 伺服器](https://code.claude.com/docs/zh-TW/mcp.md) | 外掛與 skill | 受管 |

234| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | 將 [skill](https://code.claude.com/docs/zh-TW/skills.md) 鎖定為外掛和受管來源 | 外掛與 skill | 受管 |236| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | 封鎖來自使用者和專案來源的 [skill](https://code.claude.com/docs/zh-TW/skills.md) | 外掛與 skill | 受管 |

235| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | 選擇 subagent 及主要對話以外其他請求的[提示快取存留期](https://code.claude.com/docs/zh-TW/prompt-caching.md#cache-lifetime) | 模型與回應 | 任何檔案 |237| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | 選擇 subagent 及主要對話以外其他請求的[提示快取存留期](https://code.claude.com/docs/zh-TW/prompt-caching.md#cache-lifetime) | 模型與回應 | 任何檔案 |

236| [`subagentStatusLine`](#subagentstatusline) | 使用您自己的命令改寫 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 工作顯示中的列 | 介面與終端機 | 任何檔案 |238| [`subagentStatusLine`](#subagentstatusline) | 使用您自己的命令改寫 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 工作顯示中的列 | 介面與終端機 | 任何檔案 |

237| [`switchModelsOnFlag`](#switchmodelsonflag) | 在[安全分類器](https://code.claude.com/docs/zh-TW/model-config.md#ask-before-switching)標記請求時自動切換模型或暫停 | 模型與回應 | 任何檔案 |239| [`switchModelsOnFlag`](#switchmodelsonflag) | 在[安全分類器](https://code.claude.com/docs/zh-TW/model-config.md#ask-before-switching)標記請求時自動切換模型或暫停 | 模型與回應 | 任何檔案 |

288}290}

289```291```

290 292 

291在 advisor [無法使用](https://code.claude.com/docs/zh-TW/advisor.md#requirements)的供應商上，此鍵不會產生作用，例如 Amazon Bedrock 和 Claude Platform on AWS。`"fable"` 需要 [Fable 存取權](https://code.claude.com/docs/zh-TW/advisor.md#choose-an-advisor-model)。293在 advisor [無法使用](https://code.claude.com/docs/zh-TW/advisor.md#requirements)的供應商上，此鍵不會產生作用，例如 Amazon Bedrock。在 Claude Platform on AWS 上，此鍵需要 Claude Code v2.1.300 或更新版本。`"fable"` 需要 [Fable 存取權](https://code.claude.com/docs/zh-TW/advisor.md#choose-an-advisor-model)。

292 294 

293### `alwaysThinkingEnabled`295### `alwaysThinkingEnabled`

294 296 

448 450 

449在可使用[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)的工作階段中開啟快速模式，適用於快速迭代或即時除錯等互動式工作，讓您以較高的每 token 成本換取速度。通常不需要手動編輯此鍵。執行 `/fast` 會將 `fastMode: true` 寫入 `~/.claude/settings.json`，再次執行以關閉快速模式則會移除此鍵。451在可使用[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)的工作階段中開啟快速模式，適用於快速迭代或即時除錯等互動式工作，讓您以較高的每 token 成本換取速度。通常不需要手動編輯此鍵。執行 `/fast` 會將 `fastMode: true` 寫入 `~/.claude/settings.json`，再次執行以關閉快速模式則會移除此鍵。

450 452 

451只有 Fable 5.2、Opus 5.5、Opus 5 和 Opus 4.8 支援快速模式。從其他模型執行 `/fast` 會將您切換至 Opus，而切換至不支援的模型則會關閉快速模式。請參閱[在快速模式開啟時切換模型](https://code.claude.com/docs/zh-TW/fast-mode.md#switch-models-while-fast-mode-is-on)。453在 Anthropic API 上，只有 Fable 5.2、Opus 5.5、Opus 5 和 Opus 4.8 支援快速模式。從其他模型執行 `/fast` 會將您切換至 Opus，而切換至不支援的模型則會關閉快速模式。請參閱[在快速模式開啟時切換模型](https://code.claude.com/docs/zh-TW/fast-mode.md#switch-models-while-fast-mode-is-on)。在 Google Cloud's Agent Platform 上，[`/fast` 會改為將您切換至 Fable 5.2](https://code.claude.com/docs/zh-TW/fast-mode#use-fast-mode-on-agent-platform)，且不會寫入此鍵，而 Claude Code 會忽略已儲存的 `true`。

452 454 

453* **範圍**：[`Any file`](#scopes)455* **範圍**：[`Any file`](#scopes)

454* **類型**：Boolean456* **類型**：Boolean

904控制 Claude 可以在不詢問的情況下使用哪些工具、哪些工具會提示，以及哪些工具被封鎖。也可設定新工作階段的預設[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)。下面的每個 `permissions.*` 設定鍵都巢狀在此物件下。906控制 Claude 可以在不詢問的情況下使用哪些工具、哪些工具會提示，以及哪些工具被封鎖。也可設定新工作階段的預設[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)。下面的每個 `permissions.*` 設定鍵都巢狀在此物件下。

905 907 

906* **範圍**：[`Any file`](#scopes)908* **範圍**：[`Any file`](#scopes)

907* **類型**：物件，包含 `allow`、`ask`、`deny`、`additionalDirectories`、`blockReadsOutsideWorkingDirectories`、`blockWritesOutsideWorkingDirectories`、`defaultMode`、`disableBypassPermissionsMode` 和 `disableAutoMode`909* **類型**：物件，包含 `allow`、`ask`、`deny`、`additionalDirectories`、`blockReadsOutsideWorkingDirectories`、`blockWritesOutsideWorkingDirectories`、`defaultMode`、`denyInsteadOfPrompting`、`disableBypassPermissionsMode` 和 `disableAutoMode`

908* **預設值**：未設定910* **預設值**：未設定

909 911 

910此範例在不詢問的情況下核准 `npm run` 命令，在 `git push` 前提示，封鎖 `.env` 的讀取，並以 `acceptEdits` 啟動工作階段：912此範例在不詢問的情況下核准 `npm run` 命令，在 `git push` 前提示，封鎖 `.env` 的讀取，並以 `acceptEdits` 啟動工作階段：

1163 1165 

1164權限規則分層在每個模式之上：`deny` 規則在每個模式中封鎖，包括 `bypassPermissions`。請參閱[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)。在雲端工作階段中，Claude Code 只從此設定鍵中接受 `acceptEdits`、`plan`、`default` 和 `auto`。對於 VS Code 擴充功能啟動的對話，請參閱[擴充功能為啟動權限模式讀取的設定](https://code.claude.com/docs/zh-TW/permission-modes.md#switch-permission-modes)。1166權限規則分層在每個模式之上：`deny` 規則在每個模式中封鎖，包括 `bypassPermissions`。請參閱[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)。在雲端工作階段中，Claude Code 只從此設定鍵中接受 `acceptEdits`、`plan`、`default` 和 `auto`。對於 VS Code 擴充功能啟動的對話，請參閱[擴充功能為啟動權限模式讀取的設定](https://code.claude.com/docs/zh-TW/permission-modes.md#switch-permission-modes)。

1165 1167 

1168### `permissions.denyInsteadOfPrompting`

1169 

1170將此設定為 `true`，可在沒有人能回應權限提示時讓工作階段持續執行。Claude Code 會拒絕原本會等待提示的工具呼叫，且該回合會繼續進行。需要 Claude Code v2.1.319 或更新版本。

1171 

1172如果允許規則、您的[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)或自動模式的分類器核准某個呼叫，該呼叫就會執行。若要允許大多數原本會提示的呼叫，請從 [`PermissionRequest` hook](https://code.claude.com/docs/zh-TW/hooks#permissionrequest) 回應。

1173 

1174* **範圍**：[`User or managed`](#scopes)，以及 `--settings`。儲存庫無法為您設定它。

1175* **類型**：布林值

1176 * `true`：Claude Code 拒絕原本會提示的呼叫

1177 * `false`：與未設定相同；如果這些來源中的另一個設定 `true`，呼叫仍會被拒絕

1178* **預設值**：未設定，因此需要核准的呼叫會提示您

1179 

1180在 `~/.claude/settings.json` 中，此範例以自動模式啟動工作階段，並拒絕任何仍會退回到提示的操作：

1181 

1182```json settings.json theme={null}

1183{

1184 "permissions": {

1185 "defaultMode": "auto",

1186 "denyInsteadOfPrompting": true

1187 }

1188}

1189```

1190 

1191此設定鍵適用於 `-p` 執行、互動式終端機工作階段、[VS Code 擴充功能](https://code.claude.com/docs/zh-TW/vs-code.md)、[Desktop 應用程式](https://code.claude.com/docs/zh-TW/desktop.md)中的本機工作階段、[subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 和 [agent team](https://code.claude.com/docs/zh-TW/agent-teams.md)。若要改為只在單一[非互動式](https://code.claude.com/docs/zh-TW/headless.md)執行中拒絕會提示的操作，請搭配 `-p` 傳入 [`--permission-prompts none`](https://code.claude.com/docs/zh-TW/headless#turn-off-permission-prompts-in-unattended-runs)。

1192 

1193#### `denyInsteadOfPrompting` 還會停止哪些項目

1194 

1195開啟此設定後，Claude Code 也會停止下列需要回應的請求：

1196 

1197* **問題和計畫工具**：Claude Code 會省略 [`AskUserQuestion`](https://code.claude.com/docs/zh-TW/tools-reference#askuserquestion-tool-behavior)、`EnterPlanMode` 和 `ExitPlanMode`，因此處於 plan mode 的工作階段無法自行離開。agent team 中的隊員會保留 `EnterPlanMode` 和 `ExitPlanMode`

1198* **MCP elicitation**：Claude Code 會取消 [elicitation 請求](https://code.claude.com/docs/zh-TW/mcp.md#respond-to-mcp-elicitation-requests)，除非有 [`Elicitation` hook](https://code.claude.com/docs/zh-TW/hooks#elicitation) 回應它

1199* **權限主機**：Claude Code 不會詢問您的 [`canUseTool` 回呼](https://code.claude.com/docs/zh-TW/agent-sdk/user-input)或 [`--permission-prompt-tool`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags)。若要從程式碼核准呼叫，請從 `PermissionRequest` hook 回應。有些呼叫會在詢問任何 hook 之前就被拒絕，例如 `auto` 模式中沒有任何 ask 規則涵蓋的[關鍵路徑移除](https://code.claude.com/docs/zh-TW/permission-modes.md#critical-path-removals-in-each-permission-mode)。

1200* **分類器計費通知**：在[關於計費分類器請求的通知](https://code.claude.com/docs/zh-TW/auto-mode-classifier-billing.md)會開啟對話框的情況下，Claude Code 不會顯示它，並拒絕需要這些請求的操作

1201 

1202工作階段仍可能等待[工作區信任對話](https://code.claude.com/docs/zh-TW/permissions.md#project-allow-rules-and-workspace-trust)和[專案 MCP 伺服器核准](https://code.claude.com/docs/zh-TW/mcp.md#project-server-approvals-and-workspace-trust)。在讓工作階段持續執行之前，請先回應這兩者。

1203 

1204#### 來自 `denyInsteadOfPrompting` 的訊息

1205 

1206這些訊息回報被拒絕的呼叫。它們不是提示，因此不會有任何東西等待您的回應。

1207 

1208Claude 讀取的拒絕訊息可能以下列文字開頭：

1209 

1210```text theme={null}

1211Permission for this tool use was denied. It requires approval, and this session has no approval surface

1212```

1213 

1214在 `stream-json` 輸出中，[發出 `permission_denied` 訊息的執行](https://code.claude.com/docs/zh-TW/agent-sdk/typescript#sdkpermissiondeniedmessage)會回報此 `decision_reason`：

1215 

1216```text theme={null}

1217no approval surface in this session; permission request denied automatically

1218```

1219 

1220在開啟此設定的自動模式中，當連續 20 個呼叫被分類器封鎖或被[安全檢查拒絕](https://code.claude.com/docs/zh-TW/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)後，該回合就會結束，且您會看到此訊息：

1221 

1222```text theme={null}

122320 actions were refused and no work went ahead in between, so Claude stopped.

1224```

1225 

1226`-p` 執行會將該回合回報為 `error_during_execution`。

1227 

1166### `permissions.disableBypassPermissionsMode`1228### `permissions.disableBypassPermissionsMode`

1167 1229 

1168防止任何人進入 `bypassPermissions` 模式。Claude Code 隨後會拒絕 `--dangerously-skip-permissions` 旗標，並忽略 [agent 定義](https://code.claude.com/docs/zh-TW/sub-agents.md#permission-modes)中的 `permissionMode: bypassPermissions`，因此 subagent 會以父工作階段的權限模式執行。1230防止任何人進入 `bypassPermissions` 模式。Claude Code 隨後會拒絕 `--dangerously-skip-permissions` 旗標，並忽略 [agent 定義](https://code.claude.com/docs/zh-TW/sub-agents.md#permission-modes)中的 `permissionMode: bypassPermissions`，因此 subagent 會以父工作階段的權限模式執行。

1202 1264 

1203跳過 Claude Code 在工作階段進入 `bypassPermissions` 模式前顯示的確認對話，無論是來自 `--dangerously-skip-permissions` 還是 `defaultMode: "bypassPermissions"`。當您接受該對話一次時，Claude Code 會在您的使用者設定中寫入 `true`。1265跳過 Claude Code 在工作階段進入 `bypassPermissions` 模式前顯示的確認對話，無論是來自 `--dangerously-skip-permissions` 還是 `defaultMode: "bypassPermissions"`。當您接受該對話一次時，Claude Code 會在您的使用者設定中寫入 `true`。

1204 1266 

1205* **範圍**：[`User, local, or managed`](#scopes)。不受信任的儲存庫無法為您跳過對話。1267* **範圍**：[`User, local, or managed`](#scopes)，以及以 `--settings` 傳入的檔案。[背景工作階段](https://code.claude.com/docs/zh-TW/permission-modes.md#bypass-permissions-ignored-in-a-background-session)只計入使用者和受管設定。不受信任的儲存庫無法為您跳過對話。

1206* **類型**：布林值1268* **類型**：布林值

1207 * `true`：Claude Code 在工作階段進入 `bypassPermissions` 模式前跳過確認對話1269 * `true`：Claude Code 在工作階段進入 `bypassPermissions` 模式前跳過確認對話

1208 * `false`：與未設定相同；除非這些檔案中的另一個設定 `true`，否則對話會出現1270 * `false`：與未設定相同；除非這些檔案中的另一個設定 `true`，否則對話會出現

3132 3194 

3133### `syntaxHighlightingDisabled`3195### `syntaxHighlightingDisabled`

3134 3196 

3135Claude Code 會以其內建的語法突顯器，依語言為終端機中顯示的差異、程式碼區塊與檔案預覽上色；不涉及任何外掛或語言伺服器。將此設定鍵設為 `true` 即可改以純文字顯示，例如當色彩與您的終端機主題衝突或拖慢螢幕閱讀器時。3197Claude Code 會以其內建的語法突顯器，依語言為終端機中顯示的差異、程式碼區塊與檔案預覽上色。將此設定鍵設為 `true` 即可改以純文字顯示，例如當色彩與您的終端機主題衝突或拖慢螢幕閱讀器時。

3136 3198 

3137* **範圍**：[`Any file`](#scopes)3199* **範圍**：[`Any file`](#scopes)

3138* **類型**：Boolean3200* **類型**：Boolean

4110 4172 

4111### `strictPluginOnlyCustomization`4173### `strictPluginOnlyCustomization`

4112 4174 

4113阻止 skills、agents、hooks 和 MCP 伺服器來自使用者和專案來源，因此它們只能來自 plugins 或受管設定。將其與 [`strictKnownMarketplaces`](#strictknownmarketplaces) 結合以控制完整的自訂供應鏈：marketplace 允許清單控制使用者可以安裝哪些 plugins。4175阻止來自使用者和專案來源的 skills、agents、hooks 和 MCP 伺服器。將其與 [`strictKnownMarketplaces`](#strictknownmarketplaces) 結合，以選擇使用者可以從哪些 marketplaces 安裝 plugins。新增 [`disableSideloadFlags`](#disablesideloadflags) 以拒絕在單次執行中側載 plugins、agents 和 MCP 伺服器的 CLI 旗標。

4114 4176 

4115* **Scope**: [`Managed`](#scopes)4177* **Scope**: [`Managed`](#scopes)

4116* **Type**: `true` 以鎖定所有四種自訂，或命名要鎖定的種類的陣列，來自 `"skills"`、`"agents"`、`"hooks"` 和 `"mcp"`4178* **Type**: `true` 以鎖定全部，或命名要鎖定項目的陣列，來自 `"skills"`、`"agents"`、`"hooks"` 和 `"mcp"`

4117* **Default**: 未設定，因此沒有任何內容被鎖定4179* **Default**: 未設定，因此沒有任何內容被鎖定

4118 4180 

4119此範例鎖定 skills 和 hooks，並保持 agents 和 MCP 伺服器解鎖：4181此範例鎖定 skills 和 hooks，並保持 agents 和 MCP 伺服器解鎖：

4216每個範圍服務不同的目的：4278每個範圍服務不同的目的：

4217 4279 

4218* **使用者設定**: 您的個人 plugin 偏好設定4280* **使用者設定**: 您的個人 plugin 偏好設定

4219* **專案設定**: 與儲存庫中的每個人共享的 plugins4281* **專案設定**: 為儲存庫中的每個人開啟的 plugins。這不會安裝它們，因此每個使用者需[自行安裝它們](https://code.claude.com/docs/zh-TW/plugins/org.md#require-plugins-per-repository)。

4220* **本機設定**: 每台機器的覆寫，當 Claude Code 在那裡儲存設定時被 gitignored4282* **本機設定**: 每台機器的覆寫，當 Claude Code 在那裡儲存設定時被 gitignored

4221* **受管設定**: 組織範圍的原則。設定為 `false` 的 plugin 在每個範圍都被阻止安裝，並從 marketplace 隱藏4283* **受管設定**: 組織範圍的原則。設定為 `false` 的 plugin 在每個範圍都被阻止安裝，並從 marketplace 隱藏

4222 4284 

4223專案設定優先於使用者設定，因此在 `~/.claude/settings.json` 中將 plugin 設定為 `false` 不會禁用專案的 `.claude/settings.json` 啟用的 plugin。若要在您的機器上選擇退出專案啟用的 plugin，請改為在 `.claude/settings.local.json` 中將其設定為 `false`。由受管設定強制啟用的 Plugins 無法以此方式禁用，因為受管設定覆寫本機設定。4285專案設定優先於使用者設定，因此在 `~/.claude/settings.json` 中將 plugin 設定為 `false` 不會禁用專案的 `.claude/settings.json` 啟用的 plugin。若要在您的機器上選擇退出專案啟用的 plugin，請改為在 `.claude/settings.local.json` 中將其設定為 `false`。由受管設定強制啟用的 Plugins 無法以此方式禁用，因為受管設定覆寫本機設定。

4224 4286 

4225在專案的 `.claude/settings.json` 中啟用來自外部來源（例如 GitHub 儲存庫或 npm 套件）的 plugin 不會為其他人安裝它。在載入 plugins 的每個路徑上，Claude Code 報告 plugin 未安裝，直到每個使用者[自行安裝它](https://code.claude.com/docs/zh-TW/plugins/org.md#require-plugins-per-repository)。

4226 

4227### `extraKnownMarketplaces`4287### `extraKnownMarketplaces`

4228 4288 

4229按名稱註冊其他 plugin marketplaces，以便開啟儲存庫的人或受管設定到達的每個人都能獲得 marketplace，而無需自行新增。Claude Code 註冊它尚不知道的每個 marketplace。[`enabledPlugins`](#enabledplugins) 從它命名的 plugin 是否安裝取決於 plugin 的來源和哪個檔案啟用它；該項目有規則。4289按名稱註冊其他 plugin marketplaces，以便開啟儲存庫的人或受管設定到達的每個人都能獲得 marketplace，而無需自行新增。Claude Code 註冊它尚不知道的每個 marketplace。[`enabledPlugins`](#enabledplugins) 從它命名的 plugin 是否安裝，取決於 plugin 的來源以及由哪個檔案啟用它；[在專案設定中啟用但未安裝](https://code.claude.com/docs/zh-TW/plugins/loading.md#enabled-in-project-settings-but-not-installed)說明了相關規則。

4230 4290 

4231* **Scope**: [`Any file`](#scopes)。Claude Code 僅在您接受該資料夾的工作區信任對話框後，才接受儲存庫的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的項目；在您未信任的資料夾中，包括 `-p` 執行，它會忽略它們而不顯示訊息。4291* **Scope**: [`Any file`](#scopes)。Claude Code 僅在您接受該資料夾的工作區信任對話框後，才接受儲存庫的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的項目；在您未信任的資料夾中，包括 `-p` 執行，它會忽略它們而不顯示訊息。

4232* **Type**: 將 marketplace 名稱對應到具有 `source` 物件和可選 `autoUpdate` Boolean 的物件的物件4292* **Type**: 將 marketplace 名稱對應到具有 `source` 物件和可選 `autoUpdate` Boolean 的物件的物件

4354 4414 

4355列出受管 plugins，其 [mods](https://code.claude.com/docs/zh-TW/plugins/mods/overview.md) 在使用者安裝的每個 mod 之前執行，按列出的順序。當您在受管設定中設定此鍵時，在清單中命名 `sec-default@builtin` 以保持內建守衛。在受管設定中，Claude Code 跳過其 plugin 不計為您組織的 id。請參閱[安裝您組織的 mods 並設定順序](https://code.claude.com/docs/zh-TW/plugins/mods/admin.md#install-your-organizations-mods)以取得這些條件以及兩個排序鍵如何一起運作。4415列出受管 plugins，其 [mods](https://code.claude.com/docs/zh-TW/plugins/mods/overview.md) 在使用者安裝的每個 mod 之前執行，按列出的順序。當您在受管設定中設定此鍵時，在清單中命名 `sec-default@builtin` 以保持內建守衛。在受管設定中，Claude Code 跳過其 plugin 不計為您組織的 id。請參閱[安裝您組織的 mods 並設定順序](https://code.claude.com/docs/zh-TW/plugins/mods/admin.md#install-your-organizations-mods)以取得這些條件以及兩個排序鍵如何一起運作。

4356 4416 

4357* **Scope**: [`User or managed`](#scopes)。Claude Code 從受管設定讀取鍵。它僅在沒有受管設定的機器上、在憑證不是 Team 或 Enterprise `/login` 的工作階段中，才從使用者設定讀取鍵。它忽略專案和本機設定以及 `--settings` 檔案中的鍵。4417* **Scope**: [`User or managed`](#scopes)。Claude Code 從受管設定讀取鍵。它僅在沒有受管設定或 `managed-mcp.json` 檔案的機器上、在憑證不是 Team 或 Enterprise `/login` 的工作階段中，才從使用者設定讀取鍵。它忽略專案和本機設定以及 `--settings` 檔案中的鍵。

4358* **Type**: `plugin-name@marketplace-name` 字串的陣列4418* **Type**: `plugin-name@marketplace-name` 字串的陣列

4359* **Default**: 未設定4419* **Default**: 未設定

4360 4420 

4374 4434 

4375列出受管 plugins，其 [mods](https://code.claude.com/docs/zh-TW/plugins/mods/overview.md) 在使用者安裝的每個 mod 之後執行，按列出的順序。在 `prependPlugins` 和 `appendPlugins` 中列出的 id 被前置。在受管設定中，Claude Code 跳過其 plugin 不[計為您組織的](https://code.claude.com/docs/zh-TW/plugins/mods/admin.md#install-your-organizations-mods) id。4435列出受管 plugins，其 [mods](https://code.claude.com/docs/zh-TW/plugins/mods/overview.md) 在使用者安裝的每個 mod 之後執行，按列出的順序。在 `prependPlugins` 和 `appendPlugins` 中列出的 id 被前置。在受管設定中，Claude Code 跳過其 plugin 不[計為您組織的](https://code.claude.com/docs/zh-TW/plugins/mods/admin.md#install-your-organizations-mods) id。

4376 4436 

4377* **Scope**: [`User or managed`](#scopes)。Claude Code 從受管設定讀取鍵。它僅在沒有受管設定的機器上、在憑證不是 Team 或 Enterprise `/login` 的工作階段中，才從使用者設定讀取鍵。它忽略專案和本機設定以及 `--settings` 檔案中的鍵。4437* **Scope**: [`User or managed`](#scopes)。Claude Code 從受管設定讀取鍵。它僅在沒有受管設定或 `managed-mcp.json` 檔案的機器上、在憑證不是 Team 或 Enterprise `/login` 的工作階段中，才從使用者設定讀取鍵。它忽略專案和本機設定以及 `--settings` 檔案中的鍵。

4378* **Type**: `plugin-name@marketplace-name` 字串的陣列4438* **Type**: `plugin-name@marketplace-name` 字串的陣列

4379* **Default**: 未設定4439* **Default**: 未設定

4380 4440 

4612 4672 

4613### `crossSessionInbound`4673### `crossSessionInbound`

4614 4674 

4615選擇此工作階段如何處理 [來自您其他 Claude Code 工作階段的訊息](https://code.claude.com/docs/zh-TW/cross-session-messaging.md#control-inbound-messages)。當沒有值適用時，Claude Code 會根據兩個工作階段的權限模式類別逐個訊息決定。需要 Claude Code v2.1.224 或更新版本。4675選擇此工作階段如何處理 [來自您其他 Claude Code 工作階段的訊息](https://code.claude.com/docs/zh-TW/cross-session-messaging.md#control-inbound-messages)。當沒有值適用時，Claude Code 會根據兩個工作階段的權限模式類別逐個訊息決定。

4616 4676 

4617* **Scope**: [`Any file`](#scopes)。專案或本機值僅在其比受管設定、`--settings` 旗標或使用者設定提供的值更嚴格時才適用。4677* **Scope**: [`Any file`](#scopes)。專案或本機值僅在其比受管設定、`--settings` 旗標或使用者設定提供的值更嚴格時才適用。

4618* **Type**: string，其中之一：4678* **Type**: string，其中之一：

4946}5006}

4947```5007```

4948 5008 

5009### `disableRemotePreviewScripts`

5010 

5011當使用者在桌面應用程式中從 SSH 或 WSL 工作階段[預覽 HTML 檔案](https://code.claude.com/docs/zh-TW/desktop.md#preview-html-files-in-ssh-and-wsl-sessions)時，防止指令碼執行。Browser 窗格中的外部瀏覽不受影響。

5012 

5013桌面應用程式讀取此金鑰；終端機 CLI 忽略它。需要 Claude Desktop v5.1231.0 或更新版本。較早的版本會忽略此金鑰：若要在這些版本上停止指令碼，請同時設定 [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation)，這也會關閉外部瀏覽。

5014 

5015* **範圍**：[`受管理`](#scopes)。桌面應用程式不會從遠端機器或 WSL 發行版讀取此金鑰。

5016* **類型**：布林值；只有 JSON 布林值 `true` 才會生效

5017 * `true`：SSH 和 WSL 工作階段中的 HTML 預覽不會執行指令碼

5018 * `false`：此金鑰不會關閉指令碼

5019* **預設**：未設定，因此此金鑰沒有作用

5020 

5021如果執行桌面應用程式的電腦未收到其他 Claude Code 受管理設定，也請在您建立的受管理設定中將 [`parentSettingsBehavior`](#parentsettingsbehavior) 設定為 `"merge"`。在 Windows 上，如果您建立受管理設定檔，使用者也會失去 WSL 工作階段，直到您[允許它們](https://code.claude.com/docs/zh-TW/admin-setup.md#wsl-sessions-in-claude-code-desktop)為止。[為您的組織關閉 SSH 和 WSL 預覽中的指令碼](https://code.claude.com/docs/zh-TW/desktop.md#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)說明了這兩點，並說明在何處設定此金鑰。

5022 

5023此範例僅顯示此金鑰本身，如同您將其新增到電腦已接收的受管理設定中：

5024 

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

5026{

5027 "disableRemotePreviewScripts": true

5028}

5029```

5030 

5031桌面應用程式忽略任何其他值，非布林值的值（例如字串 `"true"` 或 `1`）也會記錄警告。

5032 

4949### `enableArtifact`5033### `enableArtifact`

4950 5034 

4951關閉 [Artifact](https://code.claude.com/docs/zh-TW/artifacts.md) 工具，該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。當您在 `/config` 中關閉 **Artifacts** 列時，Claude Code 會將此金鑰寫入您的使用者設定，因此您通常不會手動編輯它。5035關閉 [Artifact](https://code.claude.com/docs/zh-TW/artifacts.md) 工具，該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。當您在 `/config` 中關閉 **Artifacts** 列時，Claude Code 會將此金鑰寫入您的使用者設定，因此您通常不會手動編輯它。

5219 5303 

5220### `forceLoginMethod`5304### `forceLoginMethod`

5221 5305 

5222限制人員可以使用哪種帳戶登入。設定 `"claudeai"` 以僅允許 claude.ai 帳戶，設定 `"console"` 以僅允許 Claude Console 帳戶，或設定 `"gateway"` 以將人員傳送到 [cloud gateway](https://code.claude.com/docs/zh-TW/claude-apps-gateway) 而不是第一方登入。管理員在受管設定中設定它，並將其與 [`forceLoginOrgUUID`](#forceloginorguuid) 配對，以將開發人員的 claude.ai 登入保持在一個組織內。5306限制人員可以使用哪種帳戶登入：`"claudeai"` 代表 claude.ai 登入，`"console"` 代表 Claude Console 登入。設定 `"gateway"` 以將人員傳送到 [cloud gateway](https://code.claude.com/docs/zh-TW/claude-apps-gateway) 而不是第一方登入。管理員在受管設定中設定它，並將其與 [`forceLoginOrgUUID`](#forceloginorguuid) 配對，以將開發人員的 claude.ai 登入保持在一個組織內。

5223 5307 

5224如果您在任何設定檔中將其設定為 `"claudeai"`，Claude Code 也會停止在該檔案適用的工作階段中提供[無金鑰 Console 登入](https://code.claude.com/docs/zh-TW/authentication.md#sign-in-without-an-api-key)。若僅設定 `"console"`，人員在登入失敗後仍可使用無金鑰登入。若要讓 Claude Code 停止提供此選項，請參閱[在受管機器上停止提供無金鑰登入](https://code.claude.com/docs/zh-TW/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines)，其中也列出了 `forceLoginOrgUUID` 會變更的其他項目。5308如果您在任何設定檔中將其設定為 `"claudeai"`，Claude Code 也會停止在該檔案適用的工作階段中提供[無金鑰 Console 登入](https://code.claude.com/docs/zh-TW/authentication.md#sign-in-without-an-api-key)。若僅設定 `"console"`，人員在登入失敗後仍可使用無金鑰登入。若要讓 Claude Code 停止提供此選項，請參閱[在受管機器上停止提供無金鑰登入](https://code.claude.com/docs/zh-TW/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines)，其中也列出了 `forceLoginOrgUUID` 會變更的其他項目。

5225 5309 

5226* **範圍**：[`任何檔案`](#scopes)。Claude Code 從與 [`forceLoginGatewayUrl`](#forcelogingatewayurl) 相同的來源接受 `"gateway"`，並在其他所有位置將其視為未設定。5310* **範圍**：[`任何檔案`](#scopes)。Claude Code 從與 [`forceLoginGatewayUrl`](#forcelogingatewayurl) 相同的來源接受 `"gateway"`，並在其他所有位置將其視為未設定。

5227* **類型**：字串，其中之一：5311* **類型**：字串，其中之一：

5228 * `"claudeai"`：僅 claude.ai 帳戶可以登入5312 * `"claudeai"`：claude.ai 登入

5229 * `"console"`：僅 Claude Console 帳戶可以登入5313 * `"console"`：Claude Console 登入

5230 * `"gateway"`：Claude Code 將人員傳送到 cloud gateway 而不是第一方登入5314 * `"gateway"`：Claude Code 將人員傳送到 cloud gateway 而不是第一方登入

5231* **預設**：未設定，所以人員選擇登入方法5315* **預設**：未設定，所以人員選擇登入方法

5232 5316 

5471 5555 

5472設定 Claude Code 在刪除之前保留[工作階段文字記錄和其他應用程式資料](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)的天數。Claude Code 在工作階段開始後作為背景掃描執行刪除，只要它能安全地確定保留期間。掃描會刪除文字記錄而不顯示訊息，因此您未使用超過保留期間的工作階段不再出現在 [`/resume`](https://code.claude.com/docs/zh-TW/sessions#resume-a-session) 選擇器中。5556設定 Claude Code 在刪除之前保留[工作階段文字記錄和其他應用程式資料](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)的天數。Claude Code 在工作階段開始後作為背景掃描執行刪除，只要它能安全地確定保留期間。掃描會刪除文字記錄而不顯示訊息，因此您未使用超過保留期間的工作階段不再出現在 [`/resume`](https://code.claude.com/docs/zh-TW/sessions#resume-a-session) 選擇器中。

5473 5557 

5558預設情況下，對於您在 Claude Desktop 或 Cowork 中啟動或最近繼續的工作階段，Claude Code 會在超過此期間後仍保留其逐字稿，即使您自行設定了此鍵也是如此。此期間[在某些情況下仍適用於它們](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)，例如在 HIPAA 設定下。在 v2.1.248 之前，Claude Code 會在此期間過後刪除它們。

5559 

5474* **範圍**：[`Any file`](#scopes)5560* **範圍**：[`Any file`](#scopes)

5475* **類型**：天數，整數，最小值 `1`5561* **類型**：天數，整數，最小值 `1`

5476* **預設值**：`30`5562* **預設值**：`30`

5485 5571 

5486### `desktopSessionCleanupPeriodDays`5572### `desktopSessionCleanupPeriodDays`

5487 5573 

5488為您在 Claude Desktop 或 Cowork 中啟動或最近繼續的工作階段逐字稿設定天數年齡限制。沒有此鍵，Claude Code [會以任何年齡保留這些逐字稿](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)。Claude Code 在每個逐字稿的年齡超過此限制和 [`cleanupPeriodDays`](#cleanupperioddays) 時刪除它，因此當 `cleanupPeriodDays` 處於其預設值 30 時，值 `7` 仍會保留它們 30 天。[自動清理](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)列出了改為適用 `cleanupPeriodDays` 且 Claude Code 忽略此鍵的情況。需要 Claude Code v2.1.248 或更新版本。5574為您在 Claude Desktop 或 Cowork 中啟動或最近繼續的工作階段逐字稿設定天數年齡限制。沒有此鍵，Claude Code [會以任何年齡保留這些逐字稿](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)，但某些情況除外，例如您在 Claude Desktop 中刪除的工作階段。需要 Claude Code v2.1.248 或更新版本。

5575 

5576Claude Code 在每個逐字稿的年齡同時超過此限制和 [`cleanupPeriodDays`](#cleanupperioddays) 時刪除它，因此當 `cleanupPeriodDays` 處於其預設值 30 時，值 `7` 仍會保留它們 30 天。[自動清理](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)列出了改為適用 `cleanupPeriodDays` 且 Claude Code 忽略此鍵的情況。

5489 5577 

5490* **範圍**：[`User or managed`](#scopes)。Claude Code 也會從您使用 `--settings` 傳遞的檔案中讀取該鍵，並在專案和本機設定中忽略它。5578* **範圍**：[`User or managed`](#scopes)。Claude Code 也會從您使用 `--settings` 傳遞的檔案中讀取該鍵，並在專案和本機設定中忽略它。

5491* **類型**：天數，整數，最小值 `0`5579* **類型**：天數，整數，最小值 `0`