405| 範圍 | 檔案 | 影響對象 | 用途 |405| 範圍 | 檔案 | 影響對象 | 用途 |
406| :- | :- | :- | :- |406| :- | :- | :- | :- |
407| 使用者 | `~/.claude/settings.json` | 您,在此機器上的每個專案中 | 個人偏好設定:佈景主題、編輯器模式、預設模型、您自己的權限規則 |407| 使用者 | `~/.claude/settings.json` | 您,在此機器上的每個專案中 | 個人偏好設定:佈景主題、編輯器模式、預設模型、您自己的權限規則 |
408| 共享專案 | `.claude/settings.json` | 每個在包含它的資料夾中工作的人。在 git 儲存庫中,提交它以便隊友取得 | 團隊權限、hooks、plugins 和專案需要的環境變數 |408| 共享專案 | `.claude/settings.json` | 每個在包含它的資料夾中工作的人。在 git 儲存庫中,提交它以便隊友取得 | 團隊權限、hook、外掛和專案需要的環境變數 |
409| 專案本機 | `.claude/settings.local.json` | 您,僅在此一個專案中。Claude Code 在建立檔案時將其保留在 git 之外;如果您手動建立,請自行將其新增至 `.gitignore` | 一個專案的個人覆寫,以及在共享前進行測試 |409| 專案本機 | `.claude/settings.local.json` | 您,僅在此一個專案中。Claude Code 在建立檔案時將其保留在 git 之外;如果您手動建立,請自行將其新增至 `.gitignore` | 一個專案的個人覆寫,以及在共享前進行測試 |
410| 受管 | `managed-settings.json` 和其他[受管來源](/docs/zh-TW/managed-settings#delivery-mechanisms) | 您的組織部署到的每個人;您設定的任何內容都不會覆寫它,除了少數[安全敏感的例外](#exceptions-to-managed-settings-precedence) | 安全政策和合規要求 |410| 受管 | `managed-settings.json` 和其他[受管來源](/docs/zh-TW/managed-settings#delivery-mechanisms) | 您的組織部署到的每個人;[設定優先順序](#settings-precedence)說明哪些內容可以覆寫它 | 安全政策和合規要求 |
411 411
412在「檔案」欄中,`~/.claude` 是您主目錄中的 `.claude` 資料夾,而裸露的 `.claude` 是您專案內的 `.claude` 資料夾。412在「檔案」欄中,`~/.claude` 是您家目錄中的 `.claude` 資料夾,而單獨的 `.claude` 是您專案內的 `.claude` 資料夾。
413 413
414<span id="where-each-file-applies" />414<span id="where-each-file-applies" />
415 415
425 425
426<SettingsScope />426<SettingsScope />
427 427
428* **`~/.claude/settings.json`**:您機器上的每個專案,以及隊友或雲端工作階段上的任何內容都不會428* **`~/.claude/settings.json`**:您機器上的每個專案,而不會到達隊友的機器或雲端工作階段
429* **`acme-app/.claude/settings.json`**:您的 `acme-app/`。只有在您將檔案提交到版本控制時,它才會到達隊友的複製和雲端工作階段;在您這樣做之前,它就像任何其他檔案一樣在您的磁碟上,沒有人有它429* **`acme-app/.claude/settings.json`**:您的 `acme-app/`。只有在您將檔案提交到版本控制時,它才會到達隊友的複製和雲端工作階段;在您這樣做之前,它就像任何其他檔案一樣在您的磁碟上,沒有人有它
430* **`acme-app/.claude/settings.local.json`**:僅您的 `acme-app/`。Claude Code 在第一次寫入檔案時將其新增至您的全域 git 排除項目,因此它保留在您的提交之外;如果您手動建立檔案,[自行將其新增至 `.gitignore`](#keep-personal-settings-out-of-a-repository)430* **`acme-app/.claude/settings.local.json`**:僅您的 `acme-app/`。Claude Code 在第一次寫入檔案時將其新增至您的全域 git 排除項目,因此它保留在您的提交之外;如果您手動建立檔案,[自行將其新增至 `.gitignore`](#keep-personal-settings-out-of-a-repository)
431* **受管設定**,無論是 `managed-settings.json` 檔案、MDM 政策,還是來自 claude.ai 主控台的[伺服器受管設定](/docs/zh-TW/server-managed-settings):您的組織部署到的每台機器上的每個專案,或您使用組織帳戶登入的地方。只有伺服器受管設定才能到達雲端工作階段431* **受管設定**,無論是 `managed-settings.json` 檔案、MDM 政策,還是來自 claude.ai 主控台的[伺服器受管設定](/docs/zh-TW/server-managed-settings):您的組織部署到的每台機器上的每個專案,或您使用組織帳戶登入的地方。只有伺服器受管設定才能到達雲端工作階段
440 440
441* **受管**:您的組織部署它。您不建立或編輯它。441* **受管**:您的組織部署它。您不建立或編輯它。
442* **共享專案**:已經使用 Claude Code 的專案可能已提交一個。如果沒有,請在專案資料夾中的 `.claude/settings.json` 建立一個。442* **共享專案**:已經使用 Claude Code 的專案可能已提交一個。如果沒有,請在專案資料夾中的 `.claude/settings.json` 建立一個。
443* **使用者**和**專案本機**:自行建立它們,或讓 Claude Code 建立它們。它在您第一次在 `/config` 選單中變更儲存在使用者設定中的選項時寫入 `~/.claude/settings.json`,例如佈景主題,以及在您第一次在權限提示上給予常設核准時寫入 `.claude/settings.local.json`,例如「是的,不要再問」以取得 Bash 命令。少數 `/config` 選項,包括**顯示提示**,改為儲存至 `.claude/settings.local.json` 而不是使用者檔案。443* **使用者**和**專案本機**:自行建立它們,或讓 Claude Code 建立它們。它在您第一次在 `/config` 選單中變更儲存在使用者設定中的選項時寫入 `~/.claude/settings.json`,例如佈景主題,以及在您第一次在權限提示上給予常設核准時寫入 `.claude/settings.local.json`,例如針對 Bash 命令選擇「是的,不要再問」。少數 `/config` 選項,包括**顯示提示**,改為儲存至 `.claude/settings.local.json` 而不是使用者檔案。
444 444
445<Info>445<Info>
446 在 Windows 上,`~/.claude` 表示 `%USERPROFILE%\.claude`。若要將主目錄檔案保留在其他地方,請設定 [`CLAUDE_CONFIG_DIR`](/docs/zh-TW/env-vars);Claude Code 會改為在那裡儲存您的設定、工作階段歷史記錄和 plugins。446 在 Windows 上,`~/.claude` 表示 `%USERPROFILE%\.claude`。若要將家目錄檔案保留在其他地方,請設定 [`CLAUDE_CONFIG_DIR`](/docs/zh-TW/env-vars);Claude Code 會改為在那裡儲存您的設定、工作階段歷史記錄和外掛。
447</Info>447</Info>
448 448
449Claude Code 也保留第五個檔案 [`~/.claude.json`](/docs/zh-TW/claude-directory#ce-claude-json),它為自己寫入;您不需要編輯它。它保留您的登入工作階段、[MCP 伺服器](/docs/zh-TW/mcp)設定、每個專案的狀態(例如信任決定),以及 `/config` 為您寫入的[全域設定金鑰](/docs/zh-TW/settings-reference#global-config-settings)。449Claude Code 也保留第五個檔案 [`~/.claude.json`](/docs/zh-TW/claude-directory#ce-claude-json),它為自己寫入;您不需要編輯它。它保留您的登入工作階段、[MCP 伺服器](/docs/zh-TW/mcp)設定、每個專案的狀態(例如信任決定),以及 `/config` 為您寫入的[全域設定鍵](/docs/zh-TW/settings-reference#global-config-settings)。
450 450
451<h3 id="share-settings-with-your-team">451<h3 id="share-settings-with-your-team">
452 與您的團隊共享設定452 與您的團隊共享設定
453</h3>453</h3>
454 454
455提交 `.claude/settings.json` 以便複製儲存庫的每個人都取得相同的權限、hooks 和 plugins。每個隊友仍然可以在自己的 `.claude/settings.local.json` 中為自己覆寫它,因此個人例外不需要提交。如需完整的團隊檔案,請參閱[團隊的共享設定](/docs/zh-TW/settings-example#a-teams-shared-settings)。455提交 `.claude/settings.json` 以便複製儲存庫的每個人都取得相同的權限、hook 和外掛。每個隊友仍然可以在自己的 `.claude/settings.local.json` 中為自己覆寫它,因此個人例外不需要提交。如需完整的團隊檔案,請參閱[團隊的共享設定](/docs/zh-TW/settings-example#a-teams-shared-settings)。
456 456
457您提交的某些內容會等到每個隊友[信任資料夾](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust),而少數金鑰永遠不會從儲存庫檔案生效;[對不適用的設定進行疑難排解](#common-cases)涵蓋兩者。457您提交的某些內容會等到每個隊友[信任資料夾](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust),而少數設定鍵永遠不會從儲存庫檔案生效;[對不適用的設定進行疑難排解](#common-cases)涵蓋兩者。
458 458
459<span id="local-settings-file" />459<span id="local-settings-file" />
460 460
468 將個人設定保留在儲存庫之外468 將個人設定保留在儲存庫之外
469</h3>469</h3>
470 470
471若要在一個專案中為自己變更設定而不為隊友變更,請將其儲存在專案內的 `.claude/settings.local.json` 中。Claude Code 在提交的 `.claude/settings.json` 上應用該檔案,因此如果您的團隊檔案設定 `"model": "claude-sonnet-5"` 而您想要 Opus,請在本機檔案中放入 `"model": "claude-opus-5-5"`,只有您的工作階段會變更。471若要在一個專案中為自己變更設定而不為隊友變更,請將其儲存在專案內的 `.claude/settings.local.json` 中。Claude Code 在提交的 `.claude/settings.json` 上套用該檔案,因此如果您的團隊檔案設定 `"model": "claude-sonnet-5"` 而您想要 Opus,請在本機檔案中放入 `"model": "claude-opus-5-5"`,只有您的工作階段會變更。
472 472
473Claude Code 也寫入此檔案,將其保留在您的提交之外,並在不需要信任步驟的情況下應用其允許規則:473Claude Code 也寫入此檔案,將其保留在您的提交之外,並在不需要信任步驟的情況下套用其允許規則:
474 474
475* **Claude Code 也寫入它。** 當 Claude 要求執行 Bash 命令的權限,而您選擇「是的,不要再問」時,Claude Code 會將該[權限核准](/docs/zh-TW/permissions#permission-system)儲存在此處作為 `allow` 規則。475* **Claude Code 也寫入它。** 當 Claude 要求執行 Bash 命令的權限,而您選擇「是的,不要再問」時,Claude Code 會將該[權限核准](/docs/zh-TW/permissions#permission-system)儲存在此處作為 `allow` 規則。
476* **您不需要自行 gitignore 它,除非您手動建立它。** Claude Code 在不已忽略它的 git 儲存庫中第一次寫入檔案時,它會將 `**/.claude/settings.local.json` 新增至您的全域 git 排除項目檔案,因此檔案在每個儲存庫中保留在您的提交之外。該檔案是 `core.excludesFile`,當您的全域 git 設定將其設定為絕對或 `~` 前綴路徑時;否則它是 `$XDG_CONFIG_HOME/git/ignore`,或當 `XDG_CONFIG_HOME` 未設定時為 `~/.config/git/ignore`。如果您手動建立檔案,而 Claude Code 尚未寫入它,請自行將其新增至 `.gitignore`。476* **您不需要自行 gitignore 它,除非您手動建立它。** Claude Code 在尚未忽略它的 git 儲存庫中第一次寫入檔案時,它會將 `**/.claude/settings.local.json` 新增至您的全域 git 排除項目檔案,因此檔案在每個儲存庫中保留在您的提交之外。當您的全域 git 設定將 `core.excludesFile` 設為絕對路徑或 `~` 前綴路徑時,該檔案就是 `core.excludesFile`;否則它是 `$XDG_CONFIG_HOME/git/ignore`,或當 `XDG_CONFIG_HOME` 未設定時為 `~/.config/git/ignore`。如果您手動建立檔案,而 Claude Code 尚未寫入它,請自行將其新增至 `.gitignore`。
477* **其 allow 規則在檔案保持未追蹤時不等待信任。** 因為檔案是您的而不是儲存庫的,Claude Code 應用其 `allow` 規則而不需要它對提交檔案要求的[工作區信任](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)步驟。如果檔案由 git 追蹤,信任步驟也適用於它;請參閱[當您的本機設定檔案需要信任時](/docs/zh-TW/permissions#when-your-local-settings-file-needs-trust)。477* **其 allow 規則在檔案保持未追蹤時不等待信任。** 因為檔案是您的而不是儲存庫的,Claude Code 套用其 `allow` 規則而不需要它對提交檔案要求的[工作區信任](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)步驟。如果檔案由 git 追蹤,信任步驟也適用於它;請參閱[當您的本機設定檔案需要信任時](/docs/zh-TW/permissions#when-your-local-settings-file-needs-trust)。
478 478
479<span id="where-claude-code-looks-for-each-file" />479<span id="where-claude-code-looks-for-each-file" />
480 480
486 Claude Code 在 git 儲存庫中保留本機檔案的位置486 Claude Code 在 git 儲存庫中保留本機檔案的位置
487</h4>487</h4>
488 488
489當 Claude 要求執行 Bash 命令的權限,而您選擇「是的,不要再問」時,Claude Code 會將該核准儲存為 `.claude/settings.local.json` 中的 `allow` 規則。如果您在 git 儲存庫的子目錄中啟動 Claude Code,它會在儲存庫根目錄讀取和寫入該檔案,並在整個儲存庫中應用核准。在 [worktree](/docs/zh-TW/worktrees) 中,它使用主簽出根目錄的檔案。489當 Claude 要求執行 Bash 命令的權限,而您選擇「是的,不要再問」時,Claude Code 會將該核准儲存為 `.claude/settings.local.json` 中的 `allow` 規則。如果您在 git 儲存庫的子目錄中啟動 Claude Code,它會在儲存庫根目錄讀取和寫入該檔案,並在整個儲存庫中套用核准。在 [worktree](/docs/zh-TW/worktrees) 中,它使用主簽出根目錄的檔案。
490 490
491兩個規則限定根位置:491兩個規則限定根位置:
492 492
493* **當檔案改為與 `.claude/settings.json` 保持在一起時**:在 git 儲存庫之外,當儲存庫根目錄是您的主目錄時,在 Windows 上,或當儲存庫根目錄或其 `.git` 或 `.claude` 項目不由您的使用者擁有時。493* **當檔案改為與 `.claude/settings.json` 保持在一起時**:在 git 儲存庫之外,當儲存庫根目錄是您的家目錄時,在 Windows 上,或當儲存庫根目錄或其 `.git` 或 `.claude` 項目不由您的使用者擁有時。
494* **檔案中的路徑不在儲存庫根目錄錨定**:以 `/` 開頭的權限規則或相對沙箱路徑[改為在工作階段的主要工作目錄錨定](/docs/zh-TW/permissions#read-and-edit)。494* **檔案中的路徑不在儲存庫根目錄錨定**:以 `/` 開頭的權限規則或相對沙箱路徑[改為在工作階段的主要工作目錄錨定](/docs/zh-TW/permissions#read-and-edit)。
495 495
496在 v2.1.211 之前,Claude Code 在啟動目錄中保留檔案。它仍然讀取較早版本在根檔案旁邊留下的檔案;當兩者設定相同金鑰時,根的值適用,兩個檔案的權限規則適用。Agent SDK 的 [`resolveSettings()`](/docs/zh-TW/agent-sdk/typescript#resolvesettings) 協助程式始終從啟動目錄讀取檔案。496在 v2.1.211 之前,Claude Code 在啟動目錄中保留檔案。它仍然會讀取較早版本留在該處的檔案,與根檔案一併讀取;當兩者設定相同的設定鍵時,以根的值為準,而兩個檔案的權限規則都適用。Agent SDK 的 [`resolveSettings()`](/docs/zh-TW/agent-sdk/typescript#resolvesettings) 協助程式始終從啟動目錄讀取檔案。
497 497
498Claude Code 從工作階段的[主要工作目錄](/docs/zh-TW/permissions#working-directories)讀取共享 `.claude/settings.json`,因此若要使用在儲存庫根目錄提交的檔案,請從那裡啟動 Claude Code。在您[使用 `/cd` 移動工作階段](/docs/zh-TW/permissions#move-the-session-to-another-directory)後,Claude Code 改為從新目錄讀取兩個專案檔案,按相同規則放置本機檔案。從您移動到的目錄讀取它們需要 Claude Code v2.1.246 或更新版本。498Claude Code 從工作階段的[主要工作目錄](/docs/zh-TW/permissions#working-directories)讀取共享 `.claude/settings.json`,因此若要使用在儲存庫根目錄提交的檔案,請從那裡啟動 Claude Code。在您[使用 `/cd` 移動工作階段](/docs/zh-TW/permissions#move-the-session-to-another-directory)後,Claude Code 改為從新目錄讀取兩個專案檔案,按相同規則放置本機檔案。從您移動到的目錄讀取它們需要 Claude Code v2.1.246 或更新版本。
499 499
511 檢查您的組織強制執行的內容511 檢查您的組織強制執行的內容
512</h3>512</h3>
513 513
514如果您的組織管理 Claude Code,某些設定是為您決定的,您在自己的檔案中放入的任何內容都不會變更它們。若要查看哪些,請執行 `/status`:`Setting sources` 行命名適用於您的受管來源。受管設定在此機器上 Claude Code 執行的任何地方適用;[開發人員可以變更的內容](/docs/zh-TW/managed-settings#what-a-developer-can-change)涵蓋本機管理員權限和 Claude Code 以外的工具。514如果您的組織管理 Claude Code,某些設定是為您決定的,您在自己的檔案中放入的任何內容都不會變更它們。若要查看哪些,請執行 `/status`:`Setting sources` 行會列出適用於您的受管來源。受管設定在此機器上 Claude Code 執行的任何地方適用;[開發人員可以變更的內容](/docs/zh-TW/managed-settings#what-a-developer-can-change)涵蓋本機管理員權限和 Claude Code 以外的工具。
515 515
516受管設定通過受管設定頁面上的[傳遞機制](/docs/zh-TW/managed-settings#delivery-mechanisms)到達您,最常見的是:516受管設定透過受管設定頁面上的[傳遞機制](/docs/zh-TW/managed-settings#delivery-mechanisms)到達您,最常見的是:
517 517
518* [伺服器受管設定](/docs/zh-TW/server-managed-settings),Claude Code 從 claude.ai 管理主控台或自託管[Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)擷取518* [伺服器受管設定](/docs/zh-TW/server-managed-settings),Claude Code 從 claude.ai 管理主控台或自行託管的 [Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)擷取
519* MDM 或作業系統層級政策,以及系統目錄中的 `managed-settings.json` 檔案519* MDM 或作業系統層級政策,以及系統目錄中的 `managed-settings.json` 檔案
520* 嵌入主機(例如 Claude Desktop),通過 SDK `managedSettings` 選項;請參閱[從嵌入主機控制政策](/docs/zh-TW/managed-settings#parent-settings-from-embedding-hosts)520* 嵌入主機(例如 Claude Desktop),透過 SDK `managedSettings` 選項;請參閱[從嵌入主機控制政策](/docs/zh-TW/managed-settings#parent-settings-from-embedding-hosts)
521 521
522在在 Claude Desktop 應用程式中在您的機器上執行的 [Cowork](https://claude.com/docs/cowork/overview) 工作階段中,Claude Code 不會從 claude.ai 管理主控台擷取伺服器受管設定,它讀取部署到您的裝置的政策,除非您的組織的 Claude Desktop 設定設定 `requireCoworkFullVmSandbox`。[政策適用的位置和時間](/docs/zh-TW/managed-settings#where-and-when-a-policy-applies)涵蓋 Cowork 和雲端工作階段。522在 Claude Desktop 應用程式中於您的機器上執行的 [Cowork](https://claude.com/docs/cowork/overview) 工作階段中,Claude Code 不會從 claude.ai 管理主控台擷取伺服器受管設定,且它會讀取部署到您裝置的政策,除非您組織的 Claude Desktop 設定設定了 `requireCoworkFullVmSandbox`。[政策適用的位置和時間](/docs/zh-TW/managed-settings#where-and-when-a-policy-applies)涵蓋 Cowork 和雲端工作階段。
523 523
524如果您是管理員,[為您的組織設定 Claude Code](/docs/zh-TW/admin-setup) 會逐步說明選擇要強制執行的內容,而[部署受管設定](/docs/zh-TW/managed-settings)涵蓋傳遞以及如何確認政策生效。524如果您是管理員,[為您的組織設定 Claude Code](/docs/zh-TW/admin-setup) 會逐步說明選擇要強制執行的內容,而[部署受管設定](/docs/zh-TW/managed-settings)涵蓋傳遞以及如何確認政策生效。
525 525
653 設定優先順序653 設定優先順序
654</h2>654</h2>
655 655
656當相同的鍵出現在多個位置時,Claude Code 會使用最高層級設定的值。下面的堆疊顯示各個層級,最高的在頂部;較高層級的鍵會覆蓋下面任何地方的相同鍵。656當相同的鍵出現在多個位置時,Claude Code 會使用最高層級設定的值。下面的堆疊顯示各個層級,最高的在頂部;較高層級的鍵會覆寫下面任何地方的相同鍵。
657 657
658<SettingsPrecedence />658<SettingsPrecedence />
659 659
660按順序,優先順序最高的優先:660按順序,優先順序最高的優先:
661 661
6621. **受管設定**:您的組織部署的設定,透過 `managed-settings.json` 檔案、MDM 原則或來自 claude.ai 主控台的[伺服器管理設定](/docs/zh-TW/server-managed-settings)。您設定的任何內容都不會覆蓋它們:您使用 `--settings` 傳遞的鍵不會覆蓋相同的受管鍵,而 `--model` 之類的旗標只會從您的組織允許的模型中選擇。受管 `model` 設定每個工作階段開始時的模型,您仍然可以使用 `/model` 切換;鎖定是 [`availableModels`](/docs/zh-TW/settings-reference#availablemodels),它限制 `/model`、`--model` 和您自己檔案中的 `model` 鍵。當您的組織提供多個受管來源時,[受管層級內的優先順序](/docs/zh-TW/managed-settings#precedence-within-the-managed-tier)規則說明 Claude Code 從每個來源讀取的內容。6621. **受管設定**:您的組織部署的設定,透過 `managed-settings.json` 檔案、MDM 原則或來自 claude.ai 主控台的[伺服器管理設定](/docs/zh-TW/server-managed-settings)。您自己的設定檔案或 `--settings` 中的任何內容都不會覆寫受管鍵,而 `--model` 之類的旗標只會從您的組織允許的模型中選擇。受管 [`model`](/docs/zh-TW/settings-reference#model) 是起始預設值,而不是鎖定;鎖定是 [`availableModels`](/docs/zh-TW/settings-reference#availablemodels) 和 [`deniedModels`](/docs/zh-TW/settings-reference#deniedmodels)。當您的組織提供多個受管來源時,[受管層級內的優先順序](/docs/zh-TW/managed-settings#precedence-within-the-managed-tier)規則說明 Claude Code 從每個來源讀取的內容。
6632. **命令列引數**:您從終端機啟動 `claude` 時傳遞的旗標,適用於一個工作階段;請參閱[變更一個工作階段的設定](#change-a-setting-for-one-session)。Claude Code 使用 `--settings <file-or-json>` 傳遞的 JSON 與您的設定檔案合併,遵循與其他層級相同的規則:它採用您在此設定的鍵而不是本機、專案或使用者設定中的相同鍵,並為您省略的鍵保留較低層級的值。6632. **命令列**:您啟動 `claude` 時使用 `--settings <file-or-json>` 傳遞的 JSON,僅適用於該工作階段;請參閱[變更一個工作階段的設定](#change-a-setting-for-one-session)。您在此設定的鍵會覆寫您專案和使用者設定檔案中的相同鍵,而您省略的鍵會保留這些檔案中的值。其他旗標(例如 `--model`)會為工作階段設定單一項目,不屬於此堆疊;[設定參考](/docs/zh-TW/settings-reference)上的鍵項目說明哪些旗標會覆寫它。
6643. **專案本機設定** (`.claude/settings.local.json`):您對此專案的個人設定。6643. **專案本機設定** (`.claude/settings.local.json`):您對此專案的個人設定。
6654. **共用專案設定** (`.claude/settings.json`):您的團隊簽入原始碼控制的設定。6654. **共用專案設定** (`.claude/settings.json`):您的團隊簽入原始碼控制的設定。
6665. **使用者設定** (`~/.claude/settings.json`):您對每個專案的個人設定。6665. **使用者設定** (`~/.claude/settings.json`):您對每個專案的個人設定。
670對於少數安全敏感的鍵,Claude Code 會尊重來自較低層級的更嚴格值而不是受管值;[受管設定優先順序的例外](#exceptions-to-managed-settings-precedence)列出了它們。670對於少數安全敏感的鍵,Claude Code 會尊重來自較低層級的更嚴格值而不是受管值;[受管設定優先順序的例外](#exceptions-to-managed-settings-precedence)列出了它們。
671 671
672<h3 id="lists-merge-instead-of-overriding">672<h3 id="lists-merge-instead-of-overriding">
673 列表合併而不是覆蓋673 列表合併而不是覆寫
674</h3>674</h3>
675 675
676當您在多個檔案中設定相同的列表鍵(例如 `permissions.allow`)時,Claude Code 會合併列表而不是選擇一個,因此每個檔案都可以新增項目而不移除另一個檔案的項目。四個保存模型列表或每個模型項目的鍵遵循自己的規則:676當您在多個檔案中設定相同的列表鍵(例如 `permissions.allow`)時,Claude Code 會合併列表而不是選擇一個,因此每個檔案都可以新增項目而不移除另一個檔案的項目。四個保存模型列表或每個模型項目的鍵遵循自己的規則:
689當 Claude 工作時,Claude Code 在微調器下方顯示一行提示,例如「使用 /config 變更您的預設權限模式(包括 Plan Mode)」。假設您想關閉這些提示,因此您在 `~/.claude/settings.json` 中將 [`spinnerTipsEnabled`](/docs/zh-TW/settings-reference#spinnertipsenabled) 設定為 `false`。下面的每個情景都是可能將它們重新開啟的事情,以及您可以做什麼。689當 Claude 工作時,Claude Code 在微調器下方顯示一行提示,例如「使用 /config 變更您的預設權限模式(包括 Plan Mode)」。假設您想關閉這些提示,因此您在 `~/.claude/settings.json` 中將 [`spinnerTipsEnabled`](/docs/zh-TW/settings-reference#spinnertipsenabled) 設定為 `false`。下面的每個情景都是可能將它們重新開啟的事情,以及您可以做什麼。
690 690
691<h4 id="team-settings-override-personal-settings">691<h4 id="team-settings-override-personal-settings">
692 團隊設定覆蓋個人設定692 團隊設定覆寫個人設定
693</h4>693</h4>
694 694
695您的團隊的 `.claude/settings.json` 將其設定為 `true`。Claude Code 使用專案值,因為共用專案位於使用者之上,因此您在該專案中看到提示,在其他地方看不到。695您的團隊的 `.claude/settings.json` 將其設定為 `true`。Claude Code 使用專案值,因為共用專案位於使用者之上,因此您在該專案中看到提示,在其他地方看不到。
697您可以取回您的值:在該專案的 `.claude/settings.local.json` 中新增 `"spinnerTipsEnabled": false`。專案本機位於共用專案之上,因此您在那裡的工作階段停止顯示提示,您的隊友的工作階段不會改變。697您可以取回您的值:在該專案的 `.claude/settings.local.json` 中新增 `"spinnerTipsEnabled": false`。專案本機位於共用專案之上,因此您在那裡的工作階段停止顯示提示,您的隊友的工作階段不會改變。
698 698
699<h4 id="organization-settings-override-everything">699<h4 id="organization-settings-override-everything">
700 組織設定覆蓋一切700 組織設定覆寫一切
701</h4>701</h4>
702 702
703您的組織的受管設定將其設定為 `true`。您在使用者、專案或本機設定中放置的任何內容都不會關閉提示,`--settings` 也不會。受管是最高層級。703您的組織的受管設定將其設定為 `true`。您在使用者、專案或本機設定中放置的任何內容都不會關閉提示,`--settings` 也不會。受管是最高層級。
705您無法取回您的值。執行 `/status` 以查看哪個受管來源適用,並詢問您的管理員是否應該變更原則。705您無法取回您的值。執行 `/status` 以查看哪個受管來源適用,並詢問您的管理員是否應該變更原則。
706 706
707<h4 id="the-command-line-overrides-your-files-for-one-session">707<h4 id="the-command-line-overrides-your-files-for-one-session">
708 命令列覆蓋您的檔案一個工作階段708 命令列覆寫您的檔案一個工作階段
709</h4>709</h4>
710 710
711您使用 `claude --settings '{"spinnerTipsEnabled": true}'` 啟動了工作階段。命令列位於除受管外的每個檔案之上,因此該工作階段顯示提示,即使您的檔案說 `false`。711您使用 `claude --settings '{"spinnerTipsEnabled": true}'` 啟動了工作階段。命令列位於除受管外的每個檔案之上,因此該工作階段顯示提示,即使您的檔案說 `false`。
716 旗標或環境變數設定相同的內容716 旗標或環境變數設定相同的內容
717</h4>717</h4>
718 718
719某些鍵具有命令列旗標或環境變數,無論哪個檔案設定它,都會覆蓋設定值:`ANTHROPIC_MODEL` 覆蓋 [`model`](/docs/zh-TW/settings-reference#model) 設定,`--model` 在一個工作階段內覆蓋兩者。719某些鍵具有命令列旗標或環境變數,無論哪個檔案設定它,都會覆寫設定值:`ANTHROPIC_MODEL` 覆寫 [`model`](/docs/zh-TW/settings-reference#model) 設定,`--model` 在一個工作階段內覆寫兩者。
720 720
721您是否可以取回您的值取決於鍵:取消設定變數或刪除旗標,並檢查[設定參考](/docs/zh-TW/settings-reference)上的鍵項目和[環境變數參考](/docs/zh-TW/env-vars)上的變數列,以了解 Claude Code 使用哪一個。721您是否可以取回您的值取決於鍵:取消設定變數或刪除旗標,並檢查[設定參考](/docs/zh-TW/settings-reference)上的鍵項目和[環境變數參考](/docs/zh-TW/env-vars)上的變數列,以了解 Claude Code 使用哪一個。
722 722
740 740
741其他東西設定了相同的鍵,檔案無法設定該值,或檔案未載入:741其他東西設定了相同的鍵,檔案無法設定該值,或檔案未載入:
742 742
743* **較高層級設定它。** 另一個設定檔案、`--settings` 旗標或受管來源在您的上方設定鍵;[堆疊](#settings-precedence)說明哪一個。旗標或環境變數也可以自行覆蓋鍵,按鍵決定;[設定參考](/docs/zh-TW/settings-reference)上的鍵項目說明 Claude Code 使用哪一個,[`env` 項目](/docs/zh-TW/settings-reference#env)涵蓋受管 `env` 值與 shell 匯出。743* **較高層級設定它。** 另一個設定檔案、`--settings` 旗標或受管來源在您的上方設定鍵;[堆疊](#settings-precedence)說明哪一個。旗標或環境變數也可以自行覆寫鍵,按鍵決定;[設定參考](/docs/zh-TW/settings-reference)上的鍵項目說明 Claude Code 使用哪一個,[`env` 項目](/docs/zh-TW/settings-reference#env)涵蓋受管 `env` 值與 shell 匯出。
744* **安全鍵保持其嚴格值。** 對於少數鍵,Claude Code 尊重來自任何檔案的限制值,因此專案 `true` 的 [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) 保持開啟;請參閱[受管設定優先順序的例外](#exceptions-to-managed-settings-precedence)。744* **安全鍵保持其嚴格值。** 對於少數鍵,Claude Code 尊重來自任何檔案的限制值,因此專案 `true` 的 [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) 保持開啟;請參閱[受管設定優先順序的例外](#exceptions-to-managed-settings-precedence)。
745* **檔案無法設定該值。** [`permissions.defaultMode`](/docs/zh-TW/settings-reference#permissions-defaultmode) 值 `auto` 和 `bypassPermissions` 不會從專案或本機設定生效;改為在使用者或受管設定中設定它們,或為一個工作階段傳遞 `--permission-mode`。在 v2.1.257 之前,`bypassPermissions` 從任何檔案生效。745* **檔案無法設定該值。** [`permissions.defaultMode`](/docs/zh-TW/settings-reference#permissions-defaultmode) 值 `auto` 和 `bypassPermissions` 不會從專案或本機設定生效;改為在使用者或受管設定中設定它們,或為一個工作階段傳遞 `--permission-mode`。在 v2.1.257 之前,`bypassPermissions` 從任何檔案生效。
746 746
770* **Claude Code 忽略儲存庫檔案中的鍵。** 在[設定索引](/docs/zh-TW/settings-reference#settings-index)的「範圍」欄中查找 `User, local, or managed`、`User or managed`、`Managed` 或 `Global config`。這些鍵永遠不會從共用檔案應用,除了少數儲存庫檔案仍然可以關閉的鍵。每個這些項目在其「範圍」行上都說明了這一點。`Global config` 鍵僅從 `~/.claude.json` 應用。770* **Claude Code 忽略儲存庫檔案中的鍵。** 在[設定索引](/docs/zh-TW/settings-reference#settings-index)的「範圍」欄中查找 `User, local, or managed`、`User or managed`、`Managed` 或 `Global config`。這些鍵永遠不會從共用檔案應用,除了少數儲存庫檔案仍然可以關閉的鍵。每個這些項目在其「範圍」行上都說明了這一點。`Global config` 鍵僅從 `~/.claude.json` 應用。
771 771
772 在 `env` 鍵內,遙測匯出變數也永遠不會從共用檔案應用,除了少數關閉值;請參閱[Claude Code 在 `env` 中忽略的變數](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)。772 在 `env` 鍵內,遙測匯出變數也永遠不會從共用檔案應用,除了少數關閉值;請參閱[Claude Code 在 `env` 中忽略的變數](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)。
773* **鍵等待信任。** `permissions.allow` 規則、`permissions.additionalDirectories`、`extraKnownMarketplaces` 和大多數 [`env`](/docs/zh-TW/settings-reference#env) 值僅在每個隊友[信任資料夾](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)後應用。在那之前,他們仍然看到提示,不會從檔案宣告的市場獲得外掛程式。`deny` 和 `ask` 規則立即應用。773* **鍵等待信任。** `permissions.allow` 規則、`permissions.additionalDirectories`、`extraKnownMarketplaces` 和大多數 [`env`](/docs/zh-TW/settings-reference#env) 值僅在每個隊友[信任資料夾](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)後應用。在那之前,他們仍然看到提示,不會從檔案宣告的市集獲得外掛。`deny` 和 `ask` 規則立即應用。
774 774
775<h4 id="permission-rules-combine-differently-than-you-expected">775<h4 id="permission-rules-combine-differently-than-you-expected">
776 權限規則的合併方式與您預期的不同776 權限規則的合併方式與您預期的不同
785 受管設定優先順序的例外785 受管設定優先順序的例外
786</h3>786</h3>
787 787
788對於少數值限制工作階段的鍵,Claude Code 尊重來自範圍的限制值,該範圍在其他情況下無法覆蓋受管設定。在此表中找到鍵以查看它尊重哪個值以及來自何處。788對於少數值限制工作階段的鍵,Claude Code 尊重來自範圍的限制值,該範圍在其他情況下無法覆寫受管設定。在此表中找到鍵以查看它尊重哪個值以及來自何處。
789 789
790| 鍵 | Claude Code 尊重的值 | 備註 |790| 鍵 | Claude Code 尊重的值 | 備註 |
791| :- | :- | :- |791| :- | :- | :- |
792| [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) | 來自任何範圍的 `true` | 即使受管來源設定 `false` 也被尊重 |792| [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) | 來自任何範圍的 `true` | 即使受管來源設定 `false` 也被尊重 |
793| [`enableArtifact`](/docs/zh-TW/settings-reference#enableartifact) | 來自任何範圍的 `false`,以及來自任何範圍的 `disableArtifact: true` | 即使受管來源設定 `true` 也被尊重;沒有任何東西會打開[成品工具](/docs/zh-TW/artifacts#disable-artifacts)。需要 Claude Code v2.1.242 或更新版本 |793| [`enableArtifact`](/docs/zh-TW/settings-reference#enableartifact) | 來自任何範圍的 `false`,以及來自任何範圍的 `disableArtifact: true` | 即使受管來源設定 `true` 也被尊重;沒有任何東西會重新開啟 [Artifact 工具](/docs/zh-TW/artifacts#disable-artifacts)。需要 Claude Code v2.1.242 或更新版本 |
794| [`isolatePeerMachines`](/docs/zh-TW/settings-reference#isolatepeermachines) | 來自任何範圍的 `true` | 即使受管來源設定 `false` 也被尊重 |794| [`isolatePeerMachines`](/docs/zh-TW/settings-reference#isolatepeermachines) | 來自任何範圍的 `true` | 即使受管來源設定 `false` 也被尊重 |
795| [`remoteControlAtStartup`](/docs/zh-TW/settings-reference#remotecontrolatstartup) | 來自 `.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使受管來源設定 `true` 也被尊重;專案或本機 `true` 被忽略 |795| [`remoteControlAtStartup`](/docs/zh-TW/settings-reference#remotecontrolatstartup) | 來自 `.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使受管來源設定 `true` 也被尊重;專案或本機 `true` 被忽略 |
796| [`crossSessionInbound`](/docs/zh-TW/settings-reference#crosssessioninbound) | 來自 `.claude/settings.json` 或 `.claude/settings.local.json` 的更嚴格值,在 `accept` \< `hold` \< `refuse` 梯級上 | 在受管、`--settings` 和使用者值上被尊重;不是更嚴格的專案或本機值被忽略 |796| [`crossSessionInbound`](/docs/zh-TW/settings-reference#crosssessioninbound) | 來自 `.claude/settings.json` 或 `.claude/settings.local.json` 的更嚴格值,在 `accept` \< `hold` \< `refuse` 梯級上 | 在受管、`--settings` 和使用者值上被尊重;不是更嚴格的專案或本機值被忽略 |
799| [`syncClaudeAiPlugins`](/docs/zh-TW/settings-reference#syncclaudeaiplugins) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使獲勝的受管來源設定 `true` 也被尊重;`.claude/settings.json` 中的 `false` 被忽略 |799| [`syncClaudeAiPlugins`](/docs/zh-TW/settings-reference#syncclaudeaiplugins) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使獲勝的受管來源設定 `true` 也被尊重;`.claude/settings.json` 中的 `false` 被忽略 |
800| [`maxEffortLevel`](/docs/zh-TW/settings-reference#maxeffortlevel) | 來自任何範圍(包括 `--settings`)的較低上限 | 即使 Claude Code 應用的受管設定設定較高的上限也被尊重;最低上限適用。需要 Claude Code v2.1.267 或更新版本 |800| [`maxEffortLevel`](/docs/zh-TW/settings-reference#maxeffortlevel) | 來自任何範圍(包括 `--settings`)的較低上限 | 即使 Claude Code 應用的受管設定設定較高的上限也被尊重;最低上限適用。需要 Claude Code v2.1.267 或更新版本 |
801 801
802執行 Claude Code 並設定 [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/zh-TW/env-vars) 的應用程式也是例外。Claude Code 採用該應用程式的模型設定而不是來自每個受管來源的 `model`、`fallbackModel`、`modelPicker` 和 `modelOverrides` 鍵,以及受管 `env` 區塊中的模型選擇變數,例如 `ANTHROPIC_MODEL` 和 `ANTHROPIC_DEFAULT_*_MODEL` 系列。Claude Code 保持受管 [`availableModels`](/docs/zh-TW/settings-reference#availablemodels) 允許清單有效,除非應用程式提供自己的。802在自身內部執行 Claude Code 並設定 [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/zh-TW/env-vars) 的應用程式也是例外。Claude Code 採用該應用程式的模型設定而不是來自每個受管來源的 `model`、`fallbackModel`、`modelPicker` 和 `modelOverrides` 鍵,以及受管 `env` 區塊中的模型選擇變數,例如 `ANTHROPIC_MODEL` 和 `ANTHROPIC_DEFAULT_*_MODEL` 系列。Claude Code 保持受管 [`availableModels`](/docs/zh-TW/settings-reference#availablemodels) 允許清單有效,除非應用程式提供自己的。
803 803
804<h2 id="settings-in-cloud-sessions">804<h2 id="settings-in-cloud-sessions">
805 雲端工作階段中的設定805 雲端工作階段中的設定