CodeBuddy命令行模式使用指南：终端操作与CLI工具配置详解

CodeBuddy CLI调用失败时，需系统排查环境配置与权限设置。本文详细解析从Node.js版本验证到安全策略启用的全流程解决方案。当CodeBuddy CLI工具安装后无法正常使用时，通常由环境变量异常、权限不足或配置文件错误导致。通过以下分步指南可快速定位并解决问题。一、验证并修复 Node.js 与 npm 环境Node.js运行环境是CodeBuddy CLI的基础依赖，若版本低于v18或npm路径未正确配置，将导致命令无法识别。1、终端执行node --version与npm --version，确保输出≥v18.0和≥v8.0。2、若提示命令不存在，需重新安装Node.js并选择添加PATH选项（Windows）或手动配置环境变量（如/usr/local/bin）。3、重启终端后重新验证命令可用性。二、全局安装 CodeBuddy CLI 包安装过程需要npm具备全局写入权限，否则会出现安装失败或命令不可用情况。1、运行安装命令：npm install -g @tencent-ai/codebuddy-code。2、PowerShell若提示脚本执行被禁用，需先执行：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned并确认。3、安装完成后通过codebuddy --version验证是否成功注册。三、完成用户级登录与模型授权首次使用需完成身份认证，否则无法调用AI模型处理指令。1、任意目录下输入：codebuddy login。2、按提示选择登录方式：国内用户微信扫码，国际用户GitHub/Google授权。3、凭证将自动保存至~/.codebuddy/auth.json，后续无需重复登录。四、配置本地 settings.json 文件该文件定义语言偏好和权限策略，缺失会导致使用默认宽松策略。1、创建配置目录：mkdir -p ~/.codebuddy。2、新建配置文件：touch ~/.codebuddy/settings.json。3、写入基础配置（如中文界面和DeepSeek模型）：{"language": "简体中文", "model": "deepseek-v3"}。4、保存后CLI下次启动自动加载配置。五、启用权限白名单与安全策略必须明确定义允许的操作范围，避免执行高危命令。1、编辑~/.codebuddy/settings.json，添加permissions字段。2、示例允许执行测试脚本："allow": ["bash(npm run lint)", "bash(npm run test:*)"]。3、禁止访问敏感文件："deny": ["read(./.env)", "read(./secrets/**)"]。4、保存后重启CLI或执行codebuddy config --reload生效。通过以上五个关键步骤的系统排查与配置，可确保CodeBuddy CLI在终端环境中稳定运行并实现安全管控。