leeguooooo/iphone-use

这是什么？

核心功能

• 01通过无障碍树以文字读取屏幕，无需截图。
• 02可在任何 App 中点击、输入和滑动，包括没有 API 的应用。
• 03支持 USB 连接，初次设置后可通过加密隧道使用 Wi-Fi 连接。
• 04为 Claude Code、Codex、Cursor 等 MCP 客户端提供工具，并提供 HTTP API。
• 05将重复任务保存为 flow，无需模型和 token 即可回放。
• 06提供网页和原生 iOS App，可实时查看屏幕并人工接管。

适用场景

• 让 Claude Code 或 Codex 在手机上完成多步骤任务，如读取应用数据或发送消息。
• 在真实 iPhone 上运行登录或流程测试，并定位失败的步骤。
• 从没有 API 的应用中导出数据，例如健康或备忘录类应用。
• 让 agent 与需要随时接管的人共用同一台 iPhone。

快速上手

1. 1

   在 Mac 上用安装脚本安装 iphone-use

   curl -fsSL https://raw.githubusercontent.com/leeguooooo/iphone-use/main/install.sh | sh
2. 2

   检查手机是否已准备好供智能体使用

   iphone-use doctor
3. 3

   运行一个无害的检查：打开设置并读取屏幕

   iphone-use try

使用前须知

• !需要运行 macOS 15 或更高版本并安装 Xcode 的 Mac，以及开启开发者模式、iOS 15 或更高版本的 iPhone。
• !首次设置需要 USB 数据线。
• !许可证为 PolyForm Shield 1.0.0，对部分商业用途有限制，使用前请查看条款。

标签

常见问题

iphone-use 是什么？

让 Claude Code、Codex 等 AI agent 通过 MCP 读取、点击、输入和滑动真实 iPhone 的操作。 iphone-use 是一个自托管工具，让 AI agent 能够操作真实的 iPhone。运行在 macOS 上的守护进程以无障碍树的形式读取屏幕文字（而非像素），通过安装在手机上的小型 XCTest runner 发送点击、输入和滑动，并在屏幕稳定后再返回结果。它适用于任何 App，包括没有 API 的应用，支持 USB 或 Wi-Fi 连接。

iphone-use 可以免费使用吗？用的什么许可证？

iphone-use 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

iphone-use 还在维护吗？

活跃维护中。iphone-use 最近一次提交是在 2026年10月19日。

iphone-use 适合用来做什么？

让 Claude Code 或 Codex 在手机上完成多步骤任务，如读取应用数据或发送消息。 在真实 iPhone 上运行登录或流程测试，并定位失败的步骤。 从没有 API 的应用中导出数据，例如健康或备忘录类应用。 让 agent 与需要随时接管的人共用同一台 iPhone。

iphone-use 怎么安装和运行？

在 Mac 上用安装脚本安装 iphone-use: curl -fsSL https://raw.githubusercontent.com/leeguooooo/iphone-use/main/install.sh | sh 检查手机是否已准备好供智能体使用: iphone-use doctor 运行一个无害的检查：打开设置并读取屏幕: iphone-use try

在哪里获取 iphone-use？

源代码和安装说明在 GitHub 上：https://github.com/leeguooooo/iphone-use