settings.json 檔案範例,每個對應一個您儲存設定的位置:
- 開發者的
~/.claude/settings.json - 團隊的
.claude/settings.json,提交到版本庫 - 組織的
managed-settings.json
您自己的設定
一位開發者的個人設定。它選擇一個模型和努力程度,調整終端機,並預先批准一個唯讀命令和一個檔案讀取。未列出的所有內容都保持其預設值。這樣的檔案放在~/.claude/settings.json 中,適用於您開啟的每個專案。
- 可複製的設定檔
- 每個鍵的作用
將此儲存為
~/.claude/settings.json。這是有效的 JSON,沒有註解,因此您可以直接貼上並刪除您不想要的鍵。~/.claude/settings.json
團隊的共享設定
一個團隊的共享設定,提交到版本庫,以便每個複製它的人都獲得相同的權限、hooks 和外掛程式市集。在版本庫的頂部將這樣的檔案儲存在.claude/settings.json。提交之前需要了解的事項:
- 雲端工作階段也會讀取它。 一個 雲端工作階段 從版本庫的複製開始,因此提交的檔案也適用於此。
- 遙測進入受管理或個人設定。 Claude Code 會忽略版本庫設定檔案中的 OpenTelemetry 匯出器變數,除了一些關閉遙測的值。在 受管理設定 中為您的組織設定它們,或在每個人的
~/.claude/settings.json中設定。 - 允許規則等待信任。 允許規則和
extraKnownMarketplaces項目在每個人 信任此資料夾本身 後生效,不僅是父資料夾;拒絕和詢問規則在每個工作階段中適用,無論是否信任。 - hook 是版本庫中的指令碼。 此檔案的 hook 執行
.claude/hooks/block-rm.sh;hook 如何解析 說明如何編寫它。 - 規則匹配所寫的命令和路徑。
Bash(git push *)不匹配git -C . push。Read(./.env)本身會停止檔案工具和命名檔案的命令,例如cat .env,但不會停止grep -r在目錄上執行;此檔案中的sandbox區塊關閉了該間隙,因為沙箱 新增您的Read拒絕路徑 到每個沙箱化命令無法讀取的內容。
- 可複製的設定檔
- 每個鍵的作用
將此儲存為版本庫頂部的
.claude/settings.json 並提交。這是有效的 JSON,沒有註解,因此您可以直接貼上並刪除您不想要的鍵。.claude/settings.json
組織的受管設定
一個managed-settings.json 檔案,顯示受管鍵的形狀,每個都有一個合理的數值。這不是建議的政策:選擇符合您自己要求的鍵並設定您自己的數值。該範例設定這些鍵:
forceLoginMethod和forceLoginOrgUUID固定登入方法和組織availableModels和enforceAvailableModels限制工作階段可以使用的模型permissions.deny拒絕兩個檔案讀取和curl命令 如 Claude 所寫,disableBypassPermissionsMode移除繞過權限模式allowManagedPermissionRulesOnly和allowManagedMcpServersOnly使受管權限和 MCP 允許清單成為唯一適用的清單allowedMcpServers透過 URL 固定 MCP 伺服器strictKnownMarketplaces允許一個外掛程式市集sandbox沙箱化命令,具有固定的網路允許清單且無沙箱外重試。其failIfUnavailable鍵會在沙箱無法執行的環境中阻止 Claude Code 啟動requiredMinimumVersion設定最低 Claude Code 版本cleanupPeriodDays將工作階段記錄和其他本機資料的保留期縮短至七天companyAnnouncements在啟動時顯示訊息
managed-settings.json,或透過 MDM 或 伺服器受管設定 部署相同的 JSON。一個部署的檔案適用於它到達的每台機器或帳戶。要為一個群組提供不同的數值,請將不同的檔案或設定檔部署到該群組,因為 伺服器受管設定尚不支援每個群組的政策。
- 可複製的設定檔
- 每個鍵的作用
將此部署為
managed-settings.json,或透過 MDM 或 claude.ai 主控台部署相同的 JSON。這是有效的 JSON,沒有註解;將範例組織 UUID、伺服器 URL 和市集替換為您自己的,並刪除您不想要的鍵。managed-settings.json