Phone Harness

项目简介

Phone Harness 是一个开源工具，可让 Claude Code、Codex 或任何智能体控制真实的 iPhone 或 Android 手机。智能体可以通过手机界面点击、输入、滚动并读取屏幕，无需越狱、Xcode，也无需在手机上安装应用。

核心功能

• 智能体通过点击、输入、滚动和读取屏幕，与真实手机应用交互。
• iPhone 控制通过 Mac 的 iPhone Mirroring 窗口进行，并可在后台运行；Android 通过 adb 控制。
• 使用 Vision OCR 或手机的无障碍树查看屏幕，并通过真实输入事件执行操作。
• Phone Harness Cloud 提供托管的 Android 和 iPhone，支持带 eSIM 的真实手机号码、持久登录和多台设备。
• 集成方式包括 CLI、MCP 服务器、Hermes Agent 和 OpenClaw，各手机共享同一套辅助函数。
• Cloud Android 可按会话启动全新手机，或使用保留应用和登录状态的已保存手机；iPhone 控制可通过 HTTPS 运行。

适用场景

• 用 AI 智能体测试和使用真实移动应用。
• 通过手机界面给他人发消息和打电话。
• 获取用于双重验证的验证码。
• 在托管的 Android 或 iPhone 设备上执行智能体任务，例如预订行程或与应用交互。

快速开始

• 向 Claude Code 或 Codex 等编码智能体发送设置提示，以使用 uv 在 Python 3.12 上安装或升级 phone-harness CLI，并注册技能。
• 运行 phone-harness doctor 检查手机设置。
• 对于云手机，使用 phone-harness cloud login、phone-harness cloud ls、phone-harness cloud start 和 phone-harness cloud stop。

部署与要求

• iPhone：macOS 15 或更高版本、与 iOS 18 或更高版本 iPhone 配对的 iPhone Mirroring，以及辅助功能和屏幕录制权限。
• Android：在 macOS、Linux 或 Windows 上使用 adb 和 USB 调试。
• Cloud Android 或 iPhone：需要 Phone Harness Cloud 账户；Cloud Android 还需要 adb。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。