跳至內容
Computer Use

下載

下載 Computer Use

版本 0.7.0 · 開發預覽 · MIT 授權

不確定自己的 Windows 是哪一種?開啟「設定 → 系統 → 關於」,查看「系統類型」

全部發佈版本與 SHA-256 檔案 (在新分頁開啟)

安裝

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