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

• 远程使用您的完整本地环境：您的文件系统、MCP servers、工具和项目配置都保持可用，输入 @ 会自动完成本地项目中的文件路径。
• 同时从两个界面工作：对话和 subagents 和 dynamic workflows 的进度在所有连接的设备上保持同步，因此您可以从终端、浏览器和手机交替发送消息。
• 从您的手机或浏览器发送图像和文件：在 Claude 应用或 claude.ai/code 中附加照片或文件，可以带有或不带有标题。Claude 直接将附加的照片视为您消息的一部分。Claude Code 将其他文件下载到您的机器，并将其作为 @ 文件引用传递给 Claude。
• 在中断后恢复：如果您的笔记本电脑进入睡眠状态或网络断开，当您的机器重新上线时，Claude Code 会自动重新连接。在连接重建时，Claude Code 会对来自 subagents 和工作流的消息、权限提示和状态更新进行排队，并在连接恢复后传递它们。

​

要求

• 订阅：在 Pro、Max、Team 和 Enterprise 计划中可用。不支持 API 密钥。在 Team 和 Enterprise 上，Owner 必须首先在 Claude Code 管理员设置中启用 Remote Control 切换。
• 身份验证：运行 claude 并使用 /login 通过 claude.ai 登录（如果您还没有登录）。如果没有符合条件的登录，claude remote-control 会以错误退出，而 claude --remote-control 仍会启动交互式会话，并在启动后不久显示 Remote Control 失败通知。
• API 端点：在以下任何配置中都不可用：
  • 您使用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。
  • 您将 ANTHROPIC_BASE_URL 指向 api.anthropic.com 以外的主机，例如 LLM gateway 或代理。取消设置该变量以使用 Remote Control。在 v2.1.196 之前，Claude Code 允许使用自定义 ANTHROPIC_BASE_URL 进行 Remote Control。
  • 您通过企业 Claude apps gateway 登录。
• 功能标志评估：DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 和 DISABLE_GROWTHBOOK 各自禁用 Remote Control 可用性所依赖的功能标志评估。在您的 shell 环境或 settings.json 文件的 env 块中取消设置该变量，以使用 Remote Control。
• 工作区信任：在您的项目目录中至少运行一次 claude 以接受工作区信任对话框。启动信任对话框永远不会为您的主目录保存信任，因此请从项目目录启动 Remote Control。

​

启动 Remote Control 会话

claude remote-control

claude --remote-control

claude --remote-control "My Project"

/remote-control

/remote-control My Project

/remote-control

​

检查连接状态

• 另一个设备或 Claude Code 会话接管了会话：仅当您想从该设备收回它时才运行 /remote-control。
• 您从另一个设备或应用结束或存档了会话：仅当您想要它回来时才运行 /remote-control；Claude Code 会重新打开存档的会话。
• 服务器找不到会话：它可能已从另一个设备或应用中删除。

​

会话 URL 提醒

• 长回合：当回合运行时间超过服务器调整的阈值时，Claude Code 会显示仍在工作通知，带有从您的手机检查链接，因此您可以从手机或浏览器跟踪回合，而不是在终端等待。Claude Code 在回合结束时删除它。
• 重复的权限提示：在您在会话中回答了多个权限提示后，从您的手机批准工具调用通知会显示会话 URL。Claude Code 在您的下一个回合开始时删除它。

​

从另一个设备连接

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

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

​

连接的设备看到什么

