CCB Mobile远程操控完整教程：如何用手机指挥服务器上的AI编码智能体-迪斯科星球

CCB Mobile远程操控完整教程：如何用手机指挥服务器上的AI编码智能体

【免费下载链接】claude_codex_bridgeVisible multi-agent CLI workspace for mixing Codex, Claude, Gemini, Kimi, Qwen, Cursor, Copilot, Pi, OpenCode, and other AI coding agents项目地址: https://gitcode.com/gh_mirrors/cl/claude_codex_bridge

CCB Mobile 是 CCB（Claude Code Bridge）官方推出的移动端远程操控工具：手机安装一个 App，就能跨网络发现服务器上所有 CCB 多智能体项目，随时向 Codex、Claude、Gemini 等 AI 编码智能体发送指令、查看对话、打开终端并传输文件。本教程带你在 3 步内完成手机配对，真正实现对服务器 AI 编码智能体的远程指挥。

什么是 CCB Mobile？为什么你需要它

CCB 是一个可视化的多智能体 CLI 工作区，让 Codex、Claude、Gemini、Kimi、Qwen、Cursor、Copilot、Pi、OpenCode 等 AI 编码智能体在 tmux 窗口中协同工作。而CCB Mobile把它从“必须坐在服务器前”解放出来：

📡服务端运行，手机端遥控：CCB 和各智能体 CLI 运行在服务器上，手机只是一个 CCB 感知的控制器
🗂️跨项目发现：手机首页列出服务器上全部已挂载、可访问的 CCB 项目
💬对话优先的 Agent 工作区：像聊天软件一样与选中的智能体对话，而不是盯着一堆终端
🔔任务完成通知：智能体干完活，手机收到通知，人不用守着屏幕

CCB Mobile 核心功能：手机上能做的 5 件事

功能	说明
Agent 对话控制	顶部快速切换 Agent，向选中智能体的终端面板直接发送文本
终端视图	显式打开原始终端，支持键盘、粘贴、重连
文件传输	通过认证网关上传/下载图片与文档
多项目浏览	打开、唤醒、关闭服务器上的 CCB 项目
通知与状态	任务完成提示、项目级运行指示灯

💡 手机端的消息发送写入的是智能体原生的 tmux 面板（pane-native input），所以你手机上发出的指令，和你 SSH 到服务器上手动输入的效果完全一致。

快速上手：3 步完成远程操控配对

第 1 步：在服务器上安装移动网关

只需一条命令，它会引导你完成安装和路由配置：

ccb update mobile

该命令会启动服务器级移动网关（默认仅绑定回环地址127.0.0.1:8787）并打印一个配对二维码 + 连接码。移动端网关源码位于 lib/mobile_gateway，App 源码位于 mobile/app。

第 2 步：选择连接路由

ccb update mobile会引导你在以下几种远程访问方式中选择，手机侧无需做任何路由判断：

LAN 直连：手机与服务器连同一 Wi-Fi / 有线局域网（避开访客隔离网络）。例如ccb install mobile --route-provider lan --listen 192.168.31.155:8787
Tailscale Tailnet：稳定的私有网络路由（使用 Tailscale Serve，不使用 Funnel）
CCB Relay / 自建 Relay：不在同一局域网时的默认远程路线，Relay 只传输加密信封，不接触明文任务数据
Cloudflare Tunnel：进阶自建路线

第 3 步：手机扫描配对

打开手机上的 CCB Mobile App（Android APK 可通过项目发布渠道获取），首屏只有两个动作：

扫描电脑二维码（推荐）
或展开「输入连接码」，粘贴终端里打印的ccb1_开头的连接码

手机会自动从扫码载荷中推导全部连接配置，无需填写 IP、网关地址或设备名。配对完成后，App 只会获得配对配置所授权的权限范围（如查看、内容、终端、文件上传/下载）。

日常使用：手机上指挥 AI 编码智能体的 4 个场景

场景 1：远程下发编码任务

在 App 首页选择项目，顶部切换到目标智能体（例如worker1:codex），在底部常驻输入框中输入指令，比如“修复登录页的解析错误并运行测试”，发送即写入该智能体面板，输出会实时渲染为对话式时间线。

场景 2：查看 Agent 工作过程与历史

选中的 Agent 工作区展示垂直可滚动的会话时间线，包括智能体原生转录、面板输出和回滚缓冲；头部还会显示当前 Provider / 模型 / 思考状态，让你远程也能确认“它现在用的是哪个模型”。

场景 3：传输文件与产物

开发过程中产出的图片、日志、文档可直接在 App 内下载；反过来，设计稿、需求截图也能上传给智能体参考——全部走认证网关，无需额外配置 SFTP。

场景 4：任务完成通知

智能体完成一个长任务后，App 会收到任务完成系统通知（低敏感事件流驱动），配合项目级运行指示灯，你可以完全离开终端，只在小憩时瞥一眼手机。

安全边界：远程操控 AI 智能体是否安全？

CCB Mobile 的远程操控有明确的安全设计：

🔒网关默认仅回环：ccbd移动网关默认只监听127.0.0.1，LAN 直连必须绑定具体内网地址，通配符和公网地址会被拒绝
🛡️权限最小化：手机只拿到配对配置授权的 scopes（查看 / 内容 / 终端 / 文件上传 / 文件下载）
📦Relay 不存明文：Relay 模式只中转加密信封，无法看到任务提示词、回复、终端输出或文件明文
🚫不托管你的凭据：CCB 不存储 Tailscale 密码、OAuth 令牌，也不自动修改 Tailnet ACL

更多远程访问模式细节可参考 relay-deployment-modes.md。

企业官网建设流程全解析