---
title: "iphone-use"
description: "让 Codex 通过 USB 操作真实 iPhone，支持引导安装、App 自动化、实时屏幕和截图回退。 本对话首次使用先 setup 复用或启动服务，等待就绪后再 READY。"
canonical: https://agentpluginsdirectory.com/plugins/iphone-use
last-updated: 2026-10-21
---

# iphone-use
让 Codex 通过 USB 操作真实 iPhone，支持引导安装、App 自动化、实时屏幕和截图回退。 本对话首次使用先 setup 复用或启动服务，等待就绪后再 READY。
- Slug: iphone-use
- Publisher: ZHONG XIN
- Repository: https://github.com/zhongerxin/iPhone-use
- Manifest: plugin.json
- Version: 0.3.15
- License: MIT
- Category (editorial): other
- Skills: 2 (iphone-use-setup, iphone-use)
- MCP servers: 1 (iphone_use)
- Stars: 4439
- Repository created: 2026-10-06
- Repository last pushed: 2026-10-16
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/iphone-use
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What iphone-use does, in the publisher's words

让 Codex、WorkBuddy 或豆包工作通过 USB 操作你的真实 iPhone。用自然语言描述任务，助手就能打开 App、读取页面、点击、滚动、输入文字、整理列表，并在侧边栏展示手机屏幕。

iPhone Use 使用 WebDriverAgent（WDA）与 iPhone 通信，包含本地 MCP 服务、安装与使用技能，以及实时屏幕 widget。它优先复用现有连接与构建；控件定位失败时，指导模型查看截图并尝试坐标点击。

插件默认向独立的 PostHog 项目发送匿名使用统计，包括启动、工具调用、连接状态、耗时和错误类别。使用随机安装标识，不上传手机画面、输入内容或设备标识。设置 IPHONE_USE_ANALYTICS=0 或 DO_NOT_TRACK=1 并重启 MCP 服务可关闭。详见 埋点与分析说明。

- 预览直接操作：支持点击画面、鼠标拖动和触控板双指滚动。
- 微信点击优化：已知导航目标直接看图点击，通讯录和会话列表按需轻量读取。
- AirDrop 文件传输：使用技能新增传输指引，将手机图片、视频和文档传回 Mac。
- 页面读取优化：精简控件树，默认最多返回 200 个节点，支持按需限制快照。
- 连接恢复改进：完善超时与断线指引，自动恢复临时快照设置。
- 长文本续传保护：续传绑定原输入框，切换 App 或焦点后停止，避免误写。

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/zhongerxin/iPhone-use/HEAD/README.md

## Skills

- iphone-use-setup: 配置 PUA（Phone Use Agent），在用户自己的 iPhone 上安装、签名并启动手机端执行服务；本对话首次使用先直接 setup，再验 READY，服务未启动时复用配置与构建启动，诊断 USB 和 Xcode 连接并打开手机屏幕侧边栏；适用于首次配置、冷启动、断线恢复或签名过期。
- iphone-use: 通过 PUA（Phone Use Agent）MCP 工具高效操作真实 iPhone；本对话首次使用先直接 setup 检查并启动服务，再取得 READY，服务未启动时沿 setup 启动流程继续。默认乐观执行导航、点击、输入和滚动，在下一步观察时顺带判断进度，只对关键最终结果显式验收；指导 App 查找、列表采集、手机屏幕侧边栏及密码或 Face ID 认证接管。

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- iphone_use: transport: stdio; command: python3 ${PLUGIN_ROOT}/server/iphone_use.py

Read from the plugin's own mcp.json. Environment variable names only, never values.