CodeBuddy在Linux上分CLI本地安装和企业私有化部署两种场景：前者需Node.js v18.20+及全局安装CLI工具，扫码登录后即可使用；后者要求Docker环境、离线包部署、私有模型导入及LDAP/SAML认证配置，全程离线运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 在 Linux 上的部署分两种主流场景：CLI 工具本地安装（面向运维/开发者日常使用） 和 企业级私有化服务部署（面向内网环境、需独立运行）。两者目标不同，操作路径也完全不同，不能混用。
Linux 上安装 CodeBuddy CLI（推荐大多数用户）
这是最常用、最轻量的方式，适合在任意 Linux 服务器或开发机上快速启用自然语言驱动的系统管理与脚本编写能力。
-
确保系统已安装 Node.js v18.20+
运行node -v检查版本。若不满足，建议用 NodeSource 安装 LTS 版本：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt install -y nodejs
-
全局安装 CLI 工具（四种包管理器任选其一）：
npm install -g @tencent-ai/codebuddy-code # 或 pnpm add -g @tencent-ai/codebuddy-code # 或 yarn global add @tencent-ai/codebuddy-code # 或 bun install -g @tencent-ai/codebuddy-code
-
首次运行并微信扫码登录（国内版）：
codebuddy
终端会弹出二维码，用微信扫描完成身份认证。
-
验证是否就绪：
codebuddy --version # 查看版本 codebuddy ask "列出当前内存使用率最高的5个进程" # 测试诊断能力
-
小技巧：
- 用
-p参数直接执行单条指令，适合写进 cron 或 shell 脚本； - 支持管道输入，例如
journalctl -n 100 | codebuddy -p "分析最近报错原因"； - 加
-y可跳过确认，实现全自动脚本调用。
- 用
Linux 内网私有化部署（企业级，全离线）
适用于金融、政务、央企等对数据不出网有强要求的场景，需自建服务实例，不依赖任何公网连接。
-
准备基础环境：
- 服务器：4核 CPU / 16GB 内存 / ≥50GB 系统盘 / ≥200GB 数据盘；
- 软件：Docker 24.0+、Docker Compose V2；
- 网络：禁用
systemd-resolved，配置内网 DNS（如10.10.10.10）。
获取离线安装包：
从腾讯云内部交付平台下载codebuddy-onprem-v2.8.3-offline.tar.gz，校验 SHA256 值为：a7f9e3d2c1b8a4f5e6d7c9b0a1f2e3d4c5b6a7f8e9d0c1b2a3f4e5d6c7b8a9f0-
解压并授权：
tar -xzf codebuddy-onprem-v2.8.3-offline.tar.gz -C /opt/codebuddy/onprem/ chmod +x /opt/codebuddy/onprem/bin/*.sh
导入私有模型：
将获授权的模型文件（如tc-code-enterprise-202604.qwen3-int4.gguf）放入/opt/codebuddy/models/，
并修改/opt/codebuddy/config/model_config.json中的model_path字段指向该路径。-
配置认证与网络：
- 编辑
/opt/codebuddy/config/auth_config.yaml，关闭微信和 GitHub 登录：enable_wechat_login: false enable_github_oauth: false
- 启用 LDAP 或 SAML 接入企业统一身份源；
- 所有服务强制走 TLS 1.3，前端入口地址设为
https://codebuddy.internal.corp:8443
- 编辑
-
启动服务：
cd /opt/codebuddy/onprem ./bin/start.sh
成功后可通过内网浏览器访问控制台，所有 AI 能力均在本地推理完成。
关键注意事项
- CLI 安装无需 root 权限，但建议避免用
sudo npm install -g，推荐改 npm 全局路径解决权限问题； - 私有化部署必须全程离线，禁止任何外网拉取行为，
setup-models.sh --offline --skip-download是必须步骤； - CLI 默认调用云端模型（国内版为 DeepSeek 等），私有化版则完全本地加载，响应延迟略高但数据零外泄；
- 日志、审计、模型缓存等路径均支持自定义，详见
/opt/codebuddy/config/下各配置文件注释。
不复杂但容易忽略细节。
