模型、回复与权限设置
model、availableModels、fallbackModel、effortLevel、提示缓存等模型与回复相关设置,以及 permissions.*、autoMode 等权限设置。
作用域缩写:任何文件 = 用户/项目/本地/托管任一处。键的取值、可用模型和版本要求以官方为准。
模型与回复
| 键 | 作用域 | 说明 |
|---|---|---|
model | 任何文件 | 改变 Claude Code 启动时使用的模型(别名或完整模型 ID);不设则用账号的默认模型 |
modelPicker | 用户或托管 | 选择 /model 选择器列出哪些模型,按你自己的顺序和标签;带 options 数组和可选的 replaceBuiltInOptions |
modelOverrides | 任何文件 | 把模型 ID 映射到服务商自己的 ID(如 Bedrock ARN),对象形式 |
availableModels | 任何文件 | 限制人们能选哪些模型(别名或 ID 数组);不设则全部可用 |
availableModelsMatch | 仅托管 | 让 availableModels 里每个模型 ID 条目只允许它点名的那个版本(默认 "prefix",另有精确匹配等取值) |
deniedModels | 仅托管 | 屏蔽特定模型,即使 availableModels 允许它们 |
enforceAvailableModels | 任何文件 | 让 /model 的 Default 选项留在你的 availableModels 允许列表之内(默认 false) |
fallbackModel | 任何文件 | 主模型过载时的备用模型数组("default" 展开为默认模型);不设则失败的请求不会换模型重试 |
switchModelsOnFlag | 任何文件 | 安全分类器标记请求时是自动切换模型还是暂停(默认 true,自动切换) |
effortLevel | 任何文件 | 为没有自己保存等级的模型设置默认努力等级 |
maxEffortLevel | 任何文件 | 给所有模型或按模型限制努力等级上限(low、medium、high、xhigh、max),在所有服务商上生效 |
modelSettings | 任何文件 | 按模型名保存努力等级,或限制某个模型的努力等级(对象,值含 effortLevel) |
alwaysThinkingEnabled | 任何文件 | 设为 false 对所有会话关闭扩展思考(思考默认开启,true 没有变化;对总是思考的模型如 Opus 5.5、Sonnet 5.5、Fable 无效;第三方服务商上是省略 thinking 参数而不是关闭思考) |
showThinkingSummaries | 任何文件 | 显示 Claude 思考的摘要而不是折叠的占位(默认 false) |
fastMode | 任何文件 | 在 fast mode 可用的会话里开启它(不设则关闭) |
fastModePerSessionOptIn | 任何文件 | 要求人们每个会话都重新开启 fast mode(默认 false) |
advisorModel | 任何文件 | 选择 Claude 询问 advisor 工具时由哪个模型回答(别名 "fable"、"opus"、"sonnet");不设则 advisor 关闭 |
ultracode | 任何文件 | 让 Claude 对每个实质性任务不待要求就规划一个工作流(不设则关闭) |
outputStyle | 任何文件 | 用输出样式(内置或自定义的名称)改变 Claude 的角色、语气和输出格式 |
language | 任何文件 | 让 Claude 用英语之外的语言回复(任何语言名,如 "japanese"、"spanish");不设时会话标题会跟随对话语言 |
promptCacheTtl | 任何文件 | 选择主对话的提示缓存生命周期(5m 或 1h);不设则每个请求取默认生命周期 |
subagentPromptCacheTtl | 任何文件 | 选择子智能体和主对话之外其他请求的提示缓存生命周期 |
modelPricing | 仅托管 | 按你组织合同价而不是标价报告花费;对象含可选的 multiplier 和 overrides 映射 |
权限
| 键 | 作用域 | 说明 |
|---|---|---|
permissions | 任何文件 | 设置 allow、ask、deny 规则和起始权限模式的对象;含 allow、ask、deny、additionalDirectories、blockReadsOutsideWorkingDirectories、defaultMode、disableBypassPermissionsMode |
permissions.allow | 任何文件 | 不经提示就批准所列的工具使用(权限规则字符串数组) |
permissions.ask | 任何文件 | 所列的工具使用之前总是提示 |
permissions.deny | 任何文件 | 阻止所列的工具使用,包括读取存放密钥的文件 |
permissions.additionalDirectories | 任何文件 | 让 Claude 能访问当前目录之外的目录(路径数组) |
permissions.defaultMode | 任何文件 | 设置新会话启动时的权限模式 |
permissions.blockReadsOutsideWorkingDirectories | 任何文件 | 让文件工具在所有权限模式下拒绝读取工作目录之外的内容(不设则读取遵循权限模式) |
permissions.disableBypassPermissionsMode | 任何文件 | 设为 "disable" 阻止任何人进入 bypassPermissions 模式 |
allowManagedPermissionRulesOnly | 仅托管 | 让托管设置成为权限规则的唯一设置来源(否则会应用用户、项目、本地设置和 --settings 里的规则) |
autoMode | 用户或托管 | 给 auto 模式分类器添加你自己的 allow 和 deny 规则:含 environment、allow、soft_deny、hard_deny 四个散文规则数组;不设则分类器只用内置规则 |
autoMode.classifyAllShell | 用户或托管 | 让每条 shell 命令都经过 auto 模式分类器,即使有窄 allow 规则匹配它(默认 false) |
disableAutoMode | 任何文件 | 设为 "disable" 把 auto 模式从权限模式循环里移除 |
useAutoModeDuringPlan | 用户、本地或托管 | 让 auto 模式分类器在计划模式下评审 shell 命令(默认 true;设 false 则改为提示) |
skipAutoPermissionPrompt | 用户或托管 | 跳过你自己进入 auto 模式(而非通过内置默认)时显示一次的提示 |
skipDangerousModePermissionPrompt | 用户、本地或托管 | 跳过进入 bypassPermissions 模式前的确认对话框 |