所有設定

設定索引

模型與回應

advisorModel

• 範圍：Any file
• 類型：字串，為別名 "fable"、"opus" 或 "sonnet" 之一（會解析為 Claude Code 目前該模型系列的預設版本），或完整的模型 ID，例如 "claude-opus-5-5"
• 預設值：未設定，因此 advisor 為關閉狀態
• 每個工作階段的覆寫：--advisor 在單一工作階段中優先於此鍵。CLAUDE_CODE_DISABLE_ADVISOR_TOOL 會關閉 advisor，且此鍵無法將其重新開啟

{
  "advisorModel": "opus"
}

alwaysThinkingEnabled

• 範圍：Any file
• 類型：Boolean
  • true：沒有作用；思考已開啟
  • false：Claude Code 在每個工作階段中關閉延伸思考
• 預設值：未設定，因此支援思考的模型會開啟思考
• 每個工作階段的覆寫：MAX_THINKING_TOKENS 在單一工作階段中優先於此鍵：0 會關閉思考，受與 false 相同的模型和供應商限制；正值則會開啟思考，即使此鍵為 false 亦然。在自適應推理模型上，數值本身會被忽略

{
  "alwaysThinkingEnabled": false
}

availableModels

• 範圍：Any file。將其部署於受管設定中，即可為組織強制執行。
• 類型：模型別名或 ID 的陣列
• 預設值：未設定，因此所有模型皆可使用

{
  "availableModels": ["sonnet", "haiku"]
}

availableModelsMatch

• 範圍：Managed。Claude Code 會忽略使用者、專案及本機設定中以及 --settings 中的此鍵，並顯示警告
• 類型：字串，為下列之一：
  • "prefix"：模型 ID 項目允許其版本，以及任何以另一個片段延伸該 ID 的模型 ID
  • "exact"：模型 ID 項目只允許其所指定的版本，因此 "claude-opus-5" 允許 Opus 5 但不允許 claude-opus-5-5。像 "claude-opus-4-5" 這樣的項目也會允許其帶日期的 Anthropic 模型 ID claude-opus-4-5-20251101。像 "opus" 這樣的系列別名仍會允許整個系列，而 best、opusplan 和 default 項目會被忽略
• 預設值："prefix"

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

deniedModels

• 範圍：Managed。Claude Code 會忽略使用者、專案及本機設定中以及 --settings 中的此鍵，並顯示警告
• 類型：模型別名或 ID 的陣列
  • 像 "opus" 這樣的系列別名會封鎖該系列中的所有模型
  • 像 "claude-opus-5-5" 這樣的模型 ID 會封鎖該版本的所有寫法，包括帶日期的 ID 和供應商特定的 ID
  • 沒有次版本號的模型 ID，例如 "claude-opus-5"，也會封鎖後續的次版本，例如 Opus 5.5。若只要封鎖 Opus 5，請寫成 "claude-opus-5-0"
  • best、opusplan 和 default 項目會被忽略
• 預設值：未設定，因此不會封鎖任何模型

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

effortLevel

• 範圍：Any file
• 類型：字串，為下列之一：
  • "low"：最少的推理，適用於簡短、範圍明確、對延遲敏感且不需要高度智慧的任務
  • "medium"：為對成本敏感、可犧牲部分智慧的工作減少 token 使用量
  • "high"：在 token 使用量與智慧之間取得平衡
  • "xhigh"：以較高的 token 花費進行更深入的推理
• 預設值：未設定
• 每個工作階段的覆寫：--effort 在單一工作階段中優先於此鍵，而 CLAUDE_CODE_EFFORT_LEVEL 則優先於兩者

{
  "effortLevel": "xhigh"
}

enforceAvailableModels

• 範圍：Any file
• 類型：Boolean
  • true：當 Default 會解析為 availableModels 以外的模型時，Claude Code 會將其解析為清單中第一個可用的模型
  • false：此鍵不會改變 Default 的解析方式
• 預設值：false

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

fallbackModel

• 範圍：Any file
• 類型：模型別名或 ID 的陣列；"default" 會展開為預設模型
• 預設值：未設定，因此失敗的請求不會在其他模型上重試
• 每個工作階段的覆寫：--fallback-model 在單一工作階段中優先於此鍵

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

fastMode

• 範圍：Any file
• 類型：Boolean
  • true：Claude Code 在可使用快速模式的工作階段中開啟快速模式。在 Fable 5.2 上，您還必須在使用 Fable 5.2 時執行 /fast
  • false：快速模式保持關閉
