在Linux服务器上部署CodeBuddy CLI，核心价值就是让运维和开发人员能在无图形界面的生产环境里，直接用自然语言执行系统诊断、生成脚本、调用服务——说白了，再也不用反复切换窗口、翻文档、手敲命令了。你只需要一台SSH能连上的服务器，就能立刻开干。

不过，动手之前，先确认三件事：Linux系统、bash或zsh shell、以及curl工具。推荐直接用一行命令搞定无root权限的原生二进制安装：curl -fsSL https://www.codebuddy.cn/cli/install.sh | bash，装完后配置好PATH，扫码登录就能用。下面一步步说清楚。

确认系统基础环境

先检查最低运行条件：uname -s 输出是不是Linux；echo $SHELL 看看当前shell类型（bash或zsh都支持）；curl --version 确认curl在不在——这个原生安装脚本的唯一依赖就是curl。

要是curl没装，分系统处理：Ubuntu/Debian跑 sudo apt update && sudo apt install -y curl；CentOS/RHEL跑 sudo yum install -y curl 或者 sudo dnf install -y curl。

【注意】千万别跳过这步。有些精简版镜像（比如Alpine或最小化CentOS）默认不带curl，不装的话后续脚本根本下不来。

选择安装方式并执行

首选方案是原生二进制安装——不依赖Node.js，体积小、启动快、权限收敛，尤其适合部署在受限权限的运维服务器上。

方法一：原生二进制安装（推荐）
在终端里一次性粘贴并执行：
curl -fsSL https://www.codebuddy.cn/cli/install.sh | bash

这个脚本会自动完成：下载最新release的静态二进制文件 → 解压到 $HOME/.local/bin → 设置可执行权限 → 检查PATH里是否有该路径。整个过程不需要root权限，所有文件只写进用户家目录。

方法二：npm全局安装（仅限服务器已装Node.js 18.20+的情况）
运行：npm install -g @tencent-ai/codebuddy-code
如果提示 EACCES 权限错误，说明npm全局目录不可写。这时候别加sudo，改用下面三步修复：
① 创建私有全局目录：mkdir -p ~/.npm-global
② 配置npm使用该目录：npm config set prefix ~/.npm-global
③ 把bin路径加入shell配置：echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc && source ~/.bashrc

验证安装并初始化身份

执行 codebuddy --version，如果看到类似 v1.12.3 的输出，说明二进制已经正确安装并能调用了。

要是提示 command not found，那就是PATH没生效。先检查 echo $PATH 是否包含 $HOME/.local/bin；如果没有，临时修复用 export PATH="$HOME/.local/bin:$PATH"，再永久写入：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。

最后，运行 codebuddy（不带任何参数），首次会自动打开浏览器扫码登录。服务器没有图形界面也没关系——它会在终端打印一个二维码URL和6位数字验证码，用手机微信扫描或者手动输入就能完成绑定。登录成功以后，终端就会直接进入交互式对话模式，等着你用自然语言下指令了。