codebuddy cli可在linux服务器上通过ssh直接部署使用，支持自然语言诊断、脚本生成与服务调用；需先确认linux系统、bash/zsh shell及curl已安装，推荐执行curl -fssl https://www.codebuddy.cn/cli/install.sh | bash进行无root权限的原生二进制安装，并配置path后扫码登录启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Linux服务器上部署CodeBuddy CLI，目的是让运维和开发人员能在无图形界面的生产环境里直接用自然语言执行系统诊断、生成脚本、调用服务，避免反复切窗口查文档写命令。你不需要本地开发机，只要SSH连上服务器就能开始用。
确认系统基础环境
先检查是否满足最低运行条件：执行 uname -s 确认是 Linux；执行 echo $SHELL 看当前 shell 类型（bash/zsh 均支持）；执行 curl --version 确保已安装 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 位数字验证码，用手机微信扫描或手动输入即可完成绑定。登录成功后，终端将进入交互式对话模式。
