Claude Code Remote Control：怎么用手机/浏览器远程控制本地会话

Remote Control 让手机或浏览器连接到本机运行的 Claude Code 会话。在终端启动服务器模式后，扫码或打开会话 URL 即可控制，所有数据留在本地。支持 v2.1.51 及以上版本，Team/Enterprise 需管理员先在 claude.ai 管理设置中开启。断网约 10 分钟后会话超时退出，需重新启动。

出门在外，但 Claude 还在跑着任务？Remote Control 让你用手机或任何浏览器连接到本地正在运行的 Claude Code 会话，全程本地执行，不上传云端。

Remote Control 需要 Claude Code v2.1.51 或更高版本，用 claude --version 查看。

使用前提

订阅：Pro、Max、Team、Enterprise 均支持；API key 不支持
Team/Enterprise 需管理员在 Claude Code 管理设置中开启 Remote Control 开关
登录：在项目目录运行过 claude 并完成 /login 登录
工作区信任：在项目目录至少运行过一次 claude，接受工作区信任对话框

怎么启动 Remote Control 会话

可以在 CLI 或 VS Code 扩展中启动。CLI 有三种方式，VS Code 使用 /remote-control 命令。

1. 服务器模式（推荐长时间远程）

cd your-project
claude remote-control

进程持续运行在终端，等待远程连接。终端显示会话 URL，按空格键可显示二维码，方便手机扫码。

参数	说明
`--name "My Project"`	设置会话名称，在 claude.ai/code 会话列表中显示
`--remote-control-session-name-prefix <前缀>`	未设置名称时的自动命名前缀，默认用主机名，生成类似 `myhost-graceful-unicorn` 的名称。也可通过环境变量 `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` 设置
`--spawn <mode>`	会话创建方式：`same-dir`（默认）所有会话共享当前目录；`worktree` 每个会话独享 git worktree（需要 git 仓库）；`session` 单会话模式。运行时按 `w` 键可在 `same-dir` 和 `worktree` 之间切换
`--capacity <N>`	最大并发会话数，默认 32，不能与 `--spawn=session` 同时使用
`--verbose`	显示详细连接和会话日志
`--sandbox` / `--no-sandbox`	开启或关闭文件系统和网络沙箱隔离。默认关闭

2. 交互模式（边本地边远程）

claude --remote-control
# 或带名称
claude --remote-control "My Project"
# 简写
claude --rc "My Project"

与服务器模式的区别：本地终端可同时输入，两端互通。

3. 从现有会话开启

已经在 Claude Code 会话中，直接输入：

/remote-control My Project

会话历史保留，同时开始接受远程连接。注意：此方式不支持 --verbose、--sandbox、--no-sandbox 参数。

4. VS Code 扩展

在 Claude Code VS Code 扩展中，在提示框输入 /remote-control 或 /rc，或输入 / 打开命令菜单。需要 Claude Code v2.1.79 或更高版本。

提示框上方出现连接状态横幅。连接后点击横幅中的 Open in browser 跳转到会话，或在 claude.ai/code 会话列表找到。再次运行 /remote-control 或点击横幅关闭按钮可断开连接。

VS Code 模式不支持名称参数，也不显示二维码。会话标题由对话历史或第一条提示自动生成。

从其他设备连接的方法

启动 Remote Control 后，有三种连接方式：

直接访问会话 URL：任意浏览器打开，进入 claude.ai/code 对应会话
扫二维码：claude remote-control 启动后按空格键显示二维码，手机扫码直接打开 Claude App
在 claude.ai/code 找会话：打开 claude.ai/code 或 Claude App，在会话列表找到名称（在线时显示绿色圆点）

会话名称命名优先级：

--name、--remote-control 或 /remote-control 传入的名称
用 /rename 设置的标题
现有对话历史中最后一条有意义的消息
自动生成的名称如 myhost-graceful-unicorn（myhost 是主机名或自定义前缀）

发送第一条提示后，未设置名称的会话标题会自动更新。

还没装 Claude 手机 App？在 Claude Code 里运行 /mobile 显示下载二维码（iOS / Android）。

为所有会话默认开启 Remote Control

在 Claude Code 里运行 /config，找到 Enable Remote Control for all sessions 设为 true。在桌面 App 中可通过 Settings → Claude Code → Enable remote control by default 切换。

开启后，每个交互式 Claude Code 进程注册一个远程会话。多个实例各自独立。要从单个进程运行多个并发会话，使用服务器模式。

连接安全性

Claude Code 只发出出向 HTTPS 请求，不在本机开放端口
所有流量通过 Anthropic API 走 TLS 加密
使用多个短生命周期凭证，每个独立过期

Remote Control vs Claude Code on the web

	Remote Control	Claude Code on the web
运行位置	你的本机	Anthropic 云服务器
本地文件	可访问	不可访问
本地 MCP 服务器	可用	不可用
适合场景	离开桌面后继续本地工作	无需本地环境，开始新任务或并行多任务

移动推送通知

当 Remote Control 激活时，Claude 可向手机发送推送通知。Claude 自主决定推送时机（如长任务完成或需要你决策时）。你也可以在提示中要求，例如 notify me when the tests finish。除下方总开关外，没有逐事件配置。

推送通知需要 Claude Code v2.1.110 或更高版本。

设置步骤：

下载 Claude App（iOS / Android）
使用与终端 Claude Code 相同的账号和组织
接受系统通知权限
在终端运行 /config，开启 Push when Claude decides

如通知未收到：

/config 显示 No mobile registered：打开手机 Claude App 刷新推送令牌，下次 Remote Control 连接时清除警告
iOS：专注模式和通知摘要可能抑制/延迟推送，检查 设置 → 通知 → Claude
Android：激进电池优化可能延迟送达，在系统设置中将 Claude App 加入电池优化白名单

