CodeBuddy采用三层配置机制：项目本地（.codebuddy/settings.local.json）→项目共享（.codebuddy/settings.json）→用户全局（~/.codebuddy/settings.json），按优先级生效，本地配置默认.gitignore，确保密钥隔离与团队协作安全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为不同项目分别设置语言、模型、权限和环境变量，又不想让A项目的密钥泄露到B项目里，也不能让团队共享配置被个人调试参数覆盖——CodeBuddy 的分层配置系统正是为此设计。
理解三层配置的生效逻辑
CodeBuddy 按优先级从高到低加载：项目本地配置（.codebuddy/settings.local.json）→ 项目共享配置（.codebuddy/settings.json）→ 用户全局配置（~/.codebuddy/settings.json）。【只有当前工作目录下存在.codebuddy目录且含settings.json时，项目级配置才会生效】
用户级配置写在你的家目录，影响所有项目；项目级配置放在项目根目录，可提交 Git；本地覆盖配置也放项目根目录，但默认被 Git 忽略——它专用于存 API Key、绝对路径、临时开关等敏感或个性化内容。
为项目创建专属配置目录与文件
第一步：打开终端，cd 进入你要配置的项目根目录，比如 cd ~/projects/my-vue-app。
第二步：执行 mkdir -p .codebuddy 创建隐藏配置目录。这一步不能跳过，否则 CodeBuddy 不会扫描该项目级配置。
第三步：用编辑器新建 .codebuddy/settings.json，填入团队共用项，例如：{"language": "简体中文", "model": "gpt-5", "permissions": {"allow": ["Bash(npm run build)"]}}。
第四步：再新建 .codebuddy/settings.local.json，只写你个人需要覆盖的内容，比如：{"env": {"API_BASE_URL": "http://localhost:3001"}, "debug": true}。注意：这个文件不会被 Git 跟踪，也不该提交。
切换工作目录以激活对应配置
方法一：在 CodeBuddy 输入框中直接输入命令 → /folder /path/to/your/project，回车后右上角会立刻显示新路径，同时自动加载该目录下的 .codebuddy 配置。
方法二：在项目资源管理器中右键点击项目文件夹 → 选择“在 CodeBuddy 中打开为工作区”，界面将刷新并加载该路径配置。
验证是否生效：输入 /config show，输出中会明确标注当前生效配置的来源路径，比如 Loaded from: /path/to/your/project/.codebuddy/settings.json。如果显示的是 ~/.codebuddy/settings.json，说明当前目录下缺少 .codebuddy 或 settings.json 文件。
