Claude Code Remote Control 指南

什么是 Remote Control

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

核心特点:

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

Remote Control vs Claude Code on the Web

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

使用建议:

已在终端里干了一半活,想躺沙发继续 → Remote Control
想新开一个云端任务,不依赖本地环境 → Claude Code on the Web

使用前提

系统要求:

Claude Code v2.1.51+
使用 claude.ai 登录（不是 API key 模式）
Team/Enterprise 需要管理员先启用 Remote Control

支持的订阅计划: Pro、Max、Team、Enterprise

检查清单:

# 检查版本
claude --version

# 检查登录状态
/login

# 确认已在项目目录启动过 claude
claude

三种启动方式

方式一: 独立服务器模式

claude remote-control

特点:

在当前终端进入 server mode
显示一个会话 URL
可以按空格显示二维码
等待你从别的设备连接

常用参数:

# 给会话命名
claude remote-control --name "My Project"

# 启用详细日志
claude remote-control --verbose

# 启用沙箱
claude remote-control --sandbox

# 使用 worktree 模式
claude remote-control --spawn worktree

# 设置最大并发会话数
claude remote-control --capacity 10

运行时操作:

按 w 键在 same-dir 和 worktree 之间实时切换
按空格显示二维码

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

claude --remote-control
# 或
claude --rc

特点:

可以继续在本地终端里正常聊天
同时又能从远端设备控制同一个会话

方式三: 在已运行会话里临时开启

/remote-control

# 或给会话命名
/remote-control Auth Fix Session

特点:

把当前会话历史一起带过去
展示会话 URL 和 QR 码
适合正在做一半才决定"我要换设备继续"

从别的设备连接

三种连接方式:

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

会话标题

优先级:

--name / --remote-control / /remote-control 传入的名字
/rename 设置的名字
最近一条有意义的消息
自动生成的名字（v2.1.92+ 默认带 hostname 前缀）

推荐做法:

/rename monorepo-auth-fix

并发模式

same-dir

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

适用场景: 多设备继续同一任务

worktree

每个并发会话单独一个 git worktree
更适合并行任务
需要 git 仓库

适用场景: 多线程工作台

session

每个并发会话独立隔离
不依赖 git
适合不在 git 仓库中的项目

运行时切换

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

远端可用命令

远端可用 (手机/浏览器都能执行):

/compact - 压缩上下文
/clear - 清空会话
/context - 查看上下文
/usage - 查看使用情况
/exit - 退出会话
/extra-usage - 查看额外使用情况
/recap - 回顾会话
/reload-plugins - 重新加载插件
/autocompact - 自动压缩

仅本地 (必须在终端操作):

/mcp - MCP 管理
/plugin - 插件管理
/resume - 恢复会话

注意: 不能在手机上装插件或恢复旧会话,但日常的上下文管理和监控都能远程完成。

安全与权限

安全边界

关键点:

远端只是入口,真正执行操作的还是你本地机器
Remote Control 继承本地会话的文件、工具和 MCP 能力
允许谁连入,比"界面在哪"更重要

传输安全

安全架构:

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

建议做法

涉及高风险仓库时,优先配合 sandbox
高风险任务不要顺手开 bypassPermissions
给 Remote Control 会话显式命名,避免误连错会话

Team/Enterprise 常见问题

常见报错

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

排查顺序

确认你不是 API key 登录
确认管理员已经打开 Claude Code 后台里的 Remote Control 开关
确认当前项目已接受 workspace trust
检查是否设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_TELEMETRY 环境变量
用 /status 确认当前登录方式和订阅状态

托管策略

v2.1.92+ 引入 forceRemoteSettingsRefresh 策略:

开启后,CLI 在成功拉取到最新远程托管设置之前不会启动
若拉取失败则直接退出 (fail-closed)

版本增强

v2.1.92 之后的重要增强:

| 版本 | 增强 | |------|------| | 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 可向手机推送通知 | | v2.1.113 | 修复子智能体执行过程不在远端实时显示的问题 | | v2.1.113 | 修复会话退出时未正确归档导致重启后丢失的问题 | | v2.1.116 | 远端支持 @-file 自动补全和 /extra-usage 命令 | | v2.1.118-119 | 修复 JWT 刷新期间会话被意外归档的稳定性问题 |

Push Notifications 配置

启用步骤:

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

效果: Claude 在 Remote Control 会话中有重要输出时会主动推送通知到手机。

典型使用场景

场景 1: 离开工位继续盯一个长任务

# 在终端里
claude --remote-control "deploy-watch"

# 然后去手机上继续:
# - 看 Claude 跑到哪一步
# - 补一句新的指令
# - 在沙发上继续盯结果

场景 2: 本地项目必须在线,但你要换设备

适用情况:

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

解决方案: 用 Remote Control 就不会丢环境

场景 3: 多设备协作

# 在办公室电脑上
claude remote-control --name "Team Project"

# 团队成员可以从各自设备连接:
# - 手机查看进度
# - 平板补充指令
# - 笔记本继续开发

