简短回答
Remote Control 把 claude.ai/code 或 Claude 手机应用连接到一个仍在你自己电脑上运行的 Claude Code 会话。什么都不会搬到云端:文件系统、MCP 服务器、工具和项目配置都留在原处,手机或浏览器只是这个本地进程的一扇窗。Anthropic 文档列出的适用套餐是 Pro、Max、Team 和 Enterprise,明确说不支持 API 密钥,并说 Team 和 Enterprise 的 Owner 必须先把它打开。电脑必须保持唤醒,claude 进程必须一直运行。
文档里大多数“无法使用”的情况可以归结为几类原因:登录不是完整的 claude.ai 会话、提供商或 base URL 不是 api.anthropic.com、某个环境变量关闭了功能开关、组织策略,或者版本太旧。下面的排查部分把每条确切的错误信息对应到文档写明的原因。本文依据 Anthropic 的 Remote Control 页面、Claude Code on the web 页面、权限模式页面和 Academy 教程,并引用 Anthropic 员工在 X 上的一手帖子和一篇独立的早期文章。所有内容均于 2026 年 10 月 28 日核对。文中没有任何内容来自我们自己的测试,文档没有说明的地方我们会直接说明。
Remote Control 是什么
按文档所述,Remote Control 会话先从你的电脑向 Anthropic API 注册,然后等待工作。当你在 claude.ai/code 或 iOS、Android 版 Claude 应用中打开该会话时,服务器在该客户端与本地进程之间转发消息。模型并不在浏览器里运行,你的仓库也不会被上传到别处执行。如果你退出这个进程,会话就会离线。
文档列出四项实际好处。第一,完整的本地环境可以远程使用,包括对本地项目文件路径的 @ 自动补全。第二,终端、浏览器和手机保持同步,包括子智能体和动态工作流的进度,所以你可以随意从任何一端发消息。第三,可以从手机或浏览器附加照片和文件;Claude 直接看到照片,其他文件会下载到你的机器上并作为 @ 引用传入。第四,能经受中断:如果笔记本休眠或网络掉线,交互式会话会在机器恢复后重新连接。
Remote Control 有三个入口:CLI、Claude 桌面应用和 VS Code 扩展。CLI 有三种模式,在设置一节介绍。无论用哪种,你创建的 Remote Control 会话都会出现在 claude.ai/code 的会话列表和手机应用的 Code 标签页里,在线时显示电脑图标和绿点。
使用要求
文档以列表形式给出要求。下表在此基础上补充了每一项不满足时出现的错误,因为大多数人搜索的正是错误文字。
| 要求 | 文档说法 | 不满足时 |
|---|---|---|
| 套餐 | Pro、Max、Team 和 Enterprise。Team 和 Enterprise 需要 Owner 先在 Claude Code 管理设置(claude.ai/admin-settings/claude-code)中打开 Remote Control 开关。 | “Remote Control is disabled by your organization’s policy” |
| 登录类型 | claude.ai 登录。不支持 API 密钥。来自 claude setup-token 或 CLAUDE_CODE_OAUTH_TOKEN 的长期令牌只能发起模型请求,无法建立会话。 | “Remote Control requires a claude.ai subscription” 或 “requires a full-scope login token” |
| 自定义角色(Enterprise) | 你的角色需要同时具备云端会话权限和 Claude Code remote control 权限。 | 出现 disabled-by-policy 信息,而同事却能用 |
| API 端点 | 不支持 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry,不支持 ANTHROPIC_BASE_URL 指向 api.anthropic.com 之外,也不支持通过企业 Claude apps 网关。 | “Remote Control is only available when using Claude via api.anthropic.com” |
| 功能开关 | CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_GROWTHBOOK 会让它不可用。单独设置 DISABLE_TELEMETRY 或 DO_NOT_TRACK 仍可用,除非你的组织要求 Trusted Devices,且需要 v2.1.283 或更高版本(桌面应用为 v2.1.304 或更高)。 | “Remote Control requires feature-flag evaluation” |
| 工作区信任 | 在不受信任的目录中,claude remote-control 会询问 Trust? [y/N]。在非终端环境里,它会以 “Workspace not trusted” 退出。主目录的信任从不会被保存。 | 每次运行都提示,或带错误退出 |
| 数据策略 | 已应用 Zero Data Retention 或 HIPAA 配置的组织无法启用 Remote Control。 | Owner 看到的开关是灰色的 |
研究阶段留下的一个问题,现在可以有定论:Remote Control 能否配合 API 密钥使用,文档的回答很明确,不能。权限模式页面重复了这一点:对 Remote Control 来说,本地机器必须登录你的 claude.ai 账户。如果你的 shell 导出了 ANTHROPIC_API_KEY,文档说会话会提示正在使用 API 密钥认证并拒绝工作;正确做法是移除这个变量,而不是绕过它。
设置步骤
下面的步骤按文档隐含的顺序排列。命令和参数引自 Remote Control 页面;顺序和检查项是我们对它们的编排。
1. 更新并用正确的方式登录
运行 claude update,然后用 claude.ai 账户登录:claude auth login 并选择 claude.ai 选项,或在会话内使用 /login。如果之前的登录是 API 密钥或 setup-token,请先登出。/status 会显示你的登录对应的套餐和组织,claude doctor 会报告哪一项资格检查没有通过。
claude update
claude auth login # choose the claude.ai option
claude doctor # shows which eligibility check failed, if any2. 安装手机应用
安装 iOS 或 Android 版 Claude 应用,并用相同的账户和组织登录。如果还没有这个应用,在 Claude Code 里运行 /mobile,会显示指向 claude.ai/mobile 的二维码,可打开对应的应用商店。
3. 选择启动方式
在项目目录里选择下面之一。首次确认提示(“Enable Remote Control? (y/n)”)只出现一次。
| 命令 | 得到什么 | 适用场景 |
|---|---|---|
| claude remote-control | 服务器模式。进程等待连接,打印会话 URL,按空格键显示二维码。可同时服务多个会话(默认容量 32)。 | 专用机器,或你从别处操控的 tmux 窗格 |
| claude --remote-control(或 --rc) | 一个普通的交互式终端会话,同时可被远程使用。你可以在本地和远程两边输入。每个进程只有一个远程会话。 | 你在终端里工作,之后想交接出去 |
| /remote-control(或 /rc) | 为你已在使用的会话开启 Remote Control,并带上对话历史。再运行一次会打开显示 URL 和二维码的状态面板。 | 你做到一半,决定离开工位 |
| 在 VS Code 或桌面应用 Code 标签页中使用 /remote-control | 在提示框中使用同一条命令。VS Code 在页脚显示一个指示器。它不接受名称参数,在 VS Code 里也不显示二维码。 | 你在 IDE 或桌面应用中工作 |
4. 从另一台设备连接
在任意浏览器中打开会话 URL,扫描二维码在 Claude 应用中打开,或在 claude.ai/code 的会话列表里按名称找到该会话。在手机应用中,点导航栏里的 Code。设备连接后会显示会话已在后台运行的子智能体和工作流,从设备上停止其中一个,会同时在你的机器上停止它。会话标题依次取自:你传入的名称、你的 /rename 标题、最后一条有意义的消息,或自动生成的名称,例如 myhost-graceful-unicorn。
5. 保持主机在线
文档说,如果你在远程机器的终端里运行 claude,要把它放在 tmux 或 screen 中,这样 SSH 断开后会话仍能存活。我们的相关指南介绍了周边配置:Antigravity Remote Control比较了类似的浏览器方案,在远程 VPS 上运行智能体介绍了基于 SSH 的配置。
# on the always-on machine
tmux new -s claude
cd ~/projects/my-app
claude remote-control --name "my-app" --spawn worktree6. 可选:自动连接与推送通知
运行 /config,把 Enable Remote Control for all sessions 设为 true,或在用户级 ~/.claude/settings.json 中把 remoteControlAtStartup 设为 true。项目或本地设置中的 true 值会被忽略,所以提交到仓库里的文件无法替所有人打开它;那里写 false 则会关闭它。推送通知需要在安装应用并允许通知之后,在 /config 中启用。
参数、spawn 模式与默认值
以下是文档中最重要的服务器模式参数。运行 claude remote-control --help 可查看你已安装版本支持的列表。
| 参数 | 效果 | 备注 |
|---|---|---|
| --name "My Project" | 设置 claude.ai/code 列表中的会话标题 | --remote-control 和 /remote-control 也接受 |
| --spawn same-dir | worktree | session | same-dir:会话共用目录,可能冲突。worktree:每个按需创建的会话拥有自己的 git worktree。session:只有一个会话。 | worktree 需要 git 仓库或 WorktreeCreate 钩子。运行时按 w 可在 same-dir 与 worktree 间切换;选择会按项目保存。 |
| --capacity N | 最大并发会话数,默认 32 | 不能与 --spawn=session 同用 |
| --permission-mode manual | acceptEdits | … | 服务器会话的起始权限模式 | 无法识别的模式会让服务器在启动时停止 |
| -c / --continue、--session-id ID | 在停止服务器后恢复上一个会话,或某个指定会话 | 需要 v2.1.200 或更高版本;服务器停止后大约四小时内有效 |
| --[no-]create-session-in-dir | 在当前目录预先创建一个会话(默认开启) | 使用 --no-create-session-in-dir 时,服务器的会话在停止时被归档,因此无法恢复 |
| --verbose、--debug、--debug-file | 连接与会话日志 | --verbose 不适用于 /remote-control |
| --sandbox、--no-sandbox | 已在 v2.1.300 中移除;传入任一项会报错退出 | 改为在设置文件中开启沙箱 |
有两个细节容易让人踩坑。第一,放在 remote-control 之前的全局参数不会被带入服务器所创建的会话;Claude Code 只允许丢弃它确认无害的参数,例如 --verbose 或 --model,对其他参数(例如 --settings)则拒绝启动,并指出需要移除的参数名。第二,保存的 spawn 模式来自你之前的回答或按 w 的选择,所以服务器以你没预期的模式启动,是因为它沿用了保存的选择,并会在启动时打印出来。
Remote Control、云端会话与 teleport 对比
这三个名字容易混淆,因为它们最后都落在同一个 claude.ai/code 界面里。判断标准是 Claude 在哪里运行。Remote Control 在你的机器上运行。云端会话在云基础设施上运行,默认由 Anthropic 管理,合上笔记本后仍会继续。Teleport 不是第三个运行位置,而是把云端会话拉进你的终端的方式。
| Remote Control | 云端会话(--cloud) | --teleport | |
|---|---|---|---|
| Claude 在哪里运行 | 你的机器(CLI、桌面应用或 VS Code) | Anthropic 云端虚拟机,或你所在组织的自托管环境 | 拉取云端会话后,在你的终端中 |
| 从哪里启动 | claude remote-control、--remote-control 或 /remote-control | claude --cloud "task"、claude.ai/code、手机 Code 标签页、桌面应用的环境选择器 | claude --teleport、/teleport 或 /tp、/tasks 然后按 t、claude.ai/code 上的 Open in > Terminal |
| 是否需要你的电脑开机 | 是,进程必须一直运行 | 否 | 是,它是本地终端 |
| 本地 MCP 服务器与文件 | 可用 | 不可用;虚拟机会按你当前的分支克隆你的 GitHub 远程仓库 | 本地检出,并拉取云端分支 |
| 套餐 | Pro、Max、Team、Enterprise(Team 和 Enterprise 由 Owner 启用) | Pro、Max、Team 和 Enterprise(需 premium 或 Chat + Claude Code 席位) | 需要 claude.ai 订阅认证,以及一个可拉取的云端会话 |
| 方向 | 从另一台设备查看本地会话 | 在云端新建会话 | 单向:云端到终端。你无法从 CLI 把终端会话推送到云端。 |
| 设置 | 一条命令,不需要 GitHub | GitHub App 或 /web-setup,一个云端环境 | 干净的 git 状态、同一仓库、已推送的分支、同一账户 |
云端文档补充了几条对选择有影响的事实。--cloud 会基于你当前的仓库新建一个云端会话,与 --remote-control 无关;较早的 --remote 写法仍作为 --cloud 的弃用别名可用。由于虚拟机克隆的是你的 GitHub 远程仓库而不是你的工作区,所以应先推送。被 teleport 的会话拥有自己的副本:在终端里的新工作留在本地,不会出现在云端会话中。如果要在 teleport 之后继续用手机操控,请在本地会话中启动 /remote-control。桌面应用可以通过其 Open in 菜单把本地会话发送到云端。
2/ Move sessions back and forth between mobile/web/desktop and terminal. Run “claude --teleport” or /teleport to continue a cloud session on your machine. Or run /remote-control to control a locally running session from your phone/web.
— @bcherny 2026 年 3 月 30 日
Claude Code 团队的 Boris Cherny 的这条帖子用两句话说明了同样的区分:teleport 把云端会话带到你的机器上,而 /remote-control 让你的手机或网页去操控一个已经在本地运行的会话。Remote Control 页面还列出了离开终端时的相邻方案:Dispatch(在手机应用里发任务,Claude 在桌面端运行)、Channels(把聊天应用中的事件推送到 CLI 会话)、Slack(提及 @Claude,在云端运行)、自托管环境和定时任务。Remote Control 是专为操控已在进行中的工作而设计的。
你该用哪一个?
| 你的情况 | 使用 | 原因 |
|---|---|---|
| 在工位上做到一半,需要离开但要保留本地工具 | /remote-control | 带上对话,并保留 MCP 服务器和文件 |
| 常开的工作站或服务器,用手机操控 | 在 tmux 中运行 claude remote-control | 服务器模式可处理多个会话并恢复崩溃的会话 |
| 仓库不在本机、任务多且并行、笔记本会合上 | claude --cloud 或 claude.ai/code | 不依赖你的机器运行;计入套餐用量 |
| 云端任务已完成,你想在本地继续 | claude --teleport | 拉取分支并把历史载入你的终端 |
| 提供商是 Bedrock、类 Vertex 或网关 | 两者都不能直接使用 | 两者都需要 Anthropic 账户;Remote Control 还需要 api.anthropic.com |
权限与推送通知
用手机操控的会话,仍然会像在键盘前一样请求权限。权限模式页面说,在你本地机器上的 Remote Control 会话,对你自己启动的会话提供 Manual、Accept edits、Plan 和 Auto,并且你无法在应用里选择 Bypass permissions。在 claude.ai/code 上,模式下拉菜单位于提示框下方;在手机应用里,点提示框中的 + 按钮,再点 Permission。下拉菜单显示本地会话当前所处的模式,包括在终端中设置的模式,并在任一处变化时同步更新。你也可以在启动时设置起始模式。
claude remote-control --permission-mode acceptEdits云端会话提供另一组选项(Accept edits、Plan、Auto),并忽略设置文件中的 dontAsk 和 bypass 模式。同一页面还说,在 Claude Code v2.1.283 或更高版本中,auto 模式是交互式终端和 VS Code 会话的内置起始模式,由第二个分类器模型代替你审核操作;该页面也明确说,auto 模式会减少提示,但不保证安全。在任何模式下,有些事情都不会被自动批准,包括被明确 ask 规则匹配的工具和内置的 AskUserQuestion 工具。Claude Code 会让权限提示和 AskUserQuestion 的问题一直保持打开,直到你回答,所以手机够不着时,会话会一直等待。其他被转发的对话框,比如安全拒绝后的模型选择提示,默认在五分钟后过期,并采用其无操作的默认值;dialogExpiry 设置可以调整或关闭这个期限。
推送通知让无人值守的使用变得切实可行。Remote Control 处于活动状态时,Claude 可以向你的手机推送通知,通常是在长任务完成或需要你做决定时。你也可以在提示里要求,例如“tests 跑完时通知我”。设置方法是:安装应用、使用相同账户、授予操作系统权限,然后在 /config 中为主动通知、权限提示和问题,或两者一并启用推送。除这些开关之外,没有更细的按事件配置。如果收不到通知,文档指向 /config 中的 No mobile registered(打开应用以刷新其推送令牌)、iOS 的专注模式和通知摘要,以及过于激进的 Android 电池优化。当你正在已连接的终端中输入或该终端处于焦点时,Claude Code 会跳过推送。
Remote Control - Session Spawning: Run claude remote-control and then spawn a NEW local session in the mobile app.
— @noahzweben 2026 年 3 月 13 日
连接与安全
文档对网络模型的描述很直白。你的本地会话只发出站 HTTPS 请求,从不打开入站端口。它向 Anthropic API 注册并轮询任务;当你从另一台设备连接时,服务器通过流式连接在客户端与本地会话之间路由消息,全部经由 Anthropic API 并使用 TLS,使用多个各自只限单一用途的短期凭证。执行和文件系统访问都留在你的机器上。
其代价同样说得很清楚:Remote Control 连接期间,会话记录(包括你的消息、Claude 的回复和工具活动)存储在 Anthropic 的服务器上,以便各设备保持同步,并让会话在掉线后重新连接。存储的记录按数据使用政策保留。如果某个仓库无法接受这一点,disableRemoteControl 设置可以完全关闭该功能,而启用了 Zero Data Retention 或 HIPAA 配置的组织则根本无法启用它。
Trusted Devices 是面向更严格场景的 beta 控制。开启后,查看或操控 Remote Control 会话需要一台已登记的设备,并且登录时间不超过 18 小时,通过 Face ID、Touch ID、Windows Hello 或通行密钥刷新。它默认关闭,Team 和 Enterprise 由 Owner 启用,Pro 和 Max 用户可以自行打开 Require trusted devices。文档提醒,Owner 启用时已在运行的会话不会被追溯保护。自动连接使用你自己的账户登录,所以它启动的会话只出现在你自己的 Claude 应用里。
限制
以下是文档列出的限制,按所影响的方面分组。它们都不是通常意义上的速率限制;该页面没有列出任何专属于 Remote Control 的请求配额。
| 限制 | 详情 | 怎么办 |
|---|---|---|
| 每个交互式进程只有一个远程会话 | 在服务器模式之外,每个 Claude Code 实例同一时间只支持一个远程会话 | 需要多个并发会话时使用服务器模式 |
| 本地进程必须保持运行 | 关闭终端、退出桌面应用或 VS Code,或停止 claude,会让会话离线 | 在远程主机上用 tmux 或 screen 运行 |
| 长时间网络中断 | 服务器模式大约 10 分钟后放弃,进程退出。交互式会话只要中断持续就会一直重试。 | 重新运行 claude remote-control;网络不稳定时使用交互式会话 |
| HTTP 403 拒绝 | 交互式会话最多重试三分钟(VPN 或网络变化后可能出现),然后断开并指出拒绝方 | 检查 VPN、代理和防火墙 |
| 在线心跳 | 交互式会话可能断开并提示 “could not reach the Remote Control server for about 30 minutes” | 运行 /remote-control 重新连接 |
| 崩溃的服务器模式会话 | 从已连接的设备发一条消息,Claude Code 会重新服务它(v2.1.238 或更高) | 无需重启 |
| 恢复窗口 | claude remote-control、--continue 和 --session-id 在服务器停止后大约四小时内可恢复会话 | 超过后,开始新会话 |
| 仅限本地的命令 | /plugin 和 /resume 只能从本地 CLI 使用。文本输出类命令和一组带参数的命令可在手机和网页使用。 | 在终端里运行这些命令 |
| 附件 | 无法下载到你机器上的文件,会被类似 [1 of 3 attachments did not arrive] 的提示取代 | 重新发送文件 |
| 连接器登录 | /mcp 选择器在手机或网页上不可用;在主机上用 claude mcp login "claude.ai Slack" --no-browser 获取链接 | 在主机上授权,然后 /mcp reconnect |
排查清单
先按下面的顺序检查,再对照信息表。这个顺序是我们的编排;表中的每个原因和修复方法都来自 Remote Control 页面。
- Claude Code 是否在主机上运行并保持唤醒?进程离线时,客户端会显示 “Remote Control disconnected” 或 “Can’t reach”。这两条信息都不会告诉你 Claude 是否仍在工作。
- 运行
/status。套餐和组织是否与你预期的一致?在 Pro 或 Max 套餐上残留的 Team 或 Enterprise 登录,会触发策略错误。 - 运行
claude doctor。它会显示哪项资格检查没有通过,对于策略问题还会显示 Organization policy 一行。 - 是否有 API 密钥或令牌覆盖了登录?检查 shell 以及设置文件 env 块里的 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、apiKeyHelper 和 CLAUDE_CODE_OAUTH_TOKEN。
- 会话是否被路由到了 api.anthropic.com 之外?检查 ANTHROPIC_BASE_URL、CLAUDE_CODE_USE_BEDROCK 以及类似的提供商变量。
- 是否在任何地方设置了 DISABLE_GROWTHBOOK 或 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC?取消设置。对于 DISABLE_TELEMETRY 或 DO_NOT_TRACK,更新 Claude Code 并检查 Trusted Devices。
- 机器能否通过 443 端口访问 Anthropic API?用
claude remote-control --verbose重新运行以获取完整错误。 - 在 Team 或 Enterprise 上,Owner 是否已启用开关,你的自定义角色是否包含两项权限?
- 用
claude update更新,然后用/remote-control重新连接。
| 信息 | 文档给出的原因 | 文档给出的修复 |
|---|---|---|
| Remote Control requires a claude.ai subscription / You must be logged in to use Remote Control | 没有用 claude.ai 登录,或有 API 密钥或令牌优先生效(ANTHROPIC_API_KEY、apiKeyHelper、ANTHROPIC_AUTH_TOKEN) | 用 claude auth login 并选择 claude.ai 选项;从 shell 或设置 env 中移除被点名的凭证 |
| 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 isn’t enabled for this account | 账户级检查结果为关闭,通常是套餐变更后的权益信息已过期 | claude auth logout 然后 claude auth login;更新 Claude Code;运行 claude doctor |
| Couldn’t verify Remote Control eligibility | 无法访问功能开关服务:离线或被代理拦截 | 在有网络时重试;claude doctor |
| Remote Control requires feature-flag evaluation | 设置了会关闭功能开关的变量;信息中会点出它 | 取消设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_GROWTHBOOK;对遥测变量,更新并检查 Trusted Devices |
| Remote Control is only available when using Claude via api.anthropic.com | Bedrock、Google Cloud 的 Agent Platform、Foundry,或自定义 ANTHROPIC_BASE_URL | 取消设置被点名的变量(也包括设置 env 键里的),并重启会话 |
| Remote Control is disabled by your organization’s policy | 按顺序检查:托管设置中的 disableRemoteControl;Pro 或 Max 套餐上残留的 Team 或 Enterprise 登录;HIPAA 配置;缺少自定义角色权限;Owner 尚未启用 | 对应原因处理:/status、重新登录、请 Owner 在 claude.ai/admin-settings/claude-code 启用或修正角色 |
| Couldn’t verify your organization’s policy for remote control | 无法获取策略且没有已保存的副本,例如离线或在 VPN 连接之前 | 恢复网络并再次运行命令;claude doctor 会显示 Organization policy 一行 |
| Remote credentials fetch failed | 无法获得短期凭证:未登录、代理或防火墙拦截了 443 端口上的 HTTPS,或会话创建失败 | 用 --verbose 重新运行;登录;确认订阅有效 |
| Couldn’t reconnect to your Remote Control session | 在 --resume 或 --continue 之后的重新连接失败,可能是暂时原因 | 用 /remote-control 重试,或用 claude --remote-control 开始新会话 |
| Previous session is unavailable | 无法恢复先前的会话 | /remote-control 开始一个新会话;如果想带上之前的消息,先重启 |
| Remote Control got an unexpected server response | 客户端无法读取服务器的回复 | claude update,然后 /remote-control |
| Your organization requires Trusted Devices… not enrolled / session expired for trusted-device check | 设备未登记,或登录已超过 18 小时 | 在 Claude Code 中 /login,或用 Face ID、Touch ID、Windows Hello 或通行密钥确认 |
有两种情况不是错误。如果交互式会话的指示器显示另一个连接接管了该会话,说明另一台设备或另一个 Claude Code 会话现在持有它;只有想拿回来时才需要重新连接。如果交互式会话在你于第二个终端恢复对话后显示 “Remote Control not started here”,说明第一个终端仍开着 Remote Control,而第二个是有意关闭的;在第二个终端里运行 /remote-control 即可把它转移过来。
功能演变
Remote Control 很新,早期文章描述的功能比今天的文档窄。Simon Willison 在 2026 年 2 月 25 日写道,这个功能“昨天才上线”,“有点不太稳”,他一开始遇到了未启用的错误,直到登出再登录才解决,而且同一时间只能运行一个会话。这些笔记有日期,最好当作发布首周的快照来读,而不是对当前行为的描述。他通过重新登录解决问题的办法,与当前文档对过期权益信息的建议一致,而今天的服务器模式列出的默认容量是 32 个会话。你可以在他的链接帖子中读到原文。
Anthropic 员工在 X 上的帖子记录了推出过程。Noah Zweben 在 2026 年 3 月 6 日发帖说,Remote Control 已面向 Team 和 Enterprise 用户开放,版本 2.1.69,默认关闭,由管理员在设置中启用。一周后,他介绍了在手机应用里 spawn 会话,需要 2.1.74 及以上版本,当时面向 Max、Team 和 Enterprise,并要求在手机上设置好 GitHub。当前文档把 Pro 也列了进去,并增加了 spawn 模式、worktree、恢复和 Trusted Devices,所以这些帖子应当当作历史,而不是现行要求。
Remote Control is now available to Team and Enterprise users! Please update to 2.1.69. We are fully launched. Default off but admins can enable it.
— @noahzweben 2026 年 3 月 6 日
1/ Did you know Claude Code has a mobile app? Personally, I write a lot of my code from the iOS app. Download the Claude app for iOS/Android, then open the Code tab.
— @bcherny 2026 年 3 月 30 日
Anthropic 还在其 Claude 频道发布了一段短视频,Using Claude Code Remote Control,在 Academy 教程页面中有链接。我们通过 YouTube 的 oEmbed 接口确认了该视频存在及其标题;这里没有概述它的内容。
结论与证据对照表
| 结论 | 来源 | 截至 2026 年 10 月 28 日的状态 |
|---|---|---|
| 适用于 Pro、Max、Team 和 Enterprise;不支持 API 密钥 | Remote Control 文档,Requirements | 文档已说明 |
| Team 和 Enterprise 需要 Owner 启用 | Remote Control 文档;Zweben 2026 年 3 月 6 日的帖子 | 文档已说明;帖子属于历史 |
| Claude 在本地运行;代码执行留在你的机器上 | Remote Control 文档,简介与 Connection and security | 文档已说明 |
| 仅出站 HTTPS,无入站端口;连接期间会话记录存储在 Anthropic 服务器上 | Remote Control 文档,Connection and security | 文档已说明 |
| 不支持 Bedrock、Google Cloud Agent Platform、Foundry 或非 Anthropic 的 base URL | Remote Control 文档,Requirements 与 Troubleshooting | 文档已说明 |
| 云端会话在云基础设施上运行并计入套餐用量 | Claude Code on the web 文档 | 文档已说明 |
| --teleport 把云端会话拉到终端;无法从 CLI 把终端会话推到云端 | Claude Code on the web 文档 | 文档已说明 |
| Remote Control 会话提供 Manual、Accept edits、Plan、Auto;Bypass 无法在应用里选择 | 权限模式文档 | 文档已说明 |
| 服务器模式默认容量为 32 个会话 | Remote Control 文档,参数表 | 文档已说明 |
| 早期发布时的限制(一个会话、不稳定的错误) | Simon Willison,2026 年 2 月 25 日 | 第三方、带日期;容量方面已被当前文档取代 |
| 任何速度、可靠性或延迟数字 | 未找到 | 未公布;本文未给出任何数字 |
我们无法核实的内容
- 我们没有测试过 Remote Control。以上所有行为都以 Anthropic 在 2026 年 10 月 28 日的文档为准;文档更新频繁并引用大量版本号,请用
claude --version对照版本说明。 - 我们没有把 Remote Control 与自行搭建的 SSH、Tailscale 和 tmux 方案做对比;文档只提到用 tmux 或 screen 来保持主机会话存活。
- 文档列出了套餐,但没有给出 Remote Control 的各套餐用量数字,除 32 个会话的默认容量外,也没有延迟、吞吐量或并发保证。
- 能否在手机上直接输入自定义斜杠命令或技能来调用,在我们读到的页面里没有说明;它们只列出了哪些内置命令可在远程使用。
- Zweben 的帖子描述的是 2026 年 3 月时的要求(spawn 需要 Max、Team 和 Enterprise,并在手机上设置 GitHub)。当前文档与此不同,我们不清楚每次变更的确切日期。
- Boris Cherny 帖串里的手机截图展示的是 Code 标签页,spawn 的截图是一帧视频画面。两者都不是对某个具体 Remote Control 界面的文档说明。
- 我们没有完整观看 YouTube 教程,因此不对其内容做任何说明。
结论
当工作已经在你自己的机器上运行,而你想从别处推动、批准或查看它,又不想搬动代码或工具时,Remote Control 是合适的工具。如果你的账户使用 API 密钥、Bedrock 之类的云提供商或网关,如果你的组织配置了 Zero Data Retention 或 HIPAA,或者机器无法一直开着,那它就是不合适的工具。这些情况下,云端会话(在可用的地方)是替代方案,它们用本地工具换来对笔记本的独立性。
如果连不上,不要靠猜。文档为每条信息都给了具体原因,而这些原因集中在登录类型、提供商、环境变量和组织策略上。在重装任何东西之前先检查这四项。对于打算让会话长期运行的人,文档支持的实用配置是:主机放在 tmux 里、服务器模式配合 worktree spawn、有意选择的权限模式、开启推送通知,并清楚待处理的批准会一直等到你回答为止。关于使用 Claude Code 的长期习惯,请见我们的 Claude Code 最佳实践指南和 Antigravity 与 Claude Code 对比。
常见问题
Claude Code Remote Control 是什么?
它把 claude.ai/code 或 Claude 手机应用连接到一个运行在你自己电脑上的 Claude Code 会话,让你可以在手机、平板或另一个浏览器中继续它。会话在本地执行,保留你的文件系统、MCP 服务器和工具。
哪些套餐支持 Remote Control?
按 Anthropic 文档,Pro、Max、Team 和 Enterprise。不支持 API 密钥。在 Team 和 Enterprise 上,Owner 必须先在 Claude Code 管理设置中启用 Remote Control 开关。
Remote Control 能用 API 密钥吗?
不能。文档说不支持 API 密钥,并说 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 优先于你的登录会产生错误,直到你把它移除。来自 claude setup-token 的令牌同样会失败,因为它们只能发起模型请求。
为什么提示 Remote Control 不可用或未启用?
文档中常见的原因是:套餐变更后登录已过期(登出再登录)、第三方提供商或自定义 ANTHROPIC_BASE_URL、关闭了功能开关的环境变量,或组织策略。运行 /status 和 claude doctor 查看是哪一项检查没有通过。
为什么 Remote Control 一直断线?
客户端的信息表示它与你电脑上的 Claude Code 失去了联系。检查进程是否在运行、机器是否保持唤醒。网络恢复后交互式会话会自行重连;服务器模式在大约 10 分钟的中断后退出;连续的 HTTP 403 响应大约三分钟后会断开,大约 30 分钟连不上服务器也会断开。运行 /remote-control 重新连接。
我的电脑必须一直开着吗?
是的。网页和手机界面是进入本地会话的一扇窗,所以机器必须开着,claude 进程必须在运行。在远程主机上,用 tmux 或 screen 运行,这样 SSH 断开后它仍能存活。
Remote Control 与 Claude Code on the web 是一回事吗?
不是。两者都使用 claude.ai/code,但 Claude Code on the web 在云基础设施上运行会话,而 Remote Control 在你的机器上运行。Teleport 是第三种东西:它把云端会话拉进你的终端。
我能让每个会话默认开启 Remote Control 吗?
可以。运行 /config 并设置 Enable Remote Control for all sessions,或在用户设置中把 remoteControlAtStartup 设为 true。项目设置中的 true 值会被忽略,所以仓库无法替每个打开它的人开启这一功能。
使用它时我的代码会上传到 Anthropic 吗?
执行和文件访问留在你的机器上,但会话记录(消息、回复和工具活动)在连接期间存储在 Anthropic 的服务器上。启用了 Zero Data Retention 或 HIPAA 配置的组织无法启用它。
如何在桌面应用或 VS Code 中启动?
在本地会话的提示框里输入 /remote-control 或 /rc。再次运行即可断开。VS Code 在提示框页脚显示一个指示器,不接受名称参数,也不显示二维码。
来源
来源于 2026 年 10 月 28 日核对。
- Continue local sessions from any device with Remote Control — Claude Code 文档(要求、模式、参数、限制、安全、排查)
- Use Claude Code in the cloud — Claude Code 文档(云端会话、--cloud、--teleport、要求)
- Choose a permission mode 和 Configure permissions — Claude Code 文档(Remote Control 会话可用的模式、auto 模式)
- Using Claude Code Remote Control — Claude Academy 教程页面及其 YouTube 视频
- Noah Zweben 在 X 上,2026 年 3 月 6 日 和 2026 年 3 月 13 日(推出过程的帖子)
- Boris Cherny 在 X 上,第 1 条帖子 和 第 2 条帖子,2026 年 3 月 30 日(手机应用、teleport 与 /remote-control)
- Claude Code Remote Control — Simon Willison,2026 年 2 月 25 日(独立的发布首周笔记)
延伸阅读:Antigravity Remote Control、远程 VPS 上的 Antigravity、Claude Code 最佳实践指南,以及 Antigravity 与 Claude Code 对比。



