CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手,支持自然语言驱动开发。 - 必备触发词:CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景:安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
codebuddy支持免服务端ssh远程开发,需启用remote development插件,配置ssh连接(直接输入或config文件),并确保vmware桥接网络、ubuntu开启ssh及推荐配置免密登录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

CodeBuddy 支持远程开发,可通过 SSH 协议直连 Linux/macOS 服务器、VMware 或 VirtualBox 中的虚拟机、云主机(如阿里云 ECS、腾讯云 CVM),无需在远程端部署额外服务端程序,连接成功后即可编辑文件、运行终端、调试代码。
确认本地 CodeBuddy 已启用远程能力
打开 CodeBuddy 客户端 → 点击左下角齿轮图标 → 进入【设置】→ 搜索“remote” → 确保 【Remote Development】插件已启用。若未安装,点击“启用并重启”;该插件为 SSH 远程开发的底层依赖,禁用后所有远程连接选项将不可见。
这一步必须完成,否则后续任何 SSH 配置都不会出现在命令面板中。
配置 SSH 主机连接(两种方式任选)
方法一:快速输入连接串(适合临时连接或单次调试)
按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)→ 输入“Remote-SSH: Connect to Host…” → 回车 → 在弹出框中直接输入:ssh username@192.168.3.28 -p 22
→ 按回车,按提示输入密码即可建立会话。
方法二:使用 SSH 配置文件(推荐用于长期项目、多环境切换)
按 Ctrl+Shift+P → 输入“Remote-SSH: Open SSH Configuration File…” → 选择用户级配置文件(路径通常为 C:\Users\XXX\.ssh\config 或 ~/.ssh/config)→ 在文件末尾新增如下区块:
Host ubuntu-dev<br> HostName 192.168.3.28<br> User t41<br> Port 22<br> IdentityFile ~/.ssh/id_rsa<br> StrictHostKeyChecking no<br> UserKnownHostsFile /dev/null
保存后,再次调用“Connect to Host…”命令,列表中会出现 ubuntu-dev 选项,点击即可连接。注意:IdentityFile 路径必须是绝对路径且私钥权限为 600(Linux/macOS)或由 Windows OpenSSH 正确识别(Windows),否则连接会卡在认证环节无报错提示。
连接 Ubuntu 虚拟机前的关键准备
第一步:确保 VMware 网络互通
在 VMware Workstation 中,右键虚拟机 → 设置 → 网络适配器 → 选择【桥接模式】→ 勾选“复制物理网络连接状态”。启动 Ubuntu 后,在终端执行 ip a | grep "inet " | grep -v "127.0.0.1",记下非 lo 接口的 IPv4 地址(如 192.168.3.28)。在 Windows 主机上用 PowerShell 执行 ping 192.168.3.28,能通才可进入下一步。
第二步:在 Ubuntu 中启用并加固 SSH 服务
执行以下命令(逐行粘贴):
sudo apt update && sudo apt install openssh-server -y<br> sudo systemctl enable --now ssh<br> sudo ufw allow OpenSSH 2>/dev/null || true
第三步:验证免密登录可行性(非必需但强烈建议)
在 Windows 上用 PowerShell 生成密钥对:ssh-keygen -t rsa -b 4096 -f "$HOME/.ssh/id_rsa" -N "";再执行:type $HOME\.ssh\id_rsa.pub | ssh t41@192.168.3.28 "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"
完成后,在 PowerShell 中执行 ssh t41@192.168.3.28,若无需输密码即登录成功,说明密钥已就位,CodeBuddy 后续连接也将跳过密码输入。
连接远程服务器后打开项目目录
连接成功后,CodeBuddy 会自动加载远程文件系统视图。
点击资源管理器顶部的“打开文件夹”图标 → 在弹出窗口中浏览远程路径,定位到你的项目根目录(例如 /home/t41/project-web)→ 点击“确定”。
此时左侧文件树显示的是远程服务器上的实时文件,所有编辑、保存、Git 操作均直接作用于远程磁盘。注意:不要勾选“在新窗口中打开”,否则会启动一个空的本地工作区,导致你误以为文件已同步到本地。
首次打开大型项目时,CodeBuddy 可能需数秒扫描文件结构并加载语言服务器,耐心等待右下角状态栏不再显示“Loading…”即可开始编码。










