需配置ssh连接使qoderwake访问远程资源：①确认openssh≥8.9p1；②生成ed25519密钥对并设强密码；③用ssh-copy-id部署公钥至服务器；④cli或ide配置远程主机、用户及私钥路径；⑤替换git仓库为ssh url并启用远程认证；⑥重启agent后即可执行远程诊断指令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在本地电脑上操作QoderWake，同时让数字员工直接访问并处理远程服务器上的代码库、日志或数据库，但当前QoderWake始终在本地文件系统中运行，无法触达远端资源。这会导致每次修改都要手动同步、反复上传下载，严重拖慢迭代节奏。
配置SSH连接供QoderWake调用
QoderWake本身不内置SSH客户端，必须依赖系统级SSH能力，并通过CLI注入可信连接上下文，否则所有远程操作都会因认证失败而中断。
第一步：确认本地已安装OpenSSH且版本不低于8.9p1。在终端执行 ssh -V，若输出含“OpenSSH_8.9p1”或更高，则继续；若提示command not found，请先安装系统SSH套件。
第二步：生成专用密钥对，【务必使用-ed25519算法且设置强密码短语】。执行命令：ssh-keygen -t ed25519 -f ~/.ssh/qoderwake_id -C "qoderwake-remote@local"，过程中两次输入同一密码短语，不可为空。
第三步：将公钥复制到目标服务器。运行 ssh-copy-id -i ~/.ssh/qoderwake_id.pub -p 2222 user@192.168.10.55（请替换为实际IP与端口），若提示权限拒绝，检查服务器sshd_config中PubkeyAuthentication是否为yes。
第四步：测试连接是否免密可用。执行 ssh -i ~/.ssh/qoderwake_id -p 2222 user@192.168.10.55 -o ConnectTimeout=5，成功则显示shell提示符，失败则返回超时或permission denied。
在QoderWake中绑定远程执行环境
只有完成环境绑定，QoderWake的Agent才能在任务中自动调用远程路径、执行远程命令或拉取远端Git仓库。未绑定时，所有涉及“服务器”“部署”“日志分析”的指令都将降级为本地模拟，结果不可信。
方法一：通过CLI配置远程上下文
在终端中运行 qodercli config set remote-host "192.168.10.55"
接着执行 qodercli config set remote-user "user"
再运行 qodercli config set remote-ssh-key "~/.ssh/qoderwake_id"
最后验证：qodercli config get remote-host → 应返回192.168.10.55
方法二：在IDE界面中手动注入
打开Qoder IDE → 右上角头像 → Settings → Remote Execution → 点击“+ Add Host”
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
填写主机地址、用户名、SSH端口、私钥路径（需绝对路径，如 /Users/you/.ssh/qoderwake_id）
【私钥路径必须可被当前用户读取，且文件权限为600】，否则保存后触发校验失败警告
勾选“Enable for all Agents”，点击Save
启用远程Git仓库自动同步
当QoderWake需要基于远程代码库执行PR审查、漏洞扫描或依赖分析时，必须让其能直接克隆、fetch和checkout，而非依赖本地副本。
第一步：在Workspace管理页中，选中目标项目 → 点击「编辑配置」
第二步：找到Repository字段，将原本地路径（如 /Users/you/project）替换为SSH Git URL：git@192.168.10.55:/opt/repo/backend.git
第三步：勾选“Use remote SSH auth for Git operations”，此项启用后，所有git pull、git log等操作均走你刚配好的qoderwake_id密钥
第四步：点击「验证连接」按钮，QoderWake会尝试执行 git ls-remote，成功则显示最近3条commit hash，失败则弹出错误详情（常见为权限不足或路径不存在）
第五步：保存配置，重启当前Workspace Agent实例，使其加载新Git上下文
触发远程诊断任务
现在你可以用自然语言指令驱动QoderWake直接操作服务器。例如在聊天框输入：“检查192.168.10.55上backend服务的CPU占用和最近2小时error日志”，QoderWake将自动登录、执行top -b -n1 | grep backend 和 tail -20 /var/log/backend/error.log，并结构化返回结果。
输入指令后，观察右下角状态栏是否显示“Connecting to 192.168.10.55 via SSH…”
若卡在该状态超过15秒，立即打开终端执行 ssh -T -i ~/.ssh/qoderwake_id -p 2222 user@192.168.10.55 测试连通性
确认无误后，在QoderWake中重新提交相同指令
