codebuddy cli 无法调用需依次检查：一、确认 node.js ≥v18 且 npm ≥v8 并加入 path；二、全局安装 cli 并解决 powershell 执行策略问题；三、执行 codebuddy login 完成身份认证；四、创建 ~/.codebuddy/settings.json 配置语言与模型；五、在配置中设置 permissions 白名单与 deny 规则以启用安全策略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 CodeBuddy CLI 工具，但在终端中无法正常调用或执行命令，可能是由于环境配置未生效、权限限制或配置文件缺失所致。以下是实现终端命令行模式可用及完成基础配置的具体操作路径：
一、验证并修复 Node.js 与 npm 环境
CodeBuddy CLI 依赖 Node.js 运行时环境，若 Node.js 版本低于 v18 或 npm 未正确加入系统 PATH，则所有 codebuddy 命令均会报错或不可识别。
1、在终端中执行 node --version 与 npm --version，确认输出版本号分别 ≥ v18.0 与 ≥ v8.0。
2、若提示“command not found”，需重新安装 Node.js 并勾选“Add to PATH”选项（Windows 安装向导）或手动将 Node.js 安装路径（如 /usr/local/bin 或 C:\Program Files\nodejs\）加入系统环境变量。
3、重启终端后再次验证 node 与 npm 命令是否可执行。
二、全局安装 CodeBuddy CLI 包
安装过程需确保 npm 具备写入全局 bin 目录的权限，否则会出现 EACCES 错误或命令不可用。
1、执行安装命令：npm install -g @tencent-ai/codebuddy-code。
2、若在 Windows PowerShell 中报错 “cannot be loaded because running scripts is disabled”，则需先运行：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，并输入 Y 确认。
3、安装完成后，执行 codebuddy --version，成功返回版本号即表示 CLI 已注册至终端命令路径。
三、完成用户级登录与模型授权
CLI 首次运行需完成身份认证，否则所有自然语言指令均被拒绝，且无法加载默认 AI 模型。
1、在任意目录下输入：codebuddy login。
2、根据提示选择登录方式：国内用户扫码微信登录，国际用户选择 GitHub 或 Google 授权。
3、登录成功后，CLI 将自动保存凭证至 ~/.codebuddy/auth.json，后续命令无需重复登录。
四、配置本地 settings.json 文件
通过 settings.json 可定义语言偏好、权限策略、模型选择等关键行为，缺失该文件将导致 CLI 使用默认宽松策略，可能触发非预期的命令执行或模型降级。
1、创建用户级配置目录：mkdir -p ~/.codebuddy。
2、新建配置文件：touch ~/.codebuddy/settings.json。
3、写入最小必要配置（例如中文界面与 DeepSeek 模型）：
{"language": "简体中文", "model": "deepseek-v3"}。
4、保存后，CLI 将在下次启动时自动加载该配置。
五、启用权限白名单与安全策略
为防止 CLI 在无监督状态下执行高危命令（如 git push、curl 外网请求），必须显式声明允许的操作范围，否则部分功能将被拦截或静默拒绝。
1、编辑 ~/.codebuddy/settings.json，在 permissions 字段中添加白名单条目。
2、例如允许执行 lint 和 test 脚本："allow": ["bash(npm run lint)", "bash(npm run test:*)"]。
3、禁止读取敏感文件："deny": ["read(./.env)", "read(./secrets/**)"]。
4、保存配置后，重启 CLI 或执行 codebuddy config --reload 使策略即时生效。
