📱 MobileVC — 手机就是你的 AI 编程助手控制台

摆脱键盘和鼠标，用手机直接接管电脑上的 Claude / Codex 会话。

MobileVC 把等待、审批、审核和继续执行，整理成一套适合手机操作的闭环。

官网：https://www.mobilevc.top

手机安装：官网首页（iOS 走 TestFlight，Android 走 APK 下载）

社区讨论：LINUX DO

---

这是什么

MobileVC 不是远程桌面，也不是终端镜像。它把电脑上正在运行的 AI 助手 CLI 会话带到手机上，让你在离开电脑时继续推进任务：

• 接住权限请求
• 推进 Plan Mode
• 审核 diff
• 恢复历史会话
• 浏览文件、日志和运行状态
• 管理 Skill / Memory / Context

---

快速开始

一键安装启动

npm install -g @justprove/mobilevc
mobilevc start

首次启动会引导你完成基础配置，并打印本机地址、局域网地址和二维码。

配置 Token 时，终端输入内容不会显示，这是正常的。直接输入完整 Token 后按回车即可。

手机连接

1. 手机访问 官网首页
2. iOS 点击 TestFlight 链接安装，Android 点击 APK 下载
3. 打开客户端，使用扫码连接或手动配置
4. 连接成功后，在输入框输入 claude 或 codex

官网可能需要国内网络环境访问。如果页面打不开，先切换到国内网络后再安装。

常用命令

mobilevc status
mobilevc logs
mobilevc logs --follow
mobilevc config
mobilevc stop

Relay 模式

不在同一 WiFi 下也能连：

mobilevc public --relay wss://relay.mobilevc.top:9443

如果只想走 Relay，不开放局域网：

mobilevc public --relay wss://relay.mobilevc.top:9443 --network-exposure-mode relay-only

Relay 只转发加密数据包，服务器看不到明文。密钥通过扫码带外传递。

自建 Relay 指南见 docs/guides/relay-deployment.md。

---

最近更新

• 全新语音通话助手：自配 Voice API / TTS API 后，先用语音和助手预沟通、确认任务，再一键交给本机 Claude / Codex 执行；支持自动识别停顿发送、调优静默判定（避免刚开口就被提前发送），交接后的执行态也不再误提示“需要补充信息”
• Codex 移动端控制增强：新增沙箱模式设置，细化权限控制，Codex 目标切换移入聊天工具栏，权限菜单改用审批图标，并跟随 Codex 默认 reasoning 展示
• 会话更稳：会话历史窗口可配置、续接历史按窗口收敛；修复会话同步、上下文占用显示和切后台状态跳动等问题
• 公网 Relay 更可靠：修复 mobilevc public --relay 重启后无法重新注册 / 配对，以及 agent 重连后陈旧连接的恢复问题
• 界面 polish：优化移动端浅色模式视觉一致性，修复聊天键盘布局与输入冻结
• 发布 0.2.10：各平台预编译后端二进制同步更新；Android 切到 arm64-v8a（官网入口指向 1.0.0 (20260601 arm64)），iOS Release / Profile 的 Archive 签名明确为 Apple Distribution

---

主要能力

• 语音通话预沟通，并把确认后的任务交给本机 Claude / Codex
• 继续电脑上的 Claude / Codex 会话
• 处理权限确认和 Plan Mode
• 按组查看并接受或回滚多文件 diff
• 浏览文件、日志、运行态和历史会话
• 管理 Skill / Memory / Session Context
• 接收权限和进度推送
• 可选 TTS
• Android 模拟器调试

---

对比定位

MobileVC 的定位不是“把终端塞进手机”，而是把 AI 编程助手的高频等待态做成手机上的结构化操作。下面只展示 MobileVC 在这些对比场景里的优势，不评价其他产品优劣。

对比对象	MobileVC 展示出的优势
Codex-Remote	同时覆盖 Claude / Codex；本机 npm 后端可控；权限、Plan Mode、diff 审核、Skill / Memory / Context、文件和日志都在同一套移动端工作流里
传统 SSH / 远程终端工具	不需要在小屏幕里操作终端；常见动作变成按钮和卡片；扫码连接、Token 鉴权、通知、状态同步和文件 / diff 查看都围绕 AI 助手场景设计
Happy	更偏本机私有工作台：Go 后端跑在自己的开发机上，支持 LAN + 官方 Relay，安装可从 npm 开始，并围绕 Claude / Codex 的权限、审查、会话恢复和项目文件流做深度整合

---

工作方式

Mobile browser / Flutter app
        │
        ▼
   MobileVC Go server
        │
        ├─ WebSocket event stream
        ├─ PTY / assistant runtime
        ├─ ADB + WebRTC bridge
        ├─ session store
        └─ ChatTTS sidecar (optional)

Go 后端

• 入口：cmd/server/main.go
• 负责 /ws、/healthz、/download、/api/tts/synthesize
• 编排会话、权限、文件、日志、Skill / Memory 和 ADB 调试

Flutter 客户端

• 入口：mobile_vc/lib/main.dart
• 根状态由 SessionController 驱动
• 首页是 SessionHomePage
• 负责把后端事件渲染成手机上可操作的界面

---

文档导航