Remote Control
- 分组:一、官方文档
- 原始链接:https://code.claude.com/docs/en/remote-control
- 抓取来源:http://code.claude.com/docs/en/remote-control
- 原始文件:/Users/yuanruiqin/Desktop/知识库/ClaudeCode-系统化知识库/01-官方文档/14-remote-control.md
- 精读版生成时间:2026-04-05 13:50:44
中文精读版(去噪)
使用远程控制从任何设备继续本地会话 - Claude Code Docs
Claude Code Docs 主页!图片 1:光徽标!图2:黑暗标志
⌘K问AI
克劳德开发者平台 网络上的克劳德代码
平台和集成
使用远程控制从任何设备继续本地会话
入门与 Claude 一起构建代码部署管理配置参考什么新资源
开始使用
概述 快速入门 变更日志
核心概念
Claude Code 的工作原理 扩展克劳德代码 探索 .claude 目录 探索上下文窗口
使用克劳德代码
平台和集成
“远程控制需要 claude.ai 订阅” ”无法确定
平台和集成
使用远程控制从任何设备继续本地会话
使用远程控制从您的手机、平板电脑或任何浏览器继续本地 Claude Code 会话。可与 claude.ai/code 和 Claude 移动应用程序配合使用。
所有计划均提供远程控制。在团队和企业中,默认情况下它处于关闭状态,直到管理员在 Claude Code 管理设置 中启用远程控制切换。
远程控制将 claude.ai/code 或适用于 iOS 和 Android 的 Claude 应用程序连接到在您的计算机上运行的 Claude Code 会话。在办公桌上启动一项任务,然后从沙发上的手机或另一台计算机上的浏览器中获取该任务。当您在计算机上启动远程控制会话时,Claude 始终在本地运行,因此不会将任何内容转移到云端。通过远程控制,您可以: 远程使用完整的本地环境:您的文件系统、MCP 服务器、工具和项目配置均保持可用 同时在两个表面上工作:对话在所有连接的设备上保持同步,因此您可以从终端、浏览器和手机互换发送消息 避免中断:如果您的笔记本电脑处于睡眠状态或网络中断,会话会在您的计算机恢复在线时自动重新连接
与在云基础设施上运行的 Claude Code on the web 不同,远程控制会话直接在您的计算机上运行并与本地文件系统交互。 Web 和移动界面只是本地会话的一个窗口。
远程控制需要 Claude Code v2.1.51 或更高版本。使用“claude --version”检查您的版本。
本页介绍了设置、如何启动和连接到会话,以及远程控制与网络上的 Claude Code 的比较。
要求
在使用远程控制之前,请确认您的环境满足以下条件: 订阅:适用于 Pro、Max、Team 和 Enterprise 计划。不支持 API 密钥。在团队和企业中,管理员必须首先在 Claude Code 管理设置 中启用远程控制切换。 工作空间信任:在项目目录中运行“claude”至少一次以接受工作空间信任对话框。
启动远程控制会话
您可以启动专用的远程控制服务器、在启用远程控制的情况下启动交互式会话或连接已在运行的会话。
服务器模式 互动环节 来自现有会话
克劳德远程控制
该进程在您的终端中以服务器模式保持运行,等待远程连接。它显示可用于从其他设备连接的会话 URL,并且您可以按空格键显示二维码以便从手机快速访问。当远程会话处于活动状态时,终端会显示连接状态和工具活动。可用标志:
| 旗帜 | 描述 |
|---|---|
--name“我的项目” | 设置在 claude.ai/code 的会话列表中可见的自定义会话标题。 |
--remote-control-session-name-prefix <前缀> | 未设置显式名称时自动生成的会话名称的前缀。默认为您计算机的主机名,生成诸如“myhost-graceful-unicorn”之类的名称。设置“CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX”以获得相同的效果。 |
--spawn <模式> | 如何创建并发会话。在运行时按“w”进行切换。 • same-dir(默认):所有会话共享当前工作目录,因此如果编辑相同的文件,它们可能会发生冲突。 • worktree:每个按需会话都有自己的git worktree。需要 git 存储库。 |
--容量 <N> | 最大并发会话数。默认值为 32。 |
--详细 | 显示详细的连接和会话日志。 |
--sandbox / --no-sandbox | 启用或禁用沙盒以进行文件系统和网络隔离。默认关闭。 |
要在启用远程控制的情况下启动正常的交互式 Claude Code 会话,请使用 --remote-control 标志(或 --rc):
克劳德——远程控制
可以选择传递会话名称:
克劳德——远程控制“我的项目”
这为您在终端中提供了完整的交互式会话,您也可以通过 claude.ai 或 Claude 应用程序进行控制。与“克劳德远程控制”(服务器模式)不同,您可以在本地键入消息,同时也可以远程进行会话。
如果您已经处于 Claude Code 会话中并且想要远程继续,请使用“/remote-control”(或“/rc”)命令:
/远程控制
传递名称作为参数来设置自定义会话标题:
/远程控制我的项目
这将启动一个远程控制会话,该会话会继承您当前的对话历史记录,并显示可用于从其他设备连接的会话 URL 和 QR 代码。 --verbose、--sandbox 和 --no-sandbox 标志不适用于此命令。
从另一台设备连接
一旦远程控制会话处于活动状态,您可以通过多种方式从其他设备进行连接:
在任何浏览器中打开会话 URL,直接转到 claude.ai/code 上的会话。 claude remote-control 和 /remote-control 都在终端中显示此 URL。
扫描会话 URL 旁边显示的二维码,直接在 Claude 应用程序中打开它。使用“claude Remote-control”,按空格键可切换二维码显示。
打开 claude.ai/code 或 Claude 应用程序,然后在会话列表中按名称查找会话。在线时,远程控制会话会显示带有绿色状态点的计算机图标。
远程会话标题按以下顺序选择:
- 您传递给
--name、--remote-control或/remote-control的名称 - 通过
/rename设置的标题 - 现有对话历史中最后一条有意义的消息
- 自动生成的名称,例如“myhost-graceful-unicorn”,其中“myhost”是您计算机的主机名或使用“--remote-control-session-name-prefix”设置的前缀
如果您没有设置明确的名称,则发送后标题会更新以反映您的提示。如果环境已经有一个活动会话,系统会询问您是继续还是开始一个新会话。如果您没有 Claud