常见问题

Q: Remote Control 会把我的代码上传到云端吗?

不会。会话仍运行在你的本地机器上,远端界面只是连接窗口。

Q: API key 登录能用吗?

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

Q: Remote Control 和 /mobile 是什么关系?

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

Q: 我已经在会话里了,还能临时开吗?

可以,直接执行 /remote-control。

Q: 它能替代 Cloud/Desktop scheduled tasks 吗?

不能。Remote Control 适合"继续一个正在运行的本地会话",不是长期持久调度系统。

Q: Ultraplan 模式下能用 Remote Control 吗?

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

Q: 网络不稳定会怎样?

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

Q: 能同时开多个 Remote Control 会话吗?

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

Q: 如何查看当前所有 Remote Control 会话?

在 claude.ai/code 或手机 App 的会话列表中可以看到所有活跃的 Remote Control 会话。

Q: 如何关闭 Remote Control?

在终端按 Ctrl+C 停止 server mode
在远端界面执行 /exit
关闭终端会自动断开连接

实用速查

启动命令

# 独立 server mode
claude remote-control

# 交互模式直接开 Remote Control
claude --remote-control

# 交互中临时开启
/remote-control

# 给会话命名
/remote-control release-monitor

# 使用 worktree 模式
claude remote-control --spawn worktree

# 启用沙箱
claude remote-control --sandbox

# 设置最大并发数
claude remote-control --capacity 10

会话管理

# 重命名会话
/rename my-session-name

# 查看登录状态和订阅信息
/status

# 手机 App 下载二维码
/mobile

# 配置 Remote Control
/config

远端可用命令

/compact          # 压缩上下文
/clear            # 清空会话
/context          # 查看上下文
/usage            # 查看使用情况
/exit             # 退出会话
/extra-usage      # 查看额外使用情况
/recap            # 回顾会话
/reload-plugins   # 重新加载插件
/autocompact      # 自动压缩

最佳实践

1. 会话命名规范

# 使用描述性名称
claude remote-control --name "frontend-refactor"

# 包含项目和任务信息
claude remote-control --name "myapp-deploy-prod"

# 使用 /rename 动态调整
/rename auth-bug-fix-session

2. 安全配置

# 高风险项目启用沙箱
claude remote-control --sandbox

# 限制并发会话数
claude remote-control --capacity 5

# 使用 worktree 隔离并发任务
claude remote-control --spawn worktree

3. 网络优化

确保稳定的网络连接
避免在网络不稳定时执行关键操作
使用有线网络代替 Wi-Fi（如果可能）

4. 团队协作

# 为团队项目创建命名会话
claude remote-control --name "team-sprint-planning"

# 使用 worktree 避免冲突
claude remote-control --spawn worktree --capacity 10

# 定期检查会话状态
/status

5. 移动端使用

在手机上安装 Claude App
启用 Push Notifications 接收重要通知
使用 /recap 快速了解会话进度
使用 /context 查看当前上下文

故障排查

问题 1: 无法启动 Remote Control

可能原因:

未使用 claude.ai 登录
订阅计划不支持
Team/Enterprise 未启用

解决方案:

# 检查登录状态
/status

# 重新登录
/login

# 检查版本
claude --version

问题 2: 远端设备无法连接

可能原因:

网络问题
会话已过期
URL 错误

解决方案:

重新生成 QR 码（按空格）
检查网络连接
重启 Remote Control

问题 3: 会话意外断开

可能原因:

网络中断超过 10 分钟
本地机器休眠
JWT 刷新失败

解决方案:

确保网络稳定
避免长时间休眠
升级到 v2.1.118+ 版本

问题 4: 远端命令不可用

可能原因:

命令仅限本地执行
版本不支持

解决方案:

查看远端可用命令列表
升级到最新版本
在本地终端执行该命令

性能优化

1. 减少延迟

使用有线网络
选择地理位置较近的服务器
避免在高峰时段使用

2. 优化并发

# 根据实际需求设置并发数
claude remote-control --capacity 5

# 使用 worktree 避免文件冲突
claude remote-control --spawn worktree

3. 上下文管理

# 定期压缩上下文
/compact

# 启用自动压缩
/autocompact

# 清理不需要的会话
/clear

总结

通过本指南,你已经掌握了:

Remote Control 概念 - 理解远程控制的工作原理
三种启动方式 - 独立 server、交互模式、临时开启
从别的设备连接 - URL、QR 码、会话列表
并发模式 - same-dir、worktree、session
远端可用命令 - 了解哪些命令可以远程执行
安全与权限 - 理解安全边界和最佳实践
Team/Enterprise 配置 - 解决常见启用问题
典型使用场景 - 实际应用案例
故障排查 - 解决常见问题
性能优化 - 提升使用体验

下一步学习:

Channels 与计划任务
高级企业集成
自定义工作流

参考资源

更新日期: 2026年4月29日
适用版本: Claude Code v2.1.119+

Claude Code Remote Control 指南

分享这篇文章