跳到正文
Computer Use

下载

下载 Computer Use

版本 0.7.0 · 开发预览 · MIT 许可

不确定自己的 Windows 是哪种？打开“设置 → 系统 → 系统信息”，查看“系统类型”

全部发布与校验文件 (在新标签页打开)

安装

下面的界面名称与 App 中显示的一致：App 目前提供简体中文和英文界面

  1. 打开下载的 .dmg，把 Computer Use 拖到“应用程序”，再从“应用程序”中打开

  2. 从菜单栏图标打开“设置…”。在“权限与状态”页请求“辅助功能”和“屏幕录制”，在系统设置中允许 Computer Use，然后完全退出并重新打开 App

  3. 可选，仅用于手动使用终端：在“通用”页选择“安装到 ~/.local/bin…”，再把该目录加入 PATH，即可在终端使用 computer-use

zsh
export PATH="$HOME/.local/bin:$PATH"

更喜欢用终端？

有 Node.js 22+ 时，npm 启动器会查找或校验并安装官方 App，然后输出一段给 Agent 的安装提示词。系统权限和首次配对批准仍需在 App 中完成

terminal
npx @starroy/computer-use setup
# or
pnpm dlx @starroy/computer-use setup

连接你的 Agent

最快的方式是使用安装提示词。App 只负责复制：提示词只包含本机路径提示，不含凭据，App 也不会改动你 Agent 的设置或 Skill 目录

  1. 在 App 中打开“设置 → 接入”，复制安装提示词

  2. 粘贴给你的 Agent。它会获取 Skill、按自己的方式安装并检查连接。它请求配对时，在 App 中批准；新的配对默认覆盖所有桌面应用

  3. 先让它做一个只读任务，例如下面的提示词，确认拿到真实的窗口截图后，再让它输入或点击

安全的第一个任务
使用 computer-use 检查连接，列出已授权窗口，打开测试窗口的会话，获取截图并描述看到的内容，然后关闭会话。此次不要点击或输入

生成提示词本身既不会配对，也不会启动任何服务。系统权限和首次配对始终由你在本机的 App 中批准

用 CLI 或 MCP 手动接入

适用于需要限定范围、使用命名 profile，或 Agent 不支持 Skill 的情况。在终端中运行命令；Windows 上请在安装目录中运行

发起配对，然后在 App 中批准请求。默认范围是所有桌面应用；加 --app <id> 可以限制范围，加 --all-apps --browser 则同时包含独立浏览器

zsh
computer-use pair --profile default --name 'My Agent'

打开一个普通（未提权）的应用，并新建一份空白测试文档（macOS 上可用“文本编辑”），然后检查连接并列出它的窗口

zsh
computer-use doctor --profile default
computer-use targets --profile default

输出适用于你的 Agent 的配置，并添加到 Agent 的 MCP 设置中。其他 Agent 可以用 computer-use config stdio --profile default 得到通用 JSON

zsh
computer-use config codex --profile default

生成的配置只包含启动路径和 profile 名称，不含凭据。Computer Use 不会修改你的 Agent 配置

校验下载文件

每个 ZIP、DMG 和安装程序在发布页上都有同名的 .sha256 文件。运行之前请先比对

macOS，在同时存放两个文件的目录中：

zsh
shasum -a 256 -c computer-use-0.7.0-macos-arm64.dmg.sha256

Windows PowerShell：

PowerShell
Get-FileHash .\computer-use-0.7.0-windows-x64-setup.exe -Algorithm SHA256
Get-Content .\computer-use-0.7.0-windows-x64-setup.exe.sha256

更新与卸载

  • Computer Use 每天检查一次 GitHub 上是否有新的正式版（可以关闭），并用该版本发布的 SHA-256 和元数据校验每次下载。不会发送任何使用数据

  • macOS：已签名的正式版可一键更新，系统权限和已配对的客户端保持不变

  • Windows：安装版会下载新的安装程序，由你运行；便携版会下载并校验 ZIP，由你自行替换

  • 卸载：macOS 上退出 App 后删除即可；Windows 上在“设置 → 应用”中卸载。配对数据和日志保留在你的用户目录中（macOS 为 ~/Library/Application Support/Computer Use 和 ~/.config/computer-use，Windows 为 %LOCALAPPDATA%\Computer Use），不再需要时可以手动删除

需要帮助？

请查看使用说明，或在 GitHub 上提交 issue