2026 年大家用 Claude Code、Codex、Gemini CLI 这类命令行 AI Agent 写代码已经非常普及,但很快就会碰到一个共同瓶颈:Agent 只能操作当前这一台机器。
真实工程环境里,代码跑在家里 Mac mini、测试机是办公室 Windows、推理服务在实验室 Linux/GPU 盒子里,甚至还有树莓派、Jetson 或插着串口线的硬件实验台。很多人尝试用官方的 claude remote-control——但它本质上是“用手机遥控本机那一个 Claude 会话”,并不是让 Agent 去跨网操作另一台独立电脑。
本文分享一种工程化的跨机 Agent 编排实践:通过内置标准 stdio MCP 服务(rds mcp),让本地 AI Agent 按 9 位设备 ID 安全操控其它电脑、ARM64 开发板甚至 ESP32-S3 物理硬件。
一、为什么推荐用「独立设备 ID + MCP」而不是暴露 SSH?
- 免公网 IP 与端口暴露:办公室电脑、家庭宽带、校园网大多在多层 NAT 后,给每台机器配公网端口或搭跳板机维护成本高且攻击面大。
- 不仅限于命令行:很多真实任务(检查 Windows 软件报错弹窗、填内部管理系统表单、看浏览器渲染)必须依赖 GUI 截图与键鼠操作,纯 SSH 做不到。
- 同屏可视、人工随时接管:AI 通过 MCP 在远端干活的同时,工程师可以在桌面客户端实时看着那台机器的屏幕,随时介入。
二、一行命令接入主流 AI 编程工具
在需要协同的两台机器装好 RockDesk(支持 Windows / macOS / Linux x86_64 & arm64,macOS 可用 brew tap rockdesk-io/tap && brew install --cask rockdesk)后,直接接入内置的 18 个原生 stdio MCP 工具:
# 1. Claude Code 一行添加 MCP
claude mcp add -s user rockdesk -- rds mcp
# 2. OpenAI Codex CLI 一行添加 MCP
codex mcp add rockdesk -- rds mcp
# 3. 也可以通过 Agent Skill 通用方式安装(Claude Code / Codex / Gemini CLI 均支持)
npx skills add rockdesk-io/rockdesk-skill
Gemini CLI 或 Cursor 用户只需在 ~/.gemini/settings.json / MCP 配置中加入:
{
"mcpServers": {
"rockdesk": {
"command": "rds",
"args": ["mcp"]
}
}
}
内置 MCP 暴露的 18 个工具覆盖了完整闭环:
- 终端与长任务:
shell(带真实退出码)、spawn(断线不中断的后台任务) - 文件与目录:
ls、copy(配合 CLI 的rds <ID> mount可做 1-RTT FUSE 挂载) - 视觉与 GUI 操作:
screenshot(直接返回压缩图片供多模态模型理解)、click、move、scroll、type_text、key - 网络与剪贴板:
forward/unforward(端口转发)、clipboard_get/clipboard_set、ping、devices
三、从软件延伸到硬件:ARM64 开发板、串口转发与 ESP32 物理审批
在机器人、边缘算力和嵌入式调试里,这套体系还可以直接打通物理硬件:
1. 远程串口(/dev/ttyUSB)与 Linux USB/IP 透传
# 把远端实验台的串口映射到本机虚拟串口(波特率自动同步)
rds 479072199 serial /dev/ttyUSB0 115200
# Linux 到 Linux 挂接远端 USB 调试器(ST-Link / J-Link / 逻辑分析仪)
rds 479072199 usb list
rds 479072199 usb attach 1-2
2. ESP32-S3 物理触摸屏作为 AI 的「人类确认键(Human-in-the-Loop)」
在让 AI 自主操作生产环境或物理设备时,最担心的就是误操作。利用一块几十元的 立创·实战派 ESP32-S3(2 寸触摸屏),通过浏览器一键烧录免费固件(https://rockdesk.cn/esp32/)后,板子会获得独立 9 位 ID:
# 远程局域网唤醒(WoL)休眠中的目标电脑
rds <板子ID> wake aa:bb:cc:dd:ee:ff
# AI 执行高危命令前,在桌面的 ESP32 触摸屏弹出「拒绝 / 允许」等你真手点击!
# 允许返回退出码 0,拒绝返回 1,无人点击超时返回 2
rds <板子ID> shell -c 'ask "要重启生产数据库吗?" && echo 已授权'
# 远程控制空闲 GPIO 引脚触发继电器或主板开机跳线
rds <板子ID> shell -c 'gpio 10 1; sleep 0.5; gpio 10 0'
四、安全边界设计
放 AI 进另一台电脑,安全必须放在协议层而不是仅靠提示词:
- 端到端加密:每台设备拥有独立证书,所有连接基于 QUIC + TLS 1.3 端到端加密,中继节点仅转发密文。
- 权限完全归属被控端:由被控电脑决定谁能连(密钥对 / 一次性密码 / 当场点允许),以及按功能粒度开关权限(例如
sudo rds config feature shell on、sudo rds config feature serial off),AI 绝不可能越过被控端放行的边界。
更多关于 Claude Code / Codex / Gemini CLI 的配置细节及硬件调试命令,可参考官方文档:https://rockdesk.cn/claude-code-remote-machine.html 与 https://rockdesk.cn/remote-serial-usb.html。