★ FEATURED ARTICLE Open Computer Use 接入实战Codex、Claude Code、Gemini CLI 与 opencode 一键安装 MCP 完整指南【免费下载链接】open-codex-computer-use Open Computer Use – Open-Source Alternative to Codex Computer Use项目地址: https://gitcode.com/gh_mirrors/op/open-codex-computer-useOpen Computer Use是一个开源的 Computer Use电脑操作服务它以 MCPModel Context Protocol协议提供服务让 Codex、Claude Code、Gemini CLI、opencode 等任何 AI Agent 都能直接操作电脑读应用界面、点击、输入、滚动、拖拽。项目灵感来自 OpenAI 的 Codex Computer Use核心卖点是非侵入式——基于系统辅助功能实现且支持 macOS、Linux、Windows 三大平台。本文将从安装到验证带你用4 条命令把它接入主流 AI 编程工具全程无需手写配置。一、什么是 Open Computer UseMCP 电脑操作服务 30 秒速览简单说它把眼睛 手装进了 AI Agent眼睛list_apps列出运行中的应用get_app_state读取某个应用的界面快照辅助功能树 截图手click、type_text、press_key、scroll、drag、set_value、perform_secondary_action九种工具覆盖绝大多数桌面操作完整工具定义见 ToolDefinitions.swiftMCP 服务入口在 MCPServer.swift。对 macOS 用户还有一个惊喜操作中会显示一个拟真的软件光标动作过程像真人操作一样自然相关运动模型见 SoftwareCursorOverlay.swift。二、快速开始npm 一键安装 Open Computer Use CLI1️⃣ 安装 CLInpm i -g open-computer-use安装后你会得到两个命令open-computer-use和短别名ocu。npm 启动器要求Node.js 18。2️⃣ macOS 权限只需一次⚠️ macOS 端要求macOS 14.0 及以上Windows 和 Linux 无此限制。open-computer-use doctordoctor会检查 Accessibility辅助功能与 Screen Recording屏幕录制权限缺什么就自动弹出引导界面你只需在系统设置中批准。Windows / Linux 不需要这一步。3️⃣ 验证服务可用open-computer-use call list_apps能看到当前运行的应用列表说明运行时已经就绪。三、一键安装 MCPCodex、Claude Code、Gemini CLI、opencode 四端命令速查这是本文的重点。项目内置了针对各 Agent 的安装器源码在 scripts/ 目录幂等设计——重复执行不会污染已有配置。AI Agent一键安装命令写入位置Codex (CLI)open-computer-use install-codex-mcp~/.codex/config.tomlClaude Codeopen-computer-use install-claude-mcp~/.claude.jsonGemini CLI项目级open-computer-use install-gemini-mcp./.gemini/settings.jsonGemini CLI用户级open-computer-use install-gemini-mcp --scope user~/.gemini/settings.jsonopencodeopen-computer-use install-opencode-mcp~/.config/opencode/opencode.json对应脚本分别是 install-codex-mcp.sh、install-claude-mcp.sh、install-gemini-mcp.sh 和 install-opencode-mcp.sh底层由 install-config-helper.mjs 统一完成配置读写。几个实用细节Gemini CLI默认写入当前项目.gemini/目录配合版本管理可以在不同项目间切换想全局生效加--scope useropencode会自动探测你实际使用的配置文件opencode.json或config.json两个文件都存在时会同步写入用短别名同样可行ocu install-codex-mcp安装完成后重启对应的 Agent用自然语言说帮我打开某个应用并查看内容它就会自动调用 Open Computer Use 的工具干活了。四、进阶用法Codex App 插件与 Agent SkillCodex App 插件模式如果你用的是 Codex App而非 CLI推荐插件安装方式open-computer-use install-codex-plugin安装官方 Skill 让 Agent 懂行Skill 是一份教 Agent 正确使用电脑操作工具的知识包权限检查、找不到应用怎么办、快照文本截断如何处理等。配合 MCP 一起装Agent 的操作手感明显更好# 为 Codex 安装 skill npx skills add iFurySt/open-codex-computer-use -g -a codex --skill open-computer-use -y # 为 Claude Code 安装 skill npx skills add iFurySt/open-codex-computer-use -g -a claude-code --skill open-computer-use -y # 更新已安装的 skill npx skills update open-computer-use -g -ySkill 内容位于 skills/open-computer-use/SKILL.md其中 references/installation.md 与 references/troubleshooting.md 是排障时最有价值的两份参考。五、手动配置 MCP给其他 MCP 客户端的通用方案如果你的客户端不在内置列表里直接把这段 stdio 配置加进 MCP 客户端即可{ mcpServers: { open-computer-use: { command: open-computer-use, args: [mcp] } } }这就是官方 README.md 中给出的通用接入方式任何支持 MCP 的客户端包括 Claude Desktop 等都适用。六、验证接入成功3 条自检命令# 权限体检macOS 建议常跑 open-computer-use doctor # 列出运行中的应用 ocu call list_apps # 读取某个应用的界面状态 open-computer-use call get_app_state --args {app:TextEdit}三条全部通过说明 MCP 链路、权限、运行时三者都 OK。七、常见问题排查清单 遇到问题时按这个顺序排查能解决 90% 的情况macOS 版本太低macOS 14.0 以下无法启动原生二进制doctor和权限修复都救不了需升级系统或换用 Windows / Linux快照为空目标应用没有可见窗口最小化/隐藏或 macOS 缺屏幕录制权限Windows/Linux 下则要确认命令运行在已登录的桌面会话内SSH 会话通常不行找应用找不到先跑call list_apps用返回里的确切名称或 Bundle ID文本被截断快照默认 500 字符限制可用text_limit参数调大或设为maxLinux 界面属性报错升级到包含 AT-SPI 接口检测修复的版本详见 20260808 历史记录完整排障手册troubleshooting.md八、项目关键资料索引内容路径项目说明与快速开始README.md四大 Agent 一键安装脚本scripts/MCP 工具定义9 个工具ToolDefinitions.swiftAgent 技能包含排障指南skills/open-computer-use/SKILL.md架构与产品文档docs/ARCHITECTURE.md、docs/DESIGN.md总结Open Computer Use 的接入路径可以浓缩成三步npm i -g open-computer-use→doctor授权 → 一条install-*-mcp命令。相比手写 MCP 配置内置安装器让你把 Codex、Claude Code、Gemini CLI、opencode 全部接入只需 4 行命令。装完后你的 AI 编程助手就拥有了看屏幕 动手操作的能力——去试试让它帮你操作浏览器或桌面应用吧 【免费下载链接】open-codex-computer-use Open Computer Use – Open-Source Alternative to Codex Computer Use项目地址: https://gitcode.com/gh_mirrors/op/open-codex-computer-use创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