限制

每个进程一个远程会话：交互模式下，一个 Claude Code 进程只支持一个远程会话。要用多个并发会话，使用服务器模式 + --spawn
终端不能关：Remote Control 是本地进程，关终端或退出 VS Code 即结束会话
网络中断超时：机器在网但无法连接网络超过约 10 分钟，会话超时退出，需重新运行 claude remote-control
Ultraplan 冲突：启动 ultraplan 会断开当前 Remote Control 会话，因为两者都需要占用 claude.ai/code 界面
部分命令仅本地可用：含交互选择器的命令（如 /mcp、/plugin、/resume）只能在本地 CLI 使用；输出文本的命令（如 /compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins）从手机/Web 可用

故障排查

“Remote Control requires a claude.ai subscription”

未用 claude.ai 账号登录。运行 claude auth login 选择 claude.ai 登录方式。如果环境变量中设置了 ANTHROPIC_API_KEY，先取消设置。

你使用了 claude setup-token 或 CLAUDE_CODE_OAUTH_TOKEN 环境变量的长期 token，仅限推理用途。运行 claude auth login 改用完整权限的会话 token。

“Unable to determine your organization for Remote Control eligibility”

账号缓存信息过期。运行 claude auth login 刷新。

“Remote Control is not yet enabled for your account”

检查环境变量：CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、DISABLE_TELEMETRY、CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX、CLAUDE_CODE_USE_FOUNDRY。Remote Control 需要 claude.ai 认证，不兼容第三方云服务商。清掉这些变量后，运行 /logout 再 /login。

“Remote Control is disabled by your organization’s policy”

先运行 /status 确认登录方式和订阅。不同原因对应不同解决：

用 API key 或 Console 账号登录：需要切换到 claude.ai OAuth。运行 /login，检查环境变量中是否存在 ANTHROPIC_API_KEY 并取消设置
Team/Enterprise 管理员未开启：管理员在 Claude Code 管理设置中开启 Remote Control 开关（服务端组织设置，不是 managed settings 配置键）
管理员面板开关灰色：组织有数据保留/合规配置不兼容 Remote Control，无法从管理面板更改，需联系 Anthropic 支持
错误信息包含 disableRemoteControl：IT 管理员已通过 managed settings 在本机禁用 Remote Control，不受组织级开关影响

“Remote credentials fetch failed”

加 --verbose 重新运行查看详细错误：

claude remote-control --verbose

常见原因：未登录 claude.ai 账号、防火墙拦截出向 HTTPS 请求（需放通 443 端口）、订阅不活跃。若同时看到 Session creation failed — see debug log，说明早期设置失败，检查订阅是否有效。

跨设备工作方式对比

Claude Code 提供了多种不在终端时的使用方式，区别在于触发方式、运行位置和设置需求。

方式	触发	Claude 运行在	设置	最适合
Dispatch	手机发送任务	本机（Desktop）	手机 App 与 Desktop 配对	离开时委托任务
Remote Control	从浏览器/手机驱动运行中的会话	本机（CLI/VS Code）	运行 `claude remote-control`	从其他设备继续当前工作
Channels	Telegram/Discord 等推送事件	本机（CLI）	安装频道插件或自行构建	响应外部事件（如 CI 失败）
Slack	在团队频道 @Claude	Anthropic 云	安装 Slack App 并启用 Claude Code on the web	PR 审查和团队协作
定时任务	设置时间表	本机/Desktop/云	选择频率	每日 PR 审查等重复性自动化

常见问题

Remote Control 需要什么条件才能用？

需要 Pro/Max/Team/Enterprise 订阅（不支持 API key），在项目目录运行过 claude 并完成 /login 登录，至少接受一次工作区信任对话框。Team/Enterprise 还需要管理员在 claude.ai 管理设置中开启 Remote Control 开关。

启动 Remote Control 后怎么从手机连接？

终端会显示会话 URL，复制到任意浏览器打开即可。claude remote-control 模式下按空格键显示二维码，用手机相机或 Claude App 扫码直接进入。也可以打开 claude.ai/code 或 Claude App 在会话列表中找到对应名称的会话（在线时显示绿色圆点）。

Remote Control 和 Claude Code on the web 有什么区别？

Remote Control 的 Claude 在你本机运行，能访问本地文件、MCP 服务器和项目配置；Claude Code on the web 在 Anthropic 云服务器运行，无法访问本地环境。选择标准：离开桌面后要继续本地工作用 Remote Control；不需要本地环境或要并行启动多个任务用 Claude Code on the web。

Claude Code Remote Control：怎么用手机/浏览器远程控制本地会话 #

使用前提 #

怎么启动 Remote Control 会话 #

1. 服务器模式（推荐长时间远程） #

2. 交互模式（边本地边远程） #

3. 从现有会话开启 #

4. VS Code 扩展 #

从其他设备连接的方法 #

为所有会话默认开启 Remote Control #

连接安全性 #

Remote Control vs Claude Code on the web #

移动推送通知 #

限制 #

故障排查 #

“Remote Control requires a claude.ai subscription” #

“Remote Control requires a full-scope login token” #

“Unable to determine your organization for Remote Control eligibility” #

“Remote Control is not yet enabled for your account” #

“Remote Control is disabled by your organization’s policy” #

“Remote credentials fetch failed” #

跨设备工作方式对比 #

相关资源 #

常见问题 #

Remote Control 需要什么条件才能用？ #

启动 Remote Control 后怎么从手机连接？ #

Remote Control 和 Claude Code on the web 有什么区别？ #