在调试微服务接口时，最令人担忧的莫过于CodeBuddy这类AI助手“顺手”执行删库、修改配置、调用生产环境API等危险操作。为此，核心安全策略必须明确：您需要显式限制它能调用的工具范围，从源头杜绝风险。

具体如何实现？这里有三种主流权限控制方式，从简便到彻底，供您灵活选择。

CLI模式：通过--allowedTools参数精确限定可用工具

在终端运行codebuddy命令时，最直接的方法是附加--allowedTools白名单参数。例如：

codebuddy -p"分析这个HTTP错误日志" --allowedTools "Bash(curl:*,jq:*)"

这条指令的含义清晰：CodeBuddy只能调用curl和jq这两个命令，并且限定在当前目录及其子目录中操作。其他系统命令、文件编辑、Git操作等均被拦截在外，有效防范越权行为。

顺便提醒一句：【Bash(curl:*,jq:*)中的星号表示通配符，但不包含上级目录路径——这是安全边界，请勿误解】

IDE插件：通过权限模式动态管控操作范围

如果您使用VS Code或JetBrains插件，操作起来更加直观便捷。

方式一：将权限模式切换为“plan”

打开CodeBuddy侧边栏 → 点击右上角齿轮图标 → 选择“权限模式” → 切换为“plan”。该模式下，CodeBuddy仅会输出一份可执行的操作计划（例如“建议运行 curl -X GET http://localhost:8080/api/beacon/123”），待您确认后才真正执行。这相当于增加了二次确认环节，大幅降低误操作风险。

方式二：手动配置禁用列表

同样点击齿轮图标 → “高级设置” → 手动输入禁用列表：--disallowedTools Bash(rm:*),Edit,Python。此设置立即生效，下次触发补全或对话时，删除文件、编辑源码、运行Python脚本等能力全部灰显，无法触碰。

本地Hook脚本：硬编码工具白名单实现项目级管控

若您希望实现更彻底、更持久的项目级别控制，Hook脚本是最可靠的选择。

第一步：进入项目根目录，确认已存在.codebuddy/hook/目录。

第二步：创建.codebuddy/hook/restrict_tools.js文件，内容如下：

const ALLOWED_TOOLS = new Set(['curl', 'jq', 'grep']);

第三步：在.codebuddy/settings.json中添加钩子配置：

{"hooks": {"ToolExecutionRequest": ".codebuddy/hook/restrict_tools.js"}}

第四步：重启IDE或重新加载CodeBuddy插件。此后，CodeBuddy每次调用工具前都会先校验其名称是否在ALLOWED_TOOLS集合中；若不在，则直接拒绝并返回退出码2，干净利落。

通过这套组合策略，无论是调试接口还是处理日志，CodeBuddy都只能老老实实执行您允许的操作——这才是安全调试的正确打开方式。