必须先安装node.js并配置path，再设置powershell执行策略为remotesigned，然后选择npm全局安装或原生脚本安装，最后新开终端验证codebuddy -v。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Windows系统上顺利安装CodeBuddy CLI工具，必须先确保Node.js环境已正确就绪且具备执行权限，否则npm命令会直接报错或静默失败，后续所有安装步骤都将无法推进。
检查并安装Node.js运行环境
打开Windows PowerShell（务必以管理员身份运行：右键“开始”按钮→选择“Windows PowerShell（管理员）”），输入以下命令：
node -v → npm -v
若提示“不是内部或外部命令”，说明Node.js未安装或PATH未生效。此时需前往nodejs.org/zh-cn下载LTS版本（如v20.11.x），安装时【必须勾选“Add to PATH”选项】，否则即使安装完成也无法在任意路径调用npm。
若版本低于v18.0.0（例如显示v16.20.2），则不满足CodeBuddy CLI最低要求，需卸载旧版后重装LTS新版。
解决PowerShell执行策略拦截
即使Node.js和npm已就位，Windows默认阻止远程脚本执行，导致后续安装命令被拒绝。
在管理员PowerShell中运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
系统会提示确认，输入 Y 并回车即可。这一步不可跳过，否则执行curl或irm方式安装时会卡在“无法加载文件”的报错上。
选择安装方式并执行
方法一：npm全局安装（需Node.js已就绪）
在管理员PowerShell中直接运行：
npm install -g @tencent-ai/codebuddy-code
等待命令行输出“+ @tencent-ai/codebuddy-code@x.x.x”即表示成功。安装过程约30–90秒，取决于网络稳定性。
方法二：原生脚本安装（推荐，无需依赖npm）
复制以下命令，在管理员PowerShell中粘贴并回车：
irm https://copilot.tencent.com/cli/install.ps1 | iex
该脚本会自动检测系统架构、下载对应二进制、配置环境变量，并提示“Installation completed successfully”。【此方式绕过npm，适合npm长期失效或权限受限的机器】
验证安装结果
关闭当前PowerShell窗口，重新打开一个新的管理员PowerShell（重要：必须新开窗口才能读取新写入的PATH）。
输入：
codebuddy -v
若返回类似 v1.4.2 的版本号，说明CLI已可调用；若提示“未识别的命令”，请检查是否漏掉新开终端，或确认install.ps1脚本是否真正写入了系统PATH（可运行 echo $env:Path 查看是否含 codebuddy 安装路径）。
