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 --sandbox2. 交互式会话启用 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