Claude Chat Mobile 是一个本机自托管的 Claude Code 远程控制台。它将用户电脑上的 claude 命令行工具接入手机或浏览器，使用户在离开电脑后，仍可新建或续接 AI 编程会话、实时查看任务输出、回答 AI 提问、审批工具调用、中断任务并切换模型与权限档位，实现「坐在电脑前打字」与「在手机上打字」的终端等价体验。项目采用 Node.js + Express + Socket.io + Claude Agent SDK 构建，无数据库、无多租户、无云端后端，会话记录、设备信任、审计日志等控制面数据全部保存在用户自己的机器上。
项目包含以下功能模块：
一、会话驱动与审批模块：负责 Agent 会话的创建与流式驱动、工具调用审批的完整生命周期与持久化存储、命令行会话镜像状态判定、消息去重与旁路提问。
二、会话与工作区模块：提供多工作区与多会话的注册表管理、历史记录读取与断线事件补齐、跨设备共享的未读位点、以及「需要你处理」的待办聚合。
三、实时同步模块：基于 Socket.io 的双向实时通道，出向事件统一收敛为受白名单约束的事件信封，通过序号与纪元实现去重回放；并含多实例管理、只读镜像引擎与命令行钩子投递箱。
四、安全鉴权模块：强制令牌鉴权、登录限速与退避锁定、设备指纹识别与新设备审批、可选的 Cloudflare Access 身份层对接。
五、文件与代码交互模块：授权工作区内的文件浏览、预览、搜索、上传与编辑，Git 变更查看，以及工作区范围越权防护。
六、运维与通知模块：配置管理与校验、启动自检（doctor）、Web Push 与 ntfy 离线推送、状态栏与额度快照、运行指标、操作审计、常驻服务管理。
七、移动端前端模块：面向手机优化的渐进式 Web 应用（PWA），支持安装到主屏幕、消息时间线渲染、审批与提问卡片、会话抽屉
点击空白处退出提示
评论