0
异步视界/claude-code-feature-radar/remote-control
· CLAUDE-CODE-FEATURE-RADAR · 2026.05.13 · 16 MIN ·

Remote Control:用浏览器和手机驱动本机的 Claude Code

笔记本放桌上、手机看进度、咖啡馆决策权限 —— Claude 仍跑在本机,云端只是看播窗口。Claude Code 唯一原生的移动端口子。 · by 思扬
AI · HERO seed:4020260513 笔记本放桌上、手机看进度、咖啡馆决策权限 —— Claude 仍跑在本机,云端只是看播窗口。Claude Code 唯一原生的移动端口子。
FIG.00 — cover · ai-generated · placeholder

原文:https://code.claude.com/docs/en/remote-control 官方定位:Continue local sessions from any device with Remote Control 引入版本:Claude Code v2.1.51(在 changelog 历史里至少能追到 v2.1.99 已成型,Remote Control 是 Claude Code 过去一年最稳的”高级功能”) 状态:Research Preview · Pro / Max / Team / Enterprise 都能用,Team/Enterprise 默认关,管理员开

🔥 影响力卡片

维度数据
引入v2.1.51,演进到 v2.1.139(撰文时)历经 50+ 次 changelog 改动
Changelog 累计提及40+ 处(本机 grep)— 在 Claude Code 所有功能里属”持续重投资”类
与移动端关系配合 Claude iOS / Android app 工作 — Claude app 的 “Code” tab 就是 Remote Control 入口
与 v2.1.139 联动新加的 /goal 命令明确支持 Remote Control;disableRemoteControl managed setting 给企业 IT 关闭口
网络模型只走 outbound HTTPS,不开任何 inbound 端口 — 跟普通 Claude Code 同一套 OAuth + TLS

🎯 为什么必读

1. 这是 Claude Code 唯一原生的”移动端口子”。

很多人以为 Claude Code 必须在 terminal 前面坐着才能用。错。Remote Control 让你启动后:笔记本放桌上,你在咖啡馆用手机看进度、回话、决策权限。Claude 实际仍然跑在你那台机器上,所有 MCP server、文件系统、.env、私有仓库 — 全部本地可达。云端只是个”看播窗口”。

2. 它跟”Claude Code on the web”是两条路线,不要混。

Remote ControlClaude Code on the web
Claude 在哪跑你的机器Anthropic 云
能访问什么你的 MCP / 文件 / 项目配置沙箱 + 你授权的 GitHub repo
适合”我在做着,但想换个屏幕继续""我没本地环境,云上起一个”
网络要求出站 HTTPS / 长连接完全云端

3. 对独立开发者的真实使用模式

  • 早上启动一组 background sessions(配合 Agent View)+ /remote-control
  • 出门接孩子 / 吃饭 / 散步,手机收到 push:“sessions blocked, needs input”
  • 手机里 peek 一下,关键决策回个话
  • 回家继续

这套流程在 2026 之前根本不存在。

一句话总结

Remote Control = 给你电脑装上 SSH-but-for-claude 的能力,但只允许 claude.ai/code 这一个客户端连进来,凭证走 OAuth,流量走 Anthropic API,你机器不开任何端口。

💎 金句墙

★ “Claude keeps running locally the entire time, so nothing moves to the cloud.” “Claude 始终在本地运行,什么都不会移到云端。” —— 🟢 这一句安抚两类人:在意隐私的 / 在意性能的。你电脑该用 GPU 还用 GPU,该读私有文件还读私有文件

★ “Your local Claude Code session makes outbound HTTPS requests only and never opens inbound ports on your machine.” “本地 Claude Code session 只发出站 HTTPS 请求,从不在你机器上开监听端口。” —— 🟢 安全模型很干净 — 等同于”你机器在主动连 Anthropic 服务器,服务器再把手机的指令转给你”。没有 NAT 穿透、没有 STUN/TURN、没有 P2P

★ “Unlike claude remote-control (server mode), you can type messages locally while the session is also available remotely.” “跟 server mode 不一样,interactive 模式下你本地还能继续打字,session 同时对外开放。” —— 🟢 三种启动模式各有取舍 — server mode 适合”专门派一台机器跑”、interactive 适合”一边本地用一边手机看”

★ “Extended network outage… if your machine is awake but unable to reach the network for more than roughly 10 minutes, the session times out and the process exits.” “如果你机器醒着但断网超过约 10 分钟,session 超时,进程退出。” —— 🟢 这是真实硬限制 — 别在火车上、地铁里靠 Remote Control,会丢

📋 核心精读

1. 三个启动模式 + VSCode,选哪个?

Server mode(claude remote-control)— 专职服务器

cd ~/your-project
claude remote-control --name "My Project" --spawn worktree --capacity 8
  • 终端进程只服务远程,不能本地打字
  • 默认能并发 32 个 session(--capacity 调)
  • --spawn worktree 自动给每个新 session 起一个 git worktree(并行写不互踩)
  • 按 spacebar 显示 QR code,直接扫码进手机
  • 按 w 在 same-dir / worktree spawn 模式之间切换

