CodeBuddy安装需分CLI、IDE、VS Code插件三路径：CLI依赖Node.js（v18.20+/v20.x）并避开权限坑；IDE推荐非C盘安装且勾选添加buddycn命令；插件版须用实名认证的腾讯云绑定微信扫码登录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想装CodeBuddy却卡在第一步？npm报错、命令找不到、微信扫不出码、安装后没buddy命令——这些不是你手残，而是没避开真实环境里的坑。本文只讲实操中验证有效的路径，每一步都对应2026年最新版（v1.8.3+）的安装行为，不绕弯、不假设、不跳步。
确认Node.js环境是否真正可用
CodeBuddy CLI必须依赖Node.js，但“装了≠能用”。很多失败根源就在这里。
以管理员身份打开Windows PowerShell（macOS/Linux用Terminal），执行：
node --version → 必须输出 v18.20.0 或 v20.x.x；
npm --version → 必须输出 9.0.0 或更高。
如果提示“命令未识别”，说明PATH没生效——Windows用户重装Node.js时必须勾选「Add to PATH」选项，macOS用户若用Homebrew安装则需运行brew doctor检查；Linux用户常见问题是用nvm管理多版本，需确保当前shell激活的是LTS版本（nvm use --lts）。
若版本过低（如v16.x或更低），直接卸载旧版，从https://nodejs.org/zh-cn下载LTS安装包重装，别试图用npm update -g npm硬升。
安装CodeBuddy CLI（命令行版）
这是DevOps、远程开发和脚本集成的核心形态，也是最容易因权限翻车的一环。
方法一：标准npm全局安装（适合已有稳定npm配置的用户）
npm install -g @tencent-ai/codebuddy-code
方法二：规避EACCES权限错误（新手强烈推荐）
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @tencent-ai/codebuddy-code
注意：Windows用户不要用PowerShell直接运行sudo npm install——这会破坏npm内部权限模型，后续所有全局包都可能失效。
安装完成后立即验证：
codebuddy --version → 应输出类似1.8.3的版本号
which codebuddy（macOS/Linux）或where codebuddy（Windows）→ 必须返回可执行文件路径
安装CodeBuddy IDE（独立桌面应用）
适合不想折腾环境、需要开箱即用的全栈开发者或初学者，自带Node.js运行时，无需额外配置。
第一步：访问官网codebuddy.ai，点击右上角「下载」→ 选择「CodeBuddy IDE」→ 下载对应系统安装包（Windows为.exe，macOS为.dmg）。
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 问题
第二步：Windows用户双击安装包→ 勾选「我同意此协议」→ 在安装路径页手动修改为D:\CodeBuddy或非C盘路径（C盘剩余空间＜20GB时IDE启动会卡死）。
第三步：macOS用户下载.dmg后，右键安装包→「显示简介」→ 点击「通用」→ 若提示“无法验证开发者”，先点「仍要打开」→ 拖拽图标到Applications文件夹→ 完成后在Launchpad或Applications中启动。
第四步：首次启动时，务必勾选「Install the ‘buddycn’ command」——这会把CLI命令软链进系统PATH，后续终端里就能直接用buddycn指令，不勾选则只能用GUI界面。
安装VS Code插件版
这是日常编码者最常用的方式，轻量、无缝嵌入现有工作流，但登录环节极易失败。
① 打开VS Code，按Ctrl+Shift+X（Windows）或Cmd+Shift+X（macOS）打开扩展商店。
② 搜索「腾讯云代码助手 CodeBuddy」，认准发布者为 Tencent Cloud，安装按钮旁显示「已安装」即成功。
③ 安装完成后，点击左侧活动栏腾讯云图标 → 弹出二维码窗口 → 用微信扫描，且必须使用已实名认证的腾讯云账号绑定的微信（仅绑手机号的微信无法通过校验）。
若扫码后提示“登录失败”或“账号未授权”，退出VS Code，打开浏览器访问console.cloud.tencent.com，完成实名认证并开通CodeBuddy服务后再试。
插件安装完毕后，任意打开一个代码文件（如index.js），按Ctrl+Enter（Windows）或Cmd+Enter（macOS）即可唤出AI输入框，无需额外配置。
验证buddy命令是否真可用
很多用户以为装完就万事大吉，结果在终端敲buddycn报“command not found”——其实只是PATH没刷新或软链失效。
Windows用户：关闭所有CMD/PowerShell窗口，重新以管理员身份打开PowerShell，运行buddycn --help。
macOS用户：打开新终端窗口，执行echo $PATH，确认输出中包含~/.npm-global/bin（方法二安装）或/usr/local/bin（方法一安装）；若无，运行source ~/.zshrc（或~/.bash_profile）再试。
Linux用户：检查~/.profile或~/.bashrc是否写入了PATH，执行source ~/.profile后运行buddycn version。
只要buddycn --help能列出完整参数列表，说明CLI已真正就位，可进入项目实战。
