封面与导读
Claude Chat Mobile 项目全景手册：认识项目、阅读路线与事实基线。
Claude Chat Mobile 是一层默认上锁的桥接转发层：把你本机已登录的 claude CLI 接到手机浏览器。同一会话、同一份 transcript、同样的权限与配置。
1
用户 / 实例 (n=1)
0
多租户设计
2000
事件环形缓冲
28
本手册页数
定位
终端等价入口
不是远程桌面，也不是 Claude 的重新实现。坐在电脑前对终端打字，和在手机上打字效果等价。
形态
自托管桥 (n=1)
Node ≥20 · ESM · Express 5 · Socket.IO 4 · Agent SDK 驱动本机 CLI。坚守单用户自托管立场。
手册
按认知顺序
认识 → 演进 → 方法论 → 实现 → 数据 → 运维 → 规范。以 dev 代码与最新门禁体系为事实基线。
这本手册从哪来
源码分支为 dev（当前基线 HEAD 687bca3）。仓库采用产品宪法 C1–C5 与硬性规则治理（详见 docs/hard-rules.md 与 docs/architecture.md），本手册按真实运行代码与架构契约重叙述，不照搬历史陈旧文档。
事实基线约定手册关键数字、协议契约与模块边界以当前 dev 代码为准。若代码演进后行为与手册发生漂移，以生产代码及
tests/gates/ 门禁为准，并应在漂移清单中透明登记。
范围本手册描述产品源码（dev 分支），产物部署于 gh-pages 分支的
docs-site/ 目录，与展示站点统一维护。
三条阅读路线
主线
完整通读 · 约 2–3 小时
从起点到规范，按认知层次逐章顺读。适合准备深入二次开发、维护或接手仓库的人。
角色
按关注面切入
运维部署直奔第六部分；同步与通信查「单驾驶员」与「事件信封」；鉴权安全查第四部分鉴权页。
技术栈一瞥
| 层级 | 技术选型 | 关键特性 |
|---|---|---|
| 运行时 | Node ≥20 · ESM · Express 5 · Socket.IO 4 | 三层架构，前后端零构建纯 ESM |
| Agent 驱动 | @anthropic-ai/claude-agent-sdk 0.3.263 | 双向流控制，驱动本机已登录的 claude CLI |
| 配置与运维 | ccm.config.json · env-schema.js | 统一结构化配置、热重载工作区、统一读写源 |
| 鉴权与安全 | jose 6 (JWT) · 设备 TOFU · IPv6 /64 限速 | 单用户强制 Token，非本地网络设备指纹审批 |
| 离线推送 | web-push (VAPID) · 可选 ntfy | 审批/提问无条件推送，前台可见连接智能抑制 |
| 测试与门禁 | node --test · Playwright · 宿主机白名单 | S0–S7 执行槽分层，容器沙箱 HOME 隔离破坏性操作 |
| 开源许可 | AGPL-3.0-only · NOTICE 补充条款 | 严格保障自托管权益 |