App Mobile-Harness 在安卓手机上运行Claude Code编程工作台

很多开发者想要“随时随地写代码”的能力，但手机上跑 AI 编程助手几乎是不可能的：没有真正的终端、没有 Linux 工具链、也没有可以预览 Web 应用的本地环境。出门在外灵感来了，要么掏笔记本，要么只能干想。
更具体地说，Claude Code 这类 agent 需要能执行 shell、能编辑文件、能起服务，而安卓系统本身把这些能力藏得很深。Mobile-Harness 的思路是在安卓上塞进一个受控的 Linux 子系统，再把 Claude Code 这类 agent 跑进去，于是手机也能当一个完整的编程工作台。

项目基本信息

一、项目介绍

techjarves/Mobile-Harness 是一个面向安卓（Android 9+，ARM64）的开源 AI 开发工作台，MIT 协议。它在安卓原生层（Kotlin + Jetpack Compose）之上，通过 C++ JNI 桥接一个 rootless 的 PRoot Linux 子系统（Ubuntu 20.04），在里面跑 Claude、DeepSeek、Antigravity 等 agent，并提供 Node.js、Git、Python、C++ 等工具链。App 端提供项目、聊天、终端、Web 预览四个界面，无需 root 即可在手机上聊天写代码、执行真实 Linux 命令、预览本地 Web 服务。

二、核心优势

1. 真·移动工作台：安卓上即可聊天、编辑项目、跑真实 Linux 命令、预览 Web 应用。
2. 无 root 要求：通过 PRoot 用户态子系统实现，不刷机、不提权也能用。
3. 多模型：agent 注册表支持 Claude、DeepSeek、Antigravity 等，可按需切换。
4. 本地隔离：密钥用 Android Keystore（AES-256 GCM）保存，项目与工作区在本地子系统内。
5. 开源 MIT：客户端与架构透明，可自行编译与审计。

三、适用场景

• 通勤或出差时临时改 bug、看日志、跑脚本，无需笔记本。
• 在手机上给开源项目做小改动并直接提交。
• 现场演示 Web 原型：手机起本地服务即时预览。
• 想把 agent 工作流搬到移动端、又不想带设备的场景。

四、安装教程

从源码构建（需要 Android SDK 与 ARM64 设备）：

git clone https://github.com/techjarves/Mobile-Harness.git
cd Mobile-Harness
./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk

常见报错：缺少 Android SDK 或 NDK 会在 assembleDebug 阶段报错，按官方文档装好对应构建工具；adb 找不到设备请确认已开启 USB 调试并连上电脑。

五、使用示例

装好后在手机上打开 App，按引导完成 Linux 子系统初始化，即可进入项目/聊天/终端/预览界面：

# 在 App 内终端实际等价于子系统里的 Linux 命令
./gradlew testDebugUnitTest   # 跑单元测试
./gradlew lintDebug           # 跑静态检查

真实流程：在聊天界面把任务交给 agent，App 会在 PRoot 子系统里调用 Git、Node、Python 等工具链完成编辑与执行；Web 预览界面可直接打开本地起的服务，验证改动效果。

六、常见问题

Q：需要 root 手机吗？
A：不需要。Mobile-Harness 用 rootless 的 PRoot 子系统，普通安卓即可运行。
Q：只支持 ARM64 吗？
A：当前目标架构是 ARM64（arm64-v8a），对应绝大多数现代安卓手机。
Q：我的代码安全吗？
A：密钥用 Android Keystore 加密保存，项目与工作区留在本地子系统，不上传到 App 之外。

七、总结

Mobile-Harness 把“Claude Code 式编程工作台”塞进了安卓手机，让真正移动化的 AI 编码成为可能。对需要随时改代码、又不想背笔记本的人，它是个有趣且实用的开源尝试；MIT 协议、无 root 要求，适合在备用机上折腾。