终端等价性
CLI 有什么 Web 就有什么；权限与配置同源。
Claude Chat Mobile 的核心产品目标是终端等价：终端 CLI 有什么，移动端 Web 就有什么。实现上不重造 Agent 调度，而是直接由 Agent SDK 驱动本机已登录的 claude CLI，并共用同一套配置、权限与 Transcript 历史。
等价原则与心智模型
当你不知道某个功能该怎么做时：CLI 有什么 web 就有什么，先去找 claude code CLI 是怎么实现的。——
CLAUDE.md
本项目不是远程桌面投屏，更不是另一个平行实现的 Claude 客户端。在手机上发送一条提示词、批准一次工具调用、切换一次模型或调整思考强度，在底层必须等价于坐在电脑前直接敲击终端命令。任何「Web 还需要什么新功能」的需求，默认动作是寻找 CLI 原生实现进行对接，严禁在桥接层私造平行逻辑。
驱动同源
依托官方 Agent SDK 与本机已登录的 claude 二进制建立 IPC 通信，而非自写工具循环。
配置同源
settingSources: ['user','project','local']，完整遵循 CLI 的配置分层继承顺序。
会话同源
Transcript 统一持久化在 ~/.claude/projects/，与 CLI /resume 指向完全一致的记录文件。
配置加载与权限体系
系统启动 Agent 时显式声明：
settingSources: ['user', 'project', 'local']这意味着用户在电脑端 ~/.claude/settings.json 或当前项目 .claude/settings.json 中配置的自定义规则、API 环境变量、自定义 MCP 服务器和 Hooks 会自动对 Web 端生效。
权限放行：绝不注入 allowedTools
在创建 SDK 实例时，系统坚决不注入 options.allowedTools。放行集合完全依托于 settings 中 permissions.allow 的并集（与终端 CLI 逻辑逐字相同）：
| 层级 | 触发行为 | 处理策略 |
|---|---|---|
settings permissions.allow | 与用户本地配置命中 | SDK 内部底层直接放行，不触发 canUseTool 回调，手机不弹窗 |
canUseTool 拦截闸 | 未在白名单中的操作（如非只读 Bash） | 由 CCM 捕获，根据当前权限档位决定直接放行、拒绝或推送到手机界面弹窗审批 |
| 桥接层自设规则 | 禁止建立独立的白名单配置 | 严格避免 Web 端与 CLI 终端规则分叉 |
~/.claude/settings.json。如果在终端中长期积累了过宽的 Bash(...) 自动放行规则，移动端连接后同样会自动放行，而不会弹窗二次确认。
六档权限模式
系统在运行时支持 6 档权限模式（通过 setPermissionMode 动态切换）：
| 模式枚举 | 语义与行为 | 与 CLI 的对应关系 |
|---|---|---|
default | 默认安全档：白名单外操作通过 canUseTool 弹出手机卡片审批 | 与 CLI 默认交互行为完全等价 |
plan | 计划模式：禁止破坏性写操作，仅允许规划与只读探索 | 与 CLI Plan 模式语义一致 |
acceptEdits | 接受编辑档：自动放行常规文件修改与编辑工具 | 对齐 CLI 接受编辑档位 |
bypassPermissions | 跳过审批档：给 SDK 映射为 default，由 CCM 内部直接放行，避免传全局危险标志 | 等价于 CLI --dangerously-skip-permissions |
dontAsk | 静默拒绝档：白名单外工具一律自动拒绝，手机绝不弹窗打扰 | Web 独有安全档，CLI Transcript 不会产生此标记 |
auto | 自动模型裁决档：依托 SDK 内部模型分类器自动判定批准或拒绝 | 对接 SDK 实验性智能判权特性 |
模型切换与思考强度 (effort) 控制
用户可以在移动端输入框随时切换活跃模型（如 Sonnet / Opus / Haiku / Fable）与思考强度（effort）。得益于 SDK 升级，思考强度支持通过 applyFlagSettings({effortLevel}) 运行时即刻生效，无需销毁重建实例。新开会话（FRESH）默认采用 CLI 设置合并后的基线配置，保证与直接新起命令行体验完全一致。