Skip to main content
本頁面包含三個 settings.json 檔案範例,每個對應一個您儲存設定的位置:
  • 開發者的 ~/.claude/settings.json
  • 團隊的 .claude/settings.json,提交到版本庫
  • 組織的 managed-settings.json
每個檔案都是該讀者的合理檔案,因此您可以看到結構並複製您想要的部分。它們都不是建議的基準。每個數值都來自 設定參考 上的鍵項目,其中包含其類型、預設值和可以設定的位置。 每個範例有兩個標籤。可複製的設定檔 是您儲存的檔案。每個鍵的作用 是相同的檔案,每個鍵上方有註解;Claude Code 不接受設定檔中的註解,因此請從第一個標籤複製。

您自己的設定

一位開發者的個人設定。它選擇一個模型和努力程度,調整終端機,並預先批准一個唯讀命令和一個檔案讀取。未列出的所有內容都保持其預設值。這樣的檔案放在 ~/.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