客户端插件

在 Codex 和 Claude Code 中使用同一套设备工作流。

安装前

先安装iPhone-use CLI 0.2.1。客户端需要具备本地 Mac 命令执行和图片读取能力。插件提供操作说明及客户端适配，不安装 CLI、不创建签名，也不会自动连接手机。

将完整 Git 仓库添加为 marketplace，不要使用 raw JSON 地址。这是项目自有公开 marketplace，不代表已进入任一客户端的官方目录。

Codex

codex plugin marketplace add HughLee824/iphone-use
codex plugin add iphone-use@iphone-use
codex plugin list --marketplace iphone-use --json

使用支持 codex plugin --help 的客户端版本。命令名称已在 CLI 0.146.0 上核对。确认插件启用，开始新的 Codex 任务并调用 $iphone-use:iphone-use。桌面插件列表未刷新时，重启客户端。

若没有 plugin add，请使用兼容版本或桌面 marketplace 安装入口，不要套用 Claude Code 的 plugin install 命令。

Claude Code

claude plugin marketplace add HughLee824/iphone-use
claude plugin install iphone-use@iphone-use
claude plugin list --json

开始新会话并调用 /iphone-use:iphone-use。交互模式也可使用 /plugin marketplace add HughLee824/iphone-use 和 /plugin install iphone-use@iphone-use。若安装结果要求重新加载，请按提示操作。

启用 iPhone-use 前停用旧 AgentSoma 插件，避免重复匹配设备操作说明。CLI 与插件版本独立：0.2.1 Release 与公开 Git 来源均提供插件 0.1.6，包含新域名与文档更新。安装后核对客户端缓存版本；0.2.0 的原有 0.1.4 ZIP 保持不变。

更新插件

codex plugin marketplace upgrade iphone-use
codex plugin add iphone-use@iphone-use

claude plugin marketplace update iphone-use
claude plugin update iphone-use@iphone-use

选择对应客户端的两条命令。只刷新 marketplace 可能仍在使用旧插件。开始新会话，并核对已安装 skill 的工作流版本。Runner 更新或签名过期时，可能需要重新准备设备。

卸载插件

使用 codex plugin remove iphone-use@iphone-use 或 claude plugin uninstall iphone-use@iphone-use。不再需要 marketplace 时再单独移除。这些命令不卸载 CLI，也不删除签名资料。