• 預設值：未設定，因此快速模式為關閉狀態
• 每個工作階段的覆寫：CLAUDE_CODE_DISABLE_FAST_MODE 會在單一工作階段中關閉快速模式，且此鍵無法將其重新開啟

{
  "fastMode": true
}

fastModePerSessionOptIn

• 範圍：Any file
• 類型：Boolean
  • true：已儲存的 fastMode: true 不再於工作階段開始時開啟快速模式，因此每位使用者需在需要的每個工作階段中執行 /fast；除非受管設定設定了此鍵，否則透過 --settings 傳入的 fastMode: true 仍會對該工作階段生效
  • false：已儲存的 fastMode: true 會依 fastMode 所述的方式運作
• 預設值：false

{
  "fastModePerSessionOptIn": true
}

language

• 範圍：Any file
• 類型：字串，任何語言名稱，例如 "japanese"、"spanish" 或 "french"；Claude Code 不會驗證此值
• 預設值：未設定；此時工作階段標題會與您對話的語言一致

{
  "language": "japanese"
}

maxEffortLevel

• 範圍：Any file。將其部署於受管設定中，即可為組織強制執行。當多個範圍設定了上限時，會套用最低的上限，因此在某個範圍設定的上限無法從另一個範圍提高
• 類型：字串，為 "low"、"medium"、"high"、"xhigh" 或 "max" 之一。"max" 值表示不設上限
• 預設值：未設定，因此不套用任何上限
• 每個模型的上限：在模型的 modelSettings 項目中加入 maxEffortLevel。該項目只會在同時設定兩者的設定來源中（例如您的使用者設定或某一個受管來源），針對該模型取代此鍵。在該處設定 "max" 可讓該模型免受該來源的上限限制；Claude Code 仍會套用其他來源的上限

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

model

• 範圍：Any file
• 類型：字串，模型別名或完整的模型 ID
• 預設值：未設定，因此 Claude Code 會使用您帳戶的預設模型
• 每個工作階段的覆寫：--model 優先於 ANTHROPIC_MODEL，而兩者在單一工作階段中都優先於此鍵，包括優先於受管的 model；availableModels 清單仍會套用於所選模型

{
  "model": "claude-sonnet-5"
}

modelOverrides

• 範圍：Any file
• 類型：將模型 ID 對應至供應商模型 ID 的物件
• 預設值：未設定

{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
  }
}

modelPicker

• 範圍：User or managed。Claude Code 會從受管設定、--settings 和使用者設定讀取此鍵，並忽略專案及本機設定中的此鍵，以免您複製的儲存庫重新標記選擇器。這三者中設定了此鍵且優先順序最高者會提供整個陣容，Claude Code 絕不會合併來自兩個來源的陣容。
• 類型：包含列組成的 options 陣列以及選用的 replaceBuiltInOptions Boolean 的物件
• 預設值：未設定，因此選擇器會顯示內建陣容

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

modelPicker 的欄位

• 捨棄：Claude Code 無法提供的列，例如已淘汰的模型，或您的組織沒有存取權的模型
• 顯示為灰色：您目前尚無法選擇的列，並顯示原因
• 沒有任何列保留：Claude Code 會保留內建陣容，並如常依允許清單篩選

modelPricing

• 範圍：Managed。透過伺服器受管設定、MDM 政策、managed-settings.json 檔案或政策輔助程式部署此鍵。Claude Code 會忽略使用者、專案及本機設定中、--settings 中，以及 Windows 上使用者可寫入的 HKCU 登錄中的此鍵。使用伺服器受管設定時，每個工作階段會以牌價回報成本，直到該工作階段的設定擷取確認此設定為止。嵌入 Claude Code 並設定 CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 的主機應用程式，可以透過 SDK 的 managedSettings 選項提供自己的費率表，Claude Code 只會在沒有受管來源設定此鍵時使用該費率表，且僅限 Claude Code v2.1.246 或更新版本。
• 類型：包含選用的 multiplier 和選用的 overrides 對應的物件
• 預設值：未設定，因此除非主機應用程式提供費率表，否則 Claude Code 會回報牌價

{
  "modelPricing": {
    "multiplier": 0.85,
    "overrides": {
      "claude-sonnet-4-6": {
        "input": 2.4,
        "output": 12,
        "cacheRead": 0.24,
        "cacheWrite": 3
      }
    }
  }
}

