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

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

Remote Control 将 claude.ai/code 或适用于 iOS 和 Android 的 Claude 应用连接到你机器上运行的 Claude Code 会话。在办公桌前启动任务，然后在沙发上用手机或另一台电脑的浏览器继续处理。

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

• 远程使用完整的本地环境：你的文件系统、MCP 服务器、工具和项目配置都保持可用，输入 @ 时会自动补全本地项目的文件路径
• 同时在多个界面工作：对话在所有连接的设备间保持同步，因此你可以从终端、浏览器和手机交替发送消息
• 从手机或浏览器发送图片和文件：当你在 Claude 应用或 claude.ai/code 中添加附件时，Claude Code 会将其下载到你的机器，并以 @ 文件引用的形式传递给 Claude，无论是否带有标题。在 v2.1.202 之前，Claude Code 可能会丢弃未带标题的附件，使其无法到达会话。
• 抵御中断：如果你的笔记本进入睡眠或网络断开，会话会在机器重新联网后自动重连

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

本页面涵盖设置、如何启动和连接会话，以及 Remote Control 与 Claude Code on the web 的比较。

要求

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

• 订阅：适用于 Pro、Max、Team 和 Enterprise 套餐。不支持 API 密钥。在 Team 和 Enterprise 套餐中，Owner 必须首先在 Claude Code 管理设置 中启用 Remote Control 开关。
• 认证：如果你尚未登录，请运行 claude 并使用 /login 通过 claude.ai 登录。
• API 端点：在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。从 v2.1.196 开始，当 ANTHROPIC_BASE_URL 指向 api.anthropic.com 以外的主机（如 LLM 网关 或代理）时，Remote Control 也会被禁用。取消设置该变量以使用 Remote Control。
• 工作区信任：至少在你的项目目录中运行一次 claude，以接受工作区信任对话框。

启动 Remote Control 会话

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

claude remote-control

claude --remote-control

claude --remote-control "My Project"

/remote-control

/remote-control My Project

/remote-control

检查连接状态

在交互式终端会话中，连接建立时，/rc active 指示器位于输入框下方的页脚中，如果终端太窄无法容纳则会隐藏。指示器文本是指向 claude.ai 上会话的链接。使用向下箭头键选中它并按 Enter，或再次运行 /remote-control，即可打开状态面板，其中包含会话 URL 和可用于 从其他设备连接 的二维码。

如果连接失败，会出现带有失败原因的通知，指示器会从页脚中消失。再次运行 /remote-control 以重试。

从其他设备连接

Remote Control 会话激活后，你有几种方式从其他设备连接：

• 在任意浏览器中打开会话 URL 以直接进入 claude.ai/code 上的会话。
• 扫描二维码 显示在会话 URL 旁边的二维码，即可直接在 Claude 应用中打开。使用 claude remote-control 时，按空格键切换二维码显示。
• 打开 claude.ai/code 或 Claude 应用 并在会话列表中按名称查找会话。在 Claude 移动应用中，点击导航栏中的 Code 以进入会话列表。Remote Control 会话在线时会显示一个带有绿色状态点的电脑图标。

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

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

如果你未设置显式名称，标题会在你发送提示后更新以反映你的提示。从 Claude Code v2.1.176 开始，自动生成的标题与你的对话语言一致，或与你配置的 language 设置一致。从 claude.ai 或 Claude 应用重命名会话也会更新 claude --resume 中显示的本地标题。

如果环境中已有活动会话，系统会询问你是继续该会话还是启动新会话。

如果你尚未安装 Claude 应用，请在 Claude Code 中使用 /mobile 命令显示 iOS 或 Android 的下载二维码。

为所有会话启用 Remote Control

除非你开启自动连接，否则 Remote Control 仅在你显式运行 claude remote-control、claude --remote-control 或 /remote-control 时激活。要为每个交互式会话自动启用它，请在 Claude Code 中运行 /config 并将 Enable Remote Control for all sessions 设置为 true。设置为 false 表示永不自动连接，或留空以遵循组织的默认设置。在 Desktop 应用中，你也可以从 Settings → Claude Code → Enable remote control by default 切换此设置。在 VS Code 扩展 中，相同的切换选项出现在命令菜单的 Settings 部分，名为 Enable Remote Control for all sessions；需要 Claude Code v2.1.203 或更高版本。

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

连接与安全

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

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

可信设备

Trusted Devices 是一项组织级设置，要求成员在从 claude.ai、Claude 移动应用或 Claude Desktop 查看或操控 Remote Control 会话之前验证其设备。它将 Remote Control 访问权限与已知设备和最近的认证绑定，而不仅仅是已登录的账户。

当该设置开启时，与 Remote Control 会话交互需要同时满足以下条件：

• 已注册设备：成员用于 Remote Control 的每个浏览器、手机或桌面应用都会注册自己的凭证。注册仅在完整登录后不久提供，因此设备作为真实认证的一部分加入可信列表，而不是在后台静默进行。
• 近期登录：成员的登录时间不得超过 18 小时。成员无需每天重新登录，而是使用 Face ID、Touch ID、Windows Hello 或通行密钥确认在场。这种生物识别升级会立即刷新会话。

