Claude Code Remote Control完整指南：手机、浏览器继续本地会话（最新整理）

来源：互联网 2026-07-16 06:09:02

Claude资讯合集

本课学习目标我将 Remote Control 定义为辅助协作而非远程放飞，是因为移动端接力同样需要明确的边界。完成本课程后，你大致可以掌握以下内容：理清 Remote Control 与 Claude Code on the Web 的本质区别正确启动 Remote Control 的三种模

本课学习目标

我将 Remote Control 定义为辅助协作而非远程放飞，是因为移动端接力同样需要明确的边界。

Claude Code Remote Control完整指南：手机、浏览器继续本地会话（最新整理）

长期稳定更新的攒劲资源： >>>点此立即查看<<<

完成本课程后，你大致可以掌握以下内容：

理清 Remote Control 与 Claude Code on the Web 的本质区别
正确启动 Remote Control 的三种模式
从手机、平板或浏览器无缝接续本地 Claude Code 会话
理解并发模式、worktree、sandbox 与权限边界
解决 Team / Enterprise 环境下最常见的启用问题

1. 核心结论

Remote Control 并非“将本地项目同步至云端”，而是：

让 claude.ai/code 或 Claude 手机 App 成为你本地 Claude Code 会话的远程访问窗口。

关键特性：

会话继续在你的本地机器上运行
本地文件系统、MCP、配置均可正常使用
手机、浏览器、终端可同时接入同一会话
适合中途离开工位但不想中断当前任务

2. 与 Claude Code on the Web 的区别

这一点最容易混淆。

功能	Remote Control	Claude Code on the Web
运行位置	你的本地机器	Anthropic 云端
文件系统	本地真实项目	云端克隆或沙箱
MCP / 本地工具	可直接复用本地环境	取决于云端环境
能否离开终端继续	可以	可以，但属于另一种会话形态
典型场景	本地工作已进行一半，想在手机上继续	希望远程开启一个新的云端任务

如果你已在终端中处理部分任务，希望换到沙发继续查看和下达指令，请使用 Remote Control。

如果你想启动一个不依赖本地运行环境的新云端任务，请使用 Claude Code on the Web。

3. 使用前提

v2.1.139+ 登录方式限制：若当前会话通过 ANTHROPIC_API_KEY、apiKeyHelper 或 ANTHROPIC_AUTH_TOKEN 使用 API key 或 helper 登录，Remote Control、/schedule、claude.ai MCP connectors 以及 notification preferences 将被禁用。如需使用远程控制和计划能力，请优先选择支持这些功能的 Claude.ai 登录路径。

官方当前要求：

Claude Code v2.1.51+
使用 claude.ai 登录
非 API key 模式
Team / Enterprise 用户需管理员先在后台启用 Remote Control

支持 Remote Control 的订阅计划：Pro、Max、Team、Enterprise。

3.1 建议先完成以下三项检查

claude --version

/login

确认已在项目目录中至少启动过一次 claude，并接受 workspace trust。

4. 三种启动方式

4.1 方式一：独立服务器模式

这是最纯粹的 Remote Control 启动方式。

claude remote-control

该命令会：

在当前终端进入 server mode
显示一个会话 URL
按空格键可显示二维码
等待其他设备连接

适用场景：

本地无需继续使用终端
希望将会话“挂出”供远程访问

常用参数

claude remote-control --name "My Project"

claude remote-control --verbose

claude remote-control --sandbox

claude remote-control --spawn worktree

这些参数中值得重点理解的是：

--name：远端会话标题
--spawn same-dir|worktree|session：并发会话的创建方式（默认 same-dir）
--sandbox / --no-sandbox：是否启用沙箱
--capacity ：最大并发会话数量

在 server mode 运行时，可按 w 键在 same-dir 和 worktree 之间实时切换。

4.2 方式二：本地交互会话 + Remote Control

若希望保留终端交互的同时，让手机或浏览器也能接入，请使用此方式：

claude --remote-control

或：

claude --rc

与 claude remote-control 的区别在于：

仍可在本地终端中正常聊天
同时支持远端设备控制同一会话

4.3 方式三：在已运行会话中临时开启

如果你已在 Claude Code 中工作，且不想重启会话：

/remote-control

也可直接命名：

/remote-control Auth Fix Session

该命令会将当前会话历史一并带过去，并显示：

会话 URL
QR 码

适用场景：

工作已进行到一半，决定换设备继续

5. 如何从其他设备连接