modelPricing 的欄位

modelPricing 的一列適用於哪些模型

• 內建模型的 ID：Claude Code 本身用於內建模型的鍵，無論該鍵是模型自身的 ID（例如 claude-sonnet-4-6），還是其 Bedrock、Agent Platform 或 Foundry ID。Claude Code 會將該列套用至該模型的每個帶日期快照 ID 和供應商特定 ID。
• 任何其他鍵：不是內建模型 ID 的鍵，例如閘道模型別名。Claude Code 只會將該列套用至那一個 ID。當某個模型 ID 與您的某個鍵完全相符，同時也屬於以內建模型 ID 為鍵的列時，Claude Code 會使用完全相符者。
• Bedrock 應用程式推論設定檔：一旦 Claude Code 透過您的 modelOverrides 對應或 bedrock:GetInferenceProfile 查詢，將該設定檔解析為其路由到的模型，Claude Code 就會將該模型的列套用至該設定檔。

modelSettings

• 範圍：Any file
• 類型：將模型名稱對應至物件的物件，該物件可包含下列任一欄位：
  • effortLevel："low"、"medium"、"high" 或 "xhigh" 之一
  • maxEffortLevel：該模型可執行的最高 effort 等級
  • autoCompactWindow：從 100000 到 1000000 的 token 數量，或 "auto" 表示針對該模型調整的視窗。/autocompact 會儲存於此。對於該模型，此值優先於同一個設定檔中頂層的 autoCompactWindow。需要 Claude Code v2.1.288 或更新版本
• 預設值：未設定

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

outputStyle

• 範圍：Any file
• 類型：字串，內建或自訂輸出風格的名稱
• 預設值：未設定，因此 Claude Code 會使用預設風格

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

• 範圍：Any file
• 類型：字串，為下列之一：
  • "5m"：快取保留五分鐘
  • "1h"：快取保留一小時
• 預設值：未設定，因此每個主要對話請求會取得其預設存留期
• 每個工作階段的覆寫：FORCE_PROMPT_CACHING_5M 優先於其他所有項目，其次是 CLAUDE_CODE_PROMPT_CACHE_TTL，然後是此鍵，最後是 ENABLE_PROMPT_CACHING_1H

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

showThinkingSummaries

• 範圍：Any file
• 類型：Boolean
  • true：使用 Ctrl+O 展開思考時，您會看到完整的思考摘要
  • false：Anthropic API 會遮蔽思考區塊，而 Claude Code 會顯示一個摺疊的虛設區塊
• 預設值：false

{
  "showThinkingSummaries": true
}

subagentPromptCacheTtl

• 範圍：Any file
• 類型：字串，為下列之一：
  • "5m"：快取保留五分鐘
  • "1h"：快取保留一小時
• 預設值：未設定，因此這些請求各自取得其預設存留期
• 每個工作階段的覆寫：FORCE_PROMPT_CACHING_5M 優先於其他所有項目，其次是 CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL，然後是此鍵，再來是 ENABLE_PROMPT_CACHING_1H，它會要求每個請求都使用一小時的存留期。關於 subagent 自身 frontmatter 值的優先順序，請參閱自行選擇 TTL

{
  "subagentPromptCacheTtl": "1h"
}

switchModelsOnFlag

• 範圍：Any file。在 /config 中顯示為 Switch models when a message is flagged，選項為 Switch automatically 和 Ask each time。
• 類型：Boolean
  • true：Claude Code 切換至備援模型並繼續
  • false：在互動式工作階段中，Claude Code 會暫停讓您在切換與編輯提示詞之間做選擇；在無法顯示對話方塊的情況下（例如 -p 執行），被標記的請求會以錯誤結束
• 預設值：未設定。Claude Code 會自動切換，但在互動式工作階段中可能會先詢問

{
  "switchModelsOnFlag": false
}

ultracode

• 範圍：Any file
• 類型：Boolean
  • true：當您啟用了動態工作流程且您的模型支援 xhigh 時，工作階段會以開啟 ultracode 的狀態啟動
  • false：工作階段會以關閉 ultracode 的狀態啟動
• 預設值：未設定，因此 ultracode 為關閉狀態
• 每個工作階段的覆寫：/effort ultracode 會在沒有此鍵的情況下於單一工作階段中開啟 ultracode，而當此鍵為 true 時，/effort ultracode off 會在單一工作階段中將其關閉。--effort ultracode 旗標也會以 xhigh effort 在單一工作階段中開啟 ultracode