生物识别检查通过操作系统或浏览器在设备上运行，与通行密钥登录机制相同。Anthropic 永远不会接收或存储指纹、面部数据或任何其他生物识别信息。仅存储设备的公钥和基本元数据，如显示名称、平台和注册时间。

该设置仅适用于 Remote Control。常规 Claude 聊天、终端中的 Claude Code 和 API 使用不受影响。

为你的组织启用 Trusted Devices

管理员从 Claude Code 管理控制台启用该设置。

成员看到的界面

每台设备的注册是一次性步骤。此后，唯一可见的变化是偶尔的生物识别提示。

• 每台设备首次使用：成员会被要求注册。如果他们的登录时间不够近，他们会先通过你的正常流程登录（包括如果配置了 SSO），然后确认注册。
• 日常使用：拥有已注册设备和近期登录的成员不会看到任何提示。当登录时间超过 18 小时，下一次 Remote Control 交互会显示一个 Face ID、Touch ID、Windows Hello 或通行密钥提示。
• 未注册设备：在设备注册之前，无法查看或操控 Remote Control 会话。该设备上的常规 Claude 聊天不受影响。
• 无平台认证器：在没有 Face ID、Touch ID 或 Windows Hello 的机器上的成员可以使用硬件安全密钥，或选择重新登录而不是进行升级认证。
• 在终端中：运行 Claude Code 的机器在开发者登录 CLI 时会自动接收自己的凭证。终端中没有单独的注册步骤。

管理已注册设备

成员可以在账户设置中查看和撤销他们自己的设备。

打开 claude.ai/settings/account 并找到 Trusted devices 部分，查看每台已注册设备的名称、平台和注册日期。移除设备会立即撤销其凭证，该设备可以在重新登录后再次注册。如果未续期，凭证也会自行过期，因此未使用的设备会自动从可信列表中移除。

对于丢失或被盗的设备，成员从此页面移除它。如果成员无法登录，管理员可以使用管理控制台中的 Sign out everywhere 来撤销该成员的所有会话和已注册设备，之后成员重新注册他们仍然持有的设备。

Remote Control 与 Claude Code on the web 的比较

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

当你正在进行本地工作并想从其他设备继续时，请使用 Remote Control。当你想无需任何本地设置即可启动任务、处理未克隆的仓库，或并行运行多个任务时，请使用 Claude Code on the web。

移动端推送通知

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

Claude 决定何时推送。它通常会在长期任务完成或需要你做决定以继续时发送通知。你也可以在提示中请求推送，例如 notify me when the tests finish。除了下面的两个开关之外，没有按事件的配置。

要设置移动端推送通知：

如果通知未送达：

• 如果 /config 显示 No mobile registered，请打开手机上的 Claude 应用，以便刷新其推送令牌。下次 Remote Control 连接时，该警告会清除。
• 在 iOS 上，专注模式和通知摘要可能会抑制或延迟推送。请检查 Settings → Notifications → Claude。
• 在 Android 上，激进的电池优化可能会延迟送达。请在系统设置中将 Claude 应用排除在电池优化之外。

当你在连接的终端中输入或聚焦时，Claude Code 会跳过移动端推送通知。从 v2.1.181 开始，你可以将 CLAUDE_CLIENT_PRESENCE_FILE 设置为标记文件路径，以将此扩展到你在机器上的任何时间，即使在另一个窗口中：只要文件存在，就会跳过通知。配置屏幕锁定监听器或类似工具，在屏幕解锁时创建该文件，在屏幕锁定时删除它。

限制

• 每个交互式进程一个远程会话：在服务器模式之外，每个 Claude Code 实例一次仅支持一个远程会话。请使用 服务器模式 从单个进程运行多个并发会话。
• 本地进程必须保持运行：Remote Control 作为本地进程运行。如果你关闭终端、退出 VS Code 或以其他方式停止 claude 进程，会话将结束。
• 长时间网络中断：如果你的机器处于唤醒状态但无法连接网络超过约 10 分钟，会话将超时并且进程退出。再次运行 claude remote-control 以启动新会话。
• Ultraplan 会断开 Remote Control：启动 ultraplan 会话会断开任何活动的 Remote Control 会话，因为这两个功能都占用 claude.ai/code 界面，且一次只能连接一个。
• 部分命令仅限本地：仅在终端界面中运行的命令，如 /plugin 或 /resume，无论从本地 CLI 是否传递参数，都只能在本地运行。以下命令可从移动端和网页端运行：
  • 文本输出命令：/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins
  • /model、/effort、/fast、/color 和 /rename：将值作为参数传递，例如 /model sonnet 或 /effort high。从移动端和网页端，/model 和 /effort 直接接受参数，代替终端选择器或滑块。
  • 从 v2.1.166 开始的 /mcp：返回服务器状态的文本摘要，而不是打开选择器，并接受 reconnect、enable 和 disable 子命令。与本地 CLI 不同，不带服务器名称的 /mcp reconnect 会重新连接所有已失败或需要认证的服务器。
  • 从 v2.1.181 开始的 /config：传递 key=value 以设置配置，或在不带参数的情况下运行以列出可设置的键。