Remote Control 启动后，官方支持以下三种连接方式：

直接打开终端中显示的 URL
扫描 QR 码
在 claude.ai/code 或手机 App 的会话列表中查找

会话标题的来源

官方当前的优先级顺序为：

--name / --remote-control / /remote-control 传入的名称
/rename 设置的名称
最近一条有意义的消息
自动生成的名称

v2.1.92（GitHub Release v2.1.92）对 Remote Control 默认名称的补充（以下为 release 英文原文，便于与官方逐字核对）：

Remote Control session names now use your hostname as the default prefix (e.g. myhost-graceful-unicorn), overridable with --remote-control-session-name-prefix

也就是说：在未手动命名时，默认名称会包含 hostname 前缀；也可使用 CLI 参数 --remote-control-session-name-prefix 覆盖该前缀行为。具体如何与上述 1～4 条优先级叠加，请以当前 CLI 实际行为为准。

因此，若希望手机端更容易识别，最实用的做法是：

/rename monorepo-auth-fix

6. 并发模式：same-dir 还是 worktree

当 Remote Control 衍生出多个并发会话时，需要先选择隔离方式。

same-dir

所有会话在同一个目录中工作
配置简单
但容易互相修改同一批文件

worktree

每个并发会话拥有独立的 git worktree
更适合并行任务
需要 git 仓库

如果使用 Remote Control 的目的是“多设备继续”而非“多人并发”，same-dir 已足够。

如果打算将其作为多线程工作台，建议优先使用 worktree。

session

每个并发会话独立隔离
不依赖 git
适用于非 git 仓库的项目

运行时切换

在 server mode 下，按 w 键可在 same-dir 和 worktree 之间实时切换。

7. 远端可用命令与仅本地命令

并非所有 Claude Code 命令都能在远端界面执行。官方当前清单如下：

远端可用（手机或浏览器均可执行）：

/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins、/autocompact

仅限本地（必须在终端操作）：

/mcp、/plugin、/resume（涉及交互式选择器的命令）

这意味着无法在手机上安装插件或恢复旧会话，但日常的上下文管理和监控均可远程完成。

8. Sandbox、权限与安全边界

关于 Remote Control 的一个关键误区是：

远端只是入口，实际执行操作的仍然是本地机器。

因此，安全问题本质上仍是本地 Claude Code 的权限问题。

8.1 官方口径下需注意的要点

Remote Control 仍继承本地会话的文件、工具和 MCP 能力
允许谁连入，比“界面在哪里”更为关键
若本地会话权限较宽，远端也会继承

8.2 传输安全

官方当前的安全架构：

所有流量走 HTTPS/TLS，经由 Anthropic API 中转
你的机器不会打开任何入站端口
使用多个短期、单一用途、独立过期的凭据

8.3 建议做法

涉及高风险仓库时，建议优先配合 sandbox
高风险任务不要随意开启 bypassPermissions
为 Remote Control 会话显式命名，避免误连错会话

9. Team / Enterprise 常见阻塞问题

在 Team 和 Enterprise 环境下，Remote Control 默认可能处于关闭状态。

你可能遇到以下报错信息：

Remote Control requires a claude.ai subscription
Remote Control is disabled by your organization’s policy
Unable to determine your organization for Remote Control eligibility
Remote Control requires a full-scope login token
Remote Control is not yet enabled for your account

9.1 排查顺序

首先确认不是 API key 登录
然后确认管理员已在 Claude Code 后台开启 Remote Control 开关
确认当前项目已接受 workspace trust
检查是否设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_TELEMETRY 环境变量（会干扰 RC 连接）
使用 /status 确认当前登录方式和订阅状态

9.2 托管策略：forceRemoteSettingsRefresh（v2.1.92）

若组织使用 remote managed settings，请关注 v2.1.92 引入的策略项（以下为 v2.1.92 release 英文原文）：

Added forceRemoteSettingsRefresh policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail-closed)

含义：开启后，CLI 在成功拉取到最新远程托管设置之前不会启动；若拉取失败则 直接退出（fail-closed）。具体在项目或企业配置中的写法，请以官方托管设置文档及管理员下发的 schema 为准，本教程不臆造 JSON 示例。

9.3 更高版本增强（v2.1.93 → v2.1.158）

v2.1.152 到 v2.1.158 这一轮更新中，Remote 及后台相关变化主要集中于稳定性和可控性增强：

