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 设置的标题如果您没有设置明确的名称,则发送后标题会更新以反映您的提示。如果环境已经有一个活动会话,系统会询问您是继续还是开始一个新会话。如果您没有 Claud