Claude Code 远程控制教程：手机连接、配置与故障排查

已有会话正在运行，就输入 /remote-control；要在终端里新开一段对话，就用 claude --remote-control；想先启动服务，等待远程任务，则用 claude remote-control。这几种入口的使用场景不同，但任务都在本地执行。Anthropic 的 Remote Control 指南说明了这三种方式。

谁可以使用 Claude Code 远程控制？

官方对使用资格的表述是：“Pro、Max、Team 和 Enterprise 套餐均可使用，不支持 API 密钥。” 对于 Team 和 Enterprise，“Owner 必须先开启 Remote Control 开关”，位置在 Claude Code 管理设置。这个组织级开关默认关闭。来源：使用要求。

开始前先登录 Claude 账号：运行 claude，再输入 /login。仅为 API 用量付费并不满足要求；即使已经保存了订阅账号的登录状态，也可能被其他已配置的凭据覆盖。下文的故障排查会说明如何区分这两种情况。

Remote Control 还要求直接连接 Anthropic API。不支持 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry，也不支持将 ANTHROPIC_BASE_URL 自定义为 api.anthropic.com 以外的地址，或通过企业 Claude 应用网关登录。来源：连接要求。

套餐费用可查看 Claude Code 价格说明。远程访问改变的是你在哪里查看和指挥任务，执行任务的仍是原来那台电脑。

Claude Code 远程连接，该选哪种启动方式？

最快的配置方式，取决于你是要开始新任务，还是继续已有任务。

前三行对应 CLI 的三种调用模式；VS Code 和 Desktop 则各有自己的入口。来源：启动模式。

在项目目录中启动服务

进入要处理的项目所在目录，运行：

claude remote-control

出现 Remote Control 的首次启用确认时，选择同意。随后，进程会等待连接，并输出会话 URL。按空格键可以显示二维码。请保持这个终端运行。

服务模式用于查看连接情况和工具活动。如果还想在这个终端里输入提示词，应选择下文的交互模式。需要在远程会话列表中快速认出项目时，可以把 --name "My Project" 加在 remote-control 后面。来源：启动服务。

新建可远程访问的交互会话

运行 claude --remote-control，或简写 claude --rc。你可以继续在本地输入，同时用手机或浏览器访问同一个会话。参数后还可以加会话名称，例如 claude --remote-control "My Project"。

如果习惯先在电脑前开始开发，再在任务中途离开，这种方式适合作为日常入口。来源：启动交互会话。

为已有对话开启远程连接

在会话内输入 /remote-control 或 /rc。如果是首次连接，按提示确认启用；已有对话记录会保留。在 CLI 中，/remote-control My Project 还可以为会话命名。

连接成功后，终端可能显示 /rc active 状态标记。再次运行 /remote-control，即可打开包含 URL、二维码和断开连接控件的状态面板。在这里断开远程连接，本地对话仍会继续运行。终端窗口过窄时，状态标记可能不会显示。来源：连接状态。

从 VS Code 或 Desktop 开启

在 Claude Code 的 VS Code 扩展中，在提示输入框里输入 /remote-control 或 /rc。点击底部状态标记即可打开已连接的会话，对话中也会出现会话 URL。在 VS Code 中，这条命令不接受会话名称参数，也不显示二维码。再次运行即可断开连接。

在 Claude Desktop 中，在 Code 标签页的本地会话里使用同样的命令。连接后的会话可以在 claude.ai/code 找到；再次输入命令即可断开。Desktop 还提供会话级的 Remote Control 开关。来源：应用内入口、Desktop 控件。

先在执行任务的电脑上确认工作区信任

工作区信任与账号登录、组织是否允许 Remote Control 是彼此独立的设置。它决定的是：是否信任 Claude Code 即将使用的目录。

服务模式遇到尚未信任的目录时，会说明信任该目录后允许执行哪些操作，并要求确认。确认后会保存选择；但用户主目录是例外，每次运行都会再次询问。

这个确认提示需要真实的终端。如果标准输入或标准输出被重定向，Claude Code 无法提问，就会报工作区信任错误并退出。文档给出的解决方式是：先在该目录运行 claude 并确认信任，或直接在终端运行 claude remote-control，当场完成确认。来源：工作区信任错误。

如何用手机或另一台设备的浏览器连接？

打开会话 URL，就能在浏览器中直接进入该会话。也可以访问 claude.ai/code，按名称选择会话。

手机端请使用官方 Claude 应用：iOS 或 Android，并登录自己的 Claude 账号。点击 Code 可查看会话列表。在线的 Remote Control 会话会带有电脑图标和绿色状态圆点，也可以扫描会话二维码，在应用内打开。来源：连接设备。