• 压缩和 /clear：当 Claude Code 压缩对话时，连接的设备显示进度，然后显示对话被压缩的位置。当您运行 /clear 时，对话也会在连接的设备上重置。
• 使用 /resume 切换对话：连接的设备不会接收切换到的对话的标题或早期历史记录，但双向的新消息会进出您的终端中打开的任何对话。要再次从设备处理原始对话，请在您的终端中运行 /resume 并切换回它。
• 使用 /teleport 拉取会话：当您使用 /teleport 将Claude Code on the web 会话拉入您的终端时，连接的设备不会接收拉取的对话的早期历史记录。双向的新消息会进出拉取的对话，这现在是您的终端中打开的对话。
• 来自您其他会话的消息：使用跨会话消息传递，相同的连接在您不同机器上的自己的会话之间以及来自您的Claude Code on the web 会话的消息，通过 Anthropic 服务器，就像其余 Remote Control 流量一样。在其他机器上的消息会话涵盖传递规则，控制入站消息涵盖入站控制。需要 Claude Code v2.1.224 或更高版本。
• 您在回合中途发送的提示：当您在当前回合结束之前从连接的设备发送提示时，Claude Code 会将其排队并在该回合完成后将其保留在设备的记录中。
• 您的更改的差异：当会话的目录在 git 存储库中时，连接的设备的差异窗格显示您未提交更改的差异。设备通过连接请求差异，Claude Code 在您的机器上计算它。当您的工作树是干净的时，Claude Code 改为提供您的分支自从它从默认分支分叉以来的更改。在 v2.1.247 之前，Claude Code 仅向由 claude remote-control 提供的会话中的连接设备报告差异。
• 模型：当您从连接的设备选择模型时，Claude Code 在该模型上运行会话。终端的 /model 选择器、/status 和 /config 显示该模型。需要 Claude Code v2.1.238 或更高版本。
  • 您从设备的模型控制中选择的模型仅适用于当前会话。当您从设备向交互式会话发送 /model <name> 时，Claude Code 也会为新会话设置您的默认值。
  • 如果您发送 Claude Code 无法识别的名称，例如预期模型 ID 的显示名称，Claude Code 拒绝选择，会话保留其当前模型。在 v2.1.260 之前，Claude Code 从设备的模型控制中保存无法识别的选择，您的下一条消息失败。
• 努力级别：当您从连接的设备使用 /effort 或设备的努力控制设置努力级别时，Claude Code 将其应用于您机器上的会话，claude.ai/code 显示会话正在使用的级别。如果您使用 CLAUDE_CODE_EFFORT_LEVEL 固定了一个级别，会话保留该级别，Claude Code 拒绝从努力控制中选择不同的级别。从努力控制中选择级别需要您机器上的 Claude Code v2.1.234 或更高版本。
• 连接失败后重新连接：运行 /remote-control 以重新连接。如果压缩重写了对话或您在此期间使用 /resume 切换了对话，Claude Code 会存档它正在使用的服务器会话，而不是将其保留在会话列表中。您仍然可以通过过滤存档的会话找到它。在设备仍然连接时切换对话不会存档会话。

​

为所有会话启用 Remote Control

• true：当交互式会话启动时自动连接。
• false：关闭自动连接，尽管来自托管设置的 true 会优先，因为 Claude Code 将选择保存到您的用户设置。项目或本地设置（.claude/settings.json、.claude/settings.local.json）中的 false 甚至会关闭自动连接，即使托管 true 也是如此。
• default：清除您的选择并遵循您的组织的管理员默认值（如果已设置），否则遵循 Claude Code 的当前默认值。

• 桌面应用：设置 > Claude Code > 默认启用远程控制。
• VS Code 扩展：命令菜单的设置部分中的为所有会话启用 Remote Control。需要 Claude Code v2.1.203 或更高版本。

​

停止服务器后恢复会话

• claude remote-control：恢复服务器提供的每个会话。
• claude remote-control --continue：仅恢复服务器启动的会话，并在该会话结束时退出。如果此目录没有记录，Claude Code 会使用此存储库的其他 git worktrees 中最新的。
• claude remote-control --session-id <id>：仅恢复您传递的 ID 的会话，并在该会话结束时退出。ID 是会话 URL 在 claude.ai/code 中 /code/ 和任何 ? 之间的部分。

​

连接和安全

​

受信任的设备

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

​

为您的组织启用受信任的设备

​

成员看到什么

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

​

管理已注册的设备

​

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

​

移动推送通知

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

​

限制

• 每个交互式进程一个远程会话：在服务器模式之外，每个 Claude Code 实例一次支持一个远程会话。使用服务器模式从单个进程运行多个并发会话。
• 本地进程必须保持运行：Remote Control 作为本地进程运行。如果您关闭终端、退出 VS Code 或以其他方式停止 claude 进程，会话将离线，直到您恢复它。除非 Claude 正在执行任务中，否则 claude.ai 和 Claude 应用会在进程退出后的几秒内显示会话离线。要在从 SSH 断开连接后保持远程机器上的会话运行，请在 tmux 或 screen 内启动它。
• 服务器模式中的崩溃会话：如果由 claude remote-control 提供的会话崩溃，请从连接的设备向其发送消息。Claude Code 将再次提供它。您不必重新启动服务器。需要 Claude Code v2.1.238 或更高版本。
• 已连接会话上的 HTTP 403 拒绝：一旦交互式会话连接，当您的机器和 Anthropic 服务器之间的某些内容以 HTTP 403 响应时（在 VPN 或网络更改后可能发生），Claude Code 会重试最多三分钟。如果拒绝持续更长时间，Claude Code 会断开连接，原因会说明是什么拒绝了：网络边缘，或您自己网络上的代理、VPN 或防火墙。
• 扩展网络中断：如果您的机器处于唤醒状态但无法到达网络，接下来的操作取决于模式：
  • 服务器模式：Claude Code 在大约 10 分钟后放弃，claude remote-control 进程退出。再次运行 claude remote-control 以启动新会话。
  • 交互式会话：继续在本地工作。Claude Code 会在中断期间持续重试，并在网络恢复时自动重新连接。