{
  "ultracode": true
}

權限設定

allowManagedPermissionRulesOnly

• 儲存庫的 .claude/ 目錄
• 您的 ~/.claude/skills/ 和 ~/.claude/commands/ 目錄，包括從 claude.ai 同步的 skill
• --add-dir 目錄
• 位於 ~/.claude/skills/ 或專案的 .claude/skills/ 內、以 .claude-plugin 資訊清單宣告的外掛
• 僅為單一工作階段載入、其 id 以 @inline 結尾的外掛，且下列條件全部成立時：
  • 該工作階段是由 Claude Desktop 應用程式本身啟動 Claude Code 的 Code 工作階段或 Cowork 工作階段，雲端工作階段除外
  • 此設定鍵由您的受管設定設定，而不僅是由嵌入主機的父設定設定
  • 該工作階段執行 Claude Code v2.1.305 或更新版本

• 範圍：Managed
• 類型：布林值
  • true：受管設定成為權限規則的唯一設定來源
  • false：Claude Code 除了套用受管規則外，還會套用來自使用者、專案、本機和 --settings 檔案的權限規則
• 預設值：未設定，因此 Claude Code 會套用來自使用者、專案和本機設定以及 --settings 的權限規則，以及受管規則

{
  "allowManagedPermissionRulesOnly": true
}

autoMode

• 範圍：User or managed
• 類型：物件，包含 environment、allow、soft_deny 和 hard_deny 散文規則陣列，加上 classifyAllShell 布林值
• 預設值：未設定，因此分類器僅使用其內建規則

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

autoMode.classifyAllShell

• 範圍：User or managed。讀取位置與 autoMode 相同。
• 類型：布林值
  • true：在自動模式啟用時，Claude Code 會將每個 Bash 和 PowerShell 命令傳送到分類器，並暫停您的 shell 允許規則；在自動模式外，規則仍然適用
  • false：自動模式只會暫停可能執行任意程式碼的允許規則，例如 Bash(*) 和 Bash(python *)；與任何其他允許規則相符的命令會跳過分類器，除非它帶有每個命令允許的網域，每個其他 shell 命令都會通過它
• 預設值：false

{
  "autoMode": {
    "classifyAllShell": true
  }
}

disableAutoMode

• 範圍：Any file。最適合在受管設定中使用，使用者無法覆寫它。也接受在 permissions 下作為 permissions.disableAutoMode。
• 類型：字串 "disable"
• 預設值：未設定

{
  "disableAutoMode": "disable"
}

permissions

• 範圍：Any file
• 類型：物件，包含 allow、ask、deny、additionalDirectories、blockReadsOutsideWorkingDirectories、blockWritesOutsideWorkingDirectories、defaultMode、denyInsteadOfPrompting、disableBypassPermissionsMode 和 disableAutoMode
• 預設值：未設定

{
  "permissions": {
    "allow": ["Bash(npm run *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"],
    "defaultMode": "acceptEdits"
  }
}

useAutoModeDuringPlan

• 範圍：User, local, or managed。儲存庫無法為您關閉它。
  • 這些檔案中任一個或 --settings 中的 false 都會將其關閉，除非您使用 --setting-sources 等選項排除該使用者或本機檔案。忽略被排除的檔案需要 Claude Code v2.1.314 或更新版本
• 類型：布林值
  • true：與未設定相同；當自動模式可用時，分類器會在規劃期間檢查 shell 命令
  • false：您會針對內建唯讀集之外的每個命令獲得權限提示
• 預設值：true

{
  "useAutoModeDuringPlan": false
}

permissions.allow

• 範圍：Any file
• 類型：權限規則字串陣列
• 預設值：未設定
• 每個工作階段的覆寫：--allowedTools 為一個工作階段新增允許規則，任何設定檔中的拒絕規則仍然會封鎖它命名的工具

{
  "permissions": {
    "allow": ["Bash(git diff *)", "Read(~/.zshrc)"]
  }
}

權限規則語法

permissions.ask

• 範圍：Any file
• 類型：權限規則字串陣列
• 預設值：未設定

{
  "permissions": {
    "ask": ["Bash(git push *)"]
  }
}

permissions.deny

