Documentation 2026-06-23 22:00 UTC to 2026-06-24 22:02 UTC

61 61 

62plist 和 HKLM 登錄位置適用於任何提供者，並且由於需要管理員權限才能寫入，因此可以抵抗篡改。Windows 使用者登錄中的 HKCU 無需提升即可寫入，因此將其視為便利預設值而不是執行通道。62plist 和 HKLM 登錄位置適用於任何提供者，並且由於需要管理員權限才能寫入，因此可以抵抗篡改。Windows 使用者登錄中的 HKCU 無需提升即可寫入，因此將其視為便利預設值而不是執行通道。

63 63 

64無論您選擇哪種機制，受管值都優先於使用者和專案設定。陣列設定（例如 `permissions.allow` 和 `permissions.deny`）會合併來自所有來源的項目，因此開發人員可以擴展受管清單但無法從中移除。64無論您選擇哪種機制，受管值都優先於使用者和專案設定。陣列設定（例如 `permissions.allow` 和 `permissions.deny`）會合併來自所有來源的項目，因此開發人員可以擴展受管清單但無法從中移除，但有 [兩個例外](/zh-TW/settings#settings-precedence)，其中受管值會取代較低層級而不是合併：`fallbackModel` 和 `availableModels`。

65 65 

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

67 67 

72受管設定可以鎖定工具、沙箱執行、限制 MCP 伺服器和外掛程式來源，以及控制哪些 hooks 執行。每一行都是一個控制表面，具有驅動它的設定鍵。72受管設定可以鎖定工具、沙箱執行、限制 MCP 伺服器和外掛程式來源，以及控制哪些 hooks 執行。每一行都是一個控制表面，具有驅動它的設定鍵。

73 73 

74| 控制 | 它的作用 | 關鍵設定 |74| 控制 | 它的作用 | 關鍵設定 |

75| :---------------------------------------------------------------------------------------- | :--------------------------------------------------------- | :---------------------------------------------------------------------------------------------- |75| :---------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------- |

76| [Permission rules](/zh-TW/permissions) | 允許、詢問或拒絕特定工具和命令 | `permissions.allow`、`permissions.deny` |76| [Permission rules](/zh-TW/permissions) | 允許、詢問或拒絕特定工具和命令 | `permissions.allow`、`permissions.deny` |

77| [Permission lockdown](/zh-TW/permissions#managed-only-settings) | 僅受管權限規則適用；禁用 `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |77| [Permission lockdown](/zh-TW/permissions#managed-only-settings) | 僅受管權限規則適用；禁用 `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |

78| [Sandboxing](/zh-TW/sandboxing) | 作業系統級別的檔案系統和網路隔離，具有網域允許清單 | `sandbox.enabled`、`sandbox.network.allowedDomains` |78| [Sandboxing](/zh-TW/sandboxing) | 作業系統級別的檔案系統和網路隔離，具有網域允許清單 | `sandbox.enabled`、`sandbox.network.allowedDomains` |

82| [Customization lockdown](/zh-TW/settings#strictpluginonlycustomization) | 阻止 skills、agents、hooks 和 MCP 伺服器來自使用者和專案來源，使其只能來自外掛程式或受管設定 | `strictPluginOnlyCustomization` |82| [Customization lockdown](/zh-TW/settings#strictpluginonlycustomization) | 阻止 skills、agents、hooks 和 MCP 伺服器來自使用者和專案來源，使其只能來自外掛程式或受管設定 | `strictPluginOnlyCustomization` |

83| [Hook restrictions](/zh-TW/settings#hook-configuration) | 僅受管 hooks 載入；限制 HTTP hook URL | `allowManagedHooksOnly`、`allowedHttpHookUrls` |83| [Hook restrictions](/zh-TW/settings#hook-configuration) | 僅受管 hooks 載入；限制 HTTP hook URL | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

84| [Disable agent view](/zh-TW/agent-view#how-background-sessions-are-hosted) | 關閉 `claude agents`、`--bg`、`/background` 和隨選監督員 | `disableAgentView` |84| [Disable agent view](/zh-TW/agent-view#how-background-sessions-are-hosted) | 關閉 `claude agents`、`--bg`、`/background` 和隨選監督員 | `disableAgentView` |

85| [Model restrictions](/zh-TW/model-config#restrict-model-selection) | 限制使用者可以選擇的模型，並可選擇性地將允許清單也應用於預設模型選擇。請參閱[表面涵蓋範圍](/zh-TW/model-config#surface-coverage)以了解此設定如何到達 CLI、網頁和 IDE | `availableModels`、`enforceAvailableModels` |

85| [Version floor](/zh-TW/settings) | 防止自動更新安裝低於組織範圍最小值的版本 | `minimumVersion` |86| [Version floor](/zh-TW/settings) | 防止自動更新安裝低於組織範圍最小值的版本 | `minimumVersion` |

86| [Required version range](/zh-TW/settings) | 當執行版本超出組織核准範圍時，完全拒絕啟動。比 `minimumVersion` 更強大，後者只會阻止降級 | `requiredMinimumVersion`、`requiredMaximumVersion` |87| [Required version range](/zh-TW/settings) | 當執行版本超出組織核准範圍時，完全拒絕啟動。比 `minimumVersion` 更強大，後者只會阻止降級 | `requiredMinimumVersion`、`requiredMaximumVersion` |

87 88 

52/advisor opus52/advisor opus

53```53```

54 54 

55您的選擇會儲存到使用者設定中的 `advisorModel`，並在會話間保持。如果您目前的主要模型不支援顧問，選擇仍會被儲存，並在您使用 [`/model`](/zh-TW/model-config#setting-your-model) 切換到[相容的主要模型](#choose-an-advisor-model)時啟動。55您的選擇會儲存到使用者設定中的 `advisorModel`，並在會話間保持。如果您組織的 [`availableModels`](/zh-TW/model-config#restrict-model-selection) 允許清單排除了已儲存的顧問模型，則顧問不會被叫用，直到您使用 `/advisor` 選擇允許的模型。如果您目前的主要模型不支援顧問，選擇仍會被儲存，並在您使用 [`/model`](/zh-TW/model-config#setting-your-model) 切換到[相容的主要模型](#choose-an-advisor-model)時啟動。

56 56 

57<h3 id="set-advisormodel-in-settings">57<h3 id="set-advisormodel-in-settings">

58 在設定中設定 `advisorModel`58 在設定中設定 `advisorModel`

76claude --advisor opus76claude --advisor opus

77```77```

78 78 

79該旗標在該會話中優先於 `advisorModel` 設定。與 `/advisor` 不同（後者會儲存非作用中的選擇），如果會話的主要模型不支援顧問，旗標會以錯誤退出。79該旗標在該會話中優先於 `advisorModel` 設定。如果會話的主要模型不支援顧問，或如果要求的顧問模型被您組織的 [`availableModels`](/zh-TW/model-config#restrict-model-selection) 允許清單排除，它會以錯誤退出。

80 80 

81<h2 id="choose-an-advisor-model">81<h2 id="choose-an-advisor-model">

82 選擇顧問模型82 選擇顧問模型

182顧問是結合模型優勢的幾種方式之一。根據您希望何時涉及第二個模型來選擇。182顧問是結合模型優勢的幾種方式之一。根據您希望何時涉及第二個模型來選擇。

183 183 

184| 方法 | 更強大的模型何時執行 | 如何啟動 |184| 方法 | 更強大的模型何時執行 | 如何啟動 |

185| -------------------------------------------------------- | ------------------------ | ----------------- |185| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------- |

186| 顧問工具 | 在任務中途的決策點 | Claude 在需要指導時呼叫它 |186| 顧問工具 | 在任務中途的決策點 | Claude 在需要指導時呼叫它 |

187| [`opusplan`](/zh-TW/model-config#opusplan-model-setting) | 在計畫模式期間，然後切換到 Sonnet 以執行 | 您進入計畫模式 |187| [`opusplan`](/zh-TW/model-config#opusplan-model-setting) | 在計畫模式期間（當 [`availableModels`](/zh-TW/model-config#restrict-model-selection) 允許時），然後切換到 Sonnet 以執行 | 您進入計畫模式 |

188| [子代理](/zh-TW/sub-agents#choose-a-model)搭配 `model` 設定 | 針對整個委派的子任務 | Claude 委派，或您呼叫子代理 |188| [子代理](/zh-TW/sub-agents#choose-a-model)搭配 `model` 設定 | 針對整個委派的子任務 | Claude 委派，或您呼叫子代理 |

189| [`/model`](/zh-TW/model-config#setting-your-model) | 針對所有後續輪次 | 您切換模型 |189| [`/model`](/zh-TW/model-config#setting-your-model) | 針對所有後續輪次 | 您切換模型 |

190 190 

86`settingSources` 涵蓋使用者、專案和本機設定。無論其值如何，都會讀取一些輸入：86`settingSources` 涵蓋使用者、專案和本機設定。無論其值如何，都會讀取一些輸入：

87 87 

88| 輸入 | 行為 | 停用方式 |88| 輸入 | 行為 | 停用方式 |

89| :------------------------------------------------------------- | :--------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |89| :------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |

90| 受管原則設定 | 主機上存在時始終載入 | 移除受管設定檔 |90| 受管原則設定 | 端點管理的原則（無論是 MDM plist、登錄原則或受管設定檔）從主機載入；[伺服器管理的設定](/zh-TW/server-managed-settings)在工作階段使用組織 OAuth 登入或直接配置的 API 金鑰進行驗證時擷取，在[符合條件的配置](/zh-TW/server-managed-settings#platform-availability)上 | 端點原則：從主機移除受管設定檔、plist 或登錄原則。伺服器管理的設定：由您的組織管理員控制；無法從 SDK 停用 |

91| `~/.claude.json` 全域設定 | 始終讀取 | 在 `env` 中使用 `CLAUDE_CONFIG_DIR` 重新定位 |91| `~/.claude.json` 全域設定 | 始終讀取 | 在 `env` 中使用 `CLAUDE_CONFIG_DIR` 重新定位 |

92| `~/.claude/projects/<project>/memory/` 的自動記憶體 | 預設載入到系統提示中 | 在設定中設定 `autoMemoryEnabled: false`，或在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |92| `~/.claude/projects/<project>/memory/` 的自動記憶體 | 預設載入到系統提示中 | 在設定中設定 `autoMemoryEnabled: false`，或在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |

93| [claude.ai MCP 連接器](/zh-TW/mcp#use-mcp-servers-from-claude-ai) | 當作用中驗證方法是 claude.ai 訂閱時載入。傳遞 `mcpServers: {}` 不會抑制它們 | 設定 `strictMcpConfig: true`、[`disableClaudeAiConnectors: true`](/zh-TW/mcp#disable-claude-ai-connectors) 在設定中，或在 `env` 中設定 `ENABLE_CLAUDEAI_MCP_SERVERS=false` |93| [claude.ai MCP 連接器](/zh-TW/mcp#use-mcp-servers-from-claude-ai) | 當作用中驗證方法是 claude.ai 訂閱時載入。傳遞 `mcpServers: {}` 不會抑制它們 | 設定 `strictMcpConfig: true`、[`disableClaudeAiConnectors: true`](/zh-TW/mcp#disable-claude-ai-connectors) 在設定中，或在 `env` 中設定 `ENABLE_CLAUDEAI_MCP_SERVERS=false` |

94 94 

95<Warning>95<Warning>

96 不要依賴預設 `query()` 選項進行多租戶隔離。因為上述輸入無論 `settingSources` 如何都會被讀取，SDK 程序可能會拾取主機層級設定和每個目錄的記憶體。對於多租戶部署，在其自己的檔案系統中執行每個租戶，並設定 `settingSources: []` 加上在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`。請參閱 [安全部署](/zh-TW/agent-sdk/secure-deployment)。96 不要依賴預設 `query()` 選項進行多租戶隔離。因為上述輸入無論 `settingSources` 如何都會被讀取，SDK 程序可能會拾取主機層級設定和每個目錄的記憶體。對於多租戶部署，在其自己的檔案系統中執行每個租戶，並設定 `settingSources: []` 加上在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`。[伺服器管理的設定](/zh-TW/server-managed-settings)在程序使用組織認證進行驗證時擷取；檔案系統隔離不會移除它們。請參閱[安全部署](/zh-TW/agent-sdk/secure-deployment)。

97</Warning>97</Warning>

98 98 

99<h2 id="project-instructions-claude-md-and-rules">99<h2 id="project-instructions-claude-md-and-rules">

897```897```

898 898 

899| 屬性 | 類型 | 預設 | 描述 |899| 屬性 | 類型 | 預設 | 描述 |

900| :---------------------------- | :--------------------------------------------------------------------------------------- | :------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |900| :---------------------------- | :--------------------------------------------------------------------------------------- | :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Tools 配置。使用 `{"type": "preset", "preset": "claude_code"}` 以取得 Claude Code 的預設 tools |901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Tools 配置。使用 `{"type": "preset", "preset": "claude_code"}` 以取得 Claude Code 的預設 tools |

902| `allowed_tools` | `list[str]` | `[]` | 自動批准的 tools，無需提示。這不會限制 Claude 僅使用這些 tools；未列出的 tools 會進入 `permission_mode` 和 `can_use_tool`。使用 `disallowed_tools` 來阻止 tools。見 [權限](/zh-TW/agent-sdk/permissions#allow-and-deny-rules) |902| `allowed_tools` | `list[str]` | `[]` | 自動批准的 tools，無需提示。這不會限制 Claude 僅使用這些 tools；未列出的 tools 會進入 `permission_mode` 和 `can_use_tool`。使用 `disallowed_tools` 來阻止 tools。見 [權限](/zh-TW/agent-sdk/permissions#allow-and-deny-rules) |

903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | 系統提示配置。傳遞字串以取得自訂提示，或使用 `{"type": "preset", "preset": "claude_code"}` 以取得 Claude Code 的系統提示。新增 `"append"` 以擴展預設 |903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | 系統提示配置。傳遞字串以取得自訂提示，或使用 `{"type": "preset", "preset": "claude_code"}` 以取得 Claude Code 的系統提示。新增 `"append"` 以擴展預設 |

933| `agents` | `dict[str, AgentDefinition] \| None` | `None` | 以程式設計方式定義的子代理 |933| `agents` | `dict[str, AgentDefinition] \| None` | `None` | 以程式設計方式定義的子代理 |

934| `plugins` | `list[SdkPluginConfig]` | `[]` | 從本地路徑載入自訂外掛程式。見 [外掛程式](/zh-TW/agent-sdk/plugins) 以了解詳情 |934| `plugins` | `list[SdkPluginConfig]` | `[]` | 從本地路徑載入自訂外掛程式。見 [外掛程式](/zh-TW/agent-sdk/plugins) 以了解詳情 |

935| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | 以程式設計方式配置沙箱行為。見 [沙箱設定](#sandboxsettings) 以了解詳情 |935| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | 以程式設計方式配置沙箱行為。見 [沙箱設定](#sandboxsettings) 以了解詳情 |

936| `setting_sources` | `list[SettingSource] \| None` | `None`（CLI 預設值：所有來源） | 控制要載入哪些檔案系統設定。傳遞 `[]` 以停用使用者、專案和本地設定。無論如何都會載入受管原則設定。見 [使用 Claude Code 功能](/zh-TW/agent-sdk/claude-code-features#what-settingsources-does-not-control) |936| `setting_sources` | `list[SettingSource] \| None` | `None`（CLI 預設值：所有來源） | 控制要載入哪些檔案系統設定。傳遞 `[]` 以停用使用者、專案和本地設定。無論如何都會載入受管原則設定；當 session 使用組織認證在[符合條件的配置](/zh-TW/server-managed-settings#platform-availability)上進行驗證時，會擷取伺服器管理的設定。見 [使用 Claude Code 功能](/zh-TW/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | 可供 session 使用的 skills。傳遞 `"all"` 以啟用每個發現的 skill，或傳遞 skill 名稱清單。設定時，SDK 會自動將 Skill tool 新增到 `allowed_tools`。如果您也傳遞 `tools`，請在該清單中包括 `"Skill"`。見 [Skills](/zh-TW/agent-sdk/skills) |937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | 可供 session 使用的 skills。傳遞 `"all"` 以啟用每個發現的 skill，或傳遞 skill 名稱清單。設定時，SDK 會自動將 Skill tool 新增到 `allowed_tools`。如果您也傳遞 `tools`，請在該清單中包括 `"Skill"`。見 [Skills](/zh-TW/agent-sdk/skills) |

938| `max_thinking_tokens` | `int \| None` | `None` | *已棄用* - 思考區塊的最大令牌數。改用 `thinking` |938| `max_thinking_tokens` | `int \| None` | `None` | *已棄用* - 思考區塊的最大令牌數。改用 `thinking` |

939| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 控制擴展思考行為。優先於 `max_thinking_tokens` |939| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 控制擴展思考行為。優先於 `max_thinking_tokens` |

1022 預設行為1022 預設行為

1023</h4>1023</h4>

1024 1024 

1025當 `setting_sources` 被省略或為 `None` 時，`query()` 載入與 Claude Code CLI 相同的檔案系統設定：使用者、專案和本地。無論如何都會載入受管原則設定。見 [settingSources 不控制的內容](/zh-TW/agent-sdk/claude-code-features#what-settingsources-does-not-control) 以了解無論此選項如何都會讀取的輸入，以及如何停用它們。1025當 `setting_sources` 被省略或為 `None` 時，`query()` 載入與 Claude Code CLI 相同的檔案系統設定：使用者、專案和本地。無論如何都會載入受管原則設定；當 session 使用組織認證在[符合條件的配置](/zh-TW/server-managed-settings#platform-availability)上進行驗證時，會擷取伺服器管理的設定。見 [settingSources 不控制的內容](/zh-TW/agent-sdk/claude-code-features#what-settingsources-does-not-control) 以了解無論此選項如何都會讀取的輸入，以及如何停用它們。

1026 1026 

1027<h4 id="why-use-setting_sources">1027<h4 id="why-use-setting_sources">

1028 為什麼使用 setting\_sources1028 為什麼使用 setting\_sources

517| `sessionStore` | [`SessionStore`](/zh-TW/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | 將會話記錄鏡像到外部後端，以便任何主機都可以恢復它們。見 [將會話持久化到外部存儲](/zh-TW/agent-sdk/session-storage) |517| `sessionStore` | [`SessionStore`](/zh-TW/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | 將會話記錄鏡像到外部後端，以便任何主機都可以恢復它們。見 [將會話持久化到外部存儲](/zh-TW/agent-sdk/session-storage) |

518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha。* `sessionStore` 的刷新模式。未設置 `sessionStore` 時忽略 |518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha。* `sessionStore` 的刷新模式。未設置 `sessionStore` 時忽略 |

519| `settings` | `string \| Settings` | `undefined` | 內聯 [設置](/zh-TW/settings) 對象或設置文件的路徑。填充 [優先級順序](/zh-TW/settings#settings-precedence) 中的標誌設置層。使用 [`applyFlagSettings()`](#applyflagsettings) 在運行時更改 |519| `settings` | `string \| Settings` | `undefined` | 內聯 [設置](/zh-TW/settings) 對象或設置文件的路徑。填充 [優先級順序](/zh-TW/settings#settings-precedence) 中的標誌設置層。使用 [`applyFlagSettings()`](#applyflagsettings) 在運行時更改 |

520| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI 默認值（所有源） | 控制加載哪些文件系統設置。傳遞 `[]` 以禁用用戶、項目和本地設置。無論如何都會加載託管策略設置。見 [使用 Claude Code 功能](/zh-TW/agent-sdk/claude-code-features#what-settingsources-does-not-control) |520| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI 默認值（所有源） | 控制加載哪些文件系統設置。傳遞 `[]` 以禁用用戶、項目和本地設置。無論如何都會加載託管策略設置；當會話使用組織憑證在 [符合條件的配置](/zh-TW/server-managed-settings#platform-availability) 上進行身份驗證時，會獲取服務器管理的設置。見 [使用 Claude Code 功能](/zh-TW/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

521| `skills` | `string[] \| 'all'` | `undefined` | 會話可用的 skills。傳遞 `'all'` 以啟用每個發現的 skill，或傳遞 skill 名稱列表。設置後，SDK 會自動將 Skill 工具添加到 `allowedTools`。如果您也傳遞 `tools`，請在該列表中包含 `'Skill'`。見 [Skills](/zh-TW/agent-sdk/skills) |521| `skills` | `string[] \| 'all'` | `undefined` | 會話可用的 skills。傳遞 `'all'` 以啟用每個發現的 skill，或傳遞 skill 名稱列表。設置後，SDK 會自動將 Skill 工具添加到 `allowedTools`。如果您也傳遞 `tools`，請在該列表中包含 `'Skill'`。見 [Skills](/zh-TW/agent-sdk/skills) |

522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | 用於生成 Claude Code 進程的自定義函數。用於在 VM、容器或遠程環境中運行 Claude Code |522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | 用於生成 Claude Code 進程的自定義函數。用於在 VM、容器或遠程環境中運行 Claude Code |

523| `stderr` | `(data: string) => void` | `undefined` | stderr 輸出的回調 |523| `stderr` | `(data: string) => void` | `undefined` | stderr 輸出的回調 |

765 默認行為765 默認行為

766</h4>766</h4>

767 767 

768當 `settingSources` 被省略或 `undefined` 時，`query()` 加載與 Claude Code CLI 相同的文件系統設置：用戶、項目和本地。託管策略設置在所有情況下都會加載。見 [settingSources 不控制什麼](/zh-TW/agent-sdk/claude-code-features#what-settingsources-does-not-control) 了解無論此選項如何都會讀取的輸入，以及如何禁用它們。768當 `settingSources` 被省略或 `undefined` 時，`query()` 加載與 Claude Code CLI 相同的文件系統設置：用戶、項目和本地。託管策略設置在所有情況下都會加載；當會話使用組織憑證在 [符合條件的配置](/zh-TW/server-managed-settings#platform-availability) 上進行身份驗證時，會獲取服務器管理的設置。見 [settingSources 不控制什麼](/zh-TW/agent-sdk/claude-code-features#what-settingsources-does-not-control) 了解無論此選項如何都會讀取的輸入，以及如何禁用它們。

769 769 

770<h4 id="why-use-settingsources">770<h4 id="why-use-settingsources">

771 為什麼使用 settingSources771 為什麼使用 settingSources

477export CLAUDE_CODE_USE_MANTLE=1477export CLAUDE_CODE_USE_MANTLE=1

478```478```

479 479 

480若要在 `/model` 選擇器中顯示 Mantle 模型，請在[設定檔](/zh-TW/settings)中的 `availableModels` 中列出其 ID。此設定也會將選擇器限制為列出的項目，因此請包括您想保持可用的每個別名：480若要在 `/model` 選擇器中顯示 Mantle 模型，請在[設定檔](/zh-TW/settings)中的 `availableModels` 中列出其 ID。此設定也會將選擇器限制為列出的項目。列出 `anthropic.claude-haiku-4-5` 會從選擇器中移除裸 `haiku` 別名，因此也請列出版本前綴或您想保持可選的版本的完整 ID。請參閱[合併行為](/zh-TW/model-config#merge-behavior)：

481 481 

482```json theme={null}482```json theme={null}

483{483{

484 "availableModels": ["opus", "sonnet", "haiku", "anthropic.claude-haiku-4-5"]484 "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]

485}485}

486```486```

487 487 

63 雲端工作階段中可用的內容63 雲端工作階段中可用的內容

64</h3>64</h3>

65 65 

66雲端工作階段從您的儲存庫的新複製開始。任何提交到儲存庫的內容都可用。您只在自己的機器上安裝或配置的任何內容都不可用。66雲端工作階段從您的儲存庫的新複製開始。任何提交到儲存庫的內容都可用。您只在自己的機器上安裝或配置的任何內容都不可用；您的組織的政策通過[伺服器管理的設定](/zh-TW/server-managed-settings)單獨到達。

67 67 

68| | 在雲端工作階段中可用 | 原因 |68| | 在雲端工作階段中可用 | 原因 |

69| :------------------------------------------------------------------ | :--------- | :----------------------------------------------------------------------------------------- |69| :------------------------------------------------------------------ | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

70| 您的儲存庫的 `CLAUDE.md` | 是 | 複製的一部分 |70| 您的儲存庫的 `CLAUDE.md` | 是 | 複製的一部分 |

71| 您的儲存庫的 `.claude/settings.json` hooks | 是 | 複製的一部分 |71| 您的儲存庫的 `.claude/settings.json` hooks | 是 | 複製的一部分 |

72| 您的儲存庫的 `.mcp.json` MCP 伺服器 | 是 | 複製的一部分 |72| 您的儲存庫的 `.mcp.json` MCP 伺服器 | 是 | 複製的一部分 |

73| 您的儲存庫的 `.claude/rules/` | 是 | 複製的一部分 |73| 您的儲存庫的 `.claude/rules/` | 是 | 複製的一部分 |

74| 您的儲存庫的 `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | 是 | 複製的一部分 |74| 您的儲存庫的 `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | 是 | 複製的一部分 |

75| 在 `.claude/settings.json` 中聲明的 Plugins | 是 | 在工作階段啟動時從您聲明的[市場](/zh-TW/plugin-marketplaces)安裝。需要網路存取才能到達市場來源 |75| 在 `.claude/settings.json` 中聲明的 Plugins | 是 | 在工作階段啟動時從您聲明的[市場](/zh-TW/plugin-marketplaces)安裝。需要網路存取才能到達市場來源 |

76| 您的組織的[伺服器管理的設定](/zh-TW/server-managed-settings) | 是 | 在工作階段啟動時從 Anthropic 的伺服器取得。請參閱[表面涵蓋範圍](/zh-TW/model-config#surface-coverage)以了解 `availableModels` 如何在雲端工作階段中強制執行。通過 MDM 或管理設定檔案部署到您的裝置的設定不適用，因為工作階段在 Anthropic 管理的 VM 上執行 |

76| 您的使用者 `~/.claude/CLAUDE.md` | 否 | 位於您的機器上，不在儲存庫中 |77| 您的使用者 `~/.claude/CLAUDE.md` | 否 | 位於您的機器上，不在儲存庫中 |

77| 您的使用者 `~/.claude/skills/`、`~/.claude/agents/`、`~/.claude/commands/` | 否 | 位於您的機器上，不在儲存庫中。改為將它們提交到儲存庫的 `.claude/` 目錄。您在 claude.ai 上啟用的技能會自動載入到雲端工作階段中 |78| 您的使用者 `~/.claude/skills/`、`~/.claude/agents/`、`~/.claude/commands/` | 否 | 位於您的機器上，不在儲存庫中。改為將它們提交到儲存庫的 `.claude/` 目錄。您在 claude.ai 上啟用的技能會自動載入到雲端工作階段中 |

78| 僅在您的使用者設定中啟用的 Plugins | 否 | 使用者範圍的 `enabledPlugins` 位於 `~/.claude/settings.json`。改為在儲存庫的 `.claude/settings.json` 中聲明它們 |79| 僅在您的使用者設定中啟用的 Plugins | 否 | 使用者範圍的 `enabledPlugins` 位於 `~/.claude/settings.json`。改為在儲存庫的 `.claude/settings.json` 中聲明它們 |

80| 靜態 API 令牌和認證 | 否 | 尚不存在專用的秘密存儲。請參閱下文 |81| 靜態 API 令牌和認證 | 否 | 尚不存在專用的秘密存儲。請參閱下文 |

81| 互動式驗證，如 AWS SSO | 否 | 不支援。SSO 需要無法在雲端工作階段中執行的基於瀏覽器的登入 |82| 互動式驗證，如 AWS SSO | 否 | 不支援。SSO 需要無法在雲端工作階段中執行的基於瀏覽器的登入 |

82 83 

83若要在雲端工作階段中提供配置，請將其提交到儲存庫。尚不可用專用的秘密存儲。環境變數和設定指令碼都存儲在環境配置中，對任何可以編輯該環境的人可見。如果您需要雲端工作階段中的秘密，請將它們新增為環境變數，並考慮該可見性。84若要在雲端工作階段中提供您自己的配置，請將其提交到儲存庫；組織政策通過[伺服器管理的設定](/zh-TW/server-managed-settings)單獨到達。尚不可用專用的秘密存儲。環境變數和設定指令碼都存儲在環境配置中，對任何可以編輯該環境的人可見。如果您需要雲端工作階段中的秘密，請將它們新增為環境變數，並考慮該可見性。

84 85 

85<h3 id="installed-tools">86<h3 id="installed-tools">

86 已安裝的工具87 已安裝的工具

245| 執行 | 在 Claude Code 啟動之前，當沒有[快取環境](#environment-caching)時 | 在 Claude Code 啟動之後，在每個工作階段上，包括已恢復的 |246| 執行 | 在 Claude Code 啟動之前，當沒有[快取環境](#environment-caching)時 | 在 Claude Code 啟動之後，在每個工作階段上，包括已恢復的 |

246| 範圍 | 僅雲端環境 | 本機和雲端 |247| 範圍 | 僅雲端環境 | 本機和雲端 |

247 248 

248SessionStart hooks 也可以在本機使用者級別 `~/.claude/settings.json` 中定義，但使用者級別設定不會轉移到雲端工作階段。在雲端中，只有提交到儲存庫的 hooks 執行。249SessionStart hooks 也可以在本機使用者級別 `~/.claude/settings.json` 中定義，但使用者級別設定不會轉移到雲端工作階段。在雲端中，hooks 來自儲存庫和您組織的[伺服器管理設定](/zh-TW/server-managed-settings)。

249 250 

250<h3 id="install-dependencies-with-a-sessionstart-hook">251<h3 id="install-dependencies-with-a-sessionstart-hook">

251 使用 SessionStart hook 安裝依賴項252 使用 SessionStart hook 安裝依賴項

88| `/ide` | 管理 IDE 整合並顯示狀態 |88| `/ide` | 管理 IDE 整合並顯示狀態 |

89| `/init` | 使用 `CLAUDE.md` 指南初始化專案。設定 `CLAUDE_CODE_NEW_INIT=1` 以進行互動式流程，該流程也會逐步引導您完成 skills、hooks 和個人記憶體檔案 |89| `/init` | 使用 `CLAUDE.md` 指南初始化專案。設定 `CLAUDE_CODE_NEW_INIT=1` 以進行互動式流程，該流程也會逐步引導您完成 skills、hooks 和個人記憶體檔案 |

90| `/insights` | 產生報告，分析您的 Claude Code 工作階段，包括專案領域、互動模式和摩擦點 |90| `/insights` | 產生報告，分析您的 Claude Code 工作階段，包括專案領域、互動模式和摩擦點 |

91| `/install-github-app` | 為存放庫設定 [Claude GitHub Actions](/zh-TW/github-actions) 應用程式。引導您選擇存放庫並配置整合 |91| `/install-github-app` | 為存放庫設定 Claude GitHub App，並可選擇設定 [GitHub Actions](/zh-TW/github-actions) 工作流程和密鑰。引導您選擇存放庫並配置整合 |

92| `/install-slack-app` | 安裝 Claude Slack 應用程式。開啟瀏覽器以完成 OAuth 流程 |92| `/install-slack-app` | 安裝 Claude Slack 應用程式。開啟瀏覽器以完成 OAuth 流程 |

93| `/keybindings` | 開啟您的[快捷鍵](/zh-TW/keybindings)檔案 |93| `/keybindings` | 開啟您的[快捷鍵](/zh-TW/keybindings)檔案 |

94| `/login` | 登入您的 Anthropic 帳戶 |94| `/login` | 登入您的 Anthropic 帳戶 |

691 受管設定691 受管設定

692</h3>692</h3>

693 693 

694受管設定會覆蓋專案和使用者設定，並在 Desktop 產生 CLI 會話時套用。您可以在您組織的[受管設定](/zh-TW/settings#settings-precedence)檔案中設定這些金鑰，或透過管理員主控台遠端推送它們。694受管設定會覆蓋專案和使用者設定，並在 Desktop 中的 Claude Code 會話時套用。您可以在您組織的[受管設定](/zh-TW/settings#settings-precedence)檔案中設定這些金鑰，或透過管理員主控台遠端推送它們。

695 695 

696| 金鑰 | 描述 |696| 金鑰 | 描述 |

697| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |697| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

698| `permissions.disableBypassPermissionsMode` | 設定為 `"disable"` 以防止使用者啟用略過權限模式。 |698| `permissions.disableBypassPermissionsMode` | 設定為 `"disable"` 以防止使用者啟用略過權限模式。 |

699| `disableAutoMode` | 設定為 `"disable"` 以防止使用者啟用 [Auto](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 模式。從模式選擇器中移除 Auto。也在 `permissions` 下接受。 |699| `disableAutoMode` | 設定為 `"disable"` 以防止使用者啟用 [Auto](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 模式。從模式選擇器中移除 Auto。也在 `permissions` 下接受。 |

700| `autoMode` | 自訂 auto 模式分類器在您的組織中信任和阻止的內容。請參閱[配置 auto 模式](/zh-TW/auto-mode-config)。 |700| `autoMode` | 自訂 auto 模式分類器在您的組織中信任和阻止的內容。請參閱[配置 auto 模式](/zh-TW/auto-mode-config)。 |

701| `sshConfigs` | 預先配置[SSH 連線](#pre-configure-ssh-connections-for-your-team)，在環境下拉式選單中顯示。使用者無法編輯或刪除受管連線。 |701| `sshConfigs` | 預先配置[SSH 連線](#pre-configure-ssh-connections-for-your-team)，在環境下拉式選單中顯示。使用者無法編輯或刪除受管連線。 |

702| `sshHostAllowlist` | 限制 [SSH 會話](#restrict-which-ssh-hosts-users-can-connect-to)連線到已解析主機名稱符合這些模式之一的主機。空陣列會停用 SSH 會話。僅從受管設定讀取。 |702| `sshHostAllowlist` | 限制 [SSH 會話](#restrict-which-ssh-hosts-users-can-connect-to)連線到已解析主機名稱符合這些模式之一的主機。空陣列會停用 SSH 會話。僅從受管設定讀取。 |

703| `managedMcpServers` | 將 MCP 伺服器配置推送到第三方部署中的所有使用者。每個項目指定 `"http"`、`"sse"` 或 `"stdio"` 的傳輸、連線詳細資訊，以及可選的 `toolPolicy` 對應，限制該伺服器中使用者可以叫用的工具。僅在第三方 (3P) Desktop 部署中可用。 |703| `managedMcpServers` | 將 MCP 伺服器配置推送到第三方部署中的所有使用者。每個項目指定 `"http"`、`"sse"` 或 `"stdio"` 的傳輸、連線詳細資訊，以及可選的 `toolPolicy` 對應，限制該伺服器中使用者可以叫用的工具。僅在第三方 (3P) Desktop 部署中可用。透過受管設定檔案或 MDM 傳遞此金鑰，因為第三方部署不會收到管理員主控台設定。 |

704 704 

705部署到每台機器上磁碟的受管設定檔案適用於 Desktop 會話。透過管理員主控台推送的遠端受管設定目前僅適用於 CLI 和 IDE 會話，因此對於 Desktop 部署，請透過 MDM 分發檔案或使用上面的[管理員主控台控制](#admin-console-controls)。705哪些受管設定到達 Desktop 會話取決於該會話執行的位置。模型限制（例如 [`availableModels`](/zh-TW/model-config#restrict-model-selection)）在 Desktop 的 Claude Code 會話中的強制方式與終端 CLI 相同；請參閱[表面涵蓋範圍](/zh-TW/model-config#surface-coverage)。

706 

707* **此機器上的本機會話**：部署到磁碟的受管設定檔案適用。透過管理員主控台推送的遠端受管設定在會話使用組織登入或直接配置的 API 金鑰向 Anthropic 的 API 進行驗證時也會到達這些會話，遵循與終端 CLI 相同的[設定優先順序](/zh-TW/settings#settings-precedence)。

708* **[雲端會話](#cloud-sessions)**：在 Anthropic 管理的 VM 上執行，僅接收[伺服器管理的設定](/zh-TW/server-managed-settings)。

709* **[SSH 會話](#ssh-sessions)**：會話從遠端主機讀取受管設定檔案。Desktop 本身在建立連線時從本機機器的受管設定讀取 `sshConfigs` 和 `sshHostAllowlist`。

706 710 

707`permissions.disableBypassPermissionsMode` 和 `disableAutoMode` 也在使用者和專案設定中運作，但將它們放在受管設定中可防止使用者覆蓋它們。`autoMode` 從使用者設定、`.claude/settings.local.json` 和受管設定讀取，但不從簽入的 `.claude/settings.json` 讀取：複製的儲存庫無法注入自己的分類器規則。有關受管專用設定（包括 `allowManagedPermissionRulesOnly` 和 `allowManagedHooksOnly`）的完整清單，請參閱[受管專用設定](/zh-TW/permissions#managed-only-settings)。711`permissions.disableBypassPermissionsMode` 和 `disableAutoMode` 也在使用者和專案設定中運作，但將它們放在受管設定中可防止使用者覆蓋它們。`autoMode` 從使用者設定、`.claude/settings.local.json` 和受管設定讀取，但不從簽入的 `.claude/settings.json` 讀取：複製的儲存庫無法注入自己的分類器規則。有關受管專用設定（包括 `allowManagedPermissionRulesOnly` 和 `allowManagedHooksOnly`）的完整清單，請參閱[受管專用設定](/zh-TW/permissions#managed-only-settings)。

708 712 

330 330 

331詳細檢視會顯示外掛程式貢獻的元件：命令、skills、agents、hooks、MCP servers 和 LSP servers。相同的清單也可從命令列透過 `claude plugin details` 取得。331詳細檢視會顯示外掛程式貢獻的元件：命令、skills、agents、hooks、MCP servers 和 LSP servers。相同的清單也可從命令列透過 `claude plugin details` 取得。

332 332 

333在 Claude Code v2.1.187 及更新版本中，Installed 標籤新增了 **Not used recently** 群組，用於您自己安裝但至少兩週內未叫用且跨越至少 10 個工作階段的 marketplace 外掛程式，詳細檢視會為每個外掛程式顯示 **Last used** 行。使用這些功能來找出您不再使用但仍在增加啟動和內容成本的外掛程式，然後停用或解除安裝它們。

334 

335您的組織管理的外掛程式或您使用 `--plugin-dir` 載入的外掛程式永遠不會列為未使用，貢獻 LSP server、theme、output style、monitor 或 workflow 的外掛程式也永遠不會列出，因為這些外掛程式提供價值而無需追蹤叫用。群組和 **Last used** 行在您的組織使用 [`strictKnownMarketplaces`](/zh-TW/settings#strictknownmarketplaces) 限制 marketplaces 時都會隱藏。

336 

333當您安裝聲明依賴項的外掛程式時，安裝輸出會列出哪些依賴項與其一起自動安裝。337當您安裝聲明依賴項的外掛程式時，安裝輸出會列出哪些依賴項與其一起自動安裝。

334 338 

335您也可以使用直接命令管理外掛程式。339您也可以使用直接命令管理外掛程式。

230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可以並行執行的唯讀工具和 subagents 的最大數量（預設值：10）。較高的值會增加並行性，但消耗更多資源 |230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可以並行執行的唯讀工具和 subagents 的最大數量（預設值：10）。較高的值會增加並行性，但消耗更多資源 |

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

232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 設定為 `1` 以使用僅安全基線環境加上伺服器配置的 `env` 而不是繼承您的 shell 環境來生成 stdio MCP 伺服器 |232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 設定為 `1` 以使用僅安全基線環境加上伺服器配置的 `env` 而不是繼承您的 shell 環境來生成 stdio MCP 伺服器 |

233| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}遠端 MCP 工具呼叫的閒置逾時（以毫秒為單位）（預設值：300000，或 5 分鐘）。當 HTTP、SSE、WebSocket 或 [claude.ai connector](/zh-TW/mcp#use-mcp-servers-from-claude-ai) MCP 伺服器在此期間內沒有發送回應和進度通知時，工具呼叫會中止並出現錯誤，而不是等待牆上時鐘 `MCP_TOOL_TIMEOUT`。設定為 `0` 以停用閒置檢查。低於 1000 的值會提高到 1 秒，該值上限為有效的 `MCP_TOOL_TIMEOUT`。不適用於 stdio 或 IDE 伺服器。需要 Claude Code v2.1.187 或更新版本 |

233| `CLAUDE_CODE_NATIVE_CURSOR` | 設定為 `1` 以在輸入插入符號處顯示終端自己的游標，而不是繪製的區塊。游標尊重終端的閃爍、形狀和焦點設定 |234| `CLAUDE_CODE_NATIVE_CURSOR` | 設定為 `1` 以在輸入插入符號處顯示終端自己的游標，而不是繪製的區塊。游標尊重終端的閃爍、形狀和焦點設定 |

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

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

55| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |55| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |

56| `There's an issue with the selected model` | [Request errors](#there%E2%80%99s-an-issue-with-the-selected-model) |56| `There's an issue with the selected model` | [Request errors](#there%E2%80%99s-an-issue-with-the-selected-model) |

57| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |57| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |

58| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organization%E2%80%99s-settings) |

58| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |59| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |

59| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |60| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |

60| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |61| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |

706* 如果您最近升級了計畫但仍然看到這個，請執行 `/logout` 然後 `/login`。儲存的令牌反映您登入時的計畫，因此在現有工作階段中升級網路不會生效，直到您重新認證。707* 如果您最近升級了計畫但仍然看到這個，請執行 `/logout` 然後 `/login`。儲存的令牌反映您登入時的計畫，因此在現有工作階段中升級網路不會生效，直到您重新認證。

707* 請參閱 [claude.com/pricing](https://claude.com/pricing) 以了解每個計畫包括哪些模型708* 請參閱 [claude.com/pricing](https://claude.com/pricing) 以了解每個計畫包括哪些模型

708 709 

710<h3 id="model-is-restricted-by-your-organization’s-settings">

711 Model is restricted by your organization's settings

712</h3>

713 

714您的組織管理員已在 Claude Console 中停用此模型，或它被受管設定中的 [`availableModels`](/zh-TW/model-config#restrict-model-selection) 允許清單排除。當受限制的模型使用 `--model`、`ANTHROPIC_MODEL` 或 `model` 設定設定時，Claude Code 會替換為允許的模型並繼續。為受限制的模型輸入 `/model <name>` 會被拒絕，並顯示 `Run /model to choose a different model.`，工作階段保持其目前的模型。

715 

716```text theme={null}

717Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

718```

719 

720**要做什麼：**

721 

722* 執行 `/model` 以從您的組織允許的模型中選擇。受限制的模型在選擇器中被隱藏。

723* 如果受限制的模型在 `--model`、`ANTHROPIC_MODEL` 或設定檔案的 `model` 欄位中設定，請移除或更新該值，以便通知不會在每次啟動時重複出現

724* 如果您需要存取受限制的模型，請要求您的組織管理員啟用它。請參閱 [Organization model restrictions](/zh-TW/model-config#organization-model-restrictions)。

725 

709<h3 id="thinking-type-enabled-is-not-supported-for-this-model">726<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

710 thinking.type.enabled is not supported for this model727 thinking.type.enabled is not supported for this model

711</h3>728</h3>

115* **Team 和 Enterprise 的管理員啟用**：快速模式預設對 Team 和 Enterprise 組織禁用。管理員必須明確[啟用快速模式](#enable-fast-mode-for-your-organization)，使用者才能存取它。115* **Team 和 Enterprise 的管理員啟用**：快速模式預設對 Team 和 Enterprise 組織禁用。管理員必須明確[啟用快速模式](#enable-fast-mode-for-your-organization)，使用者才能存取它。

116 116 

117<Note>117<Note>

118 如果您的管理員尚未為您的組織啟用快速模式，`/fast` 命令將顯示「Fast mode has been disabled by your organization.」如果您組織的 [`availableModels`](/zh-TW/model-config#restrict-model-selection) 允許清單排除了快速模式 Opus 模型，`/fast` 會被拒絕，顯示「is not in your organization's allowed models」。118 如果您的管理員尚未為您的組織啟用快速模式，`/fast` 命令將顯示「Fast mode has been disabled by your organization.」如果您組織的 [`availableModels`](/zh-TW/model-config#restrict-model-selection) 允許清單排除了快速模式 Opus 模型，`/fast` 會被拒絕，顯示「is not in your organization's allowed models」。例外情況是已在允許的 Opus 模型上執行的工作階段，該模型支援快速模式：`/fast` 則適用於該模型。

119</Note>119</Note>

120 120 

121<h3 id="enable-fast-mode-for-your-organization">121<h3 id="enable-fast-mode-for-your-organization">

56 56 

57* **在提示輸入中點擊**以在您輸入的文字中的任何位置定位游標。57* **在提示輸入中點擊**以在您輸入的文字中的任何位置定位游標。

58* **點擊 `/` 命令或 `@` 檔案清單中的建議**以接受它。懸停會突顯游標下的列。58* **點擊 `/` 命令或 `@` 檔案清單中的建議**以接受它。懸停會突顯游標下的列。

59* **點擊選擇功能表中的選項**以選擇它。這涵蓋權限提示、`/model`、`/config` 和其他顯示選項清單的對話框。懸停會在游標下的列上顯示指標。{/* min-version: 2.1.187 */}需要 Claude Code v2.1.187 或更新版本。

59* **點擊摺疊的工具結果**以展開它並查看完整輸出。再次點擊以摺疊。工具呼叫及其結果一起展開。只有有更多內容要顯示的訊息才可點擊。60* **點擊摺疊的工具結果**以展開它並查看完整輸出。再次點擊以摺疊。工具呼叫及其結果一起展開。只有有更多內容要顯示的訊息才可點擊。

60* **在 macOS 上按住 `Cmd`，或在 Linux 和 Windows 上按住 `Ctrl`，然後點擊 URL 或檔案路徑**以開啟它。工具輸出中的檔案路徑（例如在 Edit 或 Write 後列印的路徑）在您的預設應用程式中開啟。純 `http://` 和 `https://` URL 在您的瀏覽器中開啟。{/* min-version: 2.1.181 */}自 v2.1.181 起，不按住 `Cmd` 或 `Ctrl` 的純點擊不再開啟連結，符合原生終端行為。在 VS Code 整合終端和類似的基於 xterm.js 的終端中，Claude Code 遵從終端自己的連結處理程式，該處理程式使用相同的手勢。61* **在 macOS 上按住 `Cmd`，或在 Linux 和 Windows 上按住 `Ctrl`，然後點擊 URL 或檔案路徑**以開啟它。工具輸出中的檔案路徑（例如在 Edit 或 Write 後列印的路徑）在您的預設應用程式中開啟。純 `http://` 和 `https://` URL 在您的瀏覽器中開啟。{/* min-version: 2.1.181 */}自 v2.1.181 起，不按住 `Cmd` 或 `Ctrl` 的純點擊不再開啟連結，符合原生終端行為。在 VS Code 整合終端和類似的基於 xterm.js 的終端中，Claude Code 遵從終端自己的連結處理程式，該處理程式使用相同的手勢。

61* **點擊並拖曳**以在對話中的任何位置選擇文字。雙擊選擇一個單詞，符合 iTerm2 的單詞邊界，因此檔案路徑選擇為一個單位。三擊選擇該行。62* **點擊並拖曳**以在對話中的任何位置選擇文字。雙擊選擇一個單詞，符合 iTerm2 的單詞邊界，因此檔案路徑選擇為一個單位。三擊選擇該行。

44 快速設定44 快速設定

45</h2>45</h2>

46 46 

47設定此 action 的最簡單方法是透過終端機中的 Claude Code。只需開啟 claude 並執行 `/install-github-app`。47在 Claude Code 終端機中執行 `/install-github-app` 以互動方式設定整合。此命令會在您的儲存庫上安裝 Claude GitHub App，然後引導您完成新增 GitHub Actions 工作流程和 API 金鑰密鑰的步驟。

48 48 

49此命令將引導您完成 GitHub app 和所需密鑰的設定。49安裝 GitHub App 後，命令會詢問是否繼續進行 GitHub Actions 設定。在 Claude Code v2.1.187 及更新版本中，您可以選擇**暫時跳過**以僅安裝 App 並停止，然後透過再次執行 `/install-github-app` 返回工作流程和密鑰步驟。較早的版本會直接進行工作流程選擇。

50 50 

51<Note>51<Note>

52 * 您必須是儲存庫管理員才能安裝 GitHub app 並新增密鑰52 * 您必須是儲存庫管理員才能安裝 GitHub app 並新增密鑰

208 Managed settings208 Managed settings

209</h3>209</h3>

210 210 

211由 IT 或 DevOps 在組織範圍內強制執行的設定檔案，放置在 `~/.claude` 外的 OS 級路徑。使用者無法覆蓋或排除受管設定。使用此功能可實現安全策略、合規要求或整個機隊的標準化工具。211由 IT 或 DevOps 在組織範圍內強制執行的設定，透過管理員主控台從 Anthropic 的伺服器傳遞，或部署到 `~/.claude` 外的 OS 級路徑上的裝置。使用者無法從較低優先順序的範圍覆蓋受管設定。伺服器管理的傳遞適用於[符合條件的配置](/zh-TW/server-managed-settings#platform-availability)；請參閱[安全考量](/zh-TW/server-managed-settings#security-considerations)。使用此功能可實現安全策略、合規要求或整個機隊的標準化工具。

212 212 

213了解更多：[Server-managed settings](/zh-TW/server-managed-settings)213了解更多：[Server-managed settings](/zh-TW/server-managed-settings) · [Settings files](/zh-TW/settings#settings-files)

214 214 

215<h3 id="mcp-model-context-protocol">215<h3 id="mcp-model-context-protocol">

216 MCP (Model Context Protocol)216 MCP (Model Context Protocol)

268 * 按 `Ctrl+C` 以取消並恢復您的原始輸入268 * 按 `Ctrl+C` 以取消並恢復您的原始輸入

269 * 在空搜尋上按 `Backspace` 以取消269 * 在空搜尋上按 `Backspace` 以取消

270 270 

271搜尋顯示匹配的命令，搜尋詞醒目提示，因此您可以找到並重複使用先前的輸入。271搜尋會載入所選範圍中最近的 100 個唯一提示，重複項目會摺疊至最新出現。匹配的提示會顯示醒目提示的搜尋詞，因此您可以找到並重複使用先前的輸入。

272 272 

273<h2 id="background-bash-commands">273<h2 id="background-bash-commands">

274 背景 bash 命令274 背景 bash 命令

371答案出現後，覆蓋層接受這些按鍵。來自同一會話的較早側面問題會顯示為目前答案上方的淡色列表；它們保持在對話歷史之外，但在覆蓋層中保持可見，直到您清除它們。371答案出現後，覆蓋層接受這些按鍵。來自同一會話的較早側面問題會顯示為目前答案上方的淡色列表；它們保持在對話歷史之外，但在覆蓋層中保持可見，直到您清除它們。

372 372 

373| 按鍵 | 動作 |373| 按鍵 | 動作 |

374| :----------------------- | :------------------------------------------------------------------------------------------------ |374| :----------------------- | :------------------------------------------------------------------------------------------------------------------- |

375| `Space`、`Enter`、`Escape` | 關閉答案並返回提示 |375| `Space`、`Enter`、`Escape` | 關閉答案並返回提示 |

376| `Up` / `Down` | 捲動答案 |376| `Up` / `Down` | 捲動答案 |

377| `Left` / `Right` | {/* min-version: 2.1.187 */}在此答案和您來自會話的較早 `/btw` 答案之間切換。`Left` 移至較舊的答案，`Right` 返回目前的答案。需要 Claude Code v2.1.187 或更新版本 |

377| `c` | 將答案複製到您的剪貼簿作為原始 Markdown。使用此方式而不是滑鼠選取，後者會擷取硬換行的終端機呈現而非原始文字 |378| `c` | 將答案複製到您的剪貼簿作為原始 Markdown。使用此方式而不是滑鼠選取，後者會擷取硬換行的終端機呈現而非原始文字 |

378| `f` | 分支到新會話。分支繼承父對話加上此問題和答案作為真實文字記錄輪次，因此您可以繼續進行完整工具存取。原始會話保留在 [`/resume`](/zh-TW/commands) 下。僅在本機會話中可用 |379| `f` | 分支到新會話。分支繼承父對話加上此問題和答案作為真實文字記錄輪次，因此您可以繼續進行完整工具存取。原始會話保留在 [`/resume`](/zh-TW/commands) 下。僅在本機會話中可用 |

379| `x` | 清除目前答案上方顯示的較早 `/btw` 交換列表 |380| `x` | 清除目前答案上方顯示的較早 `/btw` 交換列表 |

218 218 

219每個 server 的 `timeout` 是每個工具呼叫的硬牆鐘限制，來自 server 的進度通知不會延長它。低於 1000 的值會被忽略並落回到 `MCP_TOOL_TIMEOUT`，或在該變數未設定時落回到其預設值約 28 小時。{/* min-version: 2.1.162 */}在 v2.1.162 之前，低於 1000 的值被調整為一秒。對於 HTTP 和 SSE servers，每個請求的 fetch 首位元組預算有 60 秒的最小值。219每個 server 的 `timeout` 是每個工具呼叫的硬牆鐘限制，來自 server 的進度通知不會延長它。低於 1000 的值會被忽略並落回到 `MCP_TOOL_TIMEOUT`，或在該變數未設定時落回到其預設值約 28 小時。{/* min-version: 2.1.162 */}在 v2.1.162 之前，低於 1000 的值被調整為一秒。對於 HTTP 和 SSE servers，每個請求的 fetch 首位元組預算有 60 秒的最小值。

220 220 

221自 v2.1.187 起，對遠端 HTTP、SSE、WebSocket 或 [claude.ai connector](#use-mcp-servers-from-claude-ai) server 的工具呼叫如果 5 分鐘內沒有傳送回應和進度通知，會以錯誤中止，而不是等待牆鐘限制。在毫秒中設定 [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/zh-TW/env-vars) 環境變數以變更閒置視窗，或將其設定為 `0` 以停用檢查。Stdio servers 是本機程序，不受閒置逾時限制。

222 

221<h3 id="plugin-provided-mcp-servers">223<h3 id="plugin-provided-mcp-servers">

222 Plugin 提供的 MCP servers224 Plugin 提供的 MCP servers

223</h3>225</h3>

90 90 

91`--model` 旗標和 `ANTHROPIC_MODEL` 環境變數僅適用於您啟動它們的會話。若要同時在不同終端中執行不同的模型，請使用各自的 `--model` 旗標啟動每個終端，而不是使用 `/model` 切換。91`--model` 旗標和 `ANTHROPIC_MODEL` 環境變數僅適用於您啟動它們的會話。若要同時在不同終端中執行不同的模型，請使用各自的 `--model` 旗標啟動每個終端，而不是使用 `/model` 切換。

92 92 

93使用 `claude --resume`、`--continue` 或 `/resume` 選擇器啟動的已恢復會話會保持它們在儲存文字記錄時使用的模型，無論目前的 `model` 設定如何。如果該模型已被淘汰，會話會回到正常的優先順序。這可防止另一個會話的 `/model` 選擇在恢復時改變模型。93使用 `claude --resume`、`--continue` 或 `/resume` 選擇器啟動的已恢復會話會保持它們在儲存文字記錄時使用的模型，無論目前的 `model` 設定如何。如果該模型已被淘汰或被 [`availableModels`](#restrict-model-selection) 排除，會話會回到正常的優先順序。這可防止另一個會話的 `/model` 選擇在恢復時改變模型。

94 94 

95當啟動時的活動模型來自專案或受管設定而非您自己的選擇時，啟動標題會顯示哪個設定檔設定了它。執行 `/model` 以覆蓋；專案或受管設定會在下次啟動時重新應用。95當啟動時的活動模型來自專案或受管設定而非您自己的選擇時，啟動標題會顯示哪個設定檔設定了它。執行 `/model` 以覆蓋；專案或受管設定會在下次啟動時重新應用。

96 96 

121 限制模型選擇121 限制模型選擇

122</h2>122</h2>

123 123 

124企業管理員可以在[受管理或政策設定](/zh-TW/settings#settings-files)中使用 `availableModels` 來限制使用者可以選擇的模型。124企業管理員可以在[受管理或政策設定](/zh-TW/settings#settings-files)中使用 `availableModels` 來限制使用者可以選擇的模型。項目符合模型系列（例如 `sonnet`）、版本前綴（例如 `claude-sonnet-4-5`）或完整模型 ID（例如 `claude-sonnet-4-5-20250929`）。

125 125 

126設定 `availableModels` 後，允許清單適用於使用者可以指定模型的每個位置：126設定 `availableModels` 後，允許清單適用於使用者可以指定模型的每個位置：

127 127 

128* **主要會話模型**：`/model`、`--model` 旗標和 `ANTHROPIC_MODEL` 環境變數128* **主要會話模型**：`/model`、`--model` 旗標、`ANTHROPIC_MODEL` 環境變數、`model` 設定，以及[恢復會話](#setting-your-model)時還原的模型

129* **別名解析**：{/* min-version: 2.1.176 */}`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL` 和 `ANTHROPIC_DEFAULT_FABLE_MODEL` 環境變數無法將允許的別名重新導向到清單外的模型129* **別名解析**：{/* min-version: 2.1.176 */}`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL` 和 `ANTHROPIC_DEFAULT_FABLE_MODEL` 環境變數無法將允許的別名重新導向到清單外的模型

130* **快速模式**：{/* min-version: 2.1.176 */}`/fast` 在隱含切換到清單外的 Opus 模型時拒絕切換，並顯示訊息「不在您組織的允許模型中」130* **快速模式**：{/* min-version: 2.1.176 */}`/fast` 在隱含切換到清單外的 Opus 模型時拒絕切換，並顯示訊息「不在您組織的允許模型中」

131* **子代理模型**：[子代理](/zh-TW/sub-agents#choose-a-model) frontmatter 中的 `model` 欄位、Agent 工具的 `model` 參數、`/agents` 中的模型選擇器，以及 `CLAUDE_CODE_SUBAGENT_MODEL`131* **子代理模型**：[子代理](/zh-TW/sub-agents#choose-a-model) frontmatter 中的 `model` 欄位、Agent 工具的 `model` 參數、`/agents` 中的模型選擇器，以及 `CLAUDE_CODE_SUBAGENT_MODEL`

132* **顧問模型**：已設定的 [`advisorModel`](/zh-TW/advisor) 設定132* **技能和命令模型**：[技能和命令](/zh-TW/skills)中的 `model` frontmatter

133* **後備鏈**：[後備模型鏈](#fallback-model-chains)外清單中的元素會被捨棄133* **顧問模型**：已設定的 [`advisorModel`](/zh-TW/advisor) 設定和 `--advisor` 旗標

134* **背景代理模型**：在[分派選擇器](/zh-TW/agent-view)中選擇的模型

134 135 

135使用 `/model` 切換到被阻止的模型會被拒絕並出現錯誤，而被阻止的 `--model` 旗標或 `ANTHROPIC_MODEL` 值在啟動時會被替換為警告，命名所要求和替代的模型，會話會在預設模型上啟動。被阻止的子代理或顧問覆蓋會回退到繼承或預設模型，而不是使請求失敗。136使用 `/model` 切換到被阻止的模型會被拒絕並出現錯誤，而被阻止的 `--model` 旗標、`ANTHROPIC_MODEL` 或 `model` 設定值在啟動時會被替換為警告，命名所要求和替代的模型，會話會在預設模型上啟動。被阻止的子代理、技能或命令覆蓋會回退到繼承或預設模型，而不是使請求失敗；被阻止的 `advisorModel` 設定會停用該會話的顧問，而被阻止的 `--advisor` 旗標值會在啟動時以錯誤退出。排除的模型會從 `/model` 選擇器中隱藏。

137 

138自動模型變更的檢查方式相同：[後備模型鏈](#fallback-model-chains)中清單外的元素會被捨棄，計畫模式升級（例如 [`opusplan`](#opusplan-model-setting)）到排除的模型會被跳過，以便計畫在會話的模型上繼續進行，而[自動模型後備](#automatic-model-fallback)的目標被排除時不會執行，因此標記的請求會以拒絕結束。當會話之後執行的模型在允許清單外時，啟用[快速模式](/zh-TW/fast-mode)會被拒絕。

136 139 

137```json theme={null}140```json theme={null}

138{141{

140}143}

141```144```

142 145 

146<h3 id="surface-coverage">

147 表面覆蓋

148</h3>

149 

150每個表面都會強制執行它接收的允許清單。哪個傳遞機制到達每個表面不同：

151 

152| 傳遞機制 | CLI 和 IDE | 桌面本機會話 | Web、行動和雲端會話 | Agent SDK 和非互動式 | Cowork |

153| :------------------------------------------------- | :-------- | :----- | :---------- | :-------------- | :-------- |

154| 來自管理員主控台的[伺服器管理設定](/zh-TW/server-managed-settings) | 強制執行 | 強制執行 | 強制執行 | 強制執行 | 未傳遞 |

155| [MDM 或受管理設定檔](/zh-TW/settings#settings-files) | 強制執行 | 強制執行 | 未傳遞 | 強制執行 | 在部署位置強制執行 |

156 

157* 雲端會話在[網路上的 Claude Code](/zh-TW/claude-code-on-the-web) 或桌面應用程式中執行，在 Anthropic 管理的 VM 上執行：部署到您的裝置的設定無法到達它們，因此請透過伺服器管理設定傳遞允許清單。雲端會話中的中途會話模型切換在要求的模型被允許清單排除時被拒絕。會話建立時的伺服器端拒絕適用於[組織模型限制](#organization-model-restrictions)，而不是 `availableModels` 設定鍵。

158* Cowork 是 Claude 桌面應用程式中的代理工作標籤，不是 Claude Code 表面，根據設計不接收伺服器管理設定。受管理設定檔在會話執行的位置存在時適用於 Cowork 會話；遠端 Cowork 會話在 Anthropic 管理的 VM 上執行，其中不存在裝置部署的檔案。

159* [第三方提供者](/zh-TW/server-managed-settings#platform-availability)（例如 Bedrock、Vertex AI、Foundry 和 [AWS 上的 Claude Platform](/zh-TW/claude-platform-on-aws)）上的會話不接收伺服器管理設定，因此請在那裡透過 MDM 或受管理設定檔傳遞允許清單。

160* 伺服器管理傳遞也需要會話使用組織登入或直接設定的 API 金鑰進行驗證。只透過 [`apiKeyHelper`](/zh-TW/settings#available-settings) 指令碼產生金鑰的艦隊應透過 MDM 或受管理設定檔傳遞允許清單。

161* 桌面代碼標籤也裝載 [SSH 會話](/zh-TW/desktop#ssh-sessions)，它們從執行所在的遠端主機讀取受管理設定檔。請參閱[桌面受管理設定](/zh-TW/desktop#managed-settings)。

162* claude.ai 和桌面應用程式中的模型選擇器會隱藏或灰顯您組織的允許清單排除的模型。選擇器狀態是使用者的便利；強制執行發生在會話中。

163 

143<h3 id="default-model-behavior">164<h3 id="default-model-behavior">

144 預設模型行為165 預設模型行為

145</h3>166</h3>

146 167 

147根據預設，模型選擇器中的「預設」選項不受 `availableModels` 影響。它始終保持可用，並代表系統的執行時預設值[基於使用者的訂閱層級](#default-model-setting)。168根據預設，模型選擇器中的「預設」選項不受 `availableModels` 影響，除非也設定了 [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model)。單獨使用 `availableModels` 會保持「預設」可用，根據[使用者的訂閱層級](#default-model-setting)解析為系統的執行時預設值。如果層級預設值是您想要限制的模型，也請設定 `enforceAvailableModels`。

148 169 

149若要將允許清單擴展到「預設」選項，請在受管理或政策設定中將 `enforceAvailableModels` 設定為 `true`，並搭配非空的 `availableModels` 清單。當層級預設值不在允許清單中時，「預設」會解析為第一個允許的項目，而不是層級預設值。這需要 Claude Code v2.1.175 或更新版本。170空的 `availableModels` 陣列永遠不會啟用「預設」模型強制執行：使用 `availableModels: []` 時，具名模型選擇會被阻止，但帳戶類型的「預設」模型無論 `enforceAvailableModels` 為何都保持可用。

150 171 

151空的 `availableModels` 陣列永遠不會啟用強制執行。即使使用 `availableModels: []`，使用者仍然可以使用其層級的「預設」模型來使用 Claude Code，無論 `enforceAvailableModels` 為何。172<h3 id="enforce-the-allowlist-for-the-default-model">

173 對「預設」模型強制執行允許清單

174</h3>

175 

176在受管理設定中將 `enforceAvailableModels: true` 與非空的 `availableModels` 一起設定，以將允許清單擴展到「預設」選項。這需要 Claude Code v2.1.175 或更新版本。

177 

178```json theme={null}

179{

180 "availableModels": ["sonnet", "haiku"],

181 "enforceAvailableModels": true

182}

183```

184 

185當使用者帳戶類型的預設模型不在允許清單中時，「預設」選項會改為解析為第一個 `availableModels` 項目，該項目命名允許的、可用的模型，而 `/model` 選擇器的「預設」列會顯示該模型。這適用於到達預設值的每個位置：會話啟動、在 `/model` 中選擇「預設」、[後備模型鏈](#fallback-model-chains)中的 `"default"` 關鍵字，以及排除選擇被捨棄時使用的後備。

186 

187當 `availableModels` 未設定或為空時，`enforceAvailableModels` 無效：使用 `availableModels: []` 時，帳戶類型的「預設」模型保持可用，因此該設定無法將使用者鎖定在每個模型之外。當 `availableModels` 非空但沒有項目解析為允許的、可用的模型時，強制執行會降級，「預設」會回退到帳戶類型預設值，警告僅在 `--debug` 下可見。在清單中保留至少一個保證可用的項目以避免這種情況。

188 

189在[最高優先順序受管理來源](/zh-TW/settings#settings-precedence)中部署兩個鍵：管理員部署的受管理來源不會合併，因此放在受管理設定檔中的一對在管理員主控台傳遞任何設定時會被忽略。

152 190 

153<h3 id="control-the-model-users-run-on">191<h3 id="control-the-model-users-run-on">

154 控制使用者執行的模型192 控制使用者執行的模型

155</h3>193</h3>

156 194 

157`model` 設定是初始選擇，而非強制執行。它設定會話啟動時哪個模型處於活動狀態，但使用者仍然可以開啟 `/model` 並選擇「預設」，這會解析為其層級的系統預設值，無論 `model` 設定為何。195`model` 設定是初始選擇，而非強制執行。它設定會話啟動時哪個模型處於活動狀態，但使用者仍然可以開啟 `/model` 並選擇「預設」，這會解析為其層級的系統預設值，無論 `model` 設定為何，除非 [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) 重新導向它。

158 196 

159若要完全控制模型體驗，請結合這些設定：197若要完全控制模型體驗，請結合這些設定：

160 198 

182 合併行為220 合併行為

183</h3>221</h3>

184 222 

185當 `availableModels` 僅在使用者、專案和本機設定中設定時，陣列會在這些層級中合併並去重。223當[最高優先順序受管理設定來源](/zh-TW/server-managed-settings#settings-precedence)定義 `availableModels` 時，該清單單獨適用：使用者、專案或本機設定中的項目無法擴展它，而管理員部署的受管理來源不會彼此合併，因此在伺服器管理設定傳遞任何鍵時，部署在受管理設定檔中的清單會被忽略。否則，來自使用者、專案和本機設定的清單會像其他陣列設定一樣[連接和去重](/zh-TW/settings#settings-precedence)。{/* min-version: 2.1.175 */}自 Claude Code v2.1.175 起，受管理清單會取代較低優先順序的項目；較早版本會合併它們。

186 224 

187當 `availableModels` 在受管理或政策設定中設定時，受管理或政策值會完全取代合併結果：在使用者或專案設定中新增的項目無法擴大它。受管理和政策設定以相同方式取代 `enforceAvailableModels` 的較低優先順序值。自 Claude Code v2.1.175 起，這是強制執行嚴格允許清單的唯一方式；較早版本會將受管理清單與較低優先順序項目合併。225在有效清單中，命名系列中特定模型的項目（無論是版本前綴還是完整模型 ID）會停用該系列的萬用字元項目：`["sonnet", "claude-sonnet-4-5"]` 只允許 Sonnet 4.5 版本，而不是每個 Sonnet 模型。

188 226 

189<h3 id="mantle-model-ids">227<h3 id="mantle-model-ids">

190 Mantle 模型 ID228 Mantle 模型 ID

191</h3>229</h3>

192 230 

193當[Bedrock Mantle 端點](/zh-TW/amazon-bedrock#use-the-mantle-endpoint)啟用時，`availableModels` 中以 `anthropic.` 開頭的項目會作為自訂選項新增到 `/model` 選擇器，並路由到 Mantle 端點。該設定仍然將選擇器限制為列出的項目，因此請在任何 Mantle ID 旁邊包含標準別名。231當[Bedrock Mantle 端點](/zh-TW/amazon-bedrock#use-the-mantle-endpoint)啟用時，`availableModels` 中以 `anthropic.` 開頭的項目會作為自訂選項新增到 `/model` 選擇器，並路由到 Mantle 端點。這是[為第三方部署固定模型](#pin-models-for-third-party-deployments)中描述的別名符合的例外。該設定仍然將選擇器限制為列出的項目，而 Mantle ID 嵌入系列名稱，因此它計為特定項目並停用該系列的萬用字元：在任何 Mantle ID 旁邊，列出您想要保持可選擇的版本前綴或完整 ID。請參閱[合併行為](#merge-behavior)。

232 

233<h3 id="organization-model-restrictions">

234 組織模型限制

235</h3>

236 

237當您的成員透過 Anthropic API 進行驗證，且您想要一個組織範圍的開關而不部署設定檔時，請使用主控台切換而不是 `availableModels`。組織管理員透過在 Claude 主控台中停用個別模型來限制成員可以執行的模型。此限制在 Claude Code 驗證時與帳戶的權利一起傳遞，與設定中的任何 `availableModels` 清單分開，而伺服器在建立會話時獨立強制執行相同的限制。需要 Claude Code v2.1.187 或更新版本。

238 

239受限制的模型會從 `/model` 選擇器中隱藏。使用 `--model`、`ANTHROPIC_MODEL` 環境變數或 `model` 設定按名稱選擇它會顯示通知 `Model "<name>" is restricted by your organization's settings. Using <model> instead.`，會話會在允許的模型上啟動。為受限制的模型輸入 `/model <name>` 會被拒絕，並顯示 `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`，會話會保持其目前模型。

240 

241這兩個機制組合：只有當模型被 `availableModels` 允許且未被組織限制時，它才可選擇。組織限制會傳遞到 Anthropic API 和 [LLM 閘道](/zh-TW/llm-gateway)部署上的會話。Bedrock、Vertex AI、Foundry 和 AWS 上的 Claude Platform 上的會話不接收它們，因此請改為在這些提供者上使用 `availableModels`。

194 242 

195<h2 id="special-model-behavior">243<h2 id="special-model-behavior">

196 特殊模型行為244 特殊模型行為

209 257 

210Enterprise 隨用隨付是指按使用量計費而非按訂閱席位計費的 Enterprise 組織。258Enterprise 隨用隨付是指按使用量計費而非按訂閱席位計費的 Enterprise 組織。

211 259 

260當受管設定[強制執行 Default 模型的允許清單](#enforce-the-allowlist-for-the-default-model)且帳戶類型預設不在 `availableModels` 中時，`default` 會解析為強制執行的 Default，而不是上述帳戶類型預設。

261 

212Fable 5 不是任何帳戶類型的預設模型。會話僅在您選擇 Fable 5 後才使用它，使用 `/model fable`、`model` 設定或 `best` 別名（其中 Fable 5 可用）。使用 `/model` 選擇它會將其儲存為您使用者設定中的選定模型，因此後續會話會在 Fable 5 上啟動，直到您變更模型。262Fable 5 不是任何帳戶類型的預設模型。會話僅在您選擇 Fable 5 後才使用它，使用 `/model fable`、`model` 設定或 `best` 別名（其中 Fable 5 可用）。使用 `/model` 選擇它會將其儲存為您使用者設定中的選定模型，因此後續會話會在 Fable 5 上啟動，直到您變更模型。

213 263 

214<h3 id="opusplan-model-setting">264<h3 id="opusplan-model-setting">

267 317 

268會話隨後在該 Opus 模型上繼續。若要返回 Fable 5，請執行 `/model fable`。318會話隨後在該 Opus 模型上繼續。若要返回 Fable 5，請執行 `/model fable`。

269 319 

320回退目標會根據 [`availableModels`](#restrict-model-selection) 進行檢查。當它被阻止時，不會發生回退。拒絕會作為正常錯誤出現，會話的模型保持不變。

321 

270<h4 id="check-what-triggered-fallback">322<h4 id="check-what-triggered-fallback">

271 檢查觸發回退的原因323 檢查觸發回退的原因

272</h4>324</h4>

286* 如果兩個模型都標記相同的請求，您可以編輯提示並重試，或啟動新會話。338* 如果兩個模型都標記相同的請求，您可以編輯提示並重試，或啟動新會話。

287* 在行動裝置 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 會話上，不支援編輯和重試。切換模型，或從桌面瀏覽器或桌面應用程式繼續會話。339* 在行動裝置 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 會話上，不支援編輯和重試。切換模型，或從桌面瀏覽器或桌面應用程式繼續會話。

288* 在 [non-interactive mode](/zh-TW/cli-reference#cli-flags) 和無法顯示提示的 SDK 整合中，標記的請求以拒絕結束輪次。340* 在 [non-interactive mode](/zh-TW/cli-reference#cli-flags) 和無法顯示提示的 SDK 整合中，標記的請求以拒絕結束輪次。

341* 當回退目標被 [`availableModels`](#restrict-model-selection) 阻止時，不會顯示提示。標記的請求以拒絕結束，與目標被阻止時的自動回退相同。

289 342 

290<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">343<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">

291 在 Bedrock、Vertex AI 和 Foundry 上啟用回退344 在 Bedrock、Vertex AI 和 Foundry 上啟用回退

452 505 

453自訂項目出現在 `/model` 選擇器的底部。`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` 和 `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` 是可選的。如果省略，模型 ID 會用作名稱，描述預設為 `Custom model (<model-id>)`。506自訂項目出現在 `/model` 選擇器的底部。`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` 和 `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` 是可選的。如果省略，模型 ID 會用作名稱，描述預設為 `Custom model (<model-id>)`。

454 507 

455Claude Code 會跳過在 `ANTHROPIC_CUSTOM_MODEL_OPTION` 中設定的模型 ID 的驗證，因此您可以使用您的 API 端點接受的任何字串。508Claude Code 會跳過在 `ANTHROPIC_CUSTOM_MODEL_OPTION` 中設定的模型 ID 的驗證，因此您可以使用您的 API 端點接受的任何字串。當設定 [`availableModels`](#restrict-model-selection) 時，也要在允許清單中包含自訂模型 ID：自訂項目會從選擇器中篩選出來，對其進行 `--model` 選擇會被拒絕，就像任何其他被排除的模型一樣。嵌入家族名稱的自訂 ID（例如 `my-gateway/claude-opus-4-7`）會計為該家族的特定項目，並停用其萬用字元，因此也要列出您打算保持可選擇的版本。請參閱 [合併行為](#merge-behavior)。

456 509 

457<h2 id="environment-variables">510<h2 id="environment-variables">

458 環境變數511 環境變數

505* 後綴是按變數讀取的，而不是按模型讀取的。在 Bedrock、Vertex 和 Foundry 上，一個變數中沒有 `[1m]` 的模型 ID 會使用 200K context，即使另一個變數設定相同的模型並帶有後綴。558* 後綴是按變數讀取的，而不是按模型讀取的。在 Bedrock、Vertex 和 Foundry 上，一個變數中沒有 `[1m]` 的模型 ID 會使用 200K context，即使另一個變數設定相同的模型並帶有後綴。

506 559 

507<Note>560<Note>

508 使用第三方提供者時，`settings.availableModels` 允許清單仍然適用。篩選會根據模型別名（例如 `opus`）、版本前綴（例如 `claude-opus-4-8`）或完整模型 ID 進行匹配。任何 `[1m]` 後綴會從允許清單項目和請求的模型中移除，因此 `claude-opus-4-8` 的項目允許標準和 1M-context Opus 列。提供者特定的前綴（例如 `us.anthropic.`）不會被移除：在 `availableModels` 中列出選擇器顯示的相同形式，或透過 [`modelOverrides`](#override-model-ids-per-version) 對應它。561 使用第三方提供者時，透過 [MDM 或受管設定檔](/zh-TW/settings#settings-files) 傳遞的 `availableModels` 允許清單仍然適用；[伺服器管理的設定不會在那裡傳遞](/zh-TW/server-managed-settings#platform-availability)。篩選會根據模型別名（例如 `opus`）、版本前綴（例如 `claude-opus-4-8`）或完整提供者形式模型 ID 進行匹配。提供者特定的前綴（例如 `us.anthropic.`）不會被移除，因此若要允許特定模型，請列出選擇器顯示的相同提供者形式 ID，或透過 [`modelOverrides`](#override-model-ids-per-version) 對應它。任何 `[1m]` 後綴會從允許清單項目和請求的模型中移除，然後進行匹配。

509</Note>562</Note>

510 563 

511<h3 id="customize-pinned-model-display-and-capabilities">564<h3 id="customize-pinned-model-display-and-capabilities">

572 625 

573覆蓋會取代支援 `/model` 選擇器中每個項目的內建模型 ID。在 Bedrock 上，覆蓋優先於 Claude Code 在啟動時自動發現的任何推論設定檔。您直接透過 `ANTHROPIC_MODEL`、`--model` 或 `ANTHROPIC_DEFAULT_*_MODEL` 環境變數提供的值會按原樣傳遞給提供者，不會由 `modelOverrides` 轉換。626覆蓋會取代支援 `/model` 選擇器中每個項目的內建模型 ID。在 Bedrock 上，覆蓋優先於 Claude Code 在啟動時自動發現的任何推論設定檔。您直接透過 `ANTHROPIC_MODEL`、`--model` 或 `ANTHROPIC_DEFAULT_*_MODEL` 環境變數提供的值會按原樣傳遞給提供者，不會由 `modelOverrides` 轉換。

574 627 

575`modelOverrides` 與 `availableModels` 一起運作。允許清單會根據 Anthropic 模型 ID 進行評估，而不是覆蓋值，因此 `availableModels` 中的項目（如 `"opus"`）即使 Opus 版本對應到 ARN 時仍會繼續匹配。628`modelOverrides` 與 `availableModels` 一起運作。允許清單會根據 Anthropic 模型 ID 進行評估，而不是覆蓋值，因此 `availableModels` 中的項目（如 `"opus"`）即使 Opus 版本對應到 ARN 時仍會繼續匹配。當在受管設定中設定 `enforceAvailableModels` 時，強制執行的預設值會從[最高優先順序受管來源](/zh-TW/server-managed-settings#settings-precedence)透過 `modelOverrides` 解析。管理員的對應（例如固定到推論設定檔 ARN 的版本）會在強制執行的預設值中受到尊重。來自使用者或專案設定的覆蓋不會影響它。

576 629 

577<h3 id="prompt-caching-configuration">630<h3 id="prompt-caching-configuration">

578 Prompt caching 配置631 Prompt caching 配置

1164 1164 

1165Claude Code 在內部重試失敗的 API 請求，並僅在放棄後才發出單個 `claude_code.api_error` 事件，因此事件本身是該請求的終端訊號。中間重試嘗試不會作為單獨的事件記錄。1165Claude Code 在內部重試失敗的 API 請求，並僅在放棄後才發出單個 `claude_code.api_error` 事件，因此事件本身是該請求的終端訊號。中間重試嘗試不會作為單獨的事件記錄。

1166 1166 

1167事件上的 `attempt` 屬性記錄進行的嘗試總次數。大於 `CLAUDE_CODE_MAX_RETRIES`（預設 `10`）的值表示請求在暫時性錯誤上耗盡了所有重試。較低的值表示不可重試的錯誤，例如 `400` 回應。1167事件上的 `attempt` 屬性記錄進行的嘗試總次數。`CLAUDE_CODE_MAX_RETRIES` 預設為 10，上限為 15。當請求在暫時性錯誤上耗盡所有重試時，`attempt` 等於該有效限制加一：預設為 11，永遠不超過 16。較低的值表示不可重試的錯誤，例如 `400` 回應。

1168 1168 

1169若要區分從一個恢復的工作階段與停滯的工作階段，請按 `session.id` 分組事件，並檢查錯誤後是否存在更晚的 `api_request` 事件。1169若要區分從一個恢復的工作階段與停滯的工作階段，請按 `session.id` 分組事件，並檢查錯誤後是否存在更晚的 `api_request` 事件。

1170 1170 

202 202 

203`allowRead` 中的 `.` 解析為專案根目錄，因為此配置位於專案設定中。如果您將相同的配置放在 `~/.claude/settings.json` 中，`.` 將解析為 `~/.claude`，專案檔案將保持被 `denyRead` 規則阻止。203`allowRead` 中的 `.` 解析為專案根目錄，因為此配置位於專案設定中。如果您將相同的配置放在 `~/.claude/settings.json` 中，`.` 將解析為 `~/.claude`，專案檔案將保持被 `denyRead` 規則阻止。

204 204 

205<h3 id="protect-credentials">

206 保護認證

207</h3>

208 

209`sandbox.credentials` 設定聲明沙箱化命令不得存取的認證檔案和環境變數。列出的檔案路徑在沙箱內被拒絕讀取，與 `filesystem.denyRead` 應用的區塊相同，列出的環境變數在每個沙箱化命令執行前被取消設定。專用的 `credentials` 區塊將認證規則與環境變數取消設定分組，並與一般檔案系統規則分開。需要 Claude Code v2.1.187 或更新版本。

210 

211下面的範例阻止讀取 AWS 認證檔案和 SSH 目錄，並從沙箱化命令的環境中移除 `GITHUB_TOKEN` 和 `NPM_TOKEN`：

212 

213```json theme={null}

214{

215 "sandbox": {

216 "enabled": true,

217 "credentials": {

218 "files": [

219 { "path": "~/.aws/credentials", "mode": "deny" },

220 { "path": "~/.ssh", "mode": "deny" }

221 ],

222 "envVars": [

223 { "name": "GITHUB_TOKEN", "mode": "deny" },

224 { "name": "NPM_TOKEN", "mode": "deny" }

225 ]

226 }

227 }

228}

229```

230 

231每個項目都帶有 `"mode": "deny"`，這是唯一支援的值。明確的 `mode` 欄位使架構與未來的模式向前相容。檔案路徑遵循與 `sandbox.filesystem.*` 設定相同的 [prefix rules](/zh-TW/settings#sandbox-path-prefixes)，來自每個 [settings scope](/zh-TW/settings#settings-precedence) 的項目被合併。因為唯一的模式是 `deny`，任何範圍都可以新增限制，但沒有任何範圍可以移除它們。

232 

233沒有內建的認證拒絕清單，因此只有您列出的檔案和變數被限制。此設定僅影響沙箱化 Bash 命令。若要從所有子流程中移除 Anthropic 和雲端提供者認證，無論沙箱化如何，請設定 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/zh-TW/env-vars)。

234 

205<h2 id="how-sandboxing-works">235<h2 id="how-sandboxing-works">

206 沙箱化如何運作236 沙箱化如何運作

207</h2>237</h2>

213沙箱化 Bash 工具將檔案系統存取限制在特定目錄：243沙箱化 Bash 工具將檔案系統存取限制在特定目錄：

214 244 

215* **預設寫入行為**：對目前工作目錄及其子目錄的讀取和寫入存取，加上 `$TMPDIR` 指向的工作階段暫存目錄245* **預設寫入行為**：對目前工作目錄及其子目錄的讀取和寫入存取，加上 `$TMPDIR` 指向的工作階段暫存目錄

216* **預設讀取行為**：對整個電腦的讀取存取，除了某些被拒絕的目錄。請注意，此預設仍允許讀取認證檔案，例如 `~/.aws/credentials` 和 `~/.ssh/`。將它們新增到 `denyRead` 以阻止它們。246* **預設讀取行為**：對整個電腦的讀取存取，除了某些被拒絕的目錄。請注意，此預設仍允許讀取認證檔案，例如 `~/.aws/credentials` 和 `~/.ssh/`。使用 [`sandbox.credentials`](#protect-credentials) 來阻止讀取這些檔案並取消設定祕密環境變數，或將路徑新增到 `denyRead`。

217* **被阻止的存取**：無法在沒有明確權限的情況下修改目前工作目錄和工作階段暫存目錄外的檔案，包括 shell 配置檔案（例如 `~/.bashrc`）和 `/bin/` 中的系統二進位檔案247* **被阻止的存取**：無法在沒有明確權限的情況下修改目前工作目錄和工作階段暫存目錄外的檔案，包括 shell 配置檔案（例如 `~/.bashrc`）和 `/bin/` 中的系統二進位檔案

218* **Git worktrees**：當工作目錄是[連結的 git worktree](/zh-TW/worktrees)時，沙箱也允許寫入主儲存庫的共享 `.git` 目錄，以便 `git commit` 等命令可以更新 refs 和索引。對該目錄內的 `hooks/` 和 `config` 的寫入仍然被拒絕。248* **Git worktrees**：當工作目錄是[連結的 git worktree](/zh-TW/worktrees)時，沙箱也允許寫入主儲存庫的共享 `.git` 目錄，以便 `git commit` 等命令可以更新 refs 和索引。對該目錄內的 `hooks/` 和 `config` 的寫入仍然被拒絕。

219* **可配置**：通過設定定義自訂允許和拒絕的路徑249* **可配置**：通過設定定義自訂允許和拒絕的路徑

326* **`failIfUnavailable`**：缺少的依賴項（例如 Linux 上的 bubblewrap）會阻止 Claude Code 啟動，而不是顯示警告並回退到未沙箱化執行356* **`failIfUnavailable`**：缺少的依賴項（例如 Linux 上的 bubblewrap）會阻止 Claude Code 啟動，而不是顯示警告並回退到未沙箱化執行

327* **`allowUnsandboxedCommands: false`**：`dangerouslyDisableSandbox` 逃生艙被忽略，因此在沙箱下失敗的命令無法在其外重試357* **`allowUnsandboxedCommands: false`**：`dangerouslyDisableSandbox` 逃生艙被忽略，因此在沙箱下失敗的命令無法在其外重試

328 358 

329值得考慮與它們一起的兩個補充。為任何必須在沒有隔離的情況下執行的組織批准的工具新增 `excludedCommands`。為認證目錄（例如 `~/.aws` 和 `~/.ssh`）新增 [`denyRead`](#filesystem-isolation) 項目，預設讀取策略仍允許這些。359值得考慮與它們一起的兩個補充。為任何必須在沒有隔離的情況下執行的組織批准的工具新增 `excludedCommands`。為認證目錄（例如 `~/.aws` 和 `~/.ssh`）和祕密環境變數新增 [`sandbox.credentials`](#protect-credentials) 項目，因為預設讀取策略仍允許這些。

330 360 

331沙箱不在原生 Windows 上執行，因此如果您的機隊包括 Windows 主機，請將此配置限制在 macOS 和 Linux，或讓這些使用者在 WSL2 或容器內執行 Claude Code。361沙箱不在原生 Windows 上執行，因此如果您的機隊包括 Windows 主機，請將此配置限制在 macOS 和 Linux，或讓這些使用者在 WSL2 或容器內執行 Claude Code。

332 362 

417 447 

418* **內建檔案工具**：Read、Edit 和 Write 直接使用權限系統，而不是通過沙箱執行。請參閱 [permissions](/zh-TW/permissions)。448* **內建檔案工具**：Read、Edit 和 Write 直接使用權限系統，而不是通過沙箱執行。請參閱 [permissions](/zh-TW/permissions)。

419* **電腦使用**：當 Claude 打開應用程式並控制您的螢幕時，它在您的實際桌面上執行，而不是在隔離環境中。每個應用程式的權限提示控制每個應用程式。請參閱 [CLI 中的電腦使用](/zh-TW/computer-use) 或 [Desktop 中的電腦使用](/zh-TW/desktop#let-claude-use-your-computer)。449* **電腦使用**：當 Claude 打開應用程式並控制您的螢幕時，它在您的實際桌面上執行，而不是在隔離環境中。每個應用程式的權限提示控制每個應用程式。請參閱 [CLI 中的電腦使用](/zh-TW/computer-use) 或 [Desktop 中的電腦使用](/zh-TW/desktop#let-claude-use-your-computer)。

420* **環境變數**：沙箱化 Bash 命令預設繼承父流程環境，包括在那裡設定的任何認證。若要從子流程中去除 Anthropic 和雲端提供商認證，請設定 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/zh-TW/env-vars)。450* **環境變數**：沙箱化 Bash 命令預設繼承父流程環境，包括在那裡設定的任何認證。使用 [`sandbox.credentials`](#protect-credentials) 為沙箱化命令取消設定特定變數，或設定 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/zh-TW/env-vars) 以從所有子流程中去除 Anthropic 和雲端提供商認證。

421* **子代理**：[subagents](/zh-TW/sub-agents) 在與父工作階段相同的流程中執行，並使用相同的沙箱配置。當在父工作階段中啟用沙箱化時，子代理內的 Bash 命令被沙箱化。451* **子代理**：[subagents](/zh-TW/sub-agents) 在與父工作階段相同的流程中執行，並使用相同的沙箱配置。當在父工作階段中啟用沙箱化時，子代理內的 Bash 命令被沙箱化。

422 452 

423<Warning>453<Warning>

6 6 

7> 透過伺服器傳遞的設定在 Claude.ai 上為您的組織集中設定 Claude Code，無需裝置管理基礎設施。7> 透過伺服器傳遞的設定在 Claude.ai 上為您的組織集中設定 Claude Code，無需裝置管理基礎設施。

8 8 

9伺服器管理的設定允許管理員透過 Claude.ai 上的網頁介面集中設定 Claude Code。Claude Code 用戶端在使用者使用其組織認證進行身份驗證時會自動接收這些設定。9伺服器管理的設定允許管理員透過 Claude.ai 上的網頁介面集中設定 Claude Code。Claude Code 用戶端在使用者使用其組織 OAuth 登入或直接設定的 API 金鑰進行身份驗證時會自動接收這些設定，在支援伺服器管理傳遞的平台上。請參閱[平台可用性](#platform-availability)。

10 10 

11此方法適用於沒有裝置管理基礎設施的組織，或需要為非受管裝置上的使用者管理設定的組織。11此方法適用於沒有裝置管理基礎設施的組織，或需要為非受管裝置上的使用者管理設定的組織。

12 12 

35| **伺服器管理的設定** | 沒有 MDM 的組織，或非受管裝置上的使用者 | 在身份驗證時從 Anthropic 伺服器傳遞的設定 |35| **伺服器管理的設定** | 沒有 MDM 的組織，或非受管裝置上的使用者 | 在身份驗證時從 Anthropic 伺服器傳遞的設定 |

36| **[端點管理的設定](/zh-TW/settings#settings-files)** | 具有 MDM 或端點管理的組織 | 透過 MDM 設定檔、登錄原則或受管設定檔部署到裝置的設定 |36| **[端點管理的設定](/zh-TW/settings#settings-files)** | 具有 MDM 或端點管理的組織 | 透過 MDM 設定檔、登錄原則或受管設定檔部署到裝置的設定 |

37 37 

38如果您的裝置已在 MDM 或端點管理解決方案中註冊，端點管理的設定提供更強的安全保證，因為設定檔可以在作業系統層級受到保護，防止使用者修改。38如果您的裝置已在 MDM 或端點管理解決方案中註冊，端點管理的設定提供更強的安全保證，因為設定檔可以在作業系統層級受到保護，防止使用者修改。端點管理的設定不會到達 [雲端工作階段](/zh-TW/model-config#surface-coverage)，因此在網路上使用 Claude Code 的組織也應該設定伺服器管理的設定。

39 39 

40<h2 id="configure-server-managed-settings">40<h2 id="configure-server-managed-settings">

41 設定伺服器管理的設定41 設定伺服器管理的設定

228 平台可用性228 平台可用性

229</h2>229</h2>

230 230 

231伺服器管理的設定需要直接連線到 `api.anthropic.com`，在使用第三方模型提供者時無法使用：231伺服器管理的設定需要直接連線到 `api.anthropic.com`，並且傳遞需要工作階段使用組織 OAuth 登入或直接配置的 API 金鑰進行驗證：由 [`apiKeyHelper`](/zh-TW/settings#available-settings) 指令碼傳回的金鑰不會觸發設定擷取。在使用第三方模型提供者時，伺服器管理的設定無法使用：

232 232 

233* Amazon Bedrock233* Amazon Bedrock

234* Google Vertex AI234* Google Vertex AI

235* Microsoft Foundry235* Microsoft Foundry

236* [Claude Platform on AWS](/zh-TW/claude-platform-on-aws)

236* 透過 `ANTHROPIC_BASE_URL` 或 [LLM 閘道](/zh-TW/llm-gateway) 的自訂 API 端點237* 透過 `ANTHROPIC_BASE_URL` 或 [LLM 閘道](/zh-TW/llm-gateway) 的自訂 API 端點

237 238 

238<h2 id="audit-logging">239<h2 id="audit-logging">

250伺服器管理的設定提供集中式原則強制執行，但它們作為用戶端控制運作。在非受管裝置上，具有管理員或 sudo 存取權的使用者可以修改 Claude Code 二進位檔、檔案系統或網路設定。251伺服器管理的設定提供集中式原則強制執行，但它們作為用戶端控制運作。在非受管裝置上，具有管理員或 sudo 存取權的使用者可以修改 Claude Code 二進位檔、檔案系統或網路設定。

251 252 

252| 情況 | 行為 |253| 情況 | 行為 |

253| :-------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |254| :-------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

254| 使用者編輯快取的設定檔 | 篡改的檔案在啟動時套用，但正確的設定會在下次伺服器擷取時還原 |255| 使用者編輯快取的設定檔 | 篡改的檔案在啟動時套用，但正確的設定會在下次伺服器擷取時還原 |

255| 使用者刪除快取的設定檔 | 首次啟動行為發生：設定非同步擷取，有一個簡短的未強制執行視窗 |256| 使用者刪除快取的設定檔 | 首次啟動行為發生：設定非同步擷取，有一個簡短的未強制執行視窗 |

256| API 無法使用 | 如果可用，快取設定會套用，否則受管設定在下次成功擷取之前不會強制執行。使用 `forceRemoteSettingsRefresh: true` 時，CLI 會結束而不是繼續，除了 [`claude auth` 子命令](#enforce-fail-closed-startup) |257| API 無法使用 | 如果可用，快取設定會套用，否則受管設定在下次成功擷取之前不會強制執行。使用 `forceRemoteSettingsRefresh: true` 時，CLI 會結束而不是繼續，除了 [`claude auth` 子命令](#enforce-fail-closed-startup) |

257| 使用者使用不同的組織進行身份驗證 | 不會為受管組織外的帳戶傳遞設定 |258| 使用者使用不同的組織進行身份驗證 | 不會為受管組織外的帳戶傳遞設定 |

258| 使用者設定[第三方模型提供者](#platform-availability) | 伺服器管理的設定會被略過。這包括設定 `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_MANTLE`、`CLAUDE_CODE_USE_VERTEX`、`CLAUDE_CODE_USE_FOUNDRY` 或非預設的 `ANTHROPIC_BASE_URL` |259| 使用者設定[第三方模型提供者](#platform-availability) | 伺服器管理的設定會被略過。這包括設定 `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_MANTLE`、`CLAUDE_CODE_USE_VERTEX`、`CLAUDE_CODE_USE_FOUNDRY`、`CLAUDE_CODE_USE_ANTHROPIC_AWS` 或非預設的 `ANTHROPIC_BASE_URL` |

259 260 

260若要偵測執行時期設定變更，請使用 [`ConfigChange` hooks](/zh-TW/hooks#configchange) 來記錄修改或在未授權的變更生效前阻止它們。261若要偵測執行時期設定變更，請使用 [`ConfigChange` hooks](/zh-TW/hooks#configchange) 來記錄修改或在未授權的變更生效前阻止它們。

261 262 

19</h3>19</h3>

20 20 

21| 範圍 | 位置 | 影響對象 | 與團隊共享？ |21| 範圍 | 位置 | 影響對象 | 與團隊共享？ |

22| :---------- | :----------------------------------------------- | :--------- | :------------ |22| :---------- | :----------------------------------------------- | :---------------------------------------------------------- | :------------ |

23| **Managed** | 伺服器管理的設定、plist / 登錄或系統層級 `managed-settings.json` | 機器上的所有使用者 | 是（由 IT 部署） |23| **Managed** | 伺服器管理的設定、plist / 登錄或系統層級 `managed-settings.json` | 伺服器管理交付的所有組織成員；plist、HKLM 登錄和檔案交付的機器上的所有使用者；HKCU 登錄交付的目前使用者 | 是（由 IT 部署） |

24| **User** | `~/.claude/` 目錄 | 您，跨所有專案 | 否 |24| **User** | `~/.claude/` 目錄 | 您，跨所有專案 | 否 |

25| **Project** | 儲存庫中的 `.claude/` | 此儲存庫的所有協作者 | 是（提交到 git） |25| **Project** | 儲存庫中的 `.claude/` | 此儲存庫的所有協作者 | 是（提交到 git） |

26| **Local** | `.claude/settings.local.json` | 您，僅在此儲存庫中 | 否（gitignored） |26| **Local** | `.claude/settings.local.json` | 您，僅在此儲存庫中 | 否（gitignored） |

230| `autoMode` | 自訂[自動模式](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)分類器阻止和允許的內容。包含 `environment`、`allow`、`soft_deny` 和 `hard_deny` 陣列的散文規則。在陣列中包含字面字串 `"$defaults"` 以在該位置繼承內建規則。請參閱[設定自動模式](/zh-TW/auto-mode-config)。不從共享專案設定讀取 | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |230| `autoMode` | 自訂[自動模式](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)分類器阻止和允許的內容。包含 `environment`、`allow`、`soft_deny` 和 `hard_deny` 陣列的散文規則。在陣列中包含字面字串 `"$defaults"` 以在該位置繼承內建規則。請參閱[設定自動模式](/zh-TW/auto-mode-config)。不從共享專案設定讀取 | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

231| `autoScrollEnabled` | 在[全螢幕渲染](/zh-TW/fullscreen)中，跟隨新輸出到對話的底部。預設：`true`。在 `/config` 中顯示為**自動捲軸**。當此設定關閉時，權限提示仍會捲軸進入檢視 | `false` |231| `autoScrollEnabled` | 在[全螢幕渲染](/zh-TW/fullscreen)中，跟隨新輸出到對話的底部。預設：`true`。在 `/config` 中顯示為**自動捲軸**。當此設定關閉時，權限提示仍會捲軸進入檢視 | `false` |

232| `autoUpdatesChannel` | 遵循更新的發行頻道。使用 `"stable"` 以取得通常約一週舊的版本並跳過有重大迴歸的版本，或 `"latest"`（預設）以取得最新版本。若要完全停用自動更新，請在 `env` 中設定 [`DISABLE_AUTOUPDATER`](/zh-TW/setup#disable-auto-updates) | `"stable"` |232| `autoUpdatesChannel` | 遵循更新的發行頻道。使用 `"stable"` 以取得通常約一週舊的版本並跳過有重大迴歸的版本，或 `"latest"`（預設）以取得最新版本。若要完全停用自動更新，請在 `env` 中設定 [`DISABLE_AUTOUPDATER`](/zh-TW/setup#disable-auto-updates) | `"stable"` |

233| `availableModels` | 限制使用者可以為主工作階段、[subagents](/zh-TW/sub-agents) 和 [advisor](/zh-TW/advisor) 選擇的模型。請參閱[限制模型選擇](/zh-TW/model-config#restrict-model-selection)。另請參閱 `enforceAvailableModels` 以同時限制預設模型 | `["sonnet", "haiku"]` |233| `availableModels` | 限制使用者可以為主工作階段、[subagents](/zh-TW/sub-agents)、[skills](/zh-TW/skills) 和 [advisor](/zh-TW/advisor) 選擇的模型。不影響預設選項，除非 `enforceAvailableModels` 也設定。請參閱[限制模型選擇](/zh-TW/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |

234| `awaySummaryEnabled` | 在您離開終端機幾分鐘後返回時顯示單行工作階段摘要。設定為 `false` 或在 `/config` 中關閉工作階段摘要以停用。與 [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/zh-TW/env-vars) 相同 | `true` |234| `awaySummaryEnabled` | 在您離開終端機幾分鐘後返回時顯示單行工作階段摘要。設定為 `false` 或在 `/config` 中關閉工作階段摘要以停用。與 [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/zh-TW/env-vars) 相同 | `true` |

235| `awsAuthRefresh` | 修改 `.aws` 目錄的自訂指令碼（請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)） | `aws sso login --profile myprofile` |235| `awsAuthRefresh` | 修改 `.aws` 目錄的自訂指令碼（請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)） | `aws sso login --profile myprofile` |

236| `awsCredentialExport` | 輸出包含 AWS 認證的 JSON 的自訂指令碼（請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)） | `/bin/generate_aws_grant.sh` |236| `awsCredentialExport` | 輸出包含 AWS 認證的 JSON 的自訂指令碼（請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)） | `/bin/generate_aws_grant.sh` |

258| `effortLevel` | 跨工作階段持久化[努力等級](/zh-TW/model-config#adjust-effort-level)。接受 `"low"`、`"medium"`、`"high"` 或 `"xhigh"`。當您執行 `/effort` 時自動寫入，其中包含其中一個值。`--effort` 和 [`CLAUDE_CODE_EFFORT_LEVEL`](/zh-TW/env-vars) 會覆蓋此設定以進行一個工作階段。請參閱[調整努力等級](/zh-TW/model-config#adjust-effort-level)以了解支援的模型 | `"xhigh"` |258| `effortLevel` | 跨工作階段持久化[努力等級](/zh-TW/model-config#adjust-effort-level)。接受 `"low"`、`"medium"`、`"high"` 或 `"xhigh"`。當您執行 `/effort` 時自動寫入，其中包含其中一個值。`--effort` 和 [`CLAUDE_CODE_EFFORT_LEVEL`](/zh-TW/env-vars) 會覆蓋此設定以進行一個工作階段。請參閱[調整努力等級](/zh-TW/model-config#adjust-effort-level)以了解支援的模型 | `"xhigh"` |

259| `enableAllProjectMcpServers` | 自動批准專案 `.mcp.json` 檔案中定義的所有 MCP servers | `true` |259| `enableAllProjectMcpServers` | 自動批准專案 `.mcp.json` 檔案中定義的所有 MCP servers | `true` |

260| `enabledMcpjsonServers` | 要批准的 `.mcp.json` 檔案中特定 MCP servers 的清單 | `["memory", "github"]` |260| `enabledMcpjsonServers` | 要批准的 `.mcp.json` 檔案中特定 MCP servers 的清單 | `["memory", "github"]` |

261| `enforceAvailableModels` | {/* min-version: 2.1.175 */}當為 `true` 且 `availableModels` 是 managed 或政策設定中的非空清單時，預設模型也受限於白名單。請參閱[限制模型選擇](/zh-TW/model-config#restrict-model-selection)以了解詳細資訊和[合併行為](/zh-TW/model-config#merge-behavior)（當 `availableModels` 在多個層級設定時）。需要 Claude Code v2.1.175 或更新版本 | `true` |261| `enforceAvailableModels` | {/* min-version: 2.1.175 */}將 `availableModels` 白名單擴展到預設模型。當在 managed 設定中為 `true` 且 `availableModels` 是非空陣列時，預設選項會回退到第一個可用的白名單項目。當 `availableModels` 未設定或為空時無效。請參閱[為預設模型強制執行白名單](/zh-TW/model-config#enforce-the-allowlist-for-the-default-model)。需要 Claude Code v2.1.175 或更新版本 | `true` |

262| `env` | 應用於每個工作階段和 Claude Code 從中產生的子流程的環境變數。{/* min-version: 2.1.143 */}自 v2.1.143 起，此處設定的 `NO_COLOR` 和 `FORCE_COLOR` 會傳遞到子流程，但不會改變 Claude Code 自己的介面顏色。在啟動 `claude` 前在您的 shell 中設定這些以改變介面顏色 | `{"FOO": "bar"}` |262| `env` | 應用於每個工作階段和 Claude Code 從中產生的子流程的環境變數。{/* min-version: 2.1.143 */}自 v2.1.143 起，此處設定的 `NO_COLOR` 和 `FORCE_COLOR` 會傳遞到子流程，但不會改變 Claude Code 自己的介面顏色。在啟動 `claude` 前在您的 shell 中設定這些以改變介面顏色 | `{"FOO": "bar"}` |

263| `fallbackModel` | 當主模型過載或不可用時按順序嘗試的備用模型。Claude Code 會為該輪的其餘部分切換到鏈中的下一個可用模型並顯示通知。`"default"` 擴展為預設模型。鏈限制為三個模型；額外項目會被忽略。與大多數陣列設定不同，此金鑰不跨設定檔案合併：定義它的最高優先順序檔案提供整個鏈。[`--fallback-model`](/zh-TW/cli-reference#cli-flags) 旗標會覆蓋此設定以進行一個工作階段。請參閱[備用模型鏈](/zh-TW/model-config#fallback-model-chains) | `["claude-sonnet-4-6", "claude-haiku-4-5"]` |263| `fallbackModel` | 當主模型過載或不可用時按順序嘗試的備用模型。Claude Code 會為該輪的其餘部分切換到鏈中的下一個可用模型並顯示通知。`"default"` 擴展為預設模型。鏈限制為三個模型；額外項目會被忽略。與大多數陣列設定不同，此金鑰不跨設定檔案合併：定義它的最高優先順序檔案提供整個鏈。[`--fallback-model`](/zh-TW/cli-reference#cli-flags) 旗標會覆蓋此設定以進行一個工作階段。請參閱[備用模型鏈](/zh-TW/model-config#fallback-model-chains) | `["claude-sonnet-4-6", "claude-haiku-4-5"]` |

264| `fastModePerSessionOptIn` | 當為 `true` 時，快速模式不會跨工作階段持久化。每個工作階段都以快速模式關閉開始，需要使用者使用 `/fast` 啟用它。使用者的快速模式偏好仍會儲存。請參閱[需要每個工作階段的選擇加入](/zh-TW/fast-mode#require-per-session-opt-in) | `true` |264| `fastModePerSessionOptIn` | 當為 `true` 時，快速模式不會跨工作階段持久化。每個工作階段都以快速模式關閉開始，需要使用者使用 `/fast` 啟用它。使用者的快速模式偏好仍會儲存。請參閱[需要每個工作階段的選擇加入](/zh-TW/fast-mode#require-per-session-opt-in) | `true` |

294| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}當每個互動式工作階段啟動時自動連線[遠端控制](/zh-TW/remote-control)，而不是等待 `/remote-control`。設定為 `true` 以始終自動連線，`false` 以永不自動連線，或保留未設定以遵循您組織的預設。在 `/config` 中顯示為**為所有工作階段啟用遠端控制**。請參閱[為所有工作階段啟用遠端控制](/zh-TW/remote-control#enable-remote-control-for-all-sessions) | `false` |294| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}當每個互動式工作階段啟動時自動連線[遠端控制](/zh-TW/remote-control)，而不是等待 `/remote-control`。設定為 `true` 以始終自動連線，`false` 以永不自動連線，或保留未設定以遵循您組織的預設。在 `/config` 中顯示為**為所有工作階段啟用遠端控制**。請參閱[為所有工作階段啟用遠端控制](/zh-TW/remote-control#enable-remote-control-for-all-sessions) | `false` |

295| `requiredMaximumVersion` | Managed 設定僅限。允許啟動的最大 Claude Code 版本。如果執行中的版本較新，Claude Code 會在啟動時結束並指示使用者透過組織的核准方法安裝核准的版本；`claude install <version>` 也可能有效。背景自動更新和 `claude update` 會跳過高於上限的版本，因此在範圍內的安裝保持在範圍內。`claude update`、`claude install` 和 `claude doctor` 在上限以上保持工作，以便使用者可以恢復。早於此設定的版本會忽略它 | `"2.1.150"` |295| `requiredMaximumVersion` | Managed 設定僅限。允許啟動的最大 Claude Code 版本。如果執行中的版本較新，Claude Code 會在啟動時結束並指示使用者透過組織的核准方法安裝核准的版本；`claude install <version>` 也可能有效。背景自動更新和 `claude update` 會跳過高於上限的版本，因此在範圍內的安裝保持在範圍內。`claude update`、`claude install` 和 `claude doctor` 在上限以上保持工作，以便使用者可以恢復。早於此設定的版本會忽略它 | `"2.1.150"` |

296| `requiredMinimumVersion` | Managed 設定僅限。啟動所需的最小 Claude Code 版本。如果執行中的版本較舊，Claude Code 會在啟動時結束並指示使用者透過組織的核准方法更新。`claude update`、`claude install` 和 `claude doctor` 在底線以下保持工作，以便使用者可以恢復。與 `minimumVersion` 不同，後者防止降級但永遠不會阻止啟動。早於此設定的版本會忽略它 | `"2.1.150"` |296| `requiredMinimumVersion` | Managed 設定僅限。啟動所需的最小 Claude Code 版本。如果執行中的版本較舊，Claude Code 會在啟動時結束並指示使用者透過組織的核准方法更新。`claude update`、`claude install` 和 `claude doctor` 在底線以下保持工作，以便使用者可以恢復。與 `minimumVersion` 不同，後者防止降級但永遠不會阻止啟動。早於此設定的版本會忽略它 | `"2.1.150"` |

297| `respondToBashCommands` | {/* min-version: 2.1.186 */}輸入框 `!` shell 命令執行後 Claude 是否回應。設定為 `false` 以將命令輸出新增到內容而不回應。預設：`true`。請參閱[使用 `!` 前綴的 Shell 模式](/zh-TW/interactive-mode#shell-mode-with-prefix)。需要 Claude Code v2.1.186 或更新版本 | `false` |

298| `respectGitignore` | 控制 `@` 檔案選擇器是否尊重 `.gitignore` 模式。當為 `true`（預設）時，符合 `.gitignore` 模式的檔案會從建議中排除 | `false` |297| `respectGitignore` | 控制 `@` 檔案選擇器是否尊重 `.gitignore` 模式。當為 `true`（預設）時，符合 `.gitignore` 模式的檔案會從建議中排除 | `false` |

298| `respondToBashCommands` | {/* min-version: 2.1.186 */}輸入框 `!` shell 命令執行後 Claude 是否回應。設定為 `false` 以將命令輸出新增到內容而不回應。預設：`true`。請參閱[使用 `!` 前綴的 Shell 模式](/zh-TW/interactive-mode#shell-mode-with-prefix)。需要 Claude Code v2.1.186 或更新版本 | `false` |

299| `showClearContextOnPlanAccept` | 在 Plan Mode 接受畫面上顯示「清除內容」選項。預設為 `false`。設定為 `true` 以還原選項 | `true` |299| `showClearContextOnPlanAccept` | 在 Plan Mode 接受畫面上顯示「清除內容」選項。預設為 `false`。設定為 `true` 以還原選項 | `true` |

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

301| `showTurnDuration` | 在回應後顯示輪次持續時間訊息，例如「Cooked for 1m 6s」。預設：`true`。在 `/config` 中顯示為**顯示輪次持續時間** | `false` |301| `showTurnDuration` | 在回應後顯示輪次持續時間訊息，例如「Cooked for 1m 6s」。預設：`true`。在 `/config` 中顯示為**顯示輪次持續時間** | `false` |

394設定進階 sandboxing 行為。Sandboxing 將 bash 命令與您的檔案系統和網路隔離。請參閱 [Sandboxing](/zh-TW/sandboxing) 以了解詳細資訊。394設定進階 sandboxing 行為。Sandboxing 將 bash 命令與您的檔案系統和網路隔離。請參閱 [Sandboxing](/zh-TW/sandboxing) 以了解詳細資訊。

395 395 

396| 金鑰 | 說明 | 範例 |396| 金鑰 | 說明 | 範例 |

397| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |397| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

398| `enabled` | 啟用 bash sandboxing（macOS、Linux 和 WSL2）。預設：false | `true` |398| `enabled` | 啟用 bash sandboxing（macOS、Linux 和 WSL2）。預設：false | `true` |

399| `failIfUnavailable` | 如果 `sandbox.enabled` 為 true 但 sandbox 無法啟動（遺失相依性、不支援的平台），則在啟動時以錯誤結束。當為 false（預設）時，會顯示警告，命令會以 unsandboxed 方式執行。適用於需要 sandboxing 作為硬閘門的 managed 設定部署 | `true` |399| `failIfUnavailable` | 如果 `sandbox.enabled` 為 true 但 sandbox 無法啟動（遺失相依性、不支援的平台），則在啟動時以錯誤結束。當為 false（預設）時，會顯示警告，命令會以 unsandboxed 方式執行。適用於需要 sandboxing 作為硬閘門的 managed 設定部署 | `true` |

400| `autoAllowBashIfSandboxed` | 在 sandboxed 時自動批准 bash 命令。預設：true | `true` |400| `autoAllowBashIfSandboxed` | 在 sandboxed 時自動批准 bash 命令。預設：true | `true` |

405| `filesystem.denyRead` | sandboxed 命令無法讀取的路徑。陣列跨所有設定範圍合併。也與 `Read(...)` 拒絕權限規則中的路徑合併。 | `["~/.aws/credentials"]` |405| `filesystem.denyRead` | sandboxed 命令無法讀取的路徑。陣列跨所有設定範圍合併。也與 `Read(...)` 拒絕權限規則中的路徑合併。 | `["~/.aws/credentials"]` |

406| `filesystem.allowRead` | 在 `denyRead` 區域內重新允許讀取的路徑。優先於 `denyRead`。陣列跨所有設定範圍合併。使用此選項建立僅工作區讀取存取模式。 | `["."]` |406| `filesystem.allowRead` | 在 `denyRead` 區域內重新允許讀取的路徑。優先於 `denyRead`。陣列跨所有設定範圍合併。使用此選項建立僅工作區讀取存取模式。 | `["."]` |

407| `filesystem.allowManagedReadPathsOnly` | （Managed 設定僅限）僅尊重 managed 設定中的 `filesystem.allowRead` 路徑。`denyRead` 仍從所有來源合併。預設：false | `true` |407| `filesystem.allowManagedReadPathsOnly` | （Managed 設定僅限）僅尊重 managed 設定中的 `filesystem.allowRead` 路徑。`denyRead` 仍從所有來源合併。預設：false | `true` |

408| `credentials.files` | Sandboxed 命令無法讀取的認證檔案或目錄。應用與 `filesystem.denyRead` 相同的讀取區塊；單獨的金鑰將認證路徑與 `credentials.envVars` 分組，並與一般檔案系統規則分開。每個項目為 `{ "path": "...", "mode": "deny" }`。路徑使用與 `filesystem.*` 設定相同的[前綴](#sandbox-path-prefixes)。陣列跨所有設定範圍合併。僅支援 `deny`。需要 Claude Code v2.1.187 或更新版本。 | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

409| `credentials.envVars` | 在執行 sandboxed 命令前要取消設定的環境變數。每個項目為 `{ "name": "...", "mode": "deny" }`。陣列跨所有設定範圍合併。僅支援 `deny`。需要 Claude Code v2.1.187 或更新版本。 | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

408| `network.allowUnixSockets` | （僅限 macOS）sandbox 中可存取的 Unix socket 路徑。在 Linux 和 WSL2 上被忽略，其中 seccomp 篩選器無法檢查 socket 路徑；改用 `allowAllUnixSockets`。 | `["~/.ssh/agent-socket"]` |410| `network.allowUnixSockets` | （僅限 macOS）sandbox 中可存取的 Unix socket 路徑。在 Linux 和 WSL2 上被忽略，其中 seccomp 篩選器無法檢查 socket 路徑；改用 `allowAllUnixSockets`。 | `["~/.ssh/agent-socket"]` |

409| `network.allowAllUnixSockets` | 允許 sandbox 中的所有 Unix socket 連線。在 Linux 和 WSL2 上，這是允許 Unix sockets 的唯一方式，因為它跳過了 seccomp 篩選器，否則會阻止 `socket(AF_UNIX, ...)` 呼叫。預設：false | `true` |411| `network.allowAllUnixSockets` | 允許 sandbox 中的所有 Unix socket 連線。在 Linux 和 WSL2 上，這是允許 Unix sockets 的唯一方式，因為它跳過了 seccomp 篩選器，否則會阻止 `socket(AF_UNIX, ...)` 呼叫。預設：false | `true` |

410| `network.allowLocalBinding` | 允許繫結到 localhost 連接埠（僅限 macOS）。預設：false | `true` |412| `network.allowLocalBinding` | 允許繫結到 localhost 連接埠（僅限 macOS）。預設：false | `true` |

424 Sandbox 路徑前綴426 Sandbox 路徑前綴

425</h4>427</h4>

426 428 

427`filesystem.allowWrite`、`filesystem.denyWrite`、`filesystem.denyRead` 和 `filesystem.allowRead` 中的路徑支援這些前綴：429`filesystem.allowWrite`、`filesystem.denyWrite`、`filesystem.denyRead`、`filesystem.allowRead` 和 `credentials.files` 中的路徑支援這些前綴：

428 430 

429| 前綴 | 含義 | 範例 |431| 前綴 | 含義 | 範例 |

430| :-------- | :---------------------------------------- | :---------------------------------------------------------------- |432| :-------- | :---------------------------------------- | :---------------------------------------------------------------- |

245所有欄位都是可選的。建議只使用 `description`，以便 Claude 知道何時使用該 skill。245所有欄位都是可選的。建議只使用 `description`，以便 Claude 知道何時使用該 skill。

246 246 

247| 欄位 | 必需 | 描述 |247| 欄位 | 必需 | 描述 |

248| :------------------------- | :- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |248| :------------------------- | :- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

249| `name` | 否 | Skill 清單中顯示的顯示名稱。預設為目錄名稱。請參閱[skill 如何獲得其命令名稱](#how-a-skill-gets-its-command-name)以了解這與您輸入的名稱在 `/` 後的差異。 |249| `name` | 否 | Skill 清單中顯示的顯示名稱。預設為目錄名稱。請參閱[skill 如何獲得其命令名稱](#how-a-skill-gets-its-command-name)以了解這與您輸入的名稱在 `/` 後的差異。 |

250| `description` | 建議 | Skill 的功能以及何時使用它。Claude 使用此來決定何時應用該 skill。如果省略，使用 markdown 內容的第一段。前置關鍵使用案例：結合的 `description` 和 `when_to_use` 文字在 skill 清單中截斷至 1,536 個字元以減少上下文使用。 |250| `description` | 建議 | Skill 的功能以及何時使用它。Claude 使用此來決定何時應用該 skill。如果省略，使用 markdown 內容的第一段。前置關鍵使用案例：結合的 `description` 和 `when_to_use` 文字在 skill 清單中截斷至 1,536 個字元以減少上下文使用。 |

251| `when_to_use` | 否 | Claude 應何時叫用該 skill 的額外上下文，例如觸發短語或範例請求。附加到 skill 清單中的 `description`，並計入 1,536 個字元的上限。 |251| `when_to_use` | 否 | Claude 應何時叫用該 skill 的額外上下文，例如觸發短語或範例請求。附加到 skill 清單中的 `description`，並計入 1,536 個字元的上限。 |

255| `user-invocable` | 否 | 設定為 `false` 以從 `/` 功能表中隱藏。用於使用者不應直接叫用的背景知識。預設值：`true`。 |255| `user-invocable` | 否 | 設定為 `false` 以從 `/` 功能表中隱藏。用於使用者不應直接叫用的背景知識。預設值：`true`。 |

256| `allowed-tools` | 否 | 當此 skill 處於作用中時，Claude 可以使用而無需詢問許可的工具。接受空格分隔的字串或逗號分隔的字串，或 YAML 清單。 |256| `allowed-tools` | 否 | 當此 skill 處於作用中時，Claude 可以使用而無需詢問許可的工具。接受空格分隔的字串或逗號分隔的字串，或 YAML 清單。 |

257| `disallowed-tools` | 否 | 當此 skill 處於作用中時從 Claude 的可用工具池中移除的工具。用於不應呼叫某些工具的自主 skills，例如用於背景迴圈的 `AskUserQuestion`。接受空格分隔的字串或逗號分隔的字串，或 YAML 清單。限制在您傳送下一則訊息時清除。 |257| `disallowed-tools` | 否 | 當此 skill 處於作用中時從 Claude 的可用工具池中移除的工具。用於不應呼叫某些工具的自主 skills，例如用於背景迴圈的 `AskUserQuestion`。接受空格分隔的字串或逗號分隔的字串，或 YAML 清單。限制在您傳送下一則訊息時清除。 |

258| `model` | 否 | 當此 skill 處於作用中時要使用的模型。覆蓋適用於目前回合的其餘部分，不會儲存到設定；工作階段模型在您的下一個提示時恢復。接受與 [`/model`](/zh-TW/model-config) 相同的值，或 `inherit` 以保持作用中的模型。 |258| `model` | 否 | 當此 skill 處於作用中時要使用的模型。覆蓋適用於目前回合的其餘部分，不會儲存到設定；工作階段模型在您的下一個提示時恢復。接受與 [`/model`](/zh-TW/model-config) 相同的值，或 `inherit` 以保持作用中的模型。由您組織的 [`availableModels`](/zh-TW/model-config#restrict-model-selection) 允許清單排除的值不會被使用，工作階段會保持其目前的模型。 |

259| `effort` | 否 | 當此 skill 處於作用中時的[努力級別](/zh-TW/model-config#adjust-effort-level)。覆蓋工作階段努力級別。預設值：繼承自工作階段。選項：`low`、`medium`、`high`、`xhigh`、`max`；可用級別取決於模型。 |259| `effort` | 否 | 當此 skill 處於作用中時的[努力級別](/zh-TW/model-config#adjust-effort-level)。覆蓋工作階段努力級別。預設值：繼承自工作階段。選項：`low`、`medium`、`high`、`xhigh`、`max`；可用級別取決於模型。 |

260| `context` | 否 | 設定為 `fork` 以在分叉的 subagent 上下文中執行。 |260| `context` | 否 | 設定為 `fork` 以在分叉的 subagent 上下文中執行。 |

261| `agent` | 否 | 當設定 `context: fork` 時要使用的 subagent 類型。 |261| `agent` | 否 | 當設定 `context: fork` 時要使用的 subagent 類型。 |

3173. Subagent 定義的 `model` frontmatter3173. Subagent 定義的 `model` frontmatter

3184. 主要對話的模型3184. 主要對話的模型

319 319 

320環境變數、每次呼叫的參數和 frontmatter 值會根據您組織的 [`availableModels`](/zh-TW/model-config#restrict-model-selection) 允許清單進行檢查。解析為排除模型的值不會被使用，subagent 會改為在繼承的模型上執行。

321 

320<h3 id="control-subagent-capabilities">322<h3 id="control-subagent-capabilities">

321 控制 subagent 功能323 控制 subagent 功能

322</h3>324</h3>

849 851 

850深度計算為主要對話下方的 subagent 級別數，無論每個級別是否在 [前景或背景](#run-subagents-in-foreground-or-background) 中執行。深度為五的 subagent 不接收 Agent 工具，無法進一步產生。限制是固定的且不可配置。852深度計算為主要對話下方的 subagent 級別數，無論每個級別是否在 [前景或背景](#run-subagents-in-foreground-or-background) 中執行。深度為五的 subagent 不接收 Agent 工具，無法進一步產生。限制是固定的且不可配置。

851 853 

854自 Claude Code v2.1.187 起，背景 subagent 的深度在首次產生時固定，之後 [恢復](#resume-subagents) 它不會改變該深度。例如，如果您的主要對話產生 subagent A，而 A 在深度二產生背景 subagent B，當您直接從主要對話恢復 B 時，B 仍然在深度二。從較淺的上下文恢復 subagent 不會讓它產生深度限制已經阻止的額外級別。

855 

852若要防止特定 subagent 產生其他 subagents，請從其 [`tools`](#available-tools) 列表中省略 `Agent` 或將其新增到 `disallowedTools`。856若要防止特定 subagent 產生其他 subagents，請從其 [`tools`](#available-tools) 列表中省略 `Agent` 或將其新增到 `disallowedTools`。

853 857 

854[fork](#fork-the-current-conversation) 仍然無法產生另一個 fork。它可以產生其他 subagent 類型，這些計入深度限制。858[fork](#fork-the-current-conversation) 仍然無法產生另一個 fork。它可以產生其他 subagent 類型，這些計入深度限制。

34 34 

35```35```

36/voice36/voice

37Voice mode enabled (hold). Hold Space to record. Dictation language: en (/config to change).37Voice mode enabled (hold). Hold space to record. Dictation language: en (/config to change).

38```38```

39 39 

40`/voice` 接受一個可選的模式引數：40`/voice` 接受一個可選的模式引數：

57}57}

58```58```

59 59 

60啟用語音聽寫時，當提示為空時，輸入頁尾會顯示 `hold Space to speak` 提示。提示文字反映您目前的 `voice:pushToTalk` 快捷鍵繫結，如果您[重新繫結聽寫鍵](#rebind-the-dictation-key)，則會更新。提示文字在兩種模式中都相同，如果您配置了[自訂狀態行](/zh-TW/statusline)，則不會出現。60啟用語音聽寫時，當提示為空時，輸入頁尾會顯示 `hold space to speak` 提示。提示文字反映您目前的 `voice:pushToTalk` 快捷鍵繫結，如果您[重新繫結聽寫鍵](#rebind-the-dictation-key)，則會更新。提示文字在兩種模式中都相同，如果您配置了[自訂狀態行](/zh-TW/statusline)，則不會出現。

61 61 

62轉錄在兩種模式中都針對編碼詞彙進行了調整。常見的開發術語如 `regex`、`OAuth`、`JSON` 和 `localhost` 都能正確識別，您目前的專案名稱和 git 分支名稱會自動新增為識別提示。62轉錄在兩種模式中都針對編碼詞彙進行了調整。常見的開發術語如 `regex`、`OAuth`、`JSON` 和 `localhost` 都能正確識別，您目前的專案名稱和 git 分支名稱會自動新增為識別提示。

63 63