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

Remote Control 将 claude.ai/code 或 Claude 移动应用连接到你机器上运行的 Claude Code 会话。在桌前启动任务，然后在沙发上用手机或另一台电脑的浏览器继续操作。Claude 始终在本地运行，不会迁移到云端。

[!NOTE]
Remote Control 处于研究预览阶段，所有计划均可使用。在 Team 和 Enterprise 上默认关闭，需要 Owner 在 Claude Code 管理设置 中启用 Remote Control 开关。

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

启动 Remote Control 会话后，Claude 始终在本地运行，不会迁移到云端。 你可以：

• 远程使用完整的本地环境：文件系统、MCP 服务器、工具和项目配置全部可用，输入 @ 可自动补全本地项目的文件路径
• 同时在多个界面操作：对话和 子代理 及 动态工作流 的进度跨所有连接设备保持同步，你可以在终端、浏览器和手机间交替发消息
• 从手机或浏览器发送图片和文件：在 Claude 应用或 claude.ai/code 中添加附件时，Claude Code 会将其下载到你的机器并作为 @ 文件引用传递给 Claude，可带或不带说明文字
• 经受中断：如果笔记本休眠或网络断开，机器重新上线后会话会自动重连。Claude Code 在连接重建期间会排队来自子代理和工作流的状态更新，恢复后统一送达

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

前置条件¶

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

启动 Remote Control 会话¶

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

服务器模式¶

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

claude remote-control

进程在终端中以服务器模式持续运行，等待远程连接。它会显示一个会话 URL 供你 从另一台设备连接，按空格键可以显示 QR 码快速从手机访问。远程会话活跃时，终端显示连接状态和工具活动。

可用 flag：

Claude Code 在打印帮助之前检查 Remote Control 资格，因此未使用合格账户登录时 claude remote-control --help 会返回错误而非此 flag 列表。

交互式会话¶

要启动启用了 Remote Control 的正常交互式 Claude Code 会话，使用 --remote-control flag（或 --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 会话，保留当前对话历史。

--verbose、--sandbox 和 --no-sandbox flag 在此命令中不可用。

VS Code¶

在 Claude Code VS Code 扩展 中，在提示框中输入 /remote-control 或 /rc，或使用 / 打开命令菜单并选择它。

/remote-control

提示框上方出现横幅显示连接状态。连接后，点击横幅中的 claude.ai/code 直接跳转到会话，或在 claude.ai/code 的会话列表中找到它。Claude Code 也会在对话中发布会话 URL。

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

与 CLI 不同，VS Code 命令不接受名称参数或显示 QR 码。会话标题由对话历史或第一条 prompt 生成。

检查连接状态¶

在交互式终端会话中，连接正常时输入框下方的页脚会显示 /rc active 指示器（终端太窄时隐藏）。指示器文本是指向 claude.ai 上会话的链接。用向下箭头键选中它并按回车，或再次运行 /remote-control，可打开状态面板显示会话 URL 和 QR 码供你 从另一台设备连接。

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

会话 URL 提醒¶

Remote Control 连接期间，Claude Code 会在切换到手机或浏览器最有帮助的时刻提醒你会话 URL，这样你不必从 /remote-control 中翻找链接。 需要 Claude Code v2.1.208 或更高版本。提醒会在以下任一时刻出现在提示框上方：

• 长时间 turn：当 turn 运行超过服务端调优的阈值时，会出现带 Check in from your phone 链接的 Still working 通知，让你可以从手机或浏览器跟进而非在终端等待。turn 结束时 Claude Code 移除它
• 重复权限提示：在一个会话中回答多个 权限提示 后，会出现 Approve tool calls from your phone 通知显示会话 URL。下一个 turn 开始时 Claude Code 移除它

提醒可以出现在任何已连接的会话中，包括 自动连接 的会话。它们不会在每次满足条件时出现，且每种提醒在所有会话中总共只出现几次。你无法配置或关闭它们；每个会自行消失。

从另一台设备连接¶

Remote Control 会话活跃后，你有几种方式从另一台设备连接：

• 打开会话 URL：在任何浏览器中打开，直接跳转到 claude.ai/code 上的会话
• 扫描 QR 码：扫描会话 URL 旁边显示的 QR 码，直接在 Claude 应用中打开。使用 claude remote-control 时按空格键切换 QR 码显示
• 打开 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 设置的前缀

如果没有设置显式名称，发送 prompt 后标题会更新以反映你的提问。自 Claude Code v2.1.176 起，自动生成的标题匹配你的对话语言，或已配置的 language 设置。从 claude.ai 或 Claude 应用重命名会话也会更新 claude --resume 中显示的本地标题。

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

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

