Claude Code Remote Control 使用技巧:从入门到精通
Claude Code 已经从根本上改变了开发者与 AI 的交互方式,将强大的编程辅助能力直接带入终端。但当你需要离开工作站时怎么办?借助 Remote Control(远程控制) 功能,你的编程会话不必中断——你可以从浏览器、手机或平板无缝继续工作。
本文将带你深入了解这一功能,从基础设置到高级工作流,助你实现真正的移动编程生产力。
核心概念:本地运行,远程操控
理解 Remote Control 最关键的一点是:你的 Claude Code 会话始终在本地机器上运行。Web 和移动端界面只是一个安全的窗口,让你可以远程查看和操控这个本地会话。你的文件系统、MCP 服务器、工具链和项目配置全部保留在本地,不会上传到云端。
这意味着:
- 你拥有本地环境的全部能力
- 数据安全性得到保障
- 网络仅传输聊天消息和工具结果
准备工作
在开始之前,请确保满足以下条件:
- 订阅计划: 需要 Max 计划($100-$200/月)。目前作为研究预览功能提供,Pro 计划支持即将推出
- CLI 版本: Claude Code
v2.1.52或更高版本 - 身份验证: 在终端中运行
claude,然后使用/login命令通过 claude.ai 完成登录 - 工作区信任: 在项目目录中至少运行过一次
claude,并接受工作区信任对话框
# 检查版本
claude --version
# 登录认证
claude
/login
启动远程会话
方式一:独立命令启动
在项目目录中直接运行:
claude remote-control
支持的参数:
--verbose:显示详细的连接和会话日志,便于调试--sandbox/--no-sandbox:启用或禁用沙箱模式,提供文件系统和网络隔离
方式二:从现有会话中启动
如果你已经在 Claude Code 会话中工作,无需重新开始。使用斜杠命令即可:
/remote-control
或简写:
/rc
这种方式会保留当前的对话历史,让你可以在移动端继续之前的工作上下文。
注意:通过
/rc启动时不支持--verbose和--sandbox参数。
启动后,终端会显示一个会话 URL 和一个 QR 码(按空格键切换显示)。
从其他设备连接
会话启动后,你有多种连接方式:
- 会话 URL: 直接在浏览器中打开终端显示的 URL,即可进入 claude.ai/code 上的会话
- 扫描 QR 码: 使用 Claude 移动应用扫描 QR 码,这是从手机连接最快的方式
- claude.ai/code 仪表板: 登录后,你的活跃远程会话会自动列出。Remote Control 会话显示一个带绿色状态点的电脑图标
- Claude 移动应用: iOS 和 Android 应用中可以直接看到所有活跃会话
实用技巧
1. 使用 /rename 命名会话
默认的随机会话名难以辨识。在启动 /rc 前,先用 /rename 给会话一个有意义的名称:
/rename "Refactor: Auth Service"
/rc
这样在多设备上查看会话列表时一目了然。
2. 预先提供完整的任务指令
由于你可能会在手机上操作(输入不便),应在启动任务时给 Claude 一个清晰、完整的指令。这样即使你只是偶尔在手机上查看,AI 也能按照预设目标持续工作。
3. 提前配置 MCP 服务器
如果你的工作流依赖特定的 MCP 服务器,必须在启动 Remote Control 之前配置好。远程连接后无法添加新的 MCP 服务器。
4. 为每个任务创建 Git 分支
这是一个通用的好习惯,但在远程开发中尤为重要:
git checkout -b feat/auth-refactor
独立的分支确保工作隔离,方便你回到桌面后进行代码审查。
5. 保持终端运行
启动 claude remote-control 的终端进程必须保持运行——关闭终端或停止 claude 进程会结束会话。
好消息是:笔记本可以合盖休眠。当设备唤醒并重新连接网络后,会话会自动恢复连接。
6. 注意网络超时
如果你的机器处于唤醒状态但无法连接网络超过约 10 分钟,会话会超时退出。请确保网络环境稳定。
7. 为所有会话默认启用
如果你经常使用 Remote Control,可以通过 /config 设置"Enable Remote Control for all sessions"为 true,这样每次启动会话时都会自动开启远程控制。
真实场景应用
大型重构任务
在办公室的工作站上启动一个跨多文件的重构任务。通勤路上用手机查看进度,审批或拒绝 Claude 提出的修改方案,无需将整个项目克隆到笔记本上。
后台构建调试
触发一个耗时的构建流程后去参加会议,用手机随时检查构建日志。如果构建失败,可以立即在手机上指示 Claude 进行修复。
多项目并行管理
为不同任务运行多个 Claude Code 实例,每个实例独立管理自己的远程会话和环境。在手机上可以在不同会话间快速切换。
移动中的 Code Review
团队提交了一个紧急 PR。在手机上通过 Remote Control 连接到项目环境,不仅能查看代码差异,还能直接让 Claude 运行测试,进行深入审查。
安全模型
Remote Control 的安全设计值得信赖:
- 仅出站连接: 你的机器只发起出站 HTTPS 请求,不会打开任何入站端口,不会暴露到公网
- TLS 加密: 所有流量通过 TLS 加密传输,与常规 Claude Code 会话使用相同的传输安全标准
- 短期凭证: 连接使用多个短期凭证,每个凭证作用域独立且自动过期
- 数据不离机: 你的文件和 MCP 服务器数据不会离开本地机器,只有聊天消息和工具结果通过加密通道传输
- URL 即凭证: 会话 URL 相当于密码,不要公开分享
Remote Control vs. Claude Code on the Web
| 特性 | Remote Control | Claude Code on the Web |
|---|---|---|
| 运行环境 | 你的本地机器 | Anthropic 云端基础设施 |
| 本地环境 | 完全访问文件系统、MCP 服务器、工具链 | 无本地访问 |
| 适用场景 | 从其他设备继续本地工作 | 无需本地设置即可开始任务 |
| 数据位置 | 文件始终在本地 | 文件在云端工作区 |
| 性能 | 取决于本地硬件 | 由 Anthropic 管理 |
已知限制
- 每个 Claude Code 实例仅支持一个远程会话
- 终端必须保持打开——关闭终端会结束会话
- 网络中断约 10 分钟会导致会话超时退出
- 不支持
--dangerously-skip-permissions——必须逐一审批 AI 的操作 - 手机屏幕限制——不适合详细的代码检查,更适合监控和简单交互
- 仅限 Max 计划(研究预览阶段),暂不支持 Team 或 Enterprise 计划
结语
Claude Code Remote Control 代表了一种更现代、更灵活的开发范式。它将你从物理设备的束缚中解放出来,让你能够随时随地以最高效率投入工作。无论是管理长时间运行的任务、在通勤路上审查代码,还是在多设备间无缝切换,Remote Control 都将成为你开发工具箱中不可或缺的一部分。
现在就试试 claude remote-control,开启你的移动编程新体验吧!