使用 Remote Control 从任何设备继续本地会话

使用 Remote Control 从您的手机、平板电脑或任何浏览器继续本地 Claude Code 会话。适用于 claude.ai/code 和 Claude 移动应用。

ℹ️ Remote Control 处于研究预览阶段，在所有计划中都可用。在 Team 和 Enterprise 上，在管理员在 Claude Code 管理员设置中启用 Remote Control 切换之前，它默认处于关闭状态。

Remote Control 将 claude.ai/code 或 Claude 应用（iOS 和 Android）连接到在您的机器上运行的 Claude Code 会话。在您的办公桌上启动一个任务，然后从沙发上的手机或另一台计算机上的浏览器继续。

当您在机器上启动 Remote Control 会话时，Claude 始终在本地运行，因此没有任何内容移动到云端。使用 Remote Control，您可以：

远程使用您的完整本地环境：您的文件系统、MCP servers、工具和项目配置都保持可用，输入 @ 会自动完成本地项目中的文件路径
同时从两个界面工作：对话在所有连接的设备上保持同步，因此您可以从终端、浏览器和手机交替发送消息
在中断后恢复：如果您的笔记本电脑进入睡眠状态或网络断开，当您的机器重新上线时，会话会自动重新连接

与网络上的 Claude Code（在云基础设施上运行）不同，Remote Control 会话直接在您的机器上运行并与您的本地文件系统交互。网络和移动界面只是该本地会话的一个窗口。

ℹ️ Remote Control 需要 Claude Code v2.1.51 或更高版本。使用 claude --version 检查您的版本。

本页涵盖设置、如何启动和连接到会话，以及 Remote Control 与网络上的 Claude Code 的比较。

要求

在使用 Remote Control 之前，请确认您的环境满足以下条件：

订阅：在 Pro、Max、Team 和 Enterprise 计划中可用。不支持 API 密钥。在 Team 和 Enterprise 上，管理员必须首先在 Claude Code 管理员设置中启用 Remote Control 切换。
身份验证：运行 claude 并使用 /login 通过 claude.ai 登录（如果您还没有登录）。
工作区信任：在您的项目目录中至少运行一次 claude 以接受工作区信任对话框。

启动 Remote Control 会话

您可以从 CLI 或 VS Code 扩展启动 Remote Control 会话。CLI 提供三种调用模式；VS Code 使用 /remote-control 命令。

服务器模式

导航到您的项目目录并运行：

claude remote-control

该进程在您的终端中以服务器模式保持运行，等待远程连接。它显示一个会话 URL，您可以使用该 URL 从另一个设备连接，您可以按空格键显示 QR 码以从手机快速访问。当远程会话处于活动状态时，终端显示连接状态和工具活动。

可用标志：

标志	描述
`--name "My Project"`	设置自定义会话标题，在 claude.ai/code 的会话列表中可见。
`--remote-control-session-name-prefix <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`	启用或禁用沙箱以进行文件系统和网络隔离。默认关闭。

交互式会话

要启动启用了 Remote Control 的普通交互式 Claude Code 会话，请使用 --remote-control 标志（或 --rc）：

claude --remote-control

可选地为会话传递一个名称：

claude --remote-control "My Project"

这为您提供了一个完整的交互式会话在您的终端中，您也可以从 claude.ai 或 Claude 应用控制。与 claude remote-control（服务器模式）不同，您可以在会话也可远程使用时在本地输入消息。

从现有会话

如果您已经在 Claude Code 会话中并想远程继续它，请使用 /remote-control（或 /rc）命令：

/remote-control

传递一个名称作为参数以设置自定义会话标题：

/remote-control My Project

这启动一个 Remote Control 会话，该会话继承您当前的对话历史记录，并显示一个会话 URL 和 QR 码，您可以使用它从另一个设备连接。--verbose、--sandbox 和 --no-sandbox 标志不适用于此命令。

VS Code

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

/remote-control

提示框上方会出现一个横幅，显示连接状态。连接后，单击横幅中的在浏览器中打开直接转到会话，或在 claude.ai/code 的会话列表中找到它。会话 URL 也会发布在对话中。

要断开连接，请单击横幅上的关闭图标或再次运行 /remote-control。