为所有会话启用 Remote Control¶

默认情况下，Remote Control 仅在显式运行 claude remote-control、claude --remote-control 或 /remote-control 时激活。 要为每个交互式会话自动启用，在 Claude Code 中运行 /config 并将 Enable Remote Control for all sessions 设置为 true。设回 false 可永不自动连接，设为 default 可清除你的选择。清除后 Remote Control 遵循组织管理员的默认值（如果有），否则遵循 Claude Code 当前默认值。在 Desktop 应用中，也可从 Settings → Claude Code → Enable remote control by default 切换。在 VS Code 扩展 中，相同的切换出现在命令菜单的 Settings 部分，名为 Enable Remote Control for all sessions（需要 v2.1.203 或更高版本）。

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

连接与安全¶

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

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

Remote Control 连接期间，会话记录（包括你的消息、Claude 的回复和工具活动）存储在 Anthropic 服务器上。存储的记录使对话在设备间保持同步，并让会话在网络中断后重连。执行和文件系统访问留在你的机器上，存储的记录按 数据使用 政策保留。

要完全关闭 Remote Control，使用 disableRemoteControl 设置。有合规要求（如零数据保留）的组织无法启用 Remote Control。

Trusted Devices（可信设备）¶

[!NOTE]
Trusted Devices 目前处于 beta 阶段，功能可能会随迭代变化。

Trusted Devices 在 Team 和 Enterprise 计划上可用，默认关闭直到管理员启用。

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

启用此设置后，与 Remote Control 会话交互需要同时满足：

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

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

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

为组织启用 Trusted Devices¶

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

第 1 步：打开 Claude Code 管理设置

前往 claude.ai/admin-settings/claude-code。Require trusted devices 开关出现在 Remote Control 设置下方。

第 2 步：打开 Require trusted devices

该设置适用于组织的每个成员，并适用于启用后启动的 Remote Control 会话。启用前已运行的会话不会被追溯保护，它们在结束前继续无设备要求。不支持按团队或按项目范围限定。

第 3 步：通知成员

启用设置后，成员首次从浏览器、手机或桌面应用查看或操控新的 Remote Control 会话时，会被提示注册该设备。提前告知他们可以避免困惑。

成员看到什么¶

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

管理已注册设备¶

成员可以从账户设置查看和撤销自己的设备。

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

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

Remote Control vs 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 自行决定何时推送。通常在长时间运行的任务完成或需要你做决定时发送。你也可以在 prompt 中请求推送，例如 notify me when the tests finish。除了下面两个开/关切换外，没有逐事件配置。

设置移动推送通知的步骤：

1. 安装 Claude 移动应用：下载 iOS 或 Android 版 Claude 应用
2. 使用你的 Claude Code 账户登录：使用与终端中 Claude Code 相同的账户和组织
3. 允许通知：接受操作系统的通知权限提示
4. 在 Claude Code 中启用推送：在终端中运行 /config，启用 Push when Claude decides（主动通知）和/或 Push when actions required（权限提示和问题）

如果通知未到达：

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

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

限制¶

• 每个交互进程一个远程会话：服务器模式外，每个 Claude Code 实例同时支持一个远程会话。使用 服务器模式 从单个进程运行多个并发会话
• 本地进程必须保持运行：Remote Control 作为本地进程运行。如果关闭终端、退出 VS Code 或停止 claude 进程，会话结束。要在断开 SSH 后保持远程机器上的会话运行，在 tmux 或 screen 中启动它
• 长时间网络中断：如果机器清醒但无法连接网络超过约 10 分钟，会话超时并退出。再次运行 claude remote-control 启动新会话
• Ultraplan 断开 Remote Control：启动 ultraplan 会话会断开任何活跃的 Remote Control 会话，因为两者都占用 claude.ai/code 界面且一次只能连接一个
• 部分命令仅限本地：仅在终端界面中运行的命令（如 /plugin 或 /resume），无论是否传参都只从本地 CLI 工作。以下命令从移动端和 web 可用：
• 文本输出命令：/compact、/clear、/context、/usage、/exit、/usage-credits（打印计费 URL 而非打开浏览器）、/recap、/reload-plugins
• /model、/effort、/fast、/color 和 /rename：将值作为参数传入，例如 /model sonnet 或 /effort high。从移动端和 web 使用时，/model 和 /effort 以参数替代终端选择器或滑块
• /mcp（v2.1.166 起）：从移动应用返回服务器状态的文本摘要而非打开选择器。在 web 端，单独的 /mcp 打开 claude.ai 连接器 目录而非返回摘要。reconnect、enable 和 disable 子命令 在两端都可用。与本地 CLI 不同，不带服务器名的 /mcp reconnect 会重连所有失败或需要认证的服务器
• /config（v2.1.181 起）：从移动应用传 key=value 设置值，不带参数运行列出可设置的键。在 web 端，/config 打开设置的 Claude Code 部分，忽略命令后的文本
• 在 Team 和 Enterprise 上，从移动端或 web 运行 /usage-credits 不会 向管理员发送额度请求。发送需要仅在交互式 CLI 中出现的确认，因此命令会提示你在那里运行