Interactive mode(claude --remote-control 或 --rc)— 本地用,远程顺便能看

claude --remote-control "调研项目 X"
  • 跟普通 claude 一样,你能本地打字
  • 同一对话同时对外开放,手机/网页能 echo 你的输入、能发新消息
  • 这是最自然的”边本地边远程”模式

From existing session(在 session 里 /remote-control 或 /rc)— 半路扔到云

> /remote-control My Project
  • 保留完整对话历史 — session 不重启,接管即用
  • 同样显示 URL + QR code
  • 注意:--verbose、--sandbox 这几个 flag 在 slash 命令里不能传

VSCode(extension 里 /remote-control 或 /rc)— 跟 interactive 类似

  • v2.1.79+
  • 不支持 name argument 也不显示 QR code(从 banner 点 “Open in browser”)

🟢 我的推荐(独立开发者 / 单机):

  • 绝大多数时间 → claude --remote-control(interactive)
  • 过夜长跑或多 session 并行 → claude remote-control --spawn worktree(server mode)
  • 临时性”我现在要出门了” → 当前 session 里 /rc

2. 远程连进来的 3 个入口

session 起来后,会显示:

Session URL: https://claude.ai/code/sessions/<uuid>
QR code: (按 spacebar 切换显示)

连接方式:

  1. 任何浏览器打开 URL → 直接进 session
  2. 手机扫 QR code → 自动唤起 Claude app 跳到 session
  3. 打开 claude.ai/code 或 Claude app → 在 session 列表找(“Code” tab)

session 列表里 Remote Control session 长这样:电脑图标 + 绿点(在线)。

3. session 标题怎么来的(决定优先级)

Claude 选 title 的顺序:

  1. 你 --name 传的 / /rc <name> 传的
  2. 你 /rename 改的
  3. 已有对话里最后一条有意义的消息
  4. 兜底:<hostname>-<adjective>-<noun>(如 myhost-graceful-unicorn)

可以用 --remote-control-session-name-prefix <prefix> 改前缀,或环境变量 CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX。

🟢 实操:你机器是 MacBook-Pro.local 这种长名时,一定要改前缀 — myhost-graceful-unicorn 会被截成不易识别。

4. 一键开”所有 session 都启用 Remote Control”

> /config
# 把 "Enable Remote Control for all sessions" 设为 true

打开后,每个 interactive claude 进程自动注册一个 remote session。多开 terminal = 多个 session 同时挂在 claude.ai/code,各跑各的。

注意:多进程模式下每个进程只有一个 remote session。要”一个进程多个 session”,还是得 server mode。

5. 哪些 slash 命令在 Remote Control 能用?

网页/手机能用:

/compact, /clear, /context, /usage, /exit, /extra-usage,
/recap, /reload-plugins

只能在本地 CLI 用(因为它们要弹 picker):

/mcp, /plugin, /resume

🟢 实务影响:你在 commute 时通过手机用 Remote Control,装新 MCP server 不行(/mcp)、装新 plugin 不行(/plugin)、resume 旧 session 不行(/resume)。这三个动作必须本地。

6. 移动端 push 通知 — Remote Control 才有的功能

启用流程:

  1. 装 Claude iOS / Android app
  2. 用同一个账号登录
  3. 接受系统通知权限
  4. 在 Claude Code 里 /config → 打开 Push when Claude decides

Claude 自己决定什么时候推:

  • 长跑任务跑完了 → push
  • 需要你做决策才能继续 → push
  • 你 prompt 里说”notify me when tests finish” → push

没有更细的事件配置 — Anthropic 故意做得简单,避免通知疲劳。

实操坑:

  • iOS Focus mode / 通知摘要 会延迟或合并 push → 关掉 Claude 这个 app 的相关限制
  • Android 激进省电模式会延迟 → 把 Claude 从电池优化里排除
  • /config 里 “No mobile registered” → 打开手机 app 一次让它刷 token

7. 连接 + 安全模型

你的机器                   Anthropic API                claude.ai/code (browser)
  CLAUDE_CODE             OAuth + TLS                      Claude App (mobile)
  (outbound HTTPS)  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ (browser/app)
                          短期凭证按需轮换

关键设计点:

  • 不开 inbound 端口 — 完全靠 Claude Code 主动连 Anthropic 服务器
  • 凭证多份、短命(short-lived credentials),每份只服务单一目的,独立过期
  • 跟 Claude Code 平时跑 走同一条 TLS 通道、同一套 OAuth,不增加额外攻击面

🟢 跟 SSH 的差别:你不需要在 router 里开端口、不需要 ngrok / Tailscale / cloudflared 这些反向代理 — Anthropic 服务器就是中转。代价是你必须信任 Anthropic 的 TLS + 凭证管理(本来 Claude Code 已经在信任了,等同零增量)。

