{/* TRANSLATED — 已翻译为中文 */} > ## 文档索引 > 在以下地址获取完整文档索引：https://code.claude.com/docs/llms.txt > 使用此文件发现所有可用页面，然后再进一步探索。 # 使用远程控制从任何设备继续本地会话 > 使用远程控制从手机、平板电脑或任何浏览器继续本地 Claude Code 会话。支持 claude.ai/code 和 Claude 移动应用。 远程控制处于研究预览阶段，所有计划可用。在团队和企业计划上，需要管理员在 [Claude Code 管理设置](https://claude.ai/admin-settings/claude-code)中启用远程控制开关后才默认开启。 远程控制将 [claude.ai/code](https://claude.ai/code) 或 [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) 和 [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) 版 Claude 应用连接到您机器上运行的 Claude Code 会话。在办公桌前开始任务，然后在沙发上用手机或在另一台电脑的浏览器中继续。 当您在机器上启动远程控制会话时，Claude 始终在本地运行，因此没有任何内容移动到云端。使用远程控制，您可以： * **远程使用完整的本地环境**：文件系统、[MCP 服务器](/cn/mcp)、工具和项目配置都保持可用，输入 `@` 可自动补全本地项目的文件路径 * **同时在两个界面工作**：对话在所有已连接设备间保持同步，因此您可以从终端、浏览器和手机交替发送消息 * **应对中断**：如果笔记本电脑休眠或网络断开，当机器恢复在线时会话会自动重新连接 与[网页版 Claude Code](/cn/claude-code-on-the-web)（运行在云基础设施上）不同，远程控制会话直接在您的机器上运行并与本地文件系统交互。网页和移动界面只是该本地会话的窗口。 远程控制需要 Claude Code v2.1.51 或更高版本。使用 `claude --version` 检查您的版本。 本页涵盖设置、如何启动和连接会话，以及远程控制与网页版 Claude Code 的比较。 ## 要求 使用远程控制之前，请确认您的环境满足以下条件： * **订阅**：Pro、Max、Team 和 Enterprise 计划可用。API 密钥不支持。在团队和企业计划上，管理员必须首先在 [Claude Code 管理设置](https://claude.ai/admin-settings/claude-code)中启用远程控制开关。 * **认证**：运行 `claude` 并使用 `/login` 通过 claude.ai 登录（如果尚未登录）。 * **工作区信任**：在项目目录中至少运行一次 `claude` 以接受工作区信任对话框。 ## 启动远程控制会话 您可以从 CLI 或 VS Code 扩展启动远程控制会话。CLI 提供三种调用模式；VS Code 使用 `/remote-control` 命令。 导航到项目目录并运行： ```bash theme={null} claude remote-control ``` 进程在终端中以服务器模式持续运行，等待远程连接。它显示一个会话 URL，您可以用来[从另一个设备连接](#从另一个设备连接)，按空格键显示二维码以便从手机快速访问。当远程会话活跃时，终端显示连接状态和工具活动。 可用标志： | 标志 | 描述 | | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name "My Project"` | 设置在 claude.ai/code 会话列表中可见的自定义会话标题。 | | `--remote-control-session-name-prefix ` | 未设置明确名称时自动生成会话名称的前缀。默认为您的机器主机名，生成如 `myhost-graceful-unicorn` 的名称。设置 `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` 效果相同。 | | `--spawn ` | 服务器创建会话的方式。
• `same-dir`（默认）：所有会话共享当前工作目录，因此编辑同一文件时可能冲突。
• `worktree`：每个按需会话获得自己的 [git worktree](/cn/worktrees)。需要 git 仓库。
• `session`：单会话模式。仅服务一个会话并拒绝额外连接。仅在启动时设置。
运行时按 `w` 在 `same-dir` 和 `worktree` 之间切换。 | | `--capacity ` | 最大并发会话数。默认为 32。不能与 `--spawn=session` 一起使用。 | | `--verbose` | 显示详细的连接和会话日志。 | | `--sandbox` / `--no-sandbox` | 启用或禁用文件系统和网络隔离的[沙盒](/cn/sandboxing)。默认关闭。 | 要启动启用了远程控制的正常交互式 Claude Code 会话，使用 `--remote-control` 标志（或 `--rc`）： ```bash theme={null} claude --remote-control ``` 可选传递会话名称： ```bash theme={null} claude --remote-control "My Project" ``` 这为您提供终端中的完整交互式会话，也可以从 claude.ai 或 Claude 应用控制。与 `claude remote-control`（服务器模式）不同，您可以在会话也可远程访问时在本地输入消息。 如果您已在 Claude Code 会话中并希望远程继续它，使用 `/remote-control`（或 `/rc`）命令： ```text theme={null} /remote-control ``` 传递名称作为参数设置自定义会话标题： ```text theme={null} /remote-control My Project ``` 这会启动一个远程控制会话，携带您当前的对话历史，并显示一个会话 URL 和二维码供您[从另一个设备连接](#从另一个设备连接)。`--verbose`、`--sandbox` 和 `--no-sandbox` 标志不适用于此命令。 在 [Claude Code VS Code 扩展](/cn/vs-code)中，在提示框中输入 `/remote-control` 或 `/rc`，或使用 `/` 打开命令菜单并选择它。需要 Claude Code v2.1.79 或更高版本。 ```text theme={null} /remote-control ``` 提示框上方出现横幅显示连接状态。连接后，点击横幅中的 **Open in browser** 直接进入会话，或在 [claude.ai/code](https://claude.ai/code) 的会话列表中找到它。会话 URL 也会发布在对话中。 要断开连接，点击横幅上的关闭图标或再次运行 `/remote-control`。 与 CLI 不同，VS Code 命令不接受名称参数或显示二维码。会话标题从您的对话历史或第一个提示派生。 ### 从另一个设备连接 远程控制会话激活后，您有几种方式从另一个设备连接： * **打开会话 URL** 在任何浏览器中直接进入 [claude.ai/code](https://claude.ai/code) 上的会话。 * **扫描二维码** 显示在会话 URL 旁边，直接在 Claude 应用中打开。使用 `claude remote-control` 时，按空格键切换二维码显示。 * **打开 [claude.ai/code](https://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](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) 或 [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) 的下载二维码。 ### 为所有会话启用远程控制 默认情况下，远程控制仅在您明确运行 `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](/cn/claude-code-on-the-web) 都使用 claude.ai/code 界面。关键区别在于会话运行的位置：远程控制在您的机器上执行，因此您的本地 MCP 服务器、工具和项目配置保持可用。网页版 Claude Code 在 Anthropic 管理的云基础设施中执行。 当您在本地工作中途并想从另一个设备继续时使用远程控制。当您想在没有任何本地设置的情况下启动任务、处理未克隆的仓库或并行运行多个任务时使用网页版 Claude Code。 ## 移动推送通知 远程控制激活时，Claude 可以向您的手机发送推送通知。 Claude 决定何时推送。它通常在长时间运行的任务完成或需要您做出决定以继续时发送。您也可以在提示中请求推送，例如 `notify me when the tests finish`。除了下面的开/关切换外，没有按事件的配置。 移动推送通知需要 Claude Code v2.1.110 或更高版本。 设置移动推送通知： 下载 [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) 或 [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) 版 Claude 应用。 使用您在终端中用于 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](/cn/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](https://claude.ai/admin-settings/claude-code) 中启用它，打开 **Remote Control** 开关。此开关是服务器端组织设置。 * **管理员开关灰显**：您的组织有与远程控制不兼容的数据保留或合规配置。这无法从管理面板更改。联系 Anthropic 支持讨论选项。 * **错误提到 `disableRemoteControl`**：您的 IT 管理员通过[托管设置](/cn/settings#设置文件)在此设备上禁用了远程控制，独立于组织范围的开关。 ### "Remote credentials fetch failed" Claude Code 无法从 Anthropic API 获取短期凭证来建立连接。使用 `--verbose` 重新运行以查看完整错误： ```bash theme={null} claude remote-control --verbose ``` 常见原因： * 未登录：运行 `claude` 并使用 `/login` 通过 claude.ai 账户认证。远程控制不支持 API 密钥认证。 * 网络或代理问题：防火墙或代理可能阻止出站 HTTPS 请求。远程控制需要访问端口 443 上的 Anthropic API。 * 会话创建失败：如果您还看到 `Session creation failed -- see debug log`，失败发生在设置的早期。检查您的订阅是否有效。 ## 选择正确的方法 Claude Code 提供多种在不在终端前时工作的方式。它们在触发工作的内容、Claude 运行的位置以及需要多少设置方面有所不同。 | | 触发方式 | Claude 运行在 | 设置 | 最适合 | | :--------------------------------------------- | :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ | | [Dispatch](/cn/desktop#sessions-from-dispatch) | 从 Claude 移动应用发送任务消息 | 您的机器（桌面版） | [将移动应用与桌面版配对](https://support.claude.com/en/articles/13947068) | 离开时委派工作，最少设置 | | [远程控制](/cn/remote-control) | 从 [claude.ai/code](https://claude.ai/code) 或 Claude 移动应用驱动运行中的会话 | 您的机器（CLI 或 VS Code） | 运行 `claude remote-control` | 从另一个设备引导进行中的工作 | | [频道](/cn/channels) | 从 Telegram 或 Discord 等聊天应用或您自己的服务器推送事件 | 您的机器（CLI） | [安装频道插件](/cn/channels#快速入门)或[构建自己的](/cn/channels-reference) | 对外部事件（如 CI 失败或聊天消息）做出反应 | | [Slack](/cn/slack) | 在团队频道中提及 `@Claude` | Anthropic 云端 | [安装 Slack 应用](/cn/slack#在-slack-中设置-claude-code)并启用[网页版 Claude Code](/cn/claude-code-on-the-web) | 来自团队聊天的 PR 和审查 | | [计划任务](/cn/scheduled-tasks) | 设置计划 | [CLI](/cn/scheduled-tasks)、[桌面版](/cn/desktop-scheduled-tasks) 或[云端](/cn/routines) | 选择频率 | 循环自动化如每日审查 | ## 相关资源 * [网页版 Claude Code](/cn/claude-code-on-the-web)：在 Anthropic 管理的云环境中运行会话而非在您的机器上 * [Ultraplan](/cn/ultraplan)：从终端启动云规划会话并在浏览器中审查计划 * [频道](/cn/channels)：将 Telegram、Discord 或 iMessage 转发到会话中，以便 Claude 在您离开时对消息做出反应 * [Dispatch](/cn/desktop#sessions-from-dispatch)：从手机发送任务消息，它可以生成桌面会话来处理 * [认证](/cn/authentication)：设置 `/login` 并管理 claude.ai 的凭证 * [CLI 参考](/cn/cli-reference)：包括 `claude remote-control` 在内的完整标志和命令列表 * [安全](/cn/security)：远程控制会话如何融入 Claude Code 安全模型 * [数据使用](/cn/data-usage)：本地和远程会话期间通过 Anthropic API 传输的数据