资讯动态

给Codex和Claude Code装上手:OpenPocket Phone插件与23工具MCP运行时接入指南

发布时间:2026/10/26 1:46:05 来源:尧图企业网站定制
【免费下载链接】openpocket An Intelligent Phone That Never Sleeps.项目地址https://gitcode.com/gh_mirrors/ope/openpocket点击查看免费下载OpenPocket 是一个开源的永不休眠的智能手机框架让 AI 代理通过 ADB 自主操作 Android 模拟器或真机。本文介绍如何把 OpenPocket Phone 插件装进 Codex 和 Claude Code一条命令完成依赖检查、目标配置、插件安装与 23 工具 MCP 运行时校验让 AI 编码助手像真人一样点击、滑动、输入完成手机自动化任务。它和桌面 Computer Use有什么不同很多 AI 助手操作手机靠的是看屏幕截图点鼠标在模拟器窗口上模拟桌面点击既慢又不稳定。OpenPocket Phone 走的是另一条路宿主Codex / Claude Code加载一个原生插件插件启动一个本地 MCP 服务器23 个工具的 Android 运行时MCP 服务器通过ADB直接和 Android 通信。也就是说AI 操作的是真手机系统而不是模拟器窗口。这套集成只有一套实现Codex 和 Claude Code 拿到的是同一份 phone-use 技能和字节级一致的运行时源码都在 src/mcp/server.ts。安装前的环境准备清单插件包本身是自包含的清单文件、技能、MCP 运行时、辅助 APK 都有但系统级的 Android 工具需要你自己备好组件是否随插件提供说明Node.js 20❌必需建议用当前 LTSAndroid SDK Platform-Toolsadb❌模拟器和真机都需要Android Emulator 系统镜像 AVD❌仅模拟器目标需要Android Studio❌可选装 SDK 和 AVD 最方便的方式模拟器路线最省心的做法在 Android Studio 里装好 Platform-Tools、Emulator 和系统镜像然后在 Device Manager 里创建一个名为OpenPocket_AVD的虚拟设备这样插件就能零配置启动。装完先用三条命令自检node --version adb version emulator -list-avds真机路线更简单开启开发者选项和 USB 调试或无线调试连接电脑并接受 ADB 授权确认adb devices -l里状态是device而不是unauthorized即可。一键安装CLI 用户的最快路径先拿到仓库以下命令在仓库根目录执行git clone https://gitcode.com/gh_mirrors/ope/openpocket cd openpocket一条安装命令会依次完成找到宿主 CLI、补齐仓库依赖、构建运行时、配置目标设备、安装插件并跑完 23 工具 Doctor 校验。给 Codex 装npm run phone-use:install -- codex --target emulator如果 AVD 已经建好可以加--start-emulator在安装时直接启动模拟器。给 Claude Code 装npm run phone-use:install -- claude-code --target emulatorClaude Code 安装器只会写原生插件配置不会添加旧的claude mcp add裸条目如果检测到旧版用户级openpocket-phone条目会先备份再移除。装完后用codex plugin list或claude plugin list验证然后开一个新会话再开始任务——插件工具是会话级加载的旧任务不会自动获得新工具。桌面版Codex Desktop 与 Claude Desktop 免构建安装桌面端不需要npm install和npm run build仓库里已经备好了自包含包。Codex Desktop把 OpenPocket 仓库文件夹作为项目打开重启 Codex Desktop打开 Plugins选择OpenPocket Local市场安装OpenPocket Phone然后新建任务。如果市场没出现退回一键安装命令npm run phone-use:install -- codex再重启即可。Claude Desktop打开 Settings Plugins选择 Add Upload plugin上传现成的openpocket-phone-claude.zip确认插件列表里出现OpenPocket Phone再开一个新任务。上传成功后插件以原生形式出现在列表中技能随包自带23工具MCP运行时都有什么能力插件捆绑的 MCP 服务器共暴露 23 个工具按用途可以分成四组分组工具一句话说明 目标管理target_status、start_emulator、stop_emulator查看/启停模拟器确认设备已解析 界面检查current_app、screenshot、ui_snapshot、visible_text、find_text、wait_for_text看当前应用、截屏、提取文本、定位元素 交互操作tap_text、tap、tap_element、swipe、drag、long_press_drag、type_text、key_event点击、滑动、拖拽、输入、按键 应用与 Shellopen_app、launch_app、adb_shell、list_apps、list_packages、wait打开应用、列出应用、窄范围 shell 检查官方推荐的调用顺序是先读状态、再找元素、优先按文本点击target_status→ui_snapshot/visible_text→find_text/wait_for_text→tap_text/tap_element只有在 UI 元数据拿不到时才用原始坐标tap。这套策略写进了规范技能文件 SKILL.md宿主会自动遵循。装好之后第一次验收测试在新开的 Codex 或 Claude Code 任务里粘贴这段提示词Use OpenPocket Phone only. Call target_status. If the configured target is an emulator and no emulator is online, start it. Then report targetType, avdName, devices, bootedDevices, resolvedDeviceId, resolveError, and ambiguousTarget.健康的模拟器环境应该报出emulator 目标类型、一台已启动的模拟器、解析出的设备 ID如emulator-5554、无解析错误。之后再加一句只读检查Use OpenPocket Phone to call current_app and ui_snapshot. Report the foreground Android package, screen size, and visible text. Do not tap or type anything.能顺利跑完这两步说明包 → 协议 → 新会话三层验证全部通过插件真正可用了。安全边界AI 会主动暂停的地方OpenPocket Phone 能驱动已授权的 Android 目标但它不会绕过 ADB 授权、信任弹窗、锁屏或系统安全控制。技能文件明确要求以下操作前必须停下来等用户确认 购买、支付、出价等资金类提交 发消息、发帖、点赞、关注等不可逆的社交动作 修改账号、安全、隐私或支付设置 涉及密码、OTP、验证码、银行卡、摄像头、麦克风、位置、短信等敏感能力。这种敏感动作升级给人类审批的设计让把真机交给 AI 这件事变得可控——这也正是 OpenPocket 本地优先、隐私默认理念的一部分。常见问题速查症状处理办法技能可见但工具缺失装完插件必须开新会话工具是会话级注册的Codex 看不到 OpenPocket Local 市场先以 OpenPocket 检出目录为项目并重启桌面端或用一键安装命令兜底找不到 Node 或 ADBnode --version确认 ≥20把 platform-tools 加入PATH或设置ANDROID_SDK_ROOT选错了模拟器修改~/.openpocket/config.json中的emulator.avdName多设备在线时给工具显式传deviceId想验证插件包完整性仓库根目录执行node plugins/openpocket-phone/scripts/doctor.mjs它会校验清单、内容哈希和工具清单更多细节可以对照官方上手指南 plugins/openpocket-phone/README.md 和集成架构文档 docs/codex-claude-code-phone-use.md截图版引导。小结给 Codex 或 Claude Code 装上 OpenPocket Phone本质就是三件事备好 ADB 环境 → 一条命令装原生插件 → 开新会话验收。装好后你的 AI 编码助手就多了一双操作安卓的手23 个 MCP 工具覆盖目标管理、界面检查、交互操作和应用管理敏感动作自动升级人工审批。从写代码的助手到能帮你操作手机的助手只差这一次安装。赞分享【免费下载链接】openpocket An Intelligent Phone That Never Sleeps.项目地址https://gitcode.com/gh_mirrors/ope/openpocket点击查看免费下载相关推荐任何MCP运行时都能接入commonlyai/mcp服务器配置与Codex、Claude Code联调指南任何MCP运行时都能接入commonlyai/mcp服务器配置与Codex、Claude Code联调指南 Commonly 是一个开源的人类 AIOpenLoomi插件指南如何给Claude Code和Codex装上注意力代理与长期记忆OpenLoomi插件指南如何给Claude Code和Codex装上注意力代理与长期记忆 OpenLoomi 是一款开源的 AI 同事AI coworkeclaude-codex-settings完整入门指南5分钟为Claude Code、Codex和Cursor装上35实战插件claude codex settings完整入门指南5分钟为Claude Code、Codex和Cursor装上35实战插件 正在使用 Claude Co上一篇PaddleSpeech T2S Updater 模块深度解析从 UpdaterBase 到 StandardUpdater 的训练步骤抽象下一篇TEN Framework 语音情感健康分析实战Thymia Analyzer Python 扩展详解创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