手机远程控制 Claude Code 编程教程：随时随地的 AI 编程体验
Claude Code 是 Anthropic 推出的终端 AI 编程助手，能帮你编写代码、调试 Bug、重构项目。 但如果你出门在外，或者需要在多台电脑间切换使用，如何继续你的 Claude Code 编程会话？ 本文教你用手机远程控制 Claude Code，让 AI 编程不再受地点限制。
为什么需要用手机控制 Claude Code？
🚄 移动场景
通勤路上、出差途中、午休时间，这些碎片时间都可以利用起来，通过手机查看 Claude Code 的执行进度和结果。
🛠️ 紧急响应
生产环境出现线上问题，即使身边没有电脑，也能用手机远程启动 Claude Code 进行紧急排查和修复。
💪 持续工作
提交一个耗时的代码重构任务后，可以关闭浏览器离开。Claude Code 会在后台继续运行，回来后查看结果即可。
👥 团队协作
团队共享一台高性能开发机器，每个人都可以用自己的手机远程连接，互不干扰地使用 Claude Code。
手机控制 Claude Code 的完整设置
1. 在被控机器上安装并登录 Claude
确保你的电脑上已经安装了 Claude CLI 并完成了登录：
# 安装 Claude CLI
npm install -g @anthropic-ai/claude-code
# 登录 Claude（会打开浏览器完成认证）
claude
# 验证登录成功
claude --version2. 启动 Agent Connect 的 Edge Agent
在被控机器上运行 Edge Agent，它将建立到云端 Hub 的反向连接：
# 安装 Bun（如未安装）
curl -fsSL https://bun.sh/install | bash
# 下载并安装 Agent Connect
git clone [项目地址]
cd web && bun install
# 启动 Agent
bun run agent --hub wss://yanlin-ai.cn/api/agentAgent 启动后，控制台会显示 "Connected to hub" 表示连接成功。
3. 手机浏览器连接并启动 Claude Code
打开手机浏览器，访问 Agent Connect 控制台：
- 访问
https://yanlin-ai.cn/agentConnect - 登录你的账号
- 在机器列表中选择你的被控机器
- 点击"Claude Code"终端按钮
- 等待连接建立，即可开始与 Claude 对话
手机端 Claude Code 的特色功能
📺 实时流式输出
Claude Code 的思考过程和代码生成会实时推送到手机屏幕，就像你坐在电脑前一样流畅。采用打字机效果逐字显示，体验极佳。
🔄 后台保活与重进续聊
关闭手机浏览器后，Claude Code 会话会在后台继续运行 180 秒。重新在手机上打开控制台，自动恢复会话，并回放当前轮的所有事件，让你不错过任何内容。
📜 会话历史查看
随时查看历史会话记录，回顾之前的 Claude Code 对话和生成的代码。
🔐 安全加密
所有通信都经过 WSS（WebSocket Secure）加密，你的代码和对话内容不会泄露。
手机控制 Claude Code 的最佳实践
- 使用横屏模式：手机横屏能显示更多代码内容，体验更接近桌面。
- 提交明确的任务：由于手机输入不如键盘方便，建议在电脑上先准备好 Prompt，或者让 Claude 执行相对独立的任务。
- 利用后台运行：对于耗时的代码生成或测试任务，在手机上提交后可以直接关闭浏览器，过段时间再回来看结果。
- 语音输入替代：手机自带的语音输入功能可以用来快速输入 Prompt，提升操作效率。
- 多设备协同：可以在办公电脑、家庭电脑、云服务器上都运行 Edge Agent，用手机统一管理和切换。
常见问题
手机远程控制 Claude Code 需要安装什么 App？
完全不需要。手机端只需要一个现代浏览器（Safari、Chrome、Edge 均可），不需要安装任何 App。
需要 Claude API Key 吗？
不需要。Agent Connect 复用被控机器上已经登录的 Claude CLI 登录态，不需要提供任何 API Key 或密钥。
能在手机上同时开多个 Claude Code 会话吗？
可以。你可以为不同的项目目录启动不同的 Claude Code 会话，所有会话都在手机控制台统一管理。