9.6 Remote Control：随时随地操控 Claude Code

人在外面，代码还在跑——手机上继续操控你的 Claude Code。

场景

你在电脑前让 Claude Code 跑一个大型重构任务，突然要出门。以前你只有两个选择：等它跑完，或者放弃进度。

现在有了 Remote Control，你可以：

1. 在终端开启 Remote Control
2. 掏出手机，打开 Claude App 或浏览器
3. 继续看进度、审批操作、发新指令

代码始终在你本地机器上执行，手机只是一个远程"遥控器"。

---

它是怎么工作的

核心架构非常简单：

你的电脑（Claude Code）  ──HTTPS出站──▶  Anthropic API  ◀──  手机/浏览器

三个关键点：

1. 代码不上云 —— 所有文件读写、命令执行都在本地机器上完成
2. 纯出站连接 —— 你的机器只往外发 HTTPS 请求，不开放任何入站端口，不需要配端口映射或内网穿透
3. 自动重连 —— 网络断了、笔记本合上了，恢复后会自动重新连接

你的 MCP 服务器、项目配置、Hooks、权限设置——这些全都在本地，Remote Control 会话可以正常使用它们。

---

前提条件

在开始之前，确认以下几点：

条件	要求
Claude Code 版本	v2.1.51 或更高（claude --version 查看）
订阅计划	Pro / Max / Team / Enterprise
认证方式	claude.ai OAuth 登录（不支持 API key）
Team/Enterprise	管理员需要在后台启用 Remote Control

如果你还没登录，先跑一次：

claude
# 进入后输入 /login，按提示完成 OAuth 认证

---

三种启动方式

方式一：服务器模式

这是最常用的方式。它启动一个专门的 Remote Control 服务器，可以同时管理多个远程会话：

# 最简单的启动
claude remote-control

# 给会话起个名字，方便在手机上找到
claude remote-control --name "我的重构项目"

启动后终端会显示：

• 一个连接 URL
• 按空格可以显示 QR 码
• 当前连接状态

方式二：交互模式 + 远程访问

如果你已经在用 Claude Code 干活，想顺便开启远程访问：

# 启动时就带上 --remote-control
claude --remote-control

# 也可以加名字
claude --remote-control "重构 Auth 模块"

这样你既有本地的交互式终端，又能从手机上连进来。

方式三：在已有会话里开启

已经在对话中了？输入斜杠命令：

/remote-control
/remote-control "Session Name"

如果你希望所有会话都自动开启 Remote Control，可以在设置里打开：

/config
# 找到 "Enable Remote Control for all sessions"，切换为 true

---

从手机/浏览器连接

开启 Remote Control 之后，有三种方式从其他设备连进来：

扫 QR 码（最方便）

在 claude remote-control 运行的终端里按空格键，会弹出一个 QR 码：

用手机相机或 Claude App 扫码，直接进入会话。

复制 URL

终端里会显示一个连接 URL，复制到任何浏览器里打开就行。

从会话列表找

打开 claude.ai/code 或 Claude 手机 App：

在线的会话旁边会有一个绿色圆点，点击即可进入。你给会话起的 --name 会显示在这里，所以起个有意义的名字很重要。

提示： 在 Claude Code 里输入 /mobile，会显示 Claude App 的下载 QR 码。

---

实战演练：手机上继续任务

来走一遍完整流程。

第一步：在电脑上开始工作

cd ~/projects/my-app
claude --remote-control "重构用户模块"

进入后，给 Claude 一个任务：

把 src/services/user.js 里的回调地狱改成 async/await，
并更新对应的测试文件。

Claude 开始干活了——读文件、改代码、跑测试。

第二步：开启远程，出门

任务还在跑，但你要出门了。因为启动时已经带了 --remote-control，直接合上笔记本就好（进程保持运行即可，建议用 caffeinate 或在 tmux/screen 里跑）。

Mac 用户小贴士： 合上盖子会导致进程挂起。建议在 tmux 或 screen 里运行，或者用 caffeinate -i claude --remote-control "xxx" 防止休眠。

第三步：手机接管

打开手机上的 Claude App，在会话列表里找到"重构用户模块"（绿点表示在线），点进去：

你可以看到：

• Claude 目前的工作进度
• 它执行了哪些操作
• 需要你审批的权限请求

继续在手机上发指令：

测试都通过了吗？如果有失败的帮我修一下。

Claude 在你电脑上执行测试、修复代码，结果实时同步到手机。

---

服务器模式进阶

claude remote-control 的服务器模式支持一些进阶参数：

并发会话管理

# 每个连接者获得独立的 git worktree（推荐用于团队）
claude remote-control --spawn worktree --name "Team Server"

# 所有连接者共享同一目录（默认行为）
claude remote-control --spawn same-dir

--spawn worktree 特别适合团队场景——每个连进来的人都在自己的分支上干活，互不干扰。前提是当前目录是一个 git 仓库。

容量控制

# 最多允许 5 个并发会话
claude remote-control --capacity 5

默认值是 32。

调试模式

# 显示详细的连接日志
claude remote-control --verbose

遇到连接问题时，先加 --verbose 看看发生了什么。

沙箱隔离

# 启用沙箱模式，限制文件系统和网络访问
claude remote-control --sandbox

---

Remote Control vs Claude Code on Web

Anthropic 还提供了 Cloud 上的 Claude Code（在 claude.ai/code 里直接使用）。两者的区别：

	Remote Control	Claude Code on Web
代码在哪跑	你的本地机器	Anthropic 的云服务器
文件系统	完整访问本地文件	只能访问云端环境
MCP 服务器	本地已配置的都能用	仅云端可用的
Hooks	你的本地 Hooks 正常执行	不可用
需要设置	本地已有环境	无需本地环境
适合场景	继续本地开发、需要本地工具链	从零开始、不在自己电脑前

选择建议：

• 在自己项目上干活，只是换个设备继续 → Remote Control
• 临时想试个想法，手边没电脑 → Claude Code on Web

---

常见问题

"Remote Control is not yet enabled for your account"

通常是因为环境变量干扰了。检查并移除这两个变量：

unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
unset DISABLE_TELEMETRY

然后重新登录：

# 在 Claude Code 里
/logout
/login

"Remote Control is disabled by your organization's policy"

两种可能：

1. 你用的是 API key 而不是 claude.ai 登录 → 用 /login 切换到 OAuth
2. Team/Enterprise 管理员没开这个功能 → 找管理员在后台打开

连接经常断开

• 检查网络是否稳定
• 确保本地进程还在运行（建议用 tmux / screen）
• 加 --verbose 看详细日志定位问题
• 网络中断超过 10 分钟会导致会话超时

手机上看不到会话

• 确认 Remote Control 进程还在运行
• 确认手机登录的是同一个 claude.ai 账号
• 刷新会话列表，在线会话有绿色圆点标识

---

小结

Remote Control 的核心价值是把你从电脑前解放出来——代码仍然在你本地安全执行，但你可以从任何设备上操控它。

启动就一条命令：

claude remote-control --name "My Project"

掏出手机，扫码连接，继续干活。就这么简单。

---

下一步，你可以回到 9.1 非交互模式 了解如何用脚本自动化 Claude Code，或者看看 附录 A：CLI 命令速查 查阅 Remote Control 的完整参数列表。