配置作用域
Qoder CLI 的个人、项目、本地三种配置作用域,各自的文件与适合放的内容。
Qoder CLI 的配置分为三个作用域:个人、项目、本地,对应三个不同文件,理解各自适合放什么能让设置落到正确的位置:
| 作用域 | 文件 | 适合内容 | 是否随项目提交 |
|---|---|---|---|
| 个人 | ~/.qoder/settings.json | 跨所有项目的个人偏好:主题、界面、个人默认模型和推理强度、自动升级等用户级开关 | 否 |
| 项目 | <project>/.qoder/settings.json | 团队共享的项目约定:权限规则与目录信任策略、项目统一的模型选择或参数、项目级扩展配置(MCP、Hooks 等) | 是 |
| 本地 | <project>/.qoder/settings.local.json | 当前机器上的项目私有设置:本地服务地址、个人临时覆盖 | 否(建议加入 .gitignore) |
个人配置属于你自己,不通过项目仓库分发给团队;项目配置提交到版本控制后,团队成员在此项目里使用 Qoder CLI 时会自动应用同样的约定;本地配置只在你的机器上生效。用 /settings(别名 /config)查看或修改配置项。Hooks 的三个配置来源会被合并加载。