nexus4cc — 手机远程控制 Claude Code 的自托管终端
> 一句话版本：把你的 Claude Code 终端变成手机上的 App——通过 WebSocket 连接 tmux，在手机上给 Claude 下指令、看进度、切会话，关掉手机 Agent 继续跑。
| 项目 | 信息 | |
|---|---|---|
| 来源 | https://github.com/librae8226/nexus4cc | |
| 创建时间 | 2026-04-06 | |
| Stars | 75 | Forks 17 |
| 语言 | TypeScript | |
| 许可证 | GPL v3（开源）/ 商业许可可选 | |
| 作者 | librae8226, faywong | |
| 依赖 | Node.js 20+, tmux, PM2 |
核心内容
做什么的？
nexus4cc 是一个自托管的 Web 终端，专门为远程控制 Claude Code 设计：
手机浏览器（PWA）
↓ WebSocket
nexus4cc 服务端（Node.js）
↓ tmux attach
Claude Code 终端会话
你可以在手机上：
- 实时看到 Claude Code 的终端输出
- 给 Claude 下指令、切项目、切频道
- 关掉手机，Claude 继续在 tmux 里跑
- 随时回来，一切都在
核心功能
| 功能 | 说明 |
|---|---|
| WebSocket ↔ tmux 桥接 | 一个 PTY per window，实时双向 I/O |
| 移动优先终端 | xterm.js，滑动切换、缩放、可配置软键盘工具栏 |
| Task Panel | 启动 Claude 任务，SSE 流式监控进度 |
| 文件浏览器 | 浏览、编辑、上传工作区文件 |
| 项目 + 频道管理 | 目录级项目，每个项目多个频道（类似 Slack） |
| 多会话切换 | tmux session 之间瞬间切换 |
| PWA | 可安装到手机桌面，暗色/亮色主题 |
| 零开销 | 直连 WebSocket，不需要 SSH |
快速部署
git clone https://github.com/librae8226/nexus4cc.git && cd nexus4cc
cp .env.example .env # 设置 JWT_SECRET, ACC_PASSWORD_HASH, WORKSPACE_ROOT
npm install && cd frontend && npm install && npm run build && cd ..
npm start
# 打开 http://localhost:59000
默认密码：nexus123。推荐通过 Cloudflare Tunnel 或 Tailscale 暴露，不直接裸露到互联网。
安全机制
- bcrypt 12 轮密码哈希 + JWT（30 天有效期）
- 单用户设计，非多租户平台
- WebSocket token 通过 query string 传递（生产环境需启用 TLS）
- 建议放在防火墙/VPN/隧道后面
与竞品对比
| 维度 | nexus4cc | Paseo | Anthropic Remote Control |
|---|---|---|---|
| Stars | 75 | 1,116 | — |
| 远程控制 | ✅ | ✅ | ✅ |
| 手机端 | ✅ PWA 优先 | ✅ | ❌ |
| 桌面端 | ⚠️ | ✅ 原生 | ✅ |
| CLI | ❌ | ✅ | ❌ |
| 自托管 | ✅ | ✅ | ❌ |
| 订阅费 | ✅ 免费 | ✅ 免费 | ❌ $100+/月 |
| tmux 集成 | ✅ 核心 | ✅ relay | ❌ |
| 项目/频道管理 | ✅ | ⚠️ | ❌ |
| 开源 | ✅ GPL v3 | ✅ AGPL-3.0 | ❌ |
| Fire & forget | ✅ 纯 tmux | ✅ via relay | ⚠️ 10min timeout |
分析
优势：
- 解决了真实痛点：Claude Code 只能在终端用，不在电脑前就没法操作
- PWA 体验好：可安装、移动优先设计
- 真正的 Fire & Forget：tmux 保证 Agent 持续运行
- 自托管 + 免费：不依赖第三方服务
- 项目/频道管理：比直接 tmux attach 更有组织性
不足：
- 75 stars，个人项目，维护风险
- 单用户设计，不支持多用户
- WebSocket token 在 query string（安全隐患）
- GPL v3 许可证对商业产品有传染性
- 文档较少（项目才 8 天）
- 仅支持 Linux/WSL2
与 Jay 的关联：
- OpenClaw 的 exec 工具本质也是远程控制终端，但通过 Discord/飞书
- 如果 Jay 想在手机上操作 Claude Code/Codex，nexus4cc 比 Paseo 更轻量
- 但 OpenClaw 本身已经提供了移动端消息接口（Discord/飞书），功能重叠
评分
| 维度 | 评分 (1-10) | 说明 |
|---|---|---|
| 实用性 | 7 | 解决了手机控制 Claude Code 的真实需求 |
| 创新性 | 5 | WebSocket + tmux 桥接不算新，但产品化做得好 |
| 代码质量 | 6 | 8 天项目，待验证 |
| 生态潜力 | 5 | 个人项目，社区小 |
| 与 Jay 的关联 | 5 | OpenClaw 已提供移动端接口，重叠 |
| **总分** | **5.7** | 小而美的工具，解决具体痛点，但项目太新 |