建议先留在电脑前，用手机发一条简短的后续消息。这样可以在离开前确认，连接的确实是你要继续的那段对话。

两端都可以发送提示词。已连接的设备还会显示正在运行的子智能体和后台工作流；子智能体就是在当前会话中协助执行任务的智能体。在远程端停止其中一个任务，电脑上对应的任务也会停止。来源：跨设备操作。

哪些内容留在本地，哪些会经过 Anthropic？

电脑仍然是执行工作的地方，手机和浏览器只是让你多了一套控制入口。

本地文件系统、工具、项目配置和 MCP 服务器都可以继续使用。MCP 服务器为 Claude 提供访问额外工具或数据的连接。仅仅为了远程接着处理会话，无须在另一套云环境中重新搭建本地配置。来源：本地环境。

本地执行，不代表所有会话数据都留在本地。 Anthropic 会存储会话记录，包括你的消息、Claude 的回复和工具活动，用于跨设备同步与断线重连。连接采用基于 TLS 的出站 HTTPS 和短期凭据，不会在你的电脑上开放入站端口。来源：连接与安全。

使用 Zero Data Retention 或 HIPAA 配置的组织无法启用 Remote Control。disableRemoteControl 设置也可以禁用这项功能。来源：访问限制。

工作区信任与 Trusted Devices 有什么区别？

工作区信任批准的是执行电脑上的某个目录。**Trusted Devices（受信任设备）**则是一项可选的、处于 beta 阶段的访问要求，针对查看或控制会话的设备。

开启这项要求后，每台设备都必须注册，且距离最近一次身份验证不得超过 18 小时。通过生物识别或通行密钥确认，可以刷新访问授权。在 Team 和 Enterprise 中，由 Owner 在**组织设置 > 功能 > 远程会话（Organization settings > Capabilities > Remote sessions）**下开启。它与启用 Remote Control 的开关是两项独立设置。来源：Trusted Devices。

配置自动连接和手机通知

如果经常使用，可以开启自动连接，省去每次在会话中输入命令的步骤：

• CLI：打开 /config，开启为所有会话启用 Remote Control（Enable Remote Control for all sessions）。
• **VS Code：**在命令菜单的设置部分找到该选项。
• Desktop：进入设置 > Claude Code > 将新会话连接到 Remote Control（Settings > Claude Code > Connect new sessions to Remote Control）。

底层的 remoteControlAtStartup 设置可以通过用户设置或受管设置开启自动连接。仓库的项目设置或本地设置可以禁用它，却不能替所有打开该仓库的人启用。自动连接使用的是你自己的账号。来源：启动设置、VS Code 设置、Desktop 设置。

要接收手机通知，先安装 Claude 应用，使用与终端相同的账号和组织，并授予操作系统的通知权限。然后在终端的 /config 中开启由 Claude 决定何时推送（Push when Claude decides）、需要操作时推送（Push when actions required），或同时开启两项。主动推送的时机由 Claude 判断；你可以要求它在任务完成时通知你，但无法按具体事件逐项配置。来源：手机通知。

Claude Code 远程控制连接失败，怎么排查？

先看 Claude Code 输出的具体原因。即使 Remote Control 连接失败，交互会话仍可能在本地正常工作，因此终端能用，并不代表远程访问已经开启。

未使用符合要求的账号登录，或其他凭据覆盖了登录状态

运行 claude auth login，选择通过 claude.ai 登录。如果报错提到 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN，就从所有配置来源中移除对应凭据，包括 shell 环境，以及设置文件的 env 块。如果报错提到 apiKeyHelper，则移除该设置。

通过 claude setup-token 或 CLAUDE_CODE_OAUTH_TOKEN 提供的令牌，也不能用于建立 Remote Control 连接：这些令牌仅限模型请求。请使用 claude auth login，取得所需的登录权限范围。来源：身份验证失败、令牌限制。

没有符合要求的登录状态时，claude remote-control 会退出。claude --remote-control 的行为则不同：它会先启动本地交互会话，再显示远程访问失败的通知。来源：登录要求。

环境变量阻止了功能开关检查

Claude Code 会通过功能开关检查，判断这项功能是否可用。具体处理方式取决于报错点名了哪个变量：

最后一行的版本说明，只适用于这些遥测变量的配置情形，并不代表 Remote Control 的通用最低版本要求。来源：功能开关故障排查。

正在使用网关或其他 API 地址

Remote Control 不支持通过企业 Claude 应用网关登录，也不支持前文列出的第三方 API 提供商。

如果 claude.ai 会话本身符合要求，但报错指出某个变量把请求转到了 Anthropic 以外的地址，例如自定义的 ANTHROPIC_BASE_URL，文档建议移除报错中的变量；如果设置的 env 中也有该变量，同样移除，然后重启会话。来源：API 地址要求与错误。