与 CLI 不同，VS Code 命令不接受名称参数或显示 QR 码。会话标题从您的对话历史记录或第一条提示派生。

从另一个设备连接

一旦 Remote Control 会话处于活动状态，您有几种方式从另一个设备连接：

打开会话 URL 在任何浏览器中直接转到 claude.ai/code 上的会话。
扫描 QR 码 显示在会话 URL 旁边，直接在 Claude 应用中打开它。使用 claude remote-control 时，按空格键切换 QR 码显示。
打开 claude.ai/code 或 Claude 应用 并在会话列表中按名称查找会话。Remote Control 会话在在线时显示带有绿色状态点的计算机图标。

远程会话标题按以下顺序选择：

您传递给 --name、--remote-control 或 /remote-control 的名称
您使用 /rename 设置的标题
现有对话历史记录中的最后一条有意义的消息
自动生成的名称，如 myhost-graceful-unicorn，其中 myhost 是您的机器的主机名或您使用 --remote-control-session-name-prefix 设置的前缀

如果您没有设置显式名称，一旦您发送提示，标题会更新以反映您的提示。

如果环境已经有活动会话，您将被询问是否继续它或启动新会话。

如果您还没有 Claude 应用，请在 Claude Code 中使用 /mobile 命令显示 iOS 或 Android 的下载 QR 码。

为所有会话启用 Remote Control

默认情况下，Remote Control 仅在您显式运行 claude remote-control、claude --remote-control 或 /remote-control 时激活。要为每个交互式会话自动启用它，请在 Claude Code 中运行 /config 并将为所有会话启用 Remote Control 设置为 true。将其设置回 false 以禁用。

启用此设置后，每个交互式 Claude Code 进程注册一个远程会话。如果您运行多个实例，每个实例都获得自己的环境和会话。要从单个进程运行多个并发会话，请改用服务器模式。

连接和安全

您的本地 Claude Code 会话仅发出出站 HTTPS 请求，从不在您的机器上打开入站端口。当您启动 Remote Control 时，它向 Anthropic API 注册并轮询工作。当您从另一个设备连接时，服务器通过流连接在网络或移动客户端和您的本地会话之间路由消息。

所有流量都通过 Anthropic API 通过 TLS 传输，与任何 Claude Code 会话的传输安全相同。连接使用多个短期凭证，每个凭证的范围限定为单一目的并独立过期。

Remote Control 与网络上的 Claude Code 的比较

Remote Control 和网络上的 Claude Code都使用 claude.ai/code 界面。关键区别在于会话运行的位置：Remote Control 在您的机器上执行，因此您的本地 MCP servers、工具和项目配置保持可用。网络上的 Claude Code 在 Anthropic 管理的云基础设施中执行。

当您处于本地工作中间并想从另一个设备继续时，使用 Remote Control。当您想在没有任何本地设置的情况下启动任务、处理您没有克隆的存储库或并行运行多个任务时，使用网络上的 Claude Code。

移动推送通知

当 Remote Control 处于活动状态时，Claude 可以向您的手机发送推送通知。

Claude 决定何时推送。它通常在长时间运行的任务完成或需要您的决定来继续时发送一个。您也可以在提示中请求推送，例如 notify me when the tests finish。除了下面的开/关切换外，没有按事件配置。

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

要设置移动推送通知：

安装 Claude 移动应用：下载 Claude 应用（iOS 或 Android）。
使用您的 Claude Code 账户登录：使用您在终端中用于 Claude Code 的相同账户和组织。
允许通知：接受来自操作系统的通知权限提示。
在 Claude Code 中启用推送：在您的终端中，运行 /config 并启用当 Claude 决定时推送。

如果通知没有到达：

如果 /config 显示未注册移动设备，请在您的手机上打开 Claude 应用，以便它可以刷新其推送令牌。下次 Remote Control 连接时，警告会清除。
在 iOS 上，焦点模式和通知摘要可能会抑制或延迟推送。检查设置 → 通知 → Claude。
在 Android 上，激进的电池优化可能会延迟传递。在系统设置中将 Claude 应用从电池优化中豁免。

限制

