Remote Control

Remote Control — Claude Code 远程连接

将本地终端 Claude Code 会话实时同步到手机 Claude app 或浏览器 claude.ai/code，支持双向交互。

前置条件

• Claude Code v2.1.51+（claude --version 检查）
• 订阅: Pro、Max、Team 或 Enterprise
• 认证: 必须使用 claude auth login（API key 不支持）
• Team/Enterprise: 管理员需在 claude.ai/admin-settings/claude-code 启用 Remote Control

三种启动方式

方式 A: Server 模式（推荐，长期运行）

claude remote-control

可用参数：

• --name "项目名" — 设置会话标题
• --spawn <mode> — same-dir（默认）或 worktree（隔离）
• --capacity <N> — 最大并发会话数（默认 32）
• --verbose — 显示详细日志
• --sandbox / --no-sandbox — 启用文件/网络隔离

方式 B: 启动新会话时开启

claude --remote-control
# 或带名称：
claude --remote-control "我的项目"

方式 C: 在现有会话中开启

/remote-control
# 或带名称：
/remote-control 我的项目

手机连接方式

启动后有三种连接方式：

1. Session URL — 在浏览器打开 claude.ai/code
2. QR Code — 在 claude remote-control 模式下按空格键显示 QR 码，用手机 Claude app 扫描
3. Session 列表 — 在 claude.ai/code 中按名称查找（在线会话显示绿点）

关键特性

• 双向同步: 终端和手机任一端发消息，另一端实时可见
• 本地运行: 代码在你的电脑执行，不上传云端
• 完整环境: 文件系统、MCP 服务器、工具配置全部远程可用
• 自动重连: 网络中断自动恢复
• 仅出站连接: 不开入站端口，通过 HTTPS 走 Anthropic API

常用命令

故障排查

限制

• 每个交互进程只支持 1 个远程会话（用 server 模式的 --spawn 支持多个）
• 终端必须保持打开（关闭终端 = 结束会话）
• 网络中断超过 10 分钟会超时断开

Remote Control vs Claude Code on Web