codebuddy 通过用户级、项目级（.codebuddy/settings.json）、本地级（.codebuddy/settings.local.json）三层配置实现多项目隔离；需在项目根目录创建 .codebuddy 目录并配置文件，通过 /folder 命令或右键打开切换工作目录以自动加载对应配置，执行 /config show 验证生效项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 CodeBuddy 中需要同时处理多个项目，但发现语言设置、权限策略或环境变量相互覆盖，则很可能是未区分配置层级导致的冲突。CodeBuddy 采用分层配置系统，支持用户级、项目级与工作区级三类独立配置，确保各项目互不干扰。以下是具体管理与切换方法：
一、理解 CodeBuddy 的三层配置结构
CodeBuddy 的配置按作用范围分为三个层级，优先级从高到低依次为：项目设置 > 用户设置。其中项目设置又细分为可共享的 .codebuddy/settings.json 与仅本地生效的 .codebuddy/settings.local.json。该机制允许团队统一基础规则，同时保留个人调试偏好。
1、用户设置存于 ~/.codebuddy/settings.json，影响所有打开的项目；
2、项目设置位于项目根目录下的 .codebuddy/settings.json，可提交至 Git，供团队共用；
3、本地覆盖设置存于同目录的 .codebuddy/settings.local.json，默认被 Git 忽略，用于存放密钥、绝对路径等敏感项。
二、为不同项目创建独立项目配置
每个项目应拥有专属的 .codebuddy 目录及内部配置文件，以实现行为隔离。操作前需确保目标项目根目录已初始化该结构。
1、在终端中进入项目根目录：cd /path/to/your/project；
2、创建配置目录：mkdir -p .codebuddy；
3、生成标准项目配置：touch .codebuddy/settings.json；
4、编辑该文件，填入项目特定项，例如："language": "English", "model": "gpt-5"；
5、如需添加本地覆盖项（如自定义终端路径），另建 .codebuddy/settings.local.json 并写入对应字段。
三、通过工作目录切换激活对应项目配置
CodeBuddy 依据当前工作目录自动加载其下的 .codebuddy 配置。切换工作目录即切换生效的配置集，无需重启应用或手动刷新。
1、在 CodeBuddy 输入框中输入命令：/folder /path/to/another/project；
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、执行后界面右上角将显示新路径，且自动读取该目录下 .codebuddy/settings.json 内容；
3、若该目录无配置文件，系统将回退至用户级设置；
4、输入 /folder 或 /cwd 可随时确认当前生效的配置来源路径。
四、使用资源管理器右键菜单快速跳转项目
当多个项目分散在不同磁盘位置时，图形化方式可避免记忆长路径。此方法直接启动新会话并绑定对应配置，避免残留状态干扰。
1、在 Windows 资源管理器或 macOS Finder 中定位目标项目文件夹；
2、右键点击该文件夹，在上下文菜单中选择：使用 CodeBuddy 打开；
3、CodeBuddy 启动后自动将该目录设为工作目录，并加载其 .codebuddy 子目录下的全部配置；
4、此前打开的标签页与终端会话不会被继承，确保配置纯净加载。
五、验证配置是否正确加载
配置切换后需确认实际生效项，尤其涉及权限、模型或环境变量等关键字段，防止因路径错误或文件缺失导致回退至全局设置。
1、在输入框中输入：/config show；
2、系统将输出当前生效的完整配置快照，包含来源文件路径标识；
3、检查输出中 "permissions"、"env" 等区块内容是否匹配预期项目设定；
4、若发现某字段仍为用户级值，说明该项目目录下缺少对应 .codebuddy/settings.json 或存在语法错误。
