“Claude remote agents”到底指什么:cloud session、远程操控的本地会话,还是你自己的机器
搜索 Claude remote agents 的人会落到三种不同的东西上:Anthropic 的 cloud session(Claude Code on the web、claude --cloud、Routines),Remote Control(在你自己机器上运行、用手机操控的会话),以及通过 SSH 在你自己的机器上运行的代理。这里讲清楚每一种是什么(2026 年 9 月 28 日对照 Anthropic 文档核实),各自在哪里运行,需要什么,以及我们如何用任意代理 CLI 应对每种情况。
每个月都有几百个人在 Google 里输入“claude remote agents”或“claude code remote agent”,然后落到我们讲用手机操控 Claude Code 的那个页面上。几乎没人点进来,他们是对的:那个页面回答的是一个问题,而这个搜索问的是三个。
在这个搜索词里,“remote”这个词承担了很多含义。取决于是谁在输入,它可能指一个在笔记本合上时运行在 Anthropic 服务器上的代理,一个运行在笔记本上但用手机操控的代理,或者一个运行在这个人自己拥有的构建服务器上的代理。这是三个不同的产品,各有一套不同的规则,而且 Anthropic 今年自己给第一个改了名,很大一部分混乱就是从这里来的。
这篇文章把三者分开讲清楚,事实都在 2026 年 9 月 28 日对照 Anthropic 的文档核实过,然后说明我们在 AgentsRoom 里如何用任意代理 CLI 应对每种情况。
“remote”这个词涵盖三种不同的东西
- cloud session(云端会话):代理运行在云端基础设施上,而不是你的机器上。Anthropic 以前把这个 CLI 参数叫作
--remote,这个搜索词就是这样沿用下来的。 - Remote Control:代理运行在你的机器上,你用 claude.ai 或手机上的 Claude 应用来操控它。
- 你自己的机器:代理运行在一台服务器、办公室的台式机或家里的电脑上,你通过 SSH 或隧道连过去。
三者中有两个是 Claude Code 的功能。第三个只是普通的基础设施,也是唯一一个适用于所有代理 CLI 的方式。
1. cloud session:代理运行在 Anthropic 的机器上
Anthropic 的文档把它叫作 cloud session:“一个运行在云端基础设施上、而不是运行在你机器上的 Claude Code 会话”。默认情况下,这个基础设施是 Anthropic 托管的一台隔离 VM;组织也可以把会话转到自己的自托管环境上。合上笔记本后会话继续运行,你可以从任何设备查看它或操控它。
你可以从五个地方启动它,它们共享同样的云端环境(网络访问规则、环境变量、安装脚本):
| 入口 | 方式 |
|---|---|
| 浏览器 | claude.ai/code,也叫 Claude Code on the web |
| 手机 | Claude 应用的 Code 标签页 |
| 桌面应用 | 启动会话时选择 Cloud 而不是 Local |
| 终端 | claude --cloud "Fix the authentication bug in src/auth/login.ts" |
| Routines | 定时、由 API 触发或由 GitHub 触发的运行,每一次都是一个 cloud session |
能解释这个搜索词来历的,正是终端这种形式。旧写法 --remote 仍然作为 --cloud 的已弃用别名可用。允许或禁止整个功能的组织策略至今仍叫 allow_remote_sessions。所以“remote”曾经是一段时间里的官方用词,它留存在参数、错误信息和管理设置里。
运行 claude --cloud 时实际发生的事情是:claude.ai 上创建一个新会话,云端 VM 按你当前的分支克隆仓库的 GitHub 远程仓库。它克隆的是远程仓库,不是你的工作树,所以如果你有本地提交,要先推送。如果仓库没有远程仓库,或者没有安装 Claude GitHub App,Claude Code 会把本地仓库打包(小于 100 MB,仅限已跟踪的文件)上传,并排除未提交的 .env、*.tfvars 和密钥文件。任务在云端运行,你可以继续在本地工作。完成后,你可以在 claude.ai/code 上创建 pull request,或者把会话拉回你的终端:
claude --teleport # session picker
claude --teleport <session-id> # a specific session
Teleport 会检查四件事:工作目录是否干净,是否是同一个仓库的检出,会话的分支是否已推送到远程仓库,以及是否是同一个 claude.ai 账户。然后它获取该分支,把整段对话载入你的终端。从 CLI 出发,交接只能单向进行:你可以把 cloud session 拉下来,但不能把一个现有的终端会话推上去。只有桌面应用有一个 Continue in 菜单,能把本地会话发送到云端。
Routines 是同一样东西的定时形式:一个保存好的提示词、一个或多个仓库、一组连接器,按计划、在一次 HTTP 调用时或在一个 GitHub 事件发生时运行,每次运行都是一个完整的 cloud session,不会弹出权限确认。它们目前处于研究预览(research preview)阶段,在 claude.ai/code/routines 上或在 CLI 里用 /schedule 创建,并且按账户增加了每日运行次数上限。
在依赖它之前,有三个限制值得了解。cloud session 需要 GitHub:克隆和 pull request 要么通过 Claude GitHub App,要么通过你用 /web-setup 发送的 gh 令牌。它们和你账户上的其他所有用量共享速率限制,没有单独的计算费用,但并行跑多个时会按比例消耗。而且它们要求用 Pro、Max 或 Team(或者席位合适的 Enterprise)登录 claude.ai:--cloud 和 --teleport 不能配合 API 密钥使用,Claude Code 配置为 Bedrock 或 Vertex 时也不能用。
2. Remote Control:代理运行在你的机器上,你从别处操控它
Remote Control 是它的镜像。文档用一句话说明了这一点:“与运行在云端基础设施上的 cloud session 不同,Remote Control 会话直接运行在你的机器上,并与你的本地文件系统交互。”claude.ai/code 以及 iOS 和 Android 上的 Claude 应用,是通向一个仍在你笔记本上运行的进程的窗口,带着你的文件、你的 MCP 服务器、你的 hooks 和你的项目配置。在手机上输入 @,甚至会自动补全你本地项目里的路径。
启动它有三种方式:
claude remote-control # server mode: serves sessions to your devices
claude --remote-control # an interactive session you can also drive remotely
/remote-control # from inside a session that is already running
第一次使用时,Claude Code 会请你确认一次。它需要用 Pro、Max、Team 或 Enterprise 登录 claude.ai(不支持 API 密钥),在 Team 和 Enterprise 上还需要所有者先打开开关。如果笔记本进入睡眠或者网络断开,机器恢复后会话会重新连接。而 Anthropic 自己文档里的那条说明才是要记住的:--cloud 创建 cloud session,--remote-control 与之无关。
这两个功能只在一个地方交汇。--teleport 走的是 Remote Control 的会话基础设施,所以一个过期的 teleport 会用 Remote Control 的措辞报错。这是管道层面的细节,不代表两者是同一样东西。
如果你关心的是令牌,我们测过了:Remote Control 不会多用令牌,以及 Codex 有什么替代方案。
3. 你自己的机器:SSH、隧道、构建服务器
第三种含义和 Anthropic 账户毫无关系。代理运行在一台你拥有、但不在你面前的电脑上:一台构建服务器、办公室的台式机、一台 VPS。你通过 SSH 连过去,在那里运行 claude 或 codex,会话就存在于那台机器上。
编辑器开始把这件事做成现成的功能。VS Code 1.121 加入了“Remote agents (Preview)”:Agents 窗口可以通过一个长期运行的代理主机进程,经由 SSH 或 dev tunnels,在你拥有的远程机器上运行代理会话,所以即使你的客户端断开,正在运行的会话也会继续。同样的思路,一个 CLI,一个编辑器。
最朴素的版本就是一个终端加 ssh。它适用于所有 CLI,让你的代码留在你掌控的硬件上,代价也是老样子:除非你用 tmux 或 screen 包一层,否则连接断了会话就没了,而且手机不是好用的 SSH 客户端。
怎么选
正确的问题不是“哪个最好”,而是你希望代码在哪里运行,以及你需要保留什么。
| 你想要 | 选择 |
|---|---|
| 笔记本合上,完全不用你自己的机器 | cloud session,或者一台租来的一次性机器 |
| 你的本地文件、MCP 服务器和 hooks,用手机操控 | Remote Control,或者终端的手机遥控器 |
| 代码从不离开你自己的硬件,笔记本关机 | 你自己的机器,通过 SSH 连接 |
| 对 Codex、Antigravity 或其他 CLI 也一样 | 任何不依赖厂商的方案 |
| 在你的终端里完成在别处开始的工作 | cloud session 用 --teleport,服务器用 ssh |
有两点要记住。cloud session 和 Remote Control 是 Claude Code 的功能:Codex 没有 --teleport 的对应物,而 Antigravity CLI 从 2.0 版起自带 Remote Control。另外,“remote”不等于“无人值守”:一个提出问题的 cloud session 会一直等你,直到它的环境过期;一个 Remote Control 会话也会像任何本地会话一样等待权限答复。
我们对每种情况怎么做
AgentsRoom 运行代理,但不托管代理,所以它对这三种情况各自表明立场,而不是取代它们。
用手机操控本地代理,任意 CLI 都行:AgentsRoom 移动应用通过端到端加密的中继,接管你电脑上运行的每一个代理的终端,包括 Claude Code、Codex、GitHub Copilot CLI、Cursor 和其他代理 CLI,代理等你的时候会发推送通知。在 Claude Code 会话上,它和 Anthropic 的 Remote Control 并存:一个是通向对话的窗口,另一个是通向终端的窗口。
你自己机器上的代理:SSH 连接把服务器保存一次,就在那里运行 CLI,带着和本地代理一样的磁贴、状态和通知;远程机群(Remote Fleet)在你账户下的所有电脑上做同样的事,办公室、家里和构建服务器都在一个视图里。
完全没有你自己的机器:Cloud Agents 会启动一台一次性机器,克隆仓库,按你从手机发来的指令以无头方式运行 Claude Code 或 Codex,提交,推送一个分支,然后自行销毁。它是一个任务,不是一个会话:没有可以连接的屏幕,这正是它和上面两种情况的区别。
这些都不会改变 Anthropic 的 cloud session 所做的事。如果你用的是 Claude Code,并且希望由 Anthropic 来跑 VM,claude --cloud 就是合适的工具,它推送的分支会像其他分支一样出现在你的仓库里。
常见问题
Claude 的 remote agents 和 Claude Code on the web 是一回事吗?
是的。Anthropic 现在的叫法是 cloud session:一个运行在 Anthropic 托管的基础设施上(或你所在组织的自托管环境上),而不是运行在你机器上的 Claude Code 会话。你可以从 claude.ai/code 启动,从 Claude 应用的 Code 标签页启动,在桌面应用里选择 Cloud 而不是 Local 启动,或者在终端里用 claude --cloud 启动。remote 这个词留存在旧的参数 --remote 里(它仍然作为 --cloud 的已弃用别名可用),也留存在管理这项功能的组织策略 allow_remote_sessions 里。
claude --cloud 会在我的电脑上运行什么吗?
不会。它在 claude.ai 上创建一个新会话,云端的 VM 会按你当前的分支克隆仓库的 GitHub 远程仓库,而不是你本地的检出,所以如果你有本地提交,要先推送。如果仓库没有远程仓库,或者没有安装 Claude GitHub App,Claude Code 会把本地仓库打包上传,并排除未提交的 .env、密钥和凭据文件。之后任务在云端运行,你的终端空了出来。
Remote Control 是在云端运行的吗?
不是。Remote Control 和 cloud session 正好相反:Claude Code 进程继续在你自己的机器上运行,带着你的文件系统、你的 MCP 服务器和你的项目配置,claude.ai/code 或 iOS 和 Android 上的 Claude 应用则成为通向它的一扇窗口。你可以用 claude remote-control(服务器模式)启动,在交互式会话里用 claude --remote-control 启动,或者在已经运行的会话里用 /remote-control 启动。Anthropic 的文档明确写着 --cloud 和 --remote-control 毫无关系。
Claude 的 cloud session 或 Remote Control 能和 Codex、Antigravity 或其他 CLI 一起用吗?
不能。两者都是 Claude Code 的功能,绑定在 claude.ai 订阅上。Antigravity CLI 从 2.0 版起有自己的 Remote Control。对其他 CLI 来说,你能加上的是不依赖厂商的那一块:AgentsRoom 移动应用可以通过端到端加密的中继,接管你电脑上运行的任何代理的终端,不管它用的是哪个 CLI,而且在 Claude Code 会话上它可以和 Claude 的 Remote Control 并存。
cloud session 要额外付费吗?
云端 VM 没有单独的计算费用,但 cloud session 和你账户上所有其他 Claude 与 Claude Code 用量共享速率限制,并行跑多个会话就会按比例消耗。Pro、Max 和 Team 套餐可以使用,Enterprise 需要 高级席位或 Chat + Claude Code 席位。以 cloud session 形式运行的 Routines 还有一个按账户计算的每日运行次数上限。
怎样把一个 cloud session 拉回我的终端?
用 claude --teleport 打开会话选择器,或者用 claude --teleport <session-id> 指定某个会话;在已经运行的会话里,/teleport 做同样的事。Claude Code 会检查你的工作目录是否干净、你是否处在同一个仓库的检出里、是否登录了同一个账户,然后获取该会话的分支并载入对话历史。终端拿到的是自己的一份副本:你接下来做的事留在本地,不会出现在 cloud session 里。从 CLI 出发,交接只能单向进行;只有桌面应用能把本地会话发送到云端。
下载 AgentsRoom
在一个窗口中运行你所有项目的所有 AI 代理。
配套应用:随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。
继续阅读
Claude Code的Remote Control会多用令牌吗?Codex有没有同样的东西?
自从Anthropic推出Remote Control,人们开始在Google里敲两个问题:从手机上操控一个Claude Code会话会不会多花令牌,以及Codex有没有对应的功能。简短的回答:不会,一个回合就是一个回合,不管你在哪里敲;有,但只存在一半。这里讲清楚Remote Control到底是什么,怎样用四条命令自己测出令牌问题的答案,codex remote-control今天能做什么,以及一个从不和提供商说话的手机遥控器如何改变这笔账。
阅读全文Claude Code 到底有多快?每秒令牌数,基于 20,000 轮实测
Claude Code 从不显示输出速度,但每个会话转录里都有计算它所需的全部数据。我们用一个 40 行的脚本跑了自己的 319 个会话、20,408 轮、1,200 万输出令牌:按中位数,Opus 5 每秒输出 63 个令牌,Opus 5.5 为 95,Sonnet 5 为 77,而且短回答总是比长回答慢。本文给出方法、脚本、数据,以及快速模式会带来什么变化。
阅读全文Antigravity Remote Control:在手机上能做什么,不能做什么
Google在2026年8月21日为Antigravity 2.0和Antigravity CLI推出了Remote Control,这个名字的搜索量说明大家想知道它到底是什么。下面是它能做的事,已于9月22日对照文档核实:设置里的开关和agy remote-control命令,用Google账号登录的网页仪表板,添加到主屏幕后能收到推送通知,多台机器集中在一个切换器里,以及三个要紧的限制(只支持Antigravity,每台机器一个守护进程,设置留在CLI上)。然后讲AgentsRoom手机遥控器怎样覆盖另外13个CLI,以及两者怎样配合。
阅读全文