# open-computer-use
[](./README.md)
[](./README.zh-CN.md)
[](https://github.com/iFurySt/open-codex-computer-use/releases)
[](https://deepwiki.com/iFurySt/open-codex-computer-use)
> [!TIP]
> 对 Browser Use 感兴趣的话，可以看看 [open-browser-use](https://github.com/iFurySt/open-codex-browser-use)。
---
`open-computer-use` 是一个开源的 `Computer Use` 服务，已经包装成 `MCP` 协议，支持所有的 AI Agent 或 MCP Client 快速调用，实现 macOS、Linux 和 Windows 上的 `Computer Use` 能力。
项目的背后是 OpenAI 刚发布的 [Codex Computer Use](https://openai.com/index/codex-for-almost-everything/)，让我看到了基于 Accessibility 可以实现非抢占式 CUA 能力，因此决定复刻一个开源版本
在这期间我利用了之前写的 [harness 模版](https://github.com/iFurySt/harness-template) 开启了这个新项目。这是一个可以快速拉起面向 AI 仓库的 template，非常适合 100% AI-Generated 的项目，也是这一个月来我们最大的实践和收获。现在我们可以基于这套方法论快速实现很多东西；如果你有兴趣，我也写了一篇[文章](https://www.ifuryst.com/blog/2026/speedrunning-the-ai-era/)专门介绍这套方法论
## 演示
### Codex App 和 Codex CLI
[](https://youtu.be/2s6aVpGiwaQ)
`open-computer-use` 作为 Computer Use，在 Codex App 和 Codex CLI 里使用，和官方体验一致。
### Gemini CLI
https://github.com/user-attachments/assets/eacb3b15-f939-46c7-b3b3-6f876977a58d
Gemini CLI 通过MCP接入使用 `open-computer-use`，实现完整的 Computer Use 操作。
### Linux
https://github.com/user-attachments/assets/e036b1c8-2200-4896-abd4-19225915cf66
`open-computer-use` 在 Linux 里使用
## Quick Start
```bash
npm i -g open-computer-use
```
通过 npm 安装后也会同时提供短命令 `ocu`。
> [!IMPORTANT]
> macOS 运行环境要求 macOS 14.0 或更高版本。
**macOS 第一次使用前，需要授权 `Accessibility` 和 `Screen Recording` 的权限，windows和linux无需执行**
```bash
open-computer-use
# 或
ocu
```
开始用前可以通过一键安装到主流的Agent里：
```bash
# 一键安装到 Codex，写到 ~/.codex/config.toml 中
open-computer-use install-codex-mcp
ocu install-codex-mcp
```
也可以手动配置到你自己的客户端里：
```json
{
"mcpServers": {
"open-computer-use": {
"command": "open-computer-use",
"args": ["mcp"]
}
}
}
```
### Skill
一键安装skill：
```bash
# 安装到 Codex
npx skills add iFurySt/open-codex-computer-use -g -a codex --skill open-computer-use -y
npx skills ls -g -a codex | rg 'open-computer-use'
```
安装到 Claude Code
```
npx skills add iFurySt/open-codex-computer-use -g -a claude-code --skill open-computer-use -y
```
更新已有的全局安装，包括上面安装到 Codex 的那份：
```bash
npx skills update open-computer-use -g -y
```
也可以手动下载 [`open-computer-use` skill](./skills/open-computer-use) 安装
## 更多
除了直接用上面的 MCP JSON 配置，你也可以用一些内置子命令：
```bash
# 一键安装到 Codex，写到 ~/.codex/config.toml 中
open-computer-use install-codex-mcp
# 一键安装到 Codex 插件，主要方便在 Codex App 中使用
open-computer-use install-codex-plugin
# 一键安装到 Claude Code，写到 ~/.claude.json 中
open-computer-use install-claude-mcp
# 一键安装到 Gemini CLI 当前项目，写到 ./.gemini/settings.json
open-computer-use install-gemini-mcp
# 一键安装到 Gemini CLI 用户级配置
open-computer-use install-gemini-mcp --scope user
# 一键安装到 opencode，写到 ~/.config/opencode/opencode.json（或当前生效的配置文件）
open-computer-use install-opencode-mcp
# 直接调用单个 Computer Use tool，输出 MCP 风格的 JSON result
open-computer-use call list_apps
ocu call list_apps
open-computer-use call get_app_state --args '{"app":"TextEdit"}'
# 在同一个进程里编排连续动作，复用 get_app_state 拿到的 element_index
# 连续动作默认会在成功的相邻操作之间 sleep 1 秒
open-computer-use call --calls '[{"tool":"get_app_state","args":{"app":"TextEdit"}},{"tool":"press_key","args":{"app":"TextEdit","key":"Return"}}]'
open-computer-use call --calls-file examples/textedit-overlay-seq.json --sleep 0.5
# 检查权限；只有缺失时才会拉起引导，已全部授权则只打印状态并退出
open-computer-use doctor
# 查看帮助
open-computer-use -h
ocu -h
```
## Cursor Motion
Cursor Motion 是一个面向 macOS 的开源光标运动系统，基于 Software.Inc 几位大佬的公开信息实现的开源版本，也可以到 [Releases 页面](https://github.com/iFurySt/open-codex-computer-use/releases) 下载 app 运行。
[](https://youtu.be/KRUq5GUHv1Q)
## Star History
## License
[MIT](./LICENSE)。第三方归属与许可说明见 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)。