Agent Connect 是什么？远程 AI 终端接入平台完全指南
Agent Connect 是一个革命性的远程 AI 终端接入平台。它让开发者和企业能够通过手机或电脑浏览器， 随时随地远程控制 Claude Code、Codex 等 AI 编程终端。本文全方位介绍 Agent Connect 的功能、 原理和使用方法。
1. Agent Connect 概述
Agent Connect 是长沙言灵科技推出的 Web 版远程终端 / Agent 接入平台。它的核心理念是反向接入： 被控机器上运行一个轻量级的 Edge Agent 程序，主动连接到云端的 Hub 服务。 然后用户通过任意设备的浏览器连接同一个 Hub，就可以远程控制这些机器。
一句话概括
Agent Connect = 手机/浏览器远程控制 Claude Code、Codex 和 Shell 终端的平台，零配置、零端口、零公网 IP。
无论是个人开发者想在外出时继续 AI 编程，还是企业团队需要集中管理多台开发机器， Agent Connect 都提供了一个安全、便捷、高效的解决方案。
2. 反向接入架构详解
传统远程控制方案（SSH、RDP、VNC）都需要被控机器有公网 IP 和开放入站端口， 这在家庭宽带、公司内网、云服务器等场景下往往难以实现。Agent Connect 采用完全不同的架构：
⚙️ 架构示意图
┌─────────────┐ ┌──────────────┐ ┌─────────────────┐ │ 手机浏览器 │ │ │ │ 被控机器 │ │ (控制端) │────▶│ 云端 Hub │◀────│ Edge Agent │ │ │ WSS │ (server) │ WSS │ (主动拨入) │ │ Safari/ │ │ port 3012 │ │ node-pty │ │ Chrome │ │ │ │ Claude/Codex │ └─────────────┘ └──────────────┘ └─────────────────┘
Edge Agent 拨入 Hub
运行在被控机器上，主动发起出站 WebSocket 连接到 Hub。本机不需要任何入站端口。
浏览器连接 Hub
用户在手机或电脑上打开浏览器，访问 Hub 提供的 Web 控制台。
Hub 双向转发
Hub 负责建立浏览器和 Agent 之间的双向数据通道，转发终端输入输出、会话事件等。
三条 WebSocket 通道
| 通道 | 路径 | 用途 |
|---|---|---|
| Agent 拨入 | /api/agent | Agent 注册和双向转发 |
| 终端通道 | /api/console/:machineId | PTY 终端，输出 base64 编码 |
| 会话通道 | /api/chat/:machineId | Claude/Codex 流式事件 |
3. 核心功能
🌐 浏览器远程终端
通过网页远程操作被控机器的 Shell、Claude Code、Codex 终端。手机、平板、电脑均可使用。
🔄 常驻会话
AI 会话后台保活 180 秒，关闭浏览器后会话持续运行，重进后自动续聊并回放当前进度。
🔒 零入站端口
被控机器只主动建立出站连接，无需公网 IP、无需配置防火墙、无需开放任何入站端口。
📜 会话历史
查看历史会话记录和对话内容，方便回顾之前的工作。
📱 手机端优化
专为手机浏览器优化，支持横屏模式、触摸操作，终端输出以 base64 编码传输确保字符完整。
🏢 企业多租户
支持企业账号，机器按企业归集，通过 enroll_token 实现机器注册和权限管理。
4. 支持的终端类型
🐚 Shell 终端
基础的命令行终端，用于执行任意 shell 命令。适合文件操作、git 管理、服务管理等任务。
🤖 Claude Code 终端
Anthropic 推出的 AI 编程助手。Agent Connect 使用常驻 query 模式运行： 进程不退出，每轮对话通过异步队列推送消息，includePartialMessages 实现逐字打字机效果。
5. 企业级功能
多租户架构
每个企业有独立的 enroll_token，被控机器拨入时带上 token 即自动归入该企业管理。 团队成员的机器可以统一管理，方便远程协作。
机器绑定门禁
个人注册后需要购买会员才能绑定机器。支持 monthly_1（49 元/月，1 台机器） 和 monthly_3（99 元/月，3 台机器）两种档位。
微信支付集成
完整的会员支付流程，通过 vv-agent 对接微信支付，支付成功后自动激活会员权限。
6. 与其他方案对比
| 特性 | Agent Connect | 传统 SSH | VNC/RDP | TeamViewer |
|---|---|---|---|---|
| 需公网 IP | ❌ 不需要 | ✅ 需要 | ✅ 需要 | ❌ 不需要 |
| 开放端口 | ❌ 不需要 | ✅ 需要 | ✅ 需要 | ❌ 不需要 |
| 手机支持 | ✅ 原生支持 | ⚠️ 需 App | ⚠️ 需 App | ✅ 有 App |
| Claude Code 支持 | ✅ 原生支持 | ⚠️ 手动 | ❌ 不支持 | ❌ 不支持 |
| Codex 支持 | ✅ 原生支持 | ⚠️ 手动 | ❌ 不支持 | ❌ 不支持 |
| 会话保活 | ✅ 180s 保活 | ❌ 断开即失 | ❌ 断开即失 | ✅ 部分支持 |
| 流式输出 | ✅ 原生支持 | ❌ 不支持 | ❌ 不支持 | ❌ 不支持 |
7. 快速开始
一分钟快速上手
- 访问
https://yanlin-ai.cn/agentConnect注册账号 - 在被控机器上安装并运行 Edge Agent（
bun run agent） - 手机浏览器打开控制台，选择机器，开始使用
8. 常见问题
Agent Connect 免费吗？
个人注册后每天签到可免费领取 1 小时会员体验。如需长期使用，可以选择 monthly_1（49 元/月）或 monthly_3（99 元/月）会员。
Agent Connect 和传统的远程桌面有什么区别？
Agent Connect 专门为 AI 编程终端设计，不是远程桌面。它专注于 Shell 终端、Claude Code、Codex 的远程操作，支持流式输出、会话保活、重进续聊等 AI 编程特有的功能。
被控机器需要什么配置？
只要能运行 Bun 和 Claude/Codex CLI 的机器都可以。支持 macOS、Linux、Windows（WSL）。
数据传输加密吗？
所有 WebSocket 通信都使用 WSS（WebSocket Secure）协议，经过 TLS 加密传输。
可以连接多台机器吗？
可以。会员档位决定了最多同时绑定的机器数量（月付 1 档 1 台，3 档 3 台）。你可以在控制台中随时切换不同机器。