故障排除

"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 环境变量的长期令牌进行认证。这些令牌仅限于推理，无法建立 Remote Control 会话。请运行 claude auth login 以使用完整范围的会话令牌进行认证。

"Unable to determine your organization for Remote Control eligibility"

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

"Remote Control is not yet enabled for your account"

Remote Control 推广尚未覆盖你的账户，或你缓存的权益已过期。如果你最近更改了套餐，请运行 claude auth logout 然后 claude auth login 以刷新。运行 claude doctor 查看哪个单独的资格检查失败。环境变量冲突、无法访问的检查和组织策略各自产生不同的消息，因此此错误意味着推广门控本身。

"Couldn't verify Remote Control eligibility"

Claude Code 无法访问功能标志服务以检查你的账户是否启用了 Remote Control，通常是因为你处于离线状态或代理阻止了请求。恢复网络访问后重试，或运行 claude doctor 查看详情。相关消息 "Couldn't verify your organization's Remote Control policy" 原因和解决方法相同。这两条消息均在 v2.1.178 中添加。

"Remote Control is only available when using Claude via api.anthropic.com"

会话未直接与 Anthropic API 通信，因此没有可配对的 claude.ai 后端。这发生在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上。从 v2.1.196 开始，当 ANTHROPIC_BASE_URL 指向 api.anthropic.com 以外的主机（如 LLM 网关 或代理）时也会发生，即使你使用 claude.ai 登录。取消设置 ANTHROPIC_BASE_URL 并重启会话以使用 Remote Control。

"Remote Control is disabled by your organization's policy"

此错误有四个不同的原因。首先运行 /status 查看你使用的登录方法和套餐。

• 你正在使用 API 密钥或 Console 账户认证：Remote Control 需要 claude.ai OAuth。请运行 /login 并选择 claude.ai 选项。如果环境中设置了 ANTHROPIC_API_KEY，请取消设置。
• Owner 尚未为你的组织启用它：Remote Control 在 Team 和 Enterprise 套餐中默认关闭。Owner 可以在 claude.ai/admin-settings/claude-code 开启 Remote Control 开关来启用它。此开关是服务器端组织设置。
• 管理开关呈灰色：你的组织有与 Remote Control 不兼容的数据保留或合规配置。无法从管理面板更改此设置。请联系 Anthropic 支持讨论选项。
• 错误提到 disableRemoteControl：你的 IT 管理员已通过 托管设置 在此设备上禁用了 Remote Control，这与组织级开关无关。

"Remote credentials fetch failed"

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

claude remote-control --verbose

常见原因：

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

"Couldn't reconnect to your Remote Control session"

当你使用 claude --resume 或 claude --continue 恢复对话时，Claude Code 会重新连接到该对话中记录的 Remote Control 会话。此消息意味着重连失败，原因可能是暂时的，例如网络中断或服务器错误，因此 Claude Code 无法确认远程会话是否仍然存在。当服务器确认前一个会话不再存在时，Claude Code 会创建一个新的 Remote Control 会话，而不显示此消息。

你的本地会话在没有 Remote Control 的情况下继续运行。运行 /remote-control 以重试连接，或在不使用 --resume 的情况下启动 Claude Code 以创建新的 Remote Control 会话。

在 v2.1.200 之前，重连失败会创建一个新的 Remote Control 会话而不是显示此消息，这会在 claude.ai/code 的会话列表中留下额外的会话。

"Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"

你的组织已启用 Trusted Devices，但此机器尚未注册。在 Claude Code 中运行 /login。注册是登录的一部分，没有单独的注册命令。

"session expired for trusted-device check"

你的登录时间已超过 18 小时。在 Claude Code 中运行 /login，或在 claude.ai 或移动应用提示你时，使用 Face ID、Touch ID、Windows Hello 或通行密钥确认。参见 Trusted Devices。

选择合适的方式

Claude Code 提供了多种不在终端旁时也能工作的方式。它们在触发方式、Claude 运行位置以及设置工作量上有所不同。

相关资源

• Claude Code on the web：在 Anthropic 管理的云环境中运行会话，而不是在你的机器上
• Ultraplan：从终端启动云规划会话，并在浏览器中审阅计划
• Channels：将 Telegram、Discord 或 iMessage 转发到会话中，以便 Claude 在你离开时响应消息
• Dispatch：从手机发送任务，即可生成 Desktop 会话来处理它
• Authentication：设置 /login 并管理 claude.ai 的凭证
• CLI reference：包含 claude remote-control 在内的标志和命令完整列表
• Security：Remote Control 会话如何融入 Claude Code 安全模型
• Data usage：本地和远程会话期间哪些数据流经 Anthropic API