Appearance
Remote Control：随时随地控制你的本地 Claude 会话
Remote Control 把 claude.ai/code 或 Claude 手机 App 连接到你本机运行的 Claude Code 会话。离开桌面后可以继续本地工作——文件系统、MCP 服务器、工具全程在你自己机器上运行，数据不上传云端。支持 CLI 三种启动方式（服务器模式、交互模式、会话内命令）和 VS Code 扩展；多端实时同步，网络恢复后自动重连。
出门在外，但 Claude 还在跑着任务？Remote Control 让你用手机或任何浏览器连接到本地正在运行的 Claude Code 会话。
Remote Control 需要 Claude Code v2.1.51 或更高版本，用
claude --version查看。
它是什么？能做什么？
Remote Control 把 claude.ai/code 或 Claude 手机 App（iOS/Android）连接到你本机运行的 Claude Code 会话。关键点：Claude 全程在本地跑，不会把你的代码上传到云端。
你可以：
- 完整使用本地环境：文件系统、MCP 服务器、工具、项目配置全都可用
- 多端同步：终端、浏览器、手机可以同时操作，消息实时同步
- 断网恢复：网络中断或电脑休眠后，重新连接时会话自动恢复
这与 Claude Code on the web 不同：后者跑在 Anthropic 的云服务器上，Remote Control 始终跑在你的机器上。
使用前提
- 订阅：Pro、Max、Team、Enterprise 均支持；API key 不支持
- Team/Enterprise 需要管理员在 Claude Code 管理设置 中开启 Remote Control
- 登录：在项目目录运行过
claude并完成/login登录 - 工作区信任：在项目目录至少运行过一次
claude，接受工作区信任对话框
启动方式
可以从 CLI 或 VS Code 扩展启动 Remote Control。
方式一：服务器模式（推荐用于长时间远程）
bash
cd your-project
claude remote-control进程持续运行在终端，等待远程连接。终端会显示会话 URL，按空格键可显示二维码，方便手机扫码。
完整参数说明：
| 参数 | 说明 |
|---|---|
--name "我的项目" | 设置会话名称，在 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 | 开启或关闭文件系统和网络沙箱隔离 |
方式二：交互模式（边本地边远程）
bash
claude --remote-control
# 或带名称
claude --remote-control "我的项目"
# 简写
claude --rc "我的项目"开启一个普通交互会话，同时可以远程控制。和服务器模式的区别：你可以在本地终端直接输入，远程也可以输入，两端互通。
方式三：从现有会话开启
已经在 Claude 会话中了？直接输入：
text
/remote-control 我的项目会话历史保留，同时开始接受远程连接。注意：此方式不支持 --verbose、--sandbox、--no-sandbox 参数。
方式四：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：终端显示的会话 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 显示下载二维码。
为所有会话默认开启 Remote Control
不想每次手动加 --remote-control？在 Claude Code 里运行 /config，找到 Enable Remote Control for all sessions 设为 true。
开启后，每个交互式 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 服务器 | 可用 | 不可用 |
| 适合场景 | 离开桌面后继续本地工作 | 无需本地环境，直接启动新任务或并行多任务 |
限制
- 每个进程一个远程会话：交互模式下，一个 Claude Code 进程只支持一个远程会话。要同时运行多个，用服务器模式 +
--spawn - 终端不能关：Remote Control 是本地进程，关终端或退出 VS Code 就等于结束会话
- 网络中断 10 分钟以上：会话超时退出，重新运行
claude remote-control - Ultraplan 冲突：启动 ultraplan 会断开当前 Remote Control 会话，因为两者都需要占用 claude.ai/code 界面，只能同时存在一个
故障排查
"Remote Control requires a claude.ai subscription"
未用 claude.ai 账号登录。运行 claude auth login 选择 claude.ai 登录方式。如果环境变量中设置了 ANTHROPIC_API_KEY，先取消设置。
"Remote Control requires a full-scope login token"
你使用了 claude setup-token 或 CLAUDE_CODE_OAUTH_TOKEN 环境变量设置的长期 token，这类 token 仅限推理用途，无法建立 Remote Control 会话。运行 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 管理员未开启（联系管理员在 admin-settings 开启 Remote Control 开关，这是服务端组织设置，不是 managed settings 配置键）
- 管理员面板中开关显示为灰色：组织有数据保留/合规配置不兼容 Remote Control，无法从管理面板更改，需联系 Anthropic 支持
"Remote credentials fetch failed"
加 --verbose 重新运行查看详细错误：
bash
claude remote-control --verbose常见原因：未登录 claude.ai 账号、防火墙拦截出向 HTTPS 请求（需要放通 443 端口）、订阅不活跃。
跨设备工作方式对比
| 方式 | 触发 | Claude 运行在 | 最适合 |
|---|---|---|---|
| Dispatch | 手机发送任务 | 本机（Desktop） | 离开时委托任务 |
| Remote Control | 从浏览器/手机驱动运行中的会话 | 本机（CLI/VS Code） | 从其他设备继续当前工作 |
| Channels | Telegram/Discord 等推送事件 | 本机（CLI） | 响应外部事件 |
| Slack | 在团队频道 @Claude | Anthropic 云 | 团队协作 PR 审查 |
| 定时任务 | 定时触发 | 本机或云 | 每日 PR 审查等重复性任务 |
相关文档
常见问题
Q: Remote Control 和 Claude Code on the web 有什么区别？
Remote Control 的 Claude 在你自己机器上运行，能访问本地文件、MCP 服务器和工具。Claude Code on the web 在 Anthropic 云服务器上运行，无法访问本地环境。选择标准：有本地任务要继续 → Remote Control；不需要本地环境或要并行多任务 → on the web。
Q: --spawn worktree 和 --spawn same-dir 有什么差别？
same-dir 是默认模式，所有远程会话共用同一个工作目录，适合单人独占使用。worktree 给每个远程会话创建独立的 git worktree，多人同时连接时不会产生文件冲突，需要 git 仓库。运行时按 w 可以在两者之间切换。
Q: 使用 API key 能用 Remote Control 吗？
不能。Remote Control 需要 claude.ai OAuth 认证（Pro/Max/Team/Enterprise 订阅），不支持 API key 或 Console 账号的推理专用 token。运行 claude auth login 并选择 claude.ai 登录方式即可。