Qoder Agent 连接云服务器有四种路径：一、CLI 反向 HTTP 接入；二、SSH 直连挂载工作区；三、VS Code Server 中转桥接；四、cpolar 内网穿透。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在本地 IDE 中成功启用 Qoder Agent 模式，但无法将任务调度至云服务器执行代码生成或部署操作，则可能是由于 Agent 与远程环境之间缺乏有效通信通道、身份绑定未同步或 CLI 远程服务未就绪所致。以下是实现 Qoder Agent 模式连接云服务器的多种可行路径：
一、通过 Qoder CLI 守护进程反向接入云服务器
该方法使云服务器主动暴露一个 HTTP 接口供 Agent 调度，适用于无公网 IP 或防火墙受限的 ECS 实例，且无需在服务器开放 SSH 端口即可完成双向控制。
1、在云服务器终端中进入目标项目目录，执行：qoderclicn remote-control
2、等待输出包含二维码与访问 URL 的提示信息，确保该进程持续运行（不可按 Ctrl+C 中断）。
3、在本地 JetBrains IDE 中打开 Qoder 面板，切换至 Quest 视图，点击右上角设置图标，选择「Remote Target」→「HTTP Endpoint」。
4、粘贴步骤 2 中显示的 URL，点击确认；Qoder 将自动检测远程 CLI 状态并建立长连接。
5、提交任意 Agent 任务（如“生成 Dockerfile 并构建镜像”），任务指令将被转发至云服务器执行，产物文件保留在远程磁盘。
二、使用内置 Remote SSH 组件直连云服务器并挂载 Agent 工作区
该方式复用标准 SSH 协议，在 Agent 模式下直接将远程文件系统作为工作区加载，所有代码生成、编辑与保存均实时同步至云服务器，适合已有完整开发环境的 ECS 实例。
1、确保云服务器已启用 SSH 服务，且 22 端口已放行至安全组，同时配置好密钥登录或密码认证。
2、在本地 Qoder IDE 中，点击左侧 Remote Explorer 图标，点击右上角加号（+），选择 SSH Target。
3、输入连接字符串：ssh ubuntu@your_server_public_ip（请替换为实际用户名与公网 IP）。
4、首次连接时接受主机指纹，随后选择私钥文件或输入密码完成认证。
5、连接成功后，右键远程根目录 →「Open Folder in Quest Mode」，此时 Agent 所有操作均基于远程路径执行，本地不缓存源码。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、借助 VS Code Server 中转桥接 Qoder Agent 会话
当云服务器未预装 Qoder CLI 或受限于 Node.js 版本无法运行 CLI 时，可利用 VS Code Server 作为协议转换中间件，使 Qoder Agent 复用其已建立的 SSH 通道与远程进程管理能力。
1、在本地电脑使用 VS Code 连接同一台云服务器，触发自动安装 ~/.vscode-server/ 目录下的服务组件。
2、保持该连接活跃（不关闭终端或断开 SSH），确保 VS Code Server 进程正在监听本地回环端口（默认 0.0.0.0:3000+）。
3、在 Qoder IDE 中切换至 Quest 视图，点击「Settings」→「Remote Backend」→「VS Code Server Proxy」。
4、填写服务器地址：http://your_server_public_ip:3000，并输入 VS Code Server 的唯一标识 token（可在本地 VS Code 的 Remote-SSH 输出日志中查找）。
5、保存配置后，Agent 提交的任务将通过 VS Code Server 的 exec API 在远程执行，文件操作路径与 VS Code Server 加载的工作区一致。
四、通过 cpolar 创建 TCP 隧道穿透内网云服务器
该方案适用于部署在阿里云 VPC 内网、无弹性公网 IP 的 ECS 实例，通过 cpolar 将本地 CLI 的 HTTP 服务映射为公网可访问的临时域名，供 Qoder Agent 主动调用。
1、在云服务器上安装 cpolar：执行 curl -L https://cdn.cpolar.com/static/downloads/install.sh | sudo bash。
2、启动隧道并绑定 CLI 端口：运行 cpolar tcp 3001（假设 qoderclicn remote-control 正在监听 3001 端口）。
3、从 cpolar 控制台获取生成的公网 TCP 地址（如 tcp://xxxx.cpolar.io:12345）。
4、在本地 Qoder IDE 的 Quest 设置中，选择「Custom TCP Endpoint」，填入该地址（不含 tcp:// 前缀，仅填域名与端口）。
5、点击测试连接，状态变为绿色在线后，即可向该内网服务器下发 Agent 任务，所有执行日志与产物均落于云服务器本地。