• 範圍：Any file
• 類型：權限規則字串陣列
• 預設值：未設定
• 每個工作階段的覆寫：--disallowedTools 在此設定鍵之外為一個工作階段新增拒絕規則

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

permissions.additionalDirectories

• 範圍：Any file，專案和本機項目所給予的沙箱寫入存取權有其限制
• 類型：目錄路徑陣列
• 預設值：未設定
• 每個工作階段的覆寫：--add-dir 和 /add-dir 在此設定鍵之外為一個工作階段新增目錄

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

permissions.blockReadsOutsideWorkingDirectories

• 沒有任何模式自動核准的操作涵蓋讀取此類路徑的 shell 命令何時提示您
• 區塊下的沙箱化命令涵蓋沙箱化命令可以讀取的內容

• 範圍：Any file。如果任何檔案設定 true，則區塊適用，因此儲存庫可以為自己開啟區塊，但無法解除您設定的區塊。
• 類型：布林值
  • true：Claude 的檔案工具拒絕讀取工作目錄之外的路徑
  • false：與未設定相同；另一個檔案中的 true 仍然會套用區塊
• 預設值：未設定，因此工作目錄外的讀取遵循您的權限模式

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

區塊下的沙箱化命令

• 檔案系統隔離透過 sandbox.filesystem.disabled 關閉
• allowManagedReadPathsOnly 已設定
• 您啟動 Claude Code 的目錄路徑包含 glob 字元，例如 *、? 或 [

• ~/.gitconfig
• $XDG_CONFIG_HOME/git 下的 config、ignore 和 attributes 檔案，預設為 ~/.config/git
• 您的全域 git 設定透過 [include]、[includeIf]、core.excludesFile 或 core.attributesFile 命名的檔案

permissions.blockWritesOutsideWorkingDirectories

• 範圍：Any file。只要工作階段載入的任何檔案設定 true，封鎖就會適用，因此儲存庫可以為自己開啟封鎖，但無法解除您設定的封鎖。在雲端工作階段中，Claude Code 可能不會套用此設定鍵，因為檔案工具在本身即為邊界的容器中執行。
• 類型：布林值
  • true：開啟封鎖
  • false：與未設定相同；另一個檔案中的 true 仍然會套用封鎖
• 預設值：未設定，因此工作目錄外的寫入遵循您的權限模式。當 Claude Code 無法讀取您受管設定中的 permissions 物件時，封鎖也會開啟。

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

寫入封鎖拒絕的內容以及保持可寫入的內容

• Claude Code 設定檔：即使在工作目錄內，Claude Code 也會拒絕這些寫入，因為設定檔可以解除封鎖。請自行編輯設定檔。
• 僅由儲存庫設定新增的目錄：僅在 .claude/settings.json 中，或在 .claude/settings.local.json 中（除非 git 報告該檔案為未追蹤）由 additionalDirectories 列出的目錄
• subagent 的 worktree：當 isolation: worktree subagent 的 worktree 位於工作目錄之外時，其檔案編輯會被拒絕
• 儲存庫選擇之目錄中的自動記憶：儲存庫設定中 autoMemoryDirectory 所指定的目錄

讓單一目錄通過讀取或寫入封鎖

permissions.defaultMode

• 範圍：Any file。auto 和 bypassPermissions 不會從專案或本機設定生效，因此請改為在 ~/.claude/settings.json 中設定它們。在 v2.1.257 之前，bypassPermissions 會從任何檔案生效。對於 VS Code 擴充功能啟動的對話，Claude Code 只讀取使用者、受管和 --settings 值。
• 類型：字串，其中之一：
  • "default"：Claude Code 只在不詢問的情況下執行讀取
  • "acceptEdits"：Claude Code 也在不詢問的情況下執行檔案編輯和常見的檔案系統命令，例如 mkdir 和 mv
  • "plan"：Claude Code 讀取和計畫，但在您核准計畫之前封鎖編輯
  • "auto"：Claude Code 在沒有例行提示的情況下執行；在 shell 命令和網路請求等操作執行之前，背景分類器會檢查它們是否符合您的請求
  • "dontAsk"：Claude Code 自動拒絕每個原本會提示的呼叫，不過您安裝的 mod 仍可核准其中部分呼叫。工作目錄內的檔案讀取、不需要核准的其他操作以及預先核准的工具仍然執行，但從網路路徑的讀取除外
  • "bypassPermissions"：Claude Code 在不詢問的情況下執行所有操作
  • "manual"："default" 的別名
• 預設值：未設定
• 每個工作階段的覆寫：--permission-mode 及其 bypassPermissions 的等效項 --dangerously-skip-permissions 對一個工作階段優先於此設定鍵

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

permissions.denyInsteadOfPrompting

• 範圍：User or managed，以及 --settings。儲存庫無法為您設定它。
• 類型：布林值
  • true：Claude Code 拒絕原本會提示的呼叫
  • false：與未設定相同；如果這些來源中的另一個設定 true，呼叫仍會被拒絕
• 預設值：未設定，因此需要核准的呼叫會提示您

{
  "permissions": {
    "defaultMode": "auto",
    "denyInsteadOfPrompting": true
  }
}

denyInsteadOfPrompting 還會停止哪些項目

• 問題和計畫工具：Claude Code 會省略 AskUserQuestion、EnterPlanMode 和 ExitPlanMode，因此處於 plan mode 的工作階段無法自行離開。agent team 中的隊員會保留 EnterPlanMode 和 ExitPlanMode
• MCP elicitation：Claude Code 會取消 elicitation 請求，除非有 Elicitation hook 回應它
• 權限主機：Claude Code 不會詢問您的 canUseTool 回呼或 --permission-prompt-tool。若要從程式碼核准呼叫，請從 PermissionRequest hook 回應。有些呼叫會在詢問任何 hook 之前就被拒絕，例如 auto 模式中沒有任何 ask 規則涵蓋的關鍵路徑移除。
• 分類器計費通知：在關於計費分類器請求的通知會開啟對話框的情況下，Claude Code 不會顯示它，並拒絕需要這些請求的操作

來自 denyInsteadOfPrompting 的訊息

Permission for this tool use was denied. It requires approval, and this session has no approval surface

no approval surface in this session; permission request denied automatically

20 actions were refused and no work went ahead in between, so Claude stopped.

permissions.disableBypassPermissionsMode

• 範圍：Any file。通常在受管設定中設定以強制執行組織原則。
• 類型：字串 "disable"
• 預設值：未設定
• 每個工作階段的覆寫：此設定鍵優先於 --dangerously-skip-permissions，在設定此設定鍵時 Claude Code 會拒絕它

{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

skipAutoPermissionPrompt

• 範圍：User or managed。儲存庫無法為您設定它。
• 類型：布林值
  • true：Claude Code 跳過通知
  • false：與未設定相同；除非這些檔案中的另一個設定 true，否則通知會出現一次
• 預設值：未設定，因此通知會出現一次

{
  "skipAutoPermissionPrompt": true
}

skipDangerousModePermissionPrompt

• 範圍：User, local, or managed，以及以 --settings 傳入的檔案。背景工作階段只計入使用者和受管設定。不受信任的儲存庫無法為您跳過對話。
• 類型：布林值
  • true：Claude Code 在工作階段進入 bypassPermissions 模式前跳過確認對話
  • false：與未設定相同；除非這些檔案中的另一個設定 true，否則對話會出現
• 預設值：未設定，因此對話會出現

{
  "skipDangerousModePermissionPrompt": true
}

沙箱設定

sandbox

• 範圍：Any file
• 類型：包含 enabled、failIfUnavailable、autoAllowBashIfSandboxed、excludedCommands、allowUnsandboxedCommands、enableWeakerNestedSandbox、enableWeakerNetworkIsolation、allowAppleEvents、allowNestedUserNamespaces、bwrapPath、socatPath、ignoreViolations 和 ripgrep，以及 filesystem、network 和 credentials 物件的物件
• 預設值：未設定，因此 Claude Code 會在沒有沙箱的情況下執行命令

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

sandbox.enabled

• 範圍：Any file，但對專案和本機設定有所限制
• 類型：布林值
  • true：Claude Code 會將 Bash 命令沙箱化
  • false：Bash 命令在沙箱外執行
• 預設值：false

{
  "sandbox": {
    "enabled": true
  }
}

sandbox.failIfUnavailable

• 範圍：Any file，但對專案和本機設定有所限制
• 類型：Boolean
  • true：當 sandbox.enabled 為 true 但沙箱無法啟動時，Claude Code 會在啟動時以錯誤結束。若沙箱通過該檢查後初始化失敗，工作階段會繼續執行，而 Claude Code 會拒絕每個沙箱化命令
  • false：當沙箱無法啟動時，Claude Code 會在沙箱外執行命令
• 預設值：false

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}