claude agents 可使用 ! 启动可附着的后台 shell，命令行等价入口为 claude --bg --exec ''。
/remote-control autocomplete 会在已连接时显示断开入口，Chrome 集成可通过 /chrome 选择连接的浏览器。
后台会话的 stale daemon、pinned session 重启、idle grace、worktree isolation、tmux/Windows IME/终端渲染等问题已有多轮修复。
stdio MCP 子进程会收到 CLAUDE_CODE_SESSION_ID 和 CLAUDECODE=1，脚本化排查时可用这两个环境变量识别调用来源。

v2.1.92 之后的版本对 Remote Control 进行了一系列增强和修复（以下版本号经 GitHub Release Notes 逐条核实）：

版本	增强内容
v2.1.98	修复 Remote Control 权限处理器中的内存泄漏
v2.1.101	修复 worktree 在会话崩溃时被删除、SSH 环境下 `/remote-control` 失败等问题
v2.1.110	远端支持 `/autocompact`、`/context`、`/exit`、`/reload-plugins` 命令
v2.1.110	Push notifications：Claude 可向手机推送通知（需在 `/config` 中启用 “Push when Claude decides”）
v2.1.113	修复子智能体执行过程不在远端实时显示的问题（subagent streaming）
v2.1.113	修复会话退出时未正确归档导致重启后丢失的问题
v2.1.116	远端支持 `@`-file 自动补全和 `/usage-credits` 命令
v2.1.118-119	修复 JWT 刷新期间会话被意外归档的稳定性问题
v2.1.121+	`effort.level` 在远端会话中可用；`worktree.baseRef` 控制并发 worktree 分叉来源
v2.1.133	`parentSettingsBeha vior` 影响企业环境下的 RC 启用策略（参见 09-企业实战指南）

其中 Push notifications 需要额外配置：

手机安装 Claude App（iOS / Android）
在 Claude Code 中执行 /config
启用 “Push when Claude decides”
确保手机和 CLI 使用同一账号

启用后，Claude 在 Remote Control 会话中有重要输出时会主动推送通知到手机。

10. 典型使用场景

场景 1：离开工位后继续监控长任务

在终端中执行：

claude --remote-control "deploy-watch"

然后在手机上继续：

查看 Claude 的执行进度
补充新的指令
在沙发上继续关注结果

场景 2：本地项目必须在线，但需要更换设备

例如：

本地已有浏览器登录态
本地挂着 MCP
本地项目环境较复杂

此时使用 Web 新开会话会丢失环境，而使用 Remote Control 则不会。

11. 常见问题

Q1：Remote Control 会将我的代码上传到云端吗？

不会。并非按“云端沙箱执行”的方式上传代码。会话仍运行在本地机器上，远端界面仅为连接窗口。

Q2：API key 登录能使用吗？

不能。当前官方要求使用 claude.ai 登录。

Q3：Remote Control 和 /mobile 是什么关系？

/mobile 仅用于下载 Claude 手机 App；真正开启远程接管的是 /remote-control 或对应的 CLI 入口。

Q4：我已经在会话中，还能临时开启吗？

可以，直接执行：

/remote-control

Q5：它能替代 Cloud / Desktop scheduled tasks 吗？

不能。Remote Control 适用于“继续一个正在运行的本地会话”，并非长期持久调度系统。

Q6：Ultraplan 模式下能使用 Remote Control 吗？

不能。官方文档明确说明 Ultraplan 会断开 Remote Control。如需远程监控，请避免在 Remote Control 会话中使用 Ultraplan。

Q7：网络不稳定会怎样？

短暂断网会自动重连（包括笔记本合盖或休眠）。但如果网络中断超过约 10 分钟，会话会超时断开。

Q8：能同时开启多个 Remote Control 会话吗？

在 server mode（claude remote-control）下可以，受 --capacity 限制（默认 32）。但在交互模式（claude --remote-control）下，每个交互进程只能有一个 remote session。

12. 实用速查

# 独立 server mode
claude remote-control
# 交互模式直接开启 Remote Control
claude --remote-control
# 交互中临时开启
/remote-control
# 为会话命名
/remote-control release-monitor
# v2.1.92+：默认会话名带 hostname 前缀；可用 --remote-control-session-name-prefix 覆盖（参数挂载在哪个子命令上以 claude --help 为准）
# 所有会话自动开启 Remote Control（在 /config 中设置）
/config
# 查看登录状态和订阅信息
/status
# 手机 App 下载二维码
/mobile