官方 Remote Control：架构与数据流
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)
(申请发送: agentupdate)
了解架构有助于排障和评估安全性。
组件拓扑
flowchart TB
subgraph LocalMachine[开发机]
CLI[Claude Code CLI]
WS[WebSocket 客户端]
CLI --- WS
end
subgraph Anthropic[Anthropic 后端]
Bridge[Remote Control 桥接]
Auth[OAuth / JWT]
Push[推送服务]
end
subgraph Clients[远程客户端]
Web[claude.ai/code 网页端]
App[iOS / Android 应用]
end
WS <-->|WebSocket + 轮询| Bridge
Bridge --- Auth
Bridge --> Push
Web --- Bridge
App --- Bridge关键数据流
- 入站 (Inbound): 客户端输入 → 桥接 → 本地 CLI → 工具/模型。
- 出站 (Outbound): 模型 Token 流 → 本地 CLI → 桥接 → 客户端实时渲染。
- 权限 (Permissions): 工具执行请求（Bash, Edit）被推送到客户端进行审批。
- 状态 (State): 文件、Git 和 Shell 严格保留在本地。只有对话记录被镜像到云端。
注意: v2.1.69 将稳定时的轮询频率从 1-2 秒优化为每 10 分钟一次，将服务器负载降低了 300 倍。