设置

settings.json 是配置 CodeBuddy Code 的官方机制，分层设置：用户设置 ~/.codebuddy/settings.json（所有项目）；共享项目设置 .codebuddy/settings.json（检入源代码管理与团队共享）；还有本地项目设置 settings.local.json。按优先级应用，共享项目设置高于用户设置（官方优先级列表给出完整顺序）。常用设置项：model（覆盖默认模型）、outputStyle（输出风格）、agent（覆盖主线程使用的 agent，应用其系统提示、工具限制与模型）、permissions（allow/ask/deny 规则与 defaultMode）。注意直接编辑 settings.json 后已开启的会话不一定生效，需重启进程或 /clear 新建会话。/config 可交互地查看或修改本地配置（list、get <key>、set <key> <value>）。

Auto Mode：autoMode 是顶层 settings 字段（不是 permissions 的子字段），定义 auto 权限模式分类器使用的规则；它只从用户 settings 等「受信」来源读取，共享项目配置 .codebuddy/settings.json 既不能提供 autoMode，也不能授予 defaultMode: "auto"，因为它属于本地安全边界，仓库里提交的配置不应悄悄改写。分类器默认使用 lite 变体解析出的模型；规则按来源顺序合并，特殊占位符 "$defaults" 表示把内置默认规则插到该位置。记忆与 Bash 沙箱也在这里配置（沙箱把 bash 命令与文件系统和网络隔离，默认会保护 CodeBuddy 自身的配置文件）。排除敏感文件：在权限的 deny 规则里列出 .env、密钥等路径，防止被读取。