每个交互式进程一个远程会话：在服务器模式之外，每个 Claude Code 实例一次支持一个远程会话。使用服务器模式从单个进程运行多个并发会话。
本地进程必须保持运行：Remote Control 作为本地进程运行。如果您关闭终端、退出 VS Code 或以其他方式停止 claude 进程，会话结束。
扩展网络中断：如果您的机器处于唤醒状态但无法在大约 10 分钟以上的时间内到达网络，会话超时并且进程退出。再次运行 claude remote-control 以启动新会话。
Ultraplan 断开 Remote Control：启动 ultraplan 会话会断开任何活动的 Remote Control 会话，因为两个功能都占据 claude.ai/code 界面，一次只能连接一个。
某些命令仅限本地：在终端中打开交互式选择器的命令，例如 /mcp、/plugin 或 /resume，仅从本地 CLI 工作。生成文本输出的命令，包括 /compact、/clear、/context、/usage、/exit、/extra-usage、/recap 和 /reload-plugins，可从移动和网络工作。

故障排除

”Remote Control 需要 claude.ai 订阅”

您未使用 claude.ai 账户进行身份验证。运行 claude auth login 并选择 claude.ai 选项。如果在您的环境中设置了 ANTHROPIC_API_KEY，请先取消设置它。

“Remote Control 需要完整范围的登录令牌”

您使用来自 claude setup-token 或 CLAUDE_CODE_OAUTH_TOKEN 环境变量的长期令牌进行身份验证。这些令牌仅限于推理，无法建立 Remote Control 会话。运行 claude auth login 以改用完整范围的会话令牌进行身份验证。

“无法确定您的组织以进行 Remote Control 资格检查”

您的缓存账户信息已过期或不完整。运行 claude auth login 以刷新它。

“Remote Control 尚未为您的账户启用”

在存在某些环境变量的情况下，资格检查可能会失败：

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 被您的组织的策略禁用”

此错误有三个不同的原因。首先运行 /status 以查看您使用的登录方法和订阅。

您使用 API 密钥或 Console 账户进行身份验证：Remote Control 需要 claude.ai OAuth。运行 /login 并选择 claude.ai 选项。如果在您的环境中设置了 ANTHROPIC_API_KEY，请取消设置它。
您的 Team 或 Enterprise 管理员尚未启用它：Remote Control 在这些计划上默认处于关闭状态。管理员可以在 claude.ai/admin-settings/claude-code 通过打开 Remote Control 切换来启用它。这是一个服务器端组织设置，不是仅管理设置密钥。
管理员切换呈灰色：您的组织有数据保留或合规配置与 Remote Control 不兼容。这无法从管理面板更改。请联系 Anthropic 支持以讨论选项。

“Remote credentials fetch failed”

Claude Code 无法从 Anthropic API 获取短期凭证以建立连接。使用 --verbose 重新运行以查看完整错误：

claude remote-control --verbose

常见原因：

未登录：运行 claude 并使用 /login 使用您的 claude.ai 账户进行身份验证。Remote Control 不支持 API 密钥身份验证。
网络或代理问题：防火墙或代理可能阻止出站 HTTPS 请求。Remote Control 需要访问端口 443 上的 Anthropic API。
会话创建失败：如果您还看到 Session creation failed — see debug log，失败发生在设置的早期。检查您的订阅是否处于活动状态。

选择正确的方法

Claude Code 提供了几种方式让您可以在远离终端时工作。它们的区别在于触发工作的方式、Claude 运行的位置以及您需要进行多少设置。

	触发	Claude 运行在	设置	最适合
Dispatch	从 Claude 移动应用发送任务消息	您的机器（Desktop）	将移动应用与 Desktop 配对	在远离时委派工作，最少设置
Remote Control	从 claude.ai/code 或 Claude 移动应用驱动正在运行的会话	您的机器（CLI 或 VS Code）	运行 `claude remote-control`	从另一个设备引导进行中的工作
Channels	从 Telegram 或 Discord 等聊天应用或您自己的服务器推送事件	您的机器（CLI）	安装频道插件或自己构建	对 CI 故障或聊天消息等外部事件做出反应
Slack	在团队频道中提及 `@Claude`	Anthropic 云	安装 Slack 应用并启用 Web 上的 Claude Code	来自团队聊天的 PR 和审查
计划任务	设置一个时间表	CLI、Desktop 或云	选择频率	每日审查等定期自动化

Claude Code 远程控制 - 手机 / 平板 / 浏览器继续本地会话