在移动优先的开发环境中，AI 编程助手如 Claude Code 面临着独特的架构挑战：如何在资源受限的移动设备上提供完整的开发体验，同时保持与云端 AI 模型的低延迟交互？传统的移动端开发方案往往需要在本地运行轻量级模型或依赖不稳定的网络连接，而 Claude Code On-the-Go 采用了一种创新的云 VM+SSH 隧道架构，实现了真正的移动端异步开发工作流。
云 VM+SSH 隧道：移动开发的架构范式转移
Claude Code On-the-Go 的核心洞察是：与其在移动设备上运行资源密集的 AI 模型，不如将计算卸载到云端 VM，通过优化的网络隧道实现远程访问。这一架构由多个精心选择的组件构成：
Vultr VM 作为计算核心：选择 8 核 32GB 的 vhf 实例，按小时计费（$0.29/hr），仅在开发时启动。这种按需付费模式将每日成本控制在 $7 以内，同时提供了充足的算力资源。VM 配置为 Tailscale-only 访问，公网 IP 不开放 SSH 端口，实现了深度防御安全策略。
Tailscale 构建私有网络：作为 WireGuard 的封装，Tailscale 提供了零配置的 mesh VPN，确保 VM 与移动设备间的加密通信。配合云防火墙规则（仅允许 Tailscale 协调端口）和本地 nftables，形成了三层防护体系。
Termius + mosh 实现网络弹性：Termius 作为 iOS/Android 的 SSH 客户端，配合 mosh（Mobile Shell）协议，解决了移动网络不稳定的核心痛点。mosh 使用 UDP 协议和状态同步机制，能够在 WiFi 与蜂窝网络切换、信号中断甚至设备休眠后自动恢复会话，正如开发者所述："Switch from WiFi to cellular, walk through a dead zone, put the phone to sleep. The connection persists."
tmux 提供会话持久化：通过.zshrc 自动附加到 tmux 会话，即使 Termius 应用被关闭或崩溃，开发状态也能完整保留。多个 Claude 代理可以在不同的 tmux 窗口中并行运行，使用C-a c创建新窗口，C-a n循环切换，适配移动端键盘操作习惯。
离线缓存与同步策略：从被动等待到主动通知
移动开发的最大挑战之一是网络中断时的状态保持。Claude Code 工作流通过多层缓存和智能同步机制解决了这一问题：
Git worktrees 实现并行开发隔离：通过 Git worktrees 创建多个工作目录，每个功能分支拥有独立的开发环境：
~/Code/myproject/ # main分支
~/Code/myproject-sidebar/ # 侧边栏功能分支
~/Code/myproject-dark-mode/ # 深色模式功能分支
每个 worktree 运行独立的 Claude 代理，端口分配采用确定性哈希算法避免冲突：
hash_val = sum(ord(c) for c in branch_name)
django_port = 8001 + (hash_val % 99)
PreToolUse 钩子构建推送通知系统：这是移动异步开发的关键创新。在~/.claude/settings.json中配置钩子，当 Claude 调用AskUserQuestion工具时自动触发通知：
{
"hooks": {
"PreToolUse": [{
"matcher": "AskUserQuestion",
"hooks": [{
"type": "command",
"command": "~/.claude/hooks/poke-notify.sh question"
}]
}]
}
}
通知脚本提取问题内容并通过 webhook 发送到 Poke 服务，最终推送到移动设备。这种模式将开发工作流从 "持续监控终端" 转变为 "事件驱动响应"，开发者可以 "kick off a task, pocket the phone, get notified when Claude needs input"。
移动设备优化：输入延迟与资源限制的工程应对
在移动设备上运行开发工作流需要解决三个核心限制：输入延迟、屏幕空间和电池消耗。
输入延迟优化：mosh 协议通过预测性输入和本地回显大幅减少了网络延迟感知。当用户在虚拟键盘上输入时，字符立即显示在本地终端，同时异步发送到远程 VM。对于代码补全场景，Claude Code 的流式响应进一步降低了感知延迟。
屏幕适配策略：Termius 支持自定义字体大小和配色方案，针对移动端小屏幕优化可读性。tmux 的分屏功能允许在有限空间内同时查看代码、终端输出和 Claude 交互。开发者实践表明，通过适当的配置，6 个并行 Claude 代理可以在手机屏幕上高效管理。
电池与数据消耗控制：mosh 的增量状态同步相比传统 SSH 减少了 90% 的数据传输量。VM 按需启动机制确保非开发时段零能耗。iOS Shortcuts 集成允许在打开 Termius 前自动启动 VM，进一步优化工作流效率。
可落地参数：成本、安全与性能阈值
实施 Claude Code 移动开发工作流需要关注以下可量化参数：
成本控制参数：
- VM 实例：vhf-8c-32gb @ $0.29/hr
- 每日开发时长：≤8 小时 → 日成本≤$2.32
- 月度预算：按 20 个工作日计算 ≤$46.4
- 闲置停机：通过 cron job 检测无活动 30 分钟后自动关机
安全配置阈值：
- Tailscale ACL：仅允许开发设备访问 VM 的 SSH 端口（默认 22）
- 云防火墙：入站规则仅开放 41641/udp（Tailscale derp）
- 本地防火墙：nftables 限制除 Tailscale 接口外的所有入站
- SSH 配置：禁用密码认证，强制 Ed25519 密钥，失败尝试 3 次后封禁 IP
性能监控指标：
- 网络延迟：mosh 连接 RTT ≤150ms 为绿色，150-300ms 黄色，>300ms 红色
- 输入响应：从按键到终端显示 ≤50ms
- 通知延迟：PreToolUse 触发到手机推送 ≤5 秒
- 会话恢复：Termius 重连后 tmux 附加时间 ≤2 秒
缓存策略参数：
- tmux 会话超时：无活动 24 小时后自动清理
- Git 对象缓存：本地保留最近 7 天的 commit 和 tree 对象
- 端口分配池：8001-8099（99 个端口），哈希冲突率 < 1%
- 工作树清理：分支合并后保留 3 天，自动删除旧 worktree
架构演进与风险考量
当前架构虽然成熟，但仍存在演进空间和潜在风险：
SSH agent 转发限制：mosh 不转发 SSH agent，这意味着 Git 操作需要额外的认证配置。解决方案是在 tmux 会话内启动独立的 SSH agent，或使用 Git 的 credential helper 缓存令牌。
移动输入效率瓶颈：虚拟键盘输入代码仍然效率较低。未来可集成语音输入或代码片段快捷方式，如通过 iOS Shortcuts 预定义常用代码模板。
网络恢复边缘情况：虽然 mosh 能处理大多数网络中断，但在极端弱网环境下（<10kbps）仍可能出现状态同步失败。需要实现本地命令队列和重试机制。
多设备同步挑战：当前架构针对单移动设备优化，多设备间状态同步需要额外的协调层。可考虑基于 CRDT 的终端状态同步方案。
结论：移动异步开发的新范式
Claude Code On-the-Go 架构代表了移动开发工作流的重要演进：从 "在移动设备上开发" 转变为 "通过移动设备管理云端开发"。这种范式转移解决了移动端算力限制、电池续航和输入效率等根本问题，同时保持了完整的开发体验。
关键成功因素包括：1）云 VM 按需计算的成本效益，2）mosh 协议的网络弹性，3）PreToolUse 钩子的异步通知机制，4）Git worktrees 的并行开发支持。这些组件共同构成了一个可在通勤、咖啡厅等待、家庭休闲等碎片化时间中高效工作的开发系统。
对于工程团队而言，这一架构的可贵之处在于其可复现性。所有组件都是开源或商业可用服务，配置脚本可通过 Claude Code 自身生成。正如开发者所述："The setup took one Claude Code session to build—gave it my Vultr API key and access to gh, asked for a secure dev VM. Now I code from my phone."
在 AI 辅助开发日益普及的今天，移动端工作流不再是妥协，而是效率提升的新前沿。通过合理的架构设计和参数调优，开发者可以在任何时间、任何地点保持开发节奏，将等待时间转化为生产力时间。
资料来源：
- Claude Code On-The-Go - granda (https://granda.org/en/2026/01/02/claude-code-on-the-go/)
- 3 Ways to Use Claude Code on Mobile - Apidog Blog (https://apidog.com/blog/claude-code-mobile/)