要在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。

如果当前Node.js版本低于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的安装路径。