CodeBuddy远程SSH连接失败需按顺序排查：先确认Remote Development插件已启用并重启，再通过终端执行ssh -T验证基础连通性，接着检查SSH配置文件语法与路径（含绝对路径、空格分隔、旧系统兼容配置），最后禁用动态端口转发、卸载冲突的VS Code Remote-SSH插件并清除RemoteSSH缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
接口调试时远程SSH连不上，无法查看服务日志、检查端口占用或执行curl测试，整个调试流程卡在第一步。这不是代码问题，而是连接链路中断导致的阻塞。
确认本地CodeBuddy已启用远程能力
打开CodeBuddy客户端 → 点击左下角齿轮图标 → 进入【设置】→ 搜索“remote” → 确保【Remote Development】插件已启用。若显示“启用并重启”，必须点击后等待完整重启，【未重启则命令面板中不会出现Remote-SSH相关选项】。
这一步跳过会导致后续所有操作无效——按Ctrl+Shift+P也搜不到“Connect to Host”，界面里根本看不到远程入口。
验证基础SSH连通性（绕过CodeBuddy）
在终端或PowerShell中直接运行：
ssh -T -p 22 username@192.168.3.28
观察返回信息：
- 返回
Permission denied (publickey)：说明密钥认证失败，需检查私钥路径和权限； - 返回
Connection refused：远程sshd未启动，或监听地址绑定为127.0.0.1而非0.0.0.0； - 超时无响应：本地与目标IP之间存在网络断点，可能是VMware桥接未生效、云服务器安全组未放行22端口、或中间防火墙拦截。
只有这一步成功，CodeBuddy才可能连上。VS Code和CodeBuddy共用同一套系统SSH客户端，终端能通，IDE大概率也能通；终端不通，先别折腾CodeBuddy配置。
修复SSH配置文件语法与路径
方法一：用命令校验配置有效性
执行：ssh -F ~/.ssh/config -O check DBGer-VMCentos（将DBGer-VMCentos替换为你自己的Host别名）。若报错Bad configuration option或Unexpected argument，说明.ssh/config存在格式问题。
方法二：人工检查三处硬伤
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 问题
打开~/.ssh/config（Windows为C:UsersXXX.sshconfig），逐行核对：
① 所有关键字（如HostName、IdentityFile）后必须跟空格，不能是Tab；
② IdentityFile路径必须为绝对路径，【Windows用户务必写成C:\Users\Administrator\.ssh\id_rsa或正斜杠C:/Users/Administrator/.ssh/id_rsa，反斜杠单写会解析失败】；
③ CentOS 7等旧系统需显式兼容RSA密钥：PubkeyAcceptedKeyTypes +ssh-rsa和HostKeyAlgorithms +ssh-rsa两行不可少，缺一则免密登录失效。
排查CodeBuddy专属干扰项
第一步：禁用动态端口转发
打开CodeBuddy设置 → 搜索codebuddy.remote.SSH.enableDynamicForwarding → 将其设为false → 重启CodeBuddy。
第二步：卸载VS Code官方Remote-SSH插件
CodeBuddy内置Remote-SSH能力，若同时安装了VS Code原版插件，两者会冲突。进入扩展面板 → 搜索Remote - SSH → 卸载所有非CodeBuddy官方签名的版本。
第三步：清除CodeBuddy远程缓存
关闭CodeBuddy → 删除目录：~/.code-buddy/data/RemoteSSH（macOS/Linux）或%USERPROFILE%.code-buddydataRemoteSSH（Windows）→ 重开IDE。
