English ← MyDocs

文档索引

在以下地址获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

使用远程控制从任何设备继续本地会话

使用远程控制从手机、平板电脑或任何浏览器继续本地 Claude Code 会话。支持 claude.ai/code 和 Claude 移动应用。

Note

远程控制处于研究预览阶段，所有计划可用。在团队和企业计划上，需要管理员在 Claude Code 管理设置中启用远程控制开关后才默认开启。

远程控制将 claude.ai/code 或 iOS 和 Android 版 Claude 应用连接到您机器上运行的 Claude Code 会话。在办公桌前开始任务，然后在沙发上用手机或在另一台电脑的浏览器中继续。

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

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

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

Note

远程控制需要 Claude Code v2.1.51 或更高版本。使用 claude --version 检查您的版本。

本页涵盖设置、如何启动和连接会话，以及远程控制与网页版 Claude Code 的比较。

要求

使用远程控制之前，请确认您的环境满足以下条件：

  • 订阅：Pro、Max、Team 和 Enterprise 计划可用。API 密钥不支持。在团队和企业计划上，管理员必须首先在 Claude Code 管理设置中启用远程控制开关。
  • 认证：运行 claude 并使用 /login 通过 claude.ai 登录（如果尚未登录）。
  • 工作区信任：在项目目录中至少运行一次 claude 以接受工作区信任对话框。

启动远程控制会话

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

导航到项目目录并运行：

claude remote-control

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

可用标志：

标志描述
--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启用或禁用文件系统和网络隔离的沙盒。默认关闭。

要启动启用了远程控制的正常交互式 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

这会启动一个远程控制会话，携带您当前的对话历史，并显示一个会话 URL 和二维码供您从另一个设备连接。--verbose、--sandbox 和 --no-sandbox 标志不适用于此命令。

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

/remote-control

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

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

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

从另一个设备连接

远程控制会话激活后，您有几种方式从另一个设备连接：

  • 打开会话 URL 在任何浏览器中直接进入 claude.ai/code 上的会话。
  • 扫描二维码 显示在会话 URL 旁边，直接在 Claude 应用中打开。使用 claude remote-control 时，按空格键切换二维码显示。
  • 打开 claude.ai/code 或 Claude 应用 在会话列表中按名称查找会话。在 Claude 移动应用中，点击导航中的 Code 进入会话列表。远程控制会话在线时显示带绿色状态点的计算机图标。

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

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

如果您未设置明确名称，发送提示后标题会更新以反映您的提示。从 claude.ai 或 Claude 应用重命名会话也会更新 claude --resume 中显示的本地标题。

如果环境已有活跃会话，系统会询问您是继续它还是启动新的。

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

为所有会话启用远程控制

默认情况下，远程控制仅在您明确运行 claude remote-control、claude --remote-control 或 /remote-control 时激活。要为每个交互式会话自动启用它，在 Claude Code 中运行 /config 并将 Enable Remote Control for all sessions 设置为 true。设置回 false 以禁用。在桌面应用中，您也可以从 Settings -> Claude Code -> Enable remote control by default 切换此设置。

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

连接和安全

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

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

远程控制与网页版 Claude Code 的比较

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

当您在本地工作中途并想从另一个设备继续时使用远程控制。当您想在没有任何本地设置的情况下启动任务、处理未克隆的仓库或并行运行多个任务时使用网页版 Claude Code。

移动推送通知

远程控制激活时，Claude 可以向您的手机发送推送通知。

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

Note

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

设置移动推送通知：

  1. 安装 Claude 移动应用

    下载 iOS 或 Android 版 Claude 应用。

  2. 使用 Claude Code 账户登录

    使用您在终端中用于 Claude Code 的相同账户和组织。

  3. 允许通知

    接受操作系统的通知权限提示。

  4. 在 Claude Code 中启用推送

    在终端中，运行 /config 并启用 Push when Claude decides。

如果通知未到达：

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

限制

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

故障排除

"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 环境变量的长期令牌认证。这些令牌仅限推理，无法建立远程控制会话。运行 claude auth login 改用全范围会话令牌认证。

"Unable to determine your organization for Remote Control eligibility"

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

"Remote Control is not yet enabled for your account"

资格检查在某些环境变量存在时可能失败：

  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_TELEMETRY：取消设置它们并重试。
  • CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX 或 CLAUDE_CODE_USE_FOUNDRY：远程控制需要 claude.ai 认证，不适用于第三方提供商。

如果都未设置，运行 /logout 然后 /login 刷新。

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

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

  • 您使用 API 密钥或 Console 账户认证：远程控制需要 claude.ai OAuth。运行 /login 并选择 claude.ai 选项。如果环境中设置了 ANTHROPIC_API_KEY，请取消设置。
  • 您的团队或企业管理员未启用它：远程控制在这些计划上默认关闭。管理员可以在 claude.ai/admin-settings/claude-code 中启用它，打开 Remote Control 开关。此开关是服务器端组织设置。
  • 管理员开关灰显：您的组织有与远程控制不兼容的数据保留或合规配置。这无法从管理面板更改。联系 Anthropic 支持讨论选项。
  • 错误提到 disableRemoteControl：您的 IT 管理员通过托管设置在此设备上禁用了远程控制，独立于组织范围的开关。

"Remote credentials fetch failed"

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

claude remote-control --verbose

常见原因：

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

选择正确的方法

Claude Code 提供多种在不在终端前时工作的方式。它们在触发工作的内容、Claude 运行的位置以及需要多少设置方面有所不同。

触发方式Claude 运行在设置最适合
Dispatch从 Claude 移动应用发送任务消息您的机器（桌面版）将移动应用与桌面版配对离开时委派工作，最少设置
远程控制从 claude.ai/code 或 Claude 移动应用驱动运行中的会话您的机器（CLI 或 VS Code）运行 claude remote-control从另一个设备引导进行中的工作
频道从 Telegram 或 Discord 等聊天应用或您自己的服务器推送事件您的机器（CLI）安装频道插件或构建自己的对外部事件（如 CI 失败或聊天消息）做出反应
Slack在团队频道中提及 @ClaudeAnthropic 云端安装 Slack 应用并启用网页版 Claude Code来自团队聊天的 PR 和审查
计划任务设置计划CLI、桌面版 或云端选择频率循环自动化如每日审查

相关资源

  • 网页版 Claude Code：在 Anthropic 管理的云环境中运行会话而非在您的机器上
  • Ultraplan：从终端启动云规划会话并在浏览器中审查计划
  • 频道：将 Telegram、Discord 或 iMessage 转发到会话中，以便 Claude 在您离开时对消息做出反应
  • Dispatch：从手机发送任务消息，它可以生成桌面会话来处理
  • 认证：设置 /login 并管理 claude.ai 的凭证
  • CLI 参考：包括 claude remote-control 在内的完整标志和命令列表
  • 安全：远程控制会话如何融入 Claude Code 安全模型
  • 数据使用：本地和远程会话期间通过 Anthropic API 传输的数据