组织策略或账号资格检查失败

如果被组织策略拦截，先检查 Owner 是否已启用 Remote Control。使用 disableRemoteControl 的设备策略也可能单独阻止这项功能。如果你已经改用 Pro 或 Max，但 Claude Code 仍保留旧的组织登录信息，可以用 /status 查看当前套餐和组织，再依次运行 claude auth logout 和 claude auth login，刷新登录状态。

如果更换套餐后，账号资格信息没有及时更新，文档还建议退出后重新登录、更新旧版 Claude Code，并使用 claude doctor 找出未通过的检查。如果无法获取策略，先恢复网络连接再重试；问题持续时，可查看 doctor 的组织策略检查结果，了解失败原因。来源：账号与策略故障排查。

获取远程凭据失败

使用文档提供的服务端诊断命令：

claude remote-control --verbose

文档列出的原因包括：缺少 claude.ai 身份验证、网络或代理阻止了通过 443 端口发往 Anthropic API 的出站请求，或此前创建会话失败。对于最后一种情况，应检查订阅是否有效。会话内的 /remote-control 命令不接受 --verbose 参数。来源：凭据获取故障排查。

电脑要保持运行，断线后如何恢复？

关闭终端、退出 Desktop 或 VS Code，或停止 Claude Code 进程，都会让对应会话无法再被远程访问。电脑短暂休眠或网络短暂中断后，恢复时可以重新连接；但长时间断网时，不同模式的行为不同：

• **服务模式：**断网约 10 分钟后，服务会退出，需要重新运行 claude remote-control。
• **交互模式：**本地工作可以继续，Claude Code 会不断重试，并在网络恢复后重新连接。

部分命令仍需在本地 CLI 中使用，包括 /plugin 和 /resume。远程访问并不能复现终端里的所有操作。来源：功能限制。

如果正常停止了服务，在约四小时内于同一目录重新启动，可以恢复它之前的会话。前提是没有在该目录运行另一个服务，也没有使用 --no-create-session-in-dir。超过这个时间窗口，就需要新建会话。

要恢复交互式对话，可使用 claude --continue 或 claude --resume；如果远程重连失败，再在会话内运行 /remote-control。来源：恢复会话。

该选 Remote Control，还是云端会话？

如果需要的是电脑上已经配置好的环境，就选 Remote Control；如果希望任务在云基础设施上执行，就选云端会话。

两种会话都可能出现在 claude.ai/code，因此只看这个网址，无法判断任务究竟在哪里执行。来源：官方对比、云端会话。

每个 Claude Code 交互进程支持一个远程会话，服务模式则可以处理多个本地会话。默认的 same-dir 模式会共享工作目录，可能造成编辑冲突；--spawn worktree 会为按需创建的会话分配独立的 Git worktree，也就是同一仓库中的独立工作副本。启动时最先创建的会话仍使用当前目录。来源：服务选项。

Dispatch 是另一种从手机向 Desktop 委派任务的方式；本文讲的是如何继续已有的 Claude Code 会话。如果想了解更全面的对比，包括第三方远程控制方案，可查看支持手机远程控制的 AI 编程智能体。

五种值得尝试的远程工作方式

下面这些建议都基于文档已有的控制能力，按它们对开发者继续当前工作的直接帮助程度排序：

1. **修复问题到一半的开发者：**开启 /rc，之后用手机回答下一个问题，无须重新开始对话。
2. **等待测试结果的创始人：**要求完成后通知，在手机会话中查看结果，再决定下一项任务。
3. **使用本地 MCP 工具的开发者：**远程继续同一个项目，无须到别处重新配置工具连接。
4. **换到另一台电脑检查工作的开发者：**在那台电脑的浏览器中打开会话 URL，向仍在运行的桌面会话发送反馈。
5. **反馈界面问题的创始人：**用手机附上照片或文件，为已有会话补充上下文。

它的价值在于减少任务运行与下一步决策之间的中断。无须凭空估算每小时能节省多少时间，先验证一件实际的事就够了：能否不回到电脑前，完成一次真正有用的工作衔接。相关的同步、附件和本地工具行为，都有 Remote Control 文档说明。

下次开始工作时，可以先用 /remote-control 连接一个已有项目，趁还在电脑前，用手机打开会话并发一条后续消息。确认这一步可行后，再决定是否把自动连接和通知纳入日常工作。如果你还在搭建本地工作流程，可以先看 Claude Code 使用教程。

如果希望把编程智能体接入稳定可靠的团队工作流程，可以了解 AI 生产系统。