故障排除¶

"Remote Control requires a claude.ai subscription"¶

你没有使用 claude.ai 账户认证。运行 claude auth login 并选择 claude.ai 选项。如果环境中设置了 ANTHROPIC_API_KEY，先取消设置。

v2.1.206 之前，在未登录时运行 /remote-control 报告的是 Unknown command: /remote-control 而非此消息。

"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"¶

Remote Control 的推出尚未到达你的账户，或缓存的权限信息过时。如果你最近更改了计划，运行 claude auth logout 然后 claude auth login 刷新。运行 claude doctor 查看哪个具体的资格检查失败了。环境变量冲突、检查不可达和组织策略各有自己的消息，所以此错误意味着推出门控本身。

"Couldn't verify Remote Control eligibility"¶

Claude Code 无法访问 feature-flag 服务检查 Remote Control 是否为你的账户启用，通常因为离线或代理阻止了请求。有网络访问后重试，或运行 claude doctor 获取详情。相关消息 "Couldn't verify your organization's Remote Control policy" 有相同原因和修复方法。两条消息都在 v2.1.178 中添加。

"Remote Control requires feature-flag evaluation"¶

以下变量之一已设置：DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_GROWTHBOOK。它们都会禁用 Remote Control 依赖的 feature-flag 评估，完整消息会指出 Claude Code 找到的变量。在 shell 环境或 settings.json 文件 的 env 块中取消设置该变量。v2.1.154 之前的版本中，相同配置产生的是 "Remote Control is not yet enabled for your account"。

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

会话没有直接与 Anthropic API 通信，因此没有 claude.ai 后端可配对。这发生在 Amazon Bedrock、Google Cloud Agent Platform 和 Microsoft Foundry 上。当 ANTHROPIC_BASE_URL 指向 api.anthropic.com 以外的主机（如 LLM 网关 或代理）时也会发生，即使你使用 claude.ai 登录。参见 错误参考 获取完整原因列表。

自 v2.1.219 起，消息会指出是什么将会话路由到了 Anthropic API 之外，例如 CLAUDE_CODE_USE_BEDROCK 或自定义 ANTHROPIC_BASE_URL。如果你有合格的 claude.ai 登录，取消设置该变量，如果在 settings 的 env 键中设置了也要移除，然后重启会话。v2.1.219 之前消息只有本节标题那句话，所以旧版本上需要自己检查环境中的提供商变量（如 CLAUDE_CODE_USE_BEDROCK 和 CLAUDE_CODE_USE_VERTEX）以及 ANTHROPIC_BASE_URL。

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

此错误有四种不同原因。 先运行 /status 查看使用的登录方式和订阅。

"Remote credentials fetch failed"¶

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

claude remote-control --verbose

常见原因：

• 未登录：运行 claude 并使用 /login 用 claude.ai 账户认证。Remote Control 不支持 API Key 认证
• 网络或代理问题：防火墙或代理可能阻止了出站 HTTPS 请求。Remote Control 需要访问端口 443 上的 Anthropic API
• 会话创建失败：如果还看到 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 或 passkey 确认。参见 Trusted Devices。

选择合适的方式¶

Claude Code 提供多种不在终端前工作的方式，区别在于触发方式、Claude 运行位置和所需设置量。

相关资源¶

• Claude Code on the web - 在 Anthropic 管理的云环境中运行会话，通过 cloud environments 配置
• Ultraplan - 从终端启动云端规划会话并在浏览器中审查计划
• Channels - 将 Telegram、Discord 或 iMessage 转发到会话中，让 Claude 在你不在时响应消息
• Dispatch - 从手机发送任务，可生成 Desktop 会话处理
• 认证 - 设置 /login 和管理 claude.ai 凭据
• CLI 参考 - 完整的 flag 和命令列表，包括 claude remote-control
• 安全 - Remote Control 会话如何融入 Claude Code 安全模型
• 数据使用 - 本地和远程会话中哪些数据通过 Anthropic API 流转