应通过四种方式配置忽略文件和目录：一、在.settings.json中用deny规则禁止读取；二、用.codebuddyignore类gitignore语法排除索引；三、在settings.local.json中禁用特定语言补全；四、cli初始化时用--exclude参数跳过敏感目录扫描。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 进行代码补全或分析时，发现某些文件或目录被错误地纳入上下文、触发冗余补全或引发权限警告，则可能是由于这些路径未被明确排除。以下是配置忽略文件和目录的具体操作方法：
一、通过 .codebuddy/settings.json 配置 deny 权限规则
该方式可全局或项目级禁止 CodeBuddy 读取指定路径，从而避免其参与代码补全、AST 解析或上下文构建。deny 规则优先级高于其他设置，且直接阻断文件访问行为。
1、打开项目根目录下的 .codebuddy/settings.json 文件；若不存在，可手动创建。
2、在 "permissions" 字段中添加 "deny" 数组，填入需排除的路径模式。
3、使用通配符语法匹配目标文件或目录，例如："read(./.env)"、"read(./secrets/**)"、"read(./dist/**)"。
4、保存文件后，CodeBuddy 将立即停止对匹配路径的读取与补全支持。
二、在项目根目录添加 .codebuddyignore 文件
该机制与 Git 的 .gitignore 类似，专用于声明不参与 CodeBuddy 上下文索引的文件和目录。适用于希望保留文件可读性但排除其补全影响的场景。
1、在项目根目录新建纯文本文件，命名为 .codebuddyignore。
2、每行写入一个忽略路径，支持 glob 通配符，例如：node_modules/、dist/、*.log、**/test_*.py。
3、确保该文件未被其他 ignore 机制（如 .gitignore）误删或覆盖。
4、重启 CodeBuddy IDE 或执行 /reload 命令使规则生效。
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 问题
三、使用 .codebuddy/settings.local.json 禁用特定语言补全
当仅需排除某类文件的智能补全（而非完全禁止读取），可通过本地设置关闭对应语言服务的补全能力，减少干扰并提升响应速度。
1、在项目根目录创建 .codebuddy/settings.local.json 文件。
2、添加 "editor.suggest.enabled" 配置项，并按语言 ID 设置布尔值，例如："javascript": false、"json": true。
3、也可结合 "files.exclude" 字段，填写正则或 glob 模式，如："**/*.min.js": true。
4、该文件默认被 git 忽略，适合存放个人调试偏好。
四、通过 CLI 初始化时跳过敏感目录扫描
使用 codebuddy init 创建项目结构时，CLI 默认递归扫描全部子目录。可通过参数显式排除路径，防止初始上下文污染。
1、执行命令：codebuddy init --exclude node_modules --exclude dist --exclude .github。
2、多个 --exclude 参数可重复使用，每个后接一个相对路径或 glob 模式。
3、生成的 CODEBUDDY.md 与 .codebuddy/ 目录将不包含被排除路径的元数据。
4、后续所有基于该初始化结构的补全与分析均自动忽略对应目录。