8. 与其他”非本地”路径的取舍

官方那张对比表是宝(我翻译 + 加了注解):

方案触发方式Claude 跑在哪何时用
Dispatch(Desktop + Mobile app pairing)手机发消息你机器(Claude Desktop)“派活给离开的电脑”;最低配置
Remote Controlclaude.ai/code 或 Claude app 驾驶你机器(CLI / VSCode)steering in-progress work(继续操控正在跑的)
Channels第三方 chat 推事件(Telegram / Discord / 自建)你机器(CLI)外部事件触发(CI 挂了、有人 chat 提到)
Slack 集成Slack @Claude mentionAnthropic 云团队 PR / review
Scheduled tasks(/loop / /schedule / CronCreate / Desktop schedule / Routines)时间触发CLI / Desktop / Cloud 三种周期性自动化

🟢 你只需要记:

  • “我在做着想换屏幕继续” → Remote Control
  • “我没本地环境,想直接云端启动” → Claude Code on the web(后面 11 章会写)
  • “出去玩,让 CI 挂了或邮件来了 Claude 自己反应” → Channels
  • “定时跑任务” → Routines / Scheduled tasks(后面 09 章)

9. 7 个真实坑(我帮你过了一遍 troubleshooting)

坑触发条件解法
API key 用户用不了ANTHROPIC_API_KEY / apiKeyHelper / ANTHROPIC_AUTH_TOKEN 任一被设置unset 它,改用 claude auth login 走 claude.ai OAuth(v2.1.139 明确禁了这条)
setup-token / CLAUDE_CODE_OAUTH_TOKEN 也不行这是 “full-scope” 才允许claude auth login 重新 full-scope 登录
第三方 provider 不支持Bedrock / Vertex / FoundryRemote Control 必须走 Anthropic 第一方
Team/Enterprise 默认关admin 没开claude.ai/admin-settings/claude-code → 打开 Remote Control toggle
Ultraplan 会踢掉 RC启动 ultraplan 时两个功能都占 claude.ai/code 界面,只能其一
断网 10 分钟超时退出机器醒着但断网重新 claude remote-control
disableRemoteControl managed settingIT 通过 managed settings 关找 admin

🟢 译者总评

1. Remote Control 是 Claude Code 团队对”我们已经做出了 IDE 替代品”的回应。

如果你不需要在桌面/笔记本前才能用 Claude Code,那么 Anthropic 实际上就直接绕过了”我必须坐在电脑前敲代码”这个传统约束。这跟 Cursor / Windsurf 等竞品的差异化:它们绑死 IDE,Anthropic 反过来把 IDE 解构成”任意一个能登 claude.ai 的设备”。

2. 它的设计语言一直在重申:你机器、你数据、你说了算。

仔细看几个细节:

  • 不开 inbound 端口
  • 凭证短命且分权
  • Web/Mobile 只是 “window into local session”
  • API key / 第三方 provider 一律不让用

这跟 cloud-first 的 Claude Code on the web 形成镜像。Anthropic 在押注:开发者会同时想要”本地的私密 + 远程的便利”,而不是非此即彼。

3. 实操上,跟独立开发者的工作风格高度契合。

回想你(memory 里的你)的工作模式:短冲刺 + 高频任务切换 + 期待 AI 在我离场时长跑。

Remote Control + Push 通知就是这套工作流的核心粘合剂:

  • 离场前用 /remote-control 把当前 session 扔到背景
  • 离场期间 Claude 该跑跑、该等等
  • 卡住时手机响一下
  • 你回话或回到电脑前继续

这一套配合 Agent View(第 1 篇)和 /loop(第 9 篇)就是完整的”独立开发者长跑栈”。

但要注意,它不是无成本的便利:每个 RC session 占着 quota,每个 Push 是一个 Haiku 决策,断网 10 分钟自动死。用得越熟越好,而不是用得越多越好。

🔗 延伸阅读

  • 同系列:01-agent-view.md(Agent View — RC 的兄弟功能)、09-routines-schedule.md(长跑工具链)、99-claude-product-matrix.md(Claude Code 在 Anthropic 产品矩阵里的位置,含 Claude Code on the web)
  • 官方:/en/channels — 第三方 chat 触发 session,RC 的”事件驱动版本”
  • 官方:/en/ultraplan — 跟 RC 互斥,要知道为啥

🔗 调研来源(可校验)

  • 主要原文:https://code.claude.com/docs/en/remote-control
  • changelog 累计提及:本机 raw/scan/CHANGELOG.md 中 grep 出 40+ 处,从 v2.1.51 第一次出现到 v2.1.139 仍在持续修复 / 增强
  • 与 Agent View 的关系:Agent View v2.1.139 上线后,Remote Control 角色发生微妙变化 — 现在 “many sessions” 由 Agent View 负责,Remote Control 主管 “drive sessions from elsewhere”
  • 本机版本验证:claude --version(本机 v2.1.139)、/status 应当显示当前登录方式