Agent Connect 手机远程控制 Claude Code 和 Codex 完整指南
你是否想过，出门在外时也能用手机继续运行 Claude Code 或 Codex 的 AI 编程任务？ Agent Connect 让你通过手机浏览器就能远程控制你的 AI 编程终端，无需公网 IP，无需开放入站端口，安全又便捷。
1. Agent Connect 是什么？
Agent Connect 是一个 Web 版远程终端 / Agent 接入平台。它让被控机器（比如你的个人电脑或云服务器）主动拨入云端的 Hub 服务， 然后你可以通过任意设备的浏览器（包括手机、平板）来远程打开终端、运行 Claude Code、Codex 等 AI 编程工具的常驻会话。
核心特点：
- 反向接入：被控机器只主动发出站连接，本机不需要公网 IP，不需要开放任何入站端口
- 多终端支持：同时支持 Shell 终端、Claude Code 终端和 Codex 终端
- 常驻会话：AI 会话在后台持续运行，离开后 180 秒内保活，重进自动续聊
- 流式输出：实时查看 AI 的思考过程和代码生成，就像在本地操作一样流畅
2. 手机远程控制原理
传统的远程控制方案（如 SSH、RDP）需要被控机器有公网 IP 并开放入站端口，这在家庭网络、公司内网环境中很难实现。 Agent Connect 采用反向接入架构：
手机浏览器 ⇄ Hub 云端 ⇄ 被控机器 Edge Agent
（WSS 长连接） （主动出站连接）
简单说，被控机器上运行一个 Edge Agent 程序，它会主动连接到 Agent Connect 的云端 Hub。 你的手机浏览器也连接到同一个 Hub，Hub 负责将手机的操作指令转发到被控机器，并将机器的输出实时推送到手机。
这种方式的好处是：零配置、零端口、零公网 IP，只要被控机器能上网，你就能用手机远程控制它。
3. 三步设置教程
第一步：在被控机器上运行 Edge Agent
确保被控机器已经安装了 Node.js（Bun 环境）和 Claude / Codex CLI，打开终端执行：
# 克隆项目并安装依赖
git clone [项目地址]
cd web && bun install
# 启动 Edge Agent 连接云端 Hub
bun run agent --hub wss://yanlin-ai.cn/api/agentAgent 启动后会自动注册到 Hub，等待来自浏览器的连接请求。
第二步：用手机浏览器打开控制台
在手机浏览器（Safari、Chrome 均可）中访问：
https://yanlin-ai.cn/agentConnect注册/登录后，你就能看到在线机器列表，选择你的机器即可进入控制台。
第三步：选择终端类型开始使用
在控制台中，你可以选择三种终端：
- Shell 终端：基础的命令行操作
- Claude Code：运行 Claude AI 编程会话
- Codex：运行 OpenAI Codex 编程会话
4. 用手机控制 Claude Code
Claude Code 是 Anthropic 推出的 AI 编程助手，可以直接在终端中运行。通过 Agent Connect， 你可以在手机上远程启动和操作 Claude Code 会话，所有流式输出都会实时显示在手机屏幕上。
手机使用 Claude Code 的典型场景
- 出差途中：在高铁或飞机上检查代码生成进度
- 休息间隙：睡前提交一个复杂的重构任务，让 Claude 在后台运行
- 紧急修复：收到线上告警，用手机远程执行调试命令
- 代码审查：用 Claude 分析代码差异，直接在手机上查看审查结果
重要：Claude Code 会话采用常驻 query 模式，进程不会退出。即使关闭手机浏览器， 会话仍在服务器后台运行（保活 180 秒）。重新打开后，你会看到所有已经完成的内容——就像什么都没发生过。
5. 用手机控制 Codex
OpenAI Codex 是另一个强大的 AI 编程工具。Agent Connect 同样支持 Codex 会话的远程控制和流式输出。 Codex 会话复用同一个 thread 顺序排队执行，确保代码上下文的连贯性。
在手机浏览器中，你可以：
- 启动新的 Codex 编程会话
- 查看 Codex 的流式思考过程和代码生成
- 在后台排队多个任务
- 退出后回来继续查看完成结果
Agent Connect 将会话事件规范化为统一的 ChatEvent 格式，因此无论是 Claude Code 还是 Codex， 在手机端的交互体验是一致的。
6. 使用技巧和最佳实践
📱 手机横屏模式
使用手机控制终端时，建议开启横屏模式，可以获得更大的可视区域，查看代码输出更舒适。
🔄 后台保活技巧
提交长时间任务后，可以关闭浏览器。Agent Connect 会在后台继续运行，180 秒内重进即可续聊。
🔐 多机器管理
可以在多台电脑上运行 Edge Agent，所有机器都在手机控制台统一管理，一键切换。
⚡ 企业团队使用
企业账号支持多租户管理，团队成员的机器可以统一归集，方便远程协作和管理。
7. 常见问题
手机需要安装 App 吗？
不需要。Agent Connect 完全基于 Web 技术，使用手机自带的浏览器（Safari、Chrome 等）即可连接和控制，无需安装任何 App。
被控机器需要公网 IP 吗？
不需要。Agent Connect 采用反向接入架构，被控机器只主动发出站 WebSocket 连接到 Hub，不需要公网 IP，也不需要开放任何入站端口。
远程控制安全吗？
Agent Connect 使用 WSS（WebSocket Secure）加密连接，所有数据传输都经过 TLS 加密。另外还支持企业级授权 Token 机制，确保只有授权的机器可以被管理。
需要安装 Claude 或 Codex 的 API Key 吗？
不需要。Agent Connect 复用被控机器上已经登录的 Claude CLI 或 Codex CLI 的登录态，无需提供任何 API Key。
手机看代码会不会太小？
终端输出以 base64 编码传输，避免 UTF-8 多字节字符被切断的问题。结合手机横屏模式和字体缩放功能，查看代码完全没问题。你也可以通过"回放"功能查看历史输出。