5 分钟上手：用手机浏览器远程控制 Claude Code
不需要安装手机 App、不需要公网 IP、不需要额外订阅费用。 只需要一个手机浏览器，5 分钟就能让你在任何地方远程操作 Claude Code。跟着下面的步骤走，马上就能用起来。
⏱️ 开始前你需要准备
- 一台电脑（Windows / Mac / Linux 都可以）
- 电脑上已安装 Claude CLI 并已完成登录
- 电脑能上网（不需要公网 IP）
- 一部手机（iOS / Android 均可，有浏览器就行）
第一步：在被控电脑上启动 Agent Connect
1.1 确认 Claude CLI 已安装并登录
打开电脑终端，验证 Claude CLI 是否可用：
# 检查 Claude CLI 版本
claude --version
# 如果没安装，先安装
npm install -g @anthropic-ai/claude-code
# 启动 Claude 并登录（首次使用）
claude第一次运行 claude 会打开浏览器引导你完成登录。登录后 Claude CLI 就准备好了。
1.2 安装 Bun 运行时
Agent Connect 使用 Bun 作为运行环境。如果你的电脑还没有 Bun：
# macOS / Linux 一键安装
curl -fsSL https://bun.sh/install | bash
# Windows 用户
# 推荐使用 WSL，或者在 PowerShell 中：
powershell -c "irm bun.sh/install.ps1 | iex"安装完成后，重新打开终端并运行 bun --version 确认安装成功。
1.3 下载并启动 Edge Agent
克隆 Agent Connect 仓库并启动 Edge Agent：
# 克隆项目
git clone https://github.com/你的仓库/agentConnect.git
cd agentConnect/web
# 安装依赖
bun install
# 启动 Edge Agent 连接到云端 Hub
bun run agent --hub wss://yanlin-ai.cn/api/agent如果一切顺利，你会看到类似这样的输出：
[Agent] Connected to hub at wss://yanlin-ai.cn/api/agent
[Agent] Registered as: 你的机器名 (machine-id: xxx)
[Agent] Agent ready. Waiting for console connections...💡 提示：想让 Agent 开机自启？可以使用 systemd（Linux）或 launchd（macOS）将其配置为系统服务。
第二步：手机浏览器打开控制台
- 拿出手机，打开浏览器（Safari / Chrome / Edge 都行）
- 访问
https://yanlin-ai.cn/agentConnect - 注册或登录你的账号
新用户只需邮箱 + 密码即可注册，无需手机号。
- 查看机器列表——你应该能看到刚才启动 Agent 的那台电脑显示为在线状态
💡 提示：建议在手机浏览器中将网站添加到主屏幕（iOS Safari 的"添加到主屏幕"或 Android Chrome 的"添加到主屏幕"），下次打开就像 App 一样方便。
第三步：启动 Claude Code 会话
- 在手机上的机器列表里，点击你的电脑
- 在控制台中，点击 "Claude Code" 按钮
- 系统会自动通过 Hub 向电脑上的 Agent 发送指令，启动一个新的 Claude Code 会话
- 几秒后，你会看到 Claude Code 的欢迎信息出现在手机屏幕上
- 在输入框中输入你的问题或指令，按下发送
🎉 恭喜！你已经成功用手机远程控制了 Claude Code！
现在你可以在手机上看到 Claude 的思考过程，看到代码逐行生成，就像坐在电脑前一样。 所有输出都是实时流式显示，打字机效果逐字呈现。
接下来你可以做什么
🔄 后台运行，回来续聊
提交任务后直接关闭浏览器。Claude Code 会在电脑后台继续运行。180 秒内重新打开控制台，自动恢复会话，回放所有已完成的内容。
📱 也控制 Codex
同样的平台也支持 OpenAI Codex。在控制台点击"Codex"按钮即可启动 Codex 会话，完全一样的操作方式。
💻 同时使用 Shell 终端
除了 AI 编程，还可以在手机上打开普通的 Shell 终端，运行命令行操作。
🏢 管理多台机器
在多台电脑上运行 Edge Agent，所有机器统一在手机控制台管理，一键切换。
常见问题排查
Agent 启动后提示 "Connection failed"
检查电脑网络是否正常。Agent 需要能连接外网（wss://yanlin-ai.cn）。如果公司网络有代理限制，可能需要配置代理环境变量。
手机上看不到在线机器
确认 Edge Agent 已在电脑上成功启动并显示 "Connected to hub"。如果仍看不到，尝试刷新手机浏览器页面。
Claude Code 启动后没有响应
检查电脑上 Claude CLI 是否已登录。运行 claude --version 确认已登录状态。如果未登录，在电脑上运行 claude 完成登录。
手机上的文字太小了
建议开启手机横屏模式，可以获得更大的可视区域。也可以在浏览器中缩放页面。
Agent 退出后之前的会话还在吗？
如果 Agent 进程退出，运行中的 Claude Code 会话会终止。建议保持 Agent 持续运行（可以配置为系统服务）。历史会话记录保存在云端，可以随时查看。