必须先启用Remote Development插件并配置SSH连接,否则无法编辑远程代码、运行终端或调试服务;需在设置中启用该插件,再通过快速连接串或SSH配置文件(含绝对路径私钥及正确权限)完成连接,且远程端须开启SSH服务、获取有效IP并确保网络互通。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要用CodeBuddy直接编辑远程服务器上的代码、运行终端命令、调试服务,必须先完成SSH连接配置——这一步没走通,后续所有远程文件浏览、调试、终端操作都会失败。
确认Remote Development插件已启用
打开CodeBuddy客户端 → 点击左下角齿轮图标 → 进入【设置】→ 搜索“remote” → 找到【Remote Development】插件 → 确保开关为开启状态。若显示“未安装”,点击“启用并重启”。【该插件是SSH远程能力的底层依赖,禁用后命令面板里根本不会出现任何Remote-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
HostName 192.168.3.28
User t41
Port 22
IdentityFile ~/.ssh/id_rsa
StrictHostKeyChecking no
UserKnownHostsFile /dev/null
③ 保存文件 → 再次调用“Connect to Host…”命令 → 列表中会出现ubuntu-dev选项 → 点击即可连接。
注意:【IdentityFile路径必须是绝对路径,且私钥权限在Linux/macOS上必须为600;Windows需确保OpenSSH能识别该私钥,否则连接会在认证环节静默卡住,无报错提示】
CodeBuddy VS Code插件
CodeBuddy VS Code插件下载入口,整理CodeBuddy腾讯云代码助手的官方插件地址、安装入口和基础功能说明。
下载
连接前必须完成的远程端准备
第一步:确保远程服务器已安装并运行SSH服务
Ubuntu/CentOS执行:sudo apt install openssh-server -y && sudo systemctl enable ssh && sudo systemctl start ssh(CentOS请用yum install -y openssh-server)
第二步:获取远程服务器真实IP地址
在远程终端执行:ip a | grep "inet " | grep -v "127.0.0.1" → 记下非lo接口的IPv4地址(如192.168.3.28)。若用VMware虚拟机,网络适配器必须设为桥接模式,否则主机无法ping通该IP。
第三步:测试基础连通性
在本地PowerShell或终端执行:ssh username@192.168.3.28 → 能成功登录并输入密码,说明网络和SSH服务已就绪;若超时或拒绝连接,请回头检查防火墙、SELinux(CentOS)、VMware网络模式。
