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` 以便複製儲存庫的每個人都取得相同的權限、hooks 和 plugins。每個隊友仍然可以在自己的 `.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
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` 設定每個工作階段開始時的模型,您仍然可以使用 `/model` 切換;鎖定是 [`availableModels`](/docs/zh-TW/settings-reference#availablemodels),它限制 `/model`、`--model` 和您自己檔案中的 `model` 鍵。當您的組織提供多個受管來源時,[受管層級內的優先順序](/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` 時傳遞的旗標,適用於一個工作階段;請參閱[變更一個工作階段的設定](#change-a-setting-for-one-session)。Claude Code 使用 `--settings <file-or-json>` 傳遞的 JSON 與您的設定檔案合併,遵循與其他層級相同的規則:它採用您在此設定的鍵而不是本機、專案或使用者設定中的相同鍵,並為您省略的鍵保留較低層級的值。
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`):您對每個專案的個人設定。
667 667
668環境變數不是此堆疊中的層級。當行為同時具有 shell 變數和設定金鑰時,哪一個適用是按對決定的,而不是按層級:在您的 shell 中匯出的 `ANTHROPIC_MODEL` 適用於任何檔案中的 `model` 金鑰,而 `ANTHROPIC_DEFAULT_MODEL` 僅在沒有檔案設定 `model` 時適用。[環境變數參考](/docs/zh-TW/env-vars#precedence)說明哪些金鑰有對以及 Claude Code 首先讀取哪一個。設定檔案內的 `env` 區塊是普通金鑰並遵循上面的層級。668環境變數不是此堆疊中的層級。當行為同時具有 shell 變數和設定鍵時,哪一個適用是按對決定的,而不是按層級:在您的 shell 中匯出的 `ANTHROPIC_MODEL` 適用於任何檔案中的 `model` 鍵,而 `ANTHROPIC_DEFAULT_MODEL` 僅在沒有檔案設定 `model` 時適用。[環境變數參考](/docs/zh-TW/env-vars#precedence)說明哪些鍵有對應以及 Claude Code 首先讀取哪一個。設定檔案內的 `env` 區塊是普通鍵,遵循上述層級。
669 669
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 會合併列表而不是選擇一個,因此每個檔案都可以新增項目而不移除另一個檔案的項目。四個保存模型列表或每個模型項目的鍵遵循自己的規則:
677 677
678* [`fallbackModel`](/docs/zh-TW/settings-reference#fallbackmodel) 是一個有序鏈,其中位置具有意義,因此 Claude Code 從定義它的最高優先順序檔案取整個值。678* [`fallbackModel`](/docs/zh-TW/settings-reference#fallbackmodel) 是一個有序鏈,其中位置具有意義,因此 Claude Code 採用定義它的最高優先順序檔案的整個值。
679* [`modelPicker`](/docs/zh-TW/settings-reference#modelpicker) 保存一個有序行列表加上替換旗標,因此 Claude Code 永遠不會合併來自兩個來源的行。它從定義它的受管設定、`--settings` 和使用者設定的最高取整個值,並忽略專案和本機設定中的金鑰。需要 Claude Code v2.1.242 或更新版本。679* [`modelPicker`](/docs/zh-TW/settings-reference#modelpicker) 保存一個有序列表行加上一個替換旗標,因此 Claude Code 永遠不會合併來自兩個來源的行。它採用定義它的受管設定、`--settings` 和使用者設定中最高的整個值,並忽略專案和本機設定中的鍵。需要 Claude Code v2.1.242 或更新版本。
680* [`availableModels`](/docs/zh-TW/settings-reference#availablemodels):當 Claude Code 應用的受管設定定義它時,Claude Code 按原樣應用該列表並忽略您在使用者、專案或本機設定中新增的項目,除非嵌入 Claude Code 的應用程式提供自己的模型列表;請參閱[受管設定優先順序的例外](#exceptions-to-managed-settings-precedence)。跨受管來源列表也永遠不會合併;[Claude Code 如何合併受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)說明哪個來源的列表適用。跨非受管範圍 Claude Code 照常合併陣列。680* [`availableModels`](/docs/zh-TW/settings-reference#availablemodels):當 Claude Code 應用的受管設定定義它時,Claude Code 按原樣應用該列表,並忽略您在使用者、專案或本機設定中新增的項目,除非嵌入 Claude Code 的應用程式提供自己的模型列表;請參閱[受管設定優先順序的例外](#exceptions-to-managed-settings-precedence)。在受管來源之間,列表也永遠不會合併;[Claude Code 如何合併受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)說明哪個來源的列表適用。在非受管範圍內,Claude Code 照常合併陣列。
681* [`modelSettings`](/docs/zh-TW/settings-reference#modelsettings):Claude Code 一次解析它一個模型,連同 [`effortLevel`](/docs/zh-TW/settings-reference#effortlevel)。`modelSettings` 項目說明哪個檔案的值適用於模型。681* [`modelSettings`](/docs/zh-TW/settings-reference#modelsettings):Claude Code 一次解析一個模型,連同 [`effortLevel`](/docs/zh-TW/settings-reference#effortlevel)。`modelSettings` 項目說明哪個檔案的值適用於模型。
682 682
683<span id="examples" />683<span id="examples" />
684 684
686 優先順序範例686 優先順序範例
687</h3>687</h3>
688 688
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 使用專案值,因為共用專案位於使用者之上,因此您在該專案中看到提示,在其他地方看不到。
696 696
697您可以取回您的值:在該專案中將 `"spinnerTipsEnabled": false` 新增到 `.claude/settings.local.json`。專案本機位於共享專案上方,因此您的工作階段停止顯示提示,您隊友的工作階段不變。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` 也不會。受管是最高層級。
704 704
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`。
712 712
713您在下一個工作階段上取回您的值;`--settings` 持續一個工作階段並不寫入任何檔案。713您在下一個工作階段取回您的值;`--settings` 持續一個工作階段,不會寫入任何檔案。
714 714
715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">
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
723<span id="keys-ignored-in-a-repository-file" />723<span id="keys-ignored-in-a-repository-file" />
724 724
732 疑難排解不適用的設定732 疑難排解不適用的設定
733</h3>733</h3>
734 734
735當您設定金鑰而 Claude Code 不表現得好像您有時,請從 `/status` 開始以查看它載入了哪些檔案,然後在下面找到您的症狀。[除錯您的設定](/docs/zh-TW/debug-your-config)涵蓋更廣泛的檢查,包括乾淨設定測試。735當您設定鍵而 Claude Code 沒有表現得像您一樣時,從 `/status` 開始查看它載入了哪些檔案,然後在下面找到您的症狀。[偵錯您的設定](/docs/zh-TW/debug-your-config)涵蓋更廣泛的檢查,包括乾淨設定測試。
736 736
737<h4 id="a-value-you-set-is-ignored">737<h4 id="a-value-you-set-is-ignored">
738 您設定的值被忽略738 您設定的值被忽略
739</h4>739</h4>
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* **檔案損壞。** 無效的 JSON 或拒絕的值使 Claude Code 跳過檔案或項目;請參閱[修復損壞的設定檔案](#fix-a-broken-settings-file)。746
747 [`env`](/docs/zh-TW/settings-reference#env) 區塊中的遙測匯出變數也不會從專案或本機設定生效,除了少數關閉值。[Claude Code 在 `env` 中忽略的變數](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)列出變數和這些值。
748* **檔案已損壞。** 無效的 JSON 或被拒絕的值會導致 Claude Code 跳過檔案或項目;請參閱[修復損壞的設定檔案](#fix-a-broken-settings-file)。
747 749
748<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">750<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">
749 您在 Claude Code 中所做的變更在新工作階段中丟失751 您在 Claude Code 中所做的變更在新工作階段中丟失
750</h4>752</h4>
751 753
752當您從 Claude Code 內儲存新工作階段的選擇時,例如使用 `/model` 的預設模型,Claude Code 將其寫入您的使用者設定檔案 `~/.claude/settings.json`。如果您無法寫入該檔案,例如因為另一個工具產生它或將其連結到唯讀副本,變更適用於目前工作階段並在下一個工作階段中消失。在產生檔案的工具中設定金鑰,或用您可以寫入的檔案替換檔案。754當您從 Claude Code 內部為新工作階段儲存選擇時,例如使用 `/model` 的預設模型,Claude Code 會將其寫入您的使用者設定檔案 `~/.claude/settings.json`。如果您無法寫入該檔案,例如因為另一個工具生成它或將其連結到唯讀副本,變更適用於目前工作階段,在下一個工作階段中消失。在生成檔案的工具中設定鍵,或將檔案替換為您可以寫入的檔案。
753 755
754如果您可以寫入檔案而變更仍然不持續,請檢查變更是否[僅用於一個工作階段](#change-a-setting-for-one-session)或[較高層級設定相同金鑰](#a-value-you-set-is-ignored)。對於 `model` 金鑰,[新工作階段在不同的模型上啟動而不是您選擇的](/docs/zh-TW/model-config#a-new-session-starts-on-a-different-model-than-you-picked)列出更多原因。756如果您可以寫入檔案,變更仍然不持續,請檢查變更是否[僅適用於一個工作階段](#change-a-setting-for-one-session)或[較高層級設定相同的鍵](#a-value-you-set-is-ignored)。對於 `model` 鍵,[新工作階段以不同的模型開始,而不是您選擇的](/docs/zh-TW/model-config#a-new-session-starts-on-a-different-model-than-you-picked)列出更多原因。
755 757
756<h4 id="a-managed-change-hasn’t-reached-you">758<h4 id="a-managed-change-hasn’t-reached-you">
757 受管變更還沒有到達您759 受管變更尚未到達您
758</h4>760</h4>
759 761
760受管來源按[傳遞表](/docs/zh-TW/managed-settings#choose-a-delivery-mechanism)中的排程到達執行中的工作階段,因此首先重新啟動工作階段。如果 `/status` 然後命名不同的來源而不是您的管理員變更的,較高優先順序的來源適用;[Claude Code 如何合併受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)給出順序。762受管來源根據[傳遞表](/docs/zh-TW/managed-settings#choose-a-delivery-mechanism)中的排程到達執行中的工作階段,因此請先重新啟動工作階段。如果 `/status` 隨後命名與您的管理員變更的來源不同的來源,則較高優先順序的來源適用;[Claude Code 如何合併受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)給出順序。
761 763
762<h4 id="a-committed-key-doesn’t-reach-teammates">764<h4 id="a-committed-key-doesn’t-reach-teammates">
763 提交的金鑰不到達隊友765 已提交的鍵無法到達隊友
764</h4>766</h4>
765 767
766兩件事使 `.claude/settings.json` 中的金鑰無法為複製它的每個人應用:768兩件事使 `.claude/settings.json` 中的鍵無法為克隆它的每個人應用:
769
770* **Claude Code 忽略儲存庫檔案中的鍵。** 在[設定索引](/docs/zh-TW/settings-reference#settings-index)的「範圍」欄中查找 `User, local, or managed`、`User or managed`、`Managed` 或 `Global config`。這些鍵永遠不會從共用檔案應用,除了少數儲存庫檔案仍然可以關閉的鍵。每個這些項目在其「範圍」行上都說明了這一點。`Global config` 鍵僅從 `~/.claude.json` 應用。
767 771
768* **Claude Code 忽略儲存庫檔案中的金鑰。** 在[設定索引](/docs/zh-TW/settings-reference#settings-index)的「範圍」欄中查找 `User, local, or managed`、`User or managed`、`Managed` 或 `Global config`。這些金鑰永遠不會從共享檔案應用,除了少數可以儲存庫檔案仍然關閉的金鑰。每個這些項目在其「範圍」行上說明。`Global config` 金鑰僅從 `~/.claude.json` 應用。772 在 `env` 鍵內,遙測匯出變數也永遠不會從共用檔案應用,除了少數關閉值;請參閱[Claude Code 在 `env` 中忽略的變數](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)。
769* **金鑰等待信任。** `permissions.allow` 規則、`permissions.additionalDirectories`、`extraKnownMarketplaces` 和大多數 [`env`](/docs/zh-TW/settings-reference#env) 值僅在每個隊友[信任資料夾](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)後應用。在那之前,他們仍然看到提示並不從檔案宣告的 marketplace 獲得 plugins。`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` 規則立即應用。
770 774
771<h4 id="permission-rules-combine-differently-than-you-expected">775<h4 id="permission-rules-combine-differently-than-you-expected">
772 權限規則組合方式與您預期不同776 權限規則的合併方式與您預期的不同
773</h4>777</h4>
774 778
775* **您在權限提示上選擇「是,不要再問」但仍然為相同工具獲得提示。** 該選擇將 `allow` 規則儲存到您的本機檔案,本機的 `allow` 規則不優先於專案或受管檔案的 `ask` 規則;[權限規則如何組合](/docs/zh-TW/permissions#settings-precedence)解釋順序。在 VS Code 擴充功能中,批准卡讓您選擇目標檔案,包括專案的共享檔案,這為每個人變更規則;在 CLI 中,Claude Code 僅寫入您的本機檔案。779* **您在權限提示上選擇了「是,不要再問」,但仍然收到相同工具的提示。** 該選擇將 `allow` 規則儲存到您的本機檔案,本機檔案中的 `allow` 規則不會超越專案或受管檔案中的 `ask` 規則;[權限規則如何合併](/docs/zh-TW/permissions#settings-precedence)解釋了順序。在 VS Code 擴充功能中,核准卡讓您選擇目標檔案,包括專案的共用檔案,這會為每個人變更規則;在 CLI 中,Claude Code 僅寫入您的本機檔案。
776* **您的組織的 allow 規則仍然與您的一起應用。** 這是預期的:Claude Code 跨範圍合併 [`permissions.allow`](/docs/zh-TW/settings-reference#permissions-allow),除非您的組織設定 [`allowManagedPermissionRulesOnly`](/docs/zh-TW/settings-reference#allowmanagedpermissionrulesonly)。780* **您的組織的允許規則仍然與您的規則一起應用。** 這是預期的:Claude Code 在範圍內合併 [`permissions.allow`](/docs/zh-TW/settings-reference#permissions-allow),除非您的組織設定 [`allowManagedPermissionRulesOnly`](/docs/zh-TW/settings-reference#allowmanagedpermissionrulesonly)。
777 781
778<span id="security-keys-where-the-stricter-value-applies" />782<span id="security-keys-where-the-stricter-value-applies" />
779 783
781 受管設定優先順序的例外785 受管設定優先順序的例外
782</h3>786</h3>
783 787
784對於少數值限制工作階段的金鑰,Claude Code 尊重來自否則無法覆蓋受管設定的範圍的限制值。在此表中找到金鑰以查看它尊重哪個值以及從哪裡。788對於少數值限制工作階段的鍵,Claude Code 尊重來自範圍的限制值,該範圍在其他情況下無法覆蓋受管設定。在此表中找到鍵以查看它尊重哪個值以及來自何處。
785 789
786| 金鑰 | Claude Code 尊重的值 | 注意 |790| 鍵 | Claude Code 尊重的值 | 備註 |
787| :--------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------- |791| :--------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------- |
788| [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) | 來自任何範圍的 `true` | 即使受管來源設定 `false` 也被尊重 |792| [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) | 來自任何範圍的 `true` | 即使受管來源設定 `false` 也被尊重 |
789| [`enableArtifact`](/docs/zh-TW/settings-reference#enableartifact) | 來自任何範圍的 `false`,以及來自任何範圍的 `disableArtifact: true` | 即使受管來源設定 `true` 也被尊重;沒有什麼將 [Artifact 工具](/docs/zh-TW/artifacts#disable-artifacts)打開。需要 Claude Code v2.1.242 或更新版本 |793| [`enableArtifact`](/docs/zh-TW/settings-reference#enableartifact) | 來自任何範圍的 `false`,以及來自任何範圍的 `disableArtifact: true` | 即使受管來源設定 `true` 也被尊重;沒有任何東西會打開[成品工具](/docs/zh-TW/artifacts#disable-artifacts)。需要 Claude Code v2.1.242 或更新版本 |
790| [`isolatePeerMachines`](/docs/zh-TW/settings-reference#isolatepeermachines) | 來自任何範圍的 `true` | 即使受管來源設定 `false` 也被尊重 |794| [`isolatePeerMachines`](/docs/zh-TW/settings-reference#isolatepeermachines) | 來自任何範圍的 `true` | 即使受管來源設定 `false` 也被尊重 |
791| [`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` 被忽略 |
792| [`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` 和使用者值上被尊重;不是更嚴格的專案或本機值被忽略 |
793| [`useAutoModeDuringPlan`](/docs/zh-TW/settings-reference#useautomodeduringplan) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使獲勝的受管來源設定 `true` 也被尊重;`.claude/settings.json` 中的 `false` 被忽略 |797| [`useAutoModeDuringPlan`](/docs/zh-TW/settings-reference#useautomodeduringplan) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使獲勝的受管來源設定 `true` 也被尊重;`.claude/settings.json` 中的 `false` 被忽略 |
794| [`syncClaudeAiSkills`](/docs/zh-TW/settings-reference#syncclaudeaiskills) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使獲勝的受管來源設定 `true` 也被尊重;`.claude/settings.json` 中的 `false` 被忽略 |798| [`syncClaudeAiSkills`](/docs/zh-TW/settings-reference#syncclaudeaiskills) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使獲勝的受管來源設定 `true` 也被尊重;`.claude/settings.json` 中的 `false` 被忽略 |
795| [`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` 被忽略 |
796| [`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 或更新版本 |
797 801
798在自己內部執行 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) 允許清單有效,除非應用程式提供自己的。
799 803
800<h2 id="settings-in-cloud-sessions">804<h2 id="settings-in-cloud-sessions">
801 雲端工作階段中的設定805 雲端工作階段中的設定