• 存在心跳失败：如果交互式会话断开连接并显示 could not reach the Remote Control server for about 30 minutes，运行 /remote-control 以重新连接。Claude Code 仅在会话的存在心跳失败而其余连接保持正常时显示此消息；它会在大约 30 分钟内持续重新注册会话，之后才断开连接。
• 转发的对话过期：Claude Code 会保持权限提示和 AskUserQuestion 问题打开，直到您回答。当 Claude Code 将另一种对话转发到远程会话时，例如安全拒绝后显示的模型选择提示，默认情况下它会等待五分钟，然后关闭对话并继续使用对话的无操作默认值。设置 dialogExpiry 以调整或禁用截止时间。需要 Claude Code v2.1.224 或更高版本。
• Fable 使用额度同意提示未被转发：Claude Code 仅在会话运行的位置显示中途Fable 使用额度同意提示，而不是在您的设备上。当会话在终端中运行且那里没有人在 Claude Code 关闭提示之前回答时，该轮结束而不发送请求；请参阅确认提示未被回答。
• 某些命令仅限本地：仅在终端界面中运行的命令，例如 /plugin 或 /resume，仅从本地 CLI 工作，无论您是否传递参数。以下命令可从移动和网络工作：
  • 文本输出命令：/compact、/clear、/context、/usage、/exit、/usage-credits、/recap 和 /reload-plugins。/usage-credits 打印计费 URL 而不是打开浏览器。/reload-plugins 仅在会话在交互式终端中运行时工作；没有交互式终端的会话会拒绝它。
  • /model、/effort、/fast、/color 和 /rename：将值作为参数传递，例如 /model sonnet 或 /effort high。从移动和网络，/model 和 /effort 在终端选择器或滑块的位置接受参数。
  • /mcp：从移动应用，返回服务器状态的文本摘要而不是打开选择器。在网络上，/mcp 单独打开 claude.ai 连接器 的目录而不是返回摘要。reconnect、enable 和 disable 子命令可从两者工作。与本地 CLI 不同，不带服务器名称的 /mcp reconnect 会重新连接每个已失败或需要身份验证的服务器。
  • /config，从 v2.1.181 开始：从移动应用，传递 key=value 以设置一个设置，或不带参数运行它以列出您可以设置的键。在网络上，/config 打开您设置的 Claude Code 部分，并忽略命令后的文本。
  • 在 Team 和 Enterprise 上，从移动或网络运行的 /usage-credits 不会向您的管理员发送使用额度请求。发送需要仅在交互式 CLI 中出现的确认，因此命令告诉您改为在那里运行它。在 v2.1.211 之前，文本形式在没有确认的情况下发送请求。
  • /autocompact，从 v2.1.221 开始：将窗口大小作为参数传递，例如 /autocompact 500k。不带参数时，它将当前窗口大小打印为文本，而不是打开命令在终端会话中显示的对话框。
  • /advisor，从 v2.1.260 开始：将模型作为参数传递，例如 /advisor opus，或传递 off 以关闭顾问。两种形式都仅适用于当前会话，并保持您保存的默认值不变。不带参数时，它将当前顾问打印为文本，而不是打开选择器。

​

故障排除

​

“Remote Control 需要 claude.ai 订阅”

• 已登出，来自 /remote-control 或 --remote-control：Remote Control requires a claude.ai subscription.
• 已登出，来自 claude remote-control：You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.
• 已登入，但正在使用 API 密钥或令牌：Remote Control requires claude.ai subscription auth. 后跟正在使用的凭证，例如 ANTHROPIC_API_KEY is set, so this session is using API-key auth。apiKeyHelper 设置和 ANTHROPIC_AUTH_TOKEN 的命名方式相同。

​

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

​

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

​

“Remote Control 尚未为此账户启用”

​

“无法验证 Remote Control 资格”

​

“Remote Control 需要功能标志评估”

​

“Remote Control 仅在通过 api.anthropic.com 使用 Claude 时可用”

​

“Remote Control 被您的组织的策略禁用”

• 错误提及 disableRemoteControl：您的 IT 管理员已通过托管设置在此设备上禁用了 Remote Control，独立于组织范围的切换和您的登录方式。
• 您的 claude.ai 计划是 Pro 或 Max：Claude Code 仍然以来自较早登录的 Team 或 Enterprise 组织身份登录，因此它检查该组织的 Remote Control 策略。运行 /status 以查看您的登录使用的计划和组织。运行 claude auth logout 然后 claude auth login 以在您当前的计划下重新登录。
• 组织策略未在此机器上加载：运行 claude doctor 并阅读 Organization policy 行。如果该行显示策略未加载，这就是保持 Remote Control 关闭的原因。在 v2.1.261 之前，claude doctor 不打印此行。
• 消息未说联系您的组织管理员：您的组织有与 Remote Control 不兼容的 HIPAA 配置，/status 在其 Compliance 行中列出 HIPAA。在这种状态下，管理面板的 Remote Control 切换呈灰色，因此所有者无法在那里更改它。联系 Anthropic 支持以讨论选项。在 v2.1.267 之前，这种情况显示”Remote Control isn’t available for your organization due to its compliance policy”。
• 否则，所有者尚未为您的组织启用它：Remote Control 在 Team 和 Enterprise 计划上默认处于关闭状态。所有者可以在 claude.ai/admin-settings/claude-code 通过打开 Remote Control 切换来启用它。此切换是服务器端组织设置。

​

“Remote credentials fetch failed”

claude remote-control --verbose

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

​

“无法重新连接到您的 Remote Control 会话”

• 服务器报告记录的会话已消失，或重新连接记录命名不同的账户：Claude Code 按照对话的重新连接记录所说的内容进行操作：
  • 记录命名您登录的账户：Claude Code 使用自动生成的名称启动替换会话，并将对话的早期消息排除在外。例如，在您从 claude.ai 或 Claude 应用中删除会话后，您会看到这种情况。
  • 记录命名不同的账户：Claude Code 启动新会话而不显示消息，无论记录的会话是否仍然存在，都不包括对话的早期消息。
  • 记录未说明哪个账户拥有会话，或 Claude Code 无法读取您保存的登录：Claude Code 显示 Previous session is unavailable — run /remote-control to start a new one 而不是此消息，不启动任何内容，并从对话中删除记录。
• 您在恢复前关闭了 Remote Control：除非托管 Claude Code 的应用已告诉它该应用拥有 claude.ai 会话，否则当您从 CLI 的状态面板、VS Code 扩展或基于Agent SDK 构建的主机关闭 Remote Control 时，Claude Code 删除了重新连接记录，因此它不会重新连接。当拥有的应用关闭它时，Claude Code 保留记录并重新连接。
• 此机器上的另一个 Claude Code 仍然拥有会话：您会看到以 Remote Control not started here 开头的通知，Claude Code 在恢复的会话中保持 Remote Control 关闭。在那里运行 /remote-control 以移动它。

​

“Previous session is unavailable — run /remote-control to start a new one”

​

“Remote Control got an unexpected server response”

​

“您的组织需要受信任的设备用于 Remote Control，但此设备未注册”

​

“session expired for trusted-device check”

​

选择正确的方法

​

相关资源

• 网络上的 Claude Code：在云中运行会话而不是在您的机器上，通过云环境配置
• 跨会话消息传递：让 Claude 在其他机器上或在网络上的 Claude Code 上向您的会话发送消息
• Channels：将 Telegram、Discord 或 iMessage 转发到会话中，以便 Claude 在您离开时对消息做出反应
• Dispatch：从您的手机发送任务消息，它可以生成 Desktop 会话来处理它
• 身份验证：设置 /login 并管理 claude.ai 的凭证
• CLI 参考：包括 claude remote-control 的标志和命令的完整列表
• 安全：Remote Control 会话如何适应 Claude Code 安全模型
• 数据使用：在本地和远程会话期间通过 Anthropic API 流动的数据