教程

Claude Code Remote Control 使用指南:手机和浏览器远程继续本地会话

Claude Code Remote Control 让你在手机、平板或浏览器中继续本地 Claude Code 会话。代码仍在本机执行,web/mobile 只是连接窗口,可访问本地文件、MCP servers 和项目配置。

2026/6/83分钟 阅读ClaudeEagle

Claude Code Remote Control 让你从手机、平板或浏览器继续控制本地 Claude Code session。它适合这样的场景:你在桌面启动任务,然后离开电脑,用手机继续回复、批准、查看进度。


Remote Control 和 Claude Code on the Web 有什么区别?

关键区别:Remote Control 的 Claude Code 仍然运行在你的机器上。

这意味着:

  • 文件系统仍是你的本地项目
  • 本地 MCP servers 可用
  • 本地 tools 和项目配置可用
  • @ 自动补全仍来自本地文件路径
  • web/mobile 只是一个远程窗口

而 Claude Code on the web 是在云端基础设施运行。


使用前提

要求:

  • Claude Code v2.1.51 或更高版本
  • Pro、Max、Team、Enterprise 计划
  • API key 不支持该功能
  • 已通过 /login 登录 claude.ai
  • 在项目目录运行过 Claude Code 并信任 workspace
  • Team/Enterprise 需要管理员开启 Remote Control

三种启动方式

1. Server Mode

在项目目录运行:

bash
claude remote-control

它会在终端中保持运行,显示 session URL。按空格可以显示 QR code,方便手机扫码。

常用参数:

bash
claude remote-control --name "My Project"
claude remote-control --capacity 8
claude remote-control --spawn worktree
claude remote-control --sandbox

2. 交互式会话启用 Remote Control

bash
claude --remote-control

或:

bash
claude --rc "My Project"

这种模式下,你既可以在终端输入,也可以从 web/mobile 输入。

3. 已有会话中开启

在 Claude Code 会话里输入:

text
/remote-control

或:

text
/rc My Project

它会保留当前对话历史,并生成 URL/QR code。


Spawn 模式:same-dir、worktree、session

Server mode 支持 --spawn

  • same-dir:所有 sessions 共享当前目录,默认模式,可能发生文件冲突
  • worktree:每个新 session 使用独立 git worktree,适合并行编辑
  • session:只服务一个 session,拒绝额外连接

如果你希望从手机派发多个任务,推荐在 git 仓库中使用 worktree 模式。


安全边界

Remote Control 的便利来自“远程控制本地环境”,也意味着它能触达本机文件和工具。

建议:

  • 只在可信设备上打开 session URL
  • 对敏感项目使用 --sandbox
  • 并行任务尽量用 worktree 隔离
  • 不在不可信网络环境中暴露远程会话
  • Team/Enterprise 由管理员统一控制开关

适合场景

  • 下班路上查看 coding agent 进度
  • 手机批准或回答 Agent 的问题
  • 会议中用浏览器继续桌面上的任务
  • 在 iPad 上查看本地项目状态
  • 让长任务保持本地工具链和 MCP 访问

Remote Control 的核心价值不是把代码搬到云端,而是让本地 Claude Code session 多一个随身入口。


来源:Claude Code 官方文档 - Remote Control | 整理:ClaudeEagle

相关文章推荐

教程Claude Code Remote Control 完整指南:用浏览器界面控制本地终端会话Claude Code Remote Control 完整指南:取本地权限和云端 UI 两者之长;两种启用方式(--remote-control 标志和 /remote-control 命令);4 个核心使用场景(手机远程审查/向同事展示/大屏查看长输出/配合 /diff 可视化);与 Ultraplan/Ultrareview 的互斥关系;/teleport 反向操作(把 Web/iOS 会话拉回本地);/desktop 移交到桌面应用;以及安全注意事项。2026/5/7教程Claude Code Remote Control 详解:用手机或另一台电脑控制本地 AI 编程会话Claude Code Remote Control 完整指南:3 种启动方式(Server/交互/现有会话)、手机扫码连接步骤、实际使用场景,以及与网页版的核心区别、安全机制和常见报错解决方法。2026/4/13教程Claude Code Remote Control:手机/平板远程控制本地会话、HTTPS 安全连接与 Web 版对比Claude Code Remote Control 完整指南:核心价值(本地环境全保留/多设备同步/网络中断自恢复)、使用要求(Pro/Max/Team/Enterprise 订阅/不支持 API Key)、三种启动方式(命令行新建 claude remote-control/从已有会话 /remote-control 或 /rc/所有会话默认启用)、标志说明(--name/--verbose/--sandbox)、三种远程连接方式(URL/QR 扫码/会话列表绿色在线点)、安全架构(出站 HTTPS/TLS 加密/短期凭证独立过期)、Remote Control vs Web 版对比表(执行环境/本地文件系统/MCP/关机是否继续),以及三大局限性(每次一个连接/终端保持/10 分钟网络超时)。2026/3/9教程Claude Code Agent Teams 使用指南:多 Claude 会话协作、共享任务列表和直接通信Claude Code Agent Teams 适合需要多个 Claude Code 会话并行探索、互相挑战和协调的复杂任务。它不同于 subagents:teammates 有独立上下文、共享任务列表,并能直接通信。2026/6/8教程Claude Code 高级提示技巧:TDD 驱动、截图验证、面试需求、让 AI 自我检查 7 个方法Claude Code 高级提示技巧 7 个方法:TDD 先写测试、截图验证 UI、面试确认需求、新会话 Reviewer 自检、参考现有模式、可中断大型任务、三阶段探索-计划-执行工作流。2026/4/13教程Claude Code 定时任务完整指南:每天自动 review 代码、检查依赖、生成日报Claude Code 定时任务完整配置指南:Desktop 本地任务、云端任务、/loop 三种方式对比,含 5 个实用任务模板(每日代码 review、依赖漏洞扫描、技术债报告),以及权限防卡死和补跑机制详解。2026/4/13