Appearance
Remote Control：随时随地控制你的本地 Claude 会话
出门在外，但 Claude 还在跑着任务？Remote Control 让你用手机或任何浏览器连接到本地正在运行的 Claude Code 会话。
Remote Control 需要 Claude Code v2.1.51 或更高版本，用
claude --version查看。
它是什么？能做什么？
Remote Control 把 claude.ai/code 或 Claude 手机 App（iOS/Android）连接到你本机运行的 Claude Code 会话。关键点：Claude 全程在本地跑，不会把你的代码上传到云端。
你可以：
- 完整使用本地环境：文件系统、MCP 服务器、工具、项目配置全都可用
- 多端同步：终端、浏览器、手机可以同时操作，消息实时同步
- 断网恢复：网络中断或电脑休眠后，重新连接时会话自动恢复
这与 Claude Code on the web 不同：后者跑在 Anthropic 的云服务器上，Remote Control 始终跑在你的机器上。
使用前提
- 订阅：Pro、Max、Team、Enterprise 均支持；API key 不支持
- Team/Enterprise 需要管理员在 Claude Code 管理设置 中开启 Remote Control
- 登录：在项目目录运行过
claude并完成/login登录 - 工作区信任：在项目目录至少运行过一次
claude，接受工作区信任对话框
三种启动方式
方式一：服务器模式（推荐用于长时间远程）
bash
cd your-project
claude remote-control进程持续运行在终端，等待远程连接。终端会显示会话 URL，按空格键可显示二维码，方便手机扫码。
常用参数：
| 参数 | 说明 |
|---|---|
--name "我的项目" | 设置会话名称，在 claude.ai/code 会话列表中显示 |
--spawn worktree | 每个远程会话独享一个 git worktree，避免文件冲突（需要 git 仓库） |
--capacity N | 最大并发会话数，默认 32 |
--verbose | 显示详细连接和会话日志 |
--sandbox | 开启沙箱隔离文件系统和网络 |
方式二：交互模式（边本地边远程）
bash
claude --remote-control
# 或简写
claude --rc "我的项目"开启一个普通交互会话，同时可以远程控制。和服务器模式的区别：你可以在本地终端直接输入，远程也可以输入，两端互通。
方式三：从现有会话开启
已经在 Claude 会话中了？直接输入：
text
/remote-control 我的项目会话历史保留，同时开始接受远程连接。
如何从其他设备连接
启动 Remote Control 后，有三种连接方式：
- 直接访问 URL：终端显示的会话 URL 用任意浏览器打开，直接进入 claude.ai/code 对应会话
- 扫二维码：
claude remote-control启动后按空格键显示二维码，手机扫码直接打开 Claude App - 在 claude.ai/code 找会话：打开 claude.ai/code 或 Claude App，在会话列表找到会话名称（在线时显示绿色圆点）
还没装 Claude 手机 App？在 Claude Code 里运行 /mobile 显示下载二维码。
为所有会话默认开启 Remote Control
不想每次手动加 --remote-control？在 Claude Code 里运行 /config，找到 Enable Remote Control for all sessions 设为 true。
连接安全性
- Claude Code 只发出出向 HTTPS 请求，不在本机开放任何端口
- 所有流量通过 Anthropic API 走 TLS 加密传输
- 使用多个短生命周期凭证，每个只用于特定目的，独立过期
Remote Control vs Claude Code on the web
| Remote Control | Claude Code on the web | |
|---|---|---|
| 运行位置 | 你的本机 | Anthropic 云服务器 |
| 本地文件 | 可访问 | 不可访问 |
| 本地 MCP 服务器 | 可用 | 不可用 |
| 适合场景 | 离开桌面后继续本地工作 | 无需本地环境，直接启动新任务 |
限制
- 每个进程一个远程会话：交互模式下，一个 Claude Code 进程只支持一个远程会话。要同时运行多个，用服务器模式 +
--spawn - 终端不能关：Remote Control 是本地进程，关终端 = 会话结束
- 网络中断 10 分钟以上：会话超时退出，重新运行
claude remote-control
常见问题
"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。Remote Control 需要 claude.ai 认证，不兼容第三方云服务商。清掉这些变量后，尝试 /logout 再 /login。
"Remote Control is disabled by your organization's policy"
先用 /status 确认登录方式。可能原因：
- 用 API key 登录了（需要切换到 claude.ai OAuth，运行
/login） - Team/Enterprise 管理员未开启（联系管理员在 admin-settings 开启）
- 组织有数据保留/合规配置不兼容 Remote Control（联系 Anthropic 支持）
"Remote credentials fetch failed"
加 --verbose 重新运行查看详细错误：
bash
claude remote-control --verbose常见原因：未登录 claude.ai 账号、防火墙拦截出向 HTTPS 请求（需要放通 443 端口）。
跨设备工作方式对比
| 方式 | 触发 | Claude 运行在 | 最适合 |
|---|---|---|---|
| Dispatch | 手机发送任务 | 本机（Desktop） | 离开时委托任务 |
| Remote Control | 从浏览器/手机驱动运行中的会话 | 本机（CLI/VS Code） | 从其他设备继续当前工作 |
| Channels | Telegram/Discord 等推送事件 | 本机（CLI） | 响应外部事件 |
| Slack | 在团队频道 @Claude | Anthropic 云 | 团队协作 PR 审查 |
| 定时任务 | 定时触发 | 本机或云 | 每日 PR 审查等重复性任务 |