Agent 用例站

← 用例 · 软件与工程

Codex 经 USB 操作真实 iPhone（iPhone Use）

在 macOS 上装开源 iPhone Use，USB 接真机后，Codex / Claude Code 等 MCP 客户端可读屏、点按、滑动、输入；密码与验证码等敏感步骤停下让人接管。

CodexiPhone Use

来源：GitHub · 2026-10-13 · 原文

做法 / Prompt

在本机安装 iphone-use（https://github.com/leeguooooo/iphone-use），跑 doctor / setup / try，直到真机可用；敏感步骤（Apple ID、Trust、开发者模式、解锁、密码/验证码）停下告诉我怎么做，等我说完成再继续。不要向我索要密码或验证码。

痛点

想让 Agent 操作真实 iPhone 上的 App（健康、微信、笔记、自研 App 等），但多数方案要么只驱动模拟器，要么依赖截图黑屏的录屏，要么门槛文档不全、无法复现。

做法

  1. 门槛先看清（缺一不可）：Mac（README 要求 macOS 15+）+ 完整 Xcode（已登录 Apple ID，免费账号可用）+ iPhone（iOS 15+，开启开发者模式）+ USB 线首次配对；不越狱。
  2. 手机用线接到 Mac，解锁并点 Trust；在终端执行官方安装脚本（见仓库 README），或把仓库里的「让 Agent 代装」提示词贴进 Codex / Claude Code。
  3. 跑 iphone-use doctor → 按提示补缺 → iphone-use setup → iphone-use try（无害自检：开设置、读屏、回主屏）。Xcode 登录、手机 Trust、开发者模式、解锁等只有人能做的步骤：Agent 必须停下说明，等你确认完成；不要把密码/验证码交给 Agent。
  4. 安装程序会向 Codex / Claude Code 等注册 MCP；新开一轮对话后即可用自然语言让 Agent 启动 App、点按、滑动、输入中文。也可用 CLI / HTTP Agent API；可选 Wi-Fi 隧道（首次仍需 USB）。
  5. 安全约定（README）：登录 / 锁屏密码 / Face ID 等由人在手机上完成；可用环境变量屏蔽敏感 App、限制单任务动作数；默认本机回环监听。

社区另有基于 WebDriverAgent 的同名思路仓；本站详情以文档完整、可复现的 leeguooooo/iphone-use（自研 XCTest runner + MCP/CLI）为准。X 分享亦提到可接 WorkBuddy / 豆包等工作流，以各客户端 MCP 配置为准。

验收

  • iphone-use doctor 无缺失项；iphone-use try 成功。
  • Codex（或 Claude Code）会话中出现 phone_* / 等价 MCP 工具，能打开指定 App 并完成一次点按+读屏。
  • 遇到密码/验证码时 Agent 停下等人接管，未索要密钥。

来源