Anthropic 计算机使用（适用于 Mac）

Anthropic 计算机使用 是一项 Anthropic 的 Beta 功能，它运行一个包含 Ubuntu 的 Docker 镜像并对其进行控制。此分叉允许您在 macOS 上原生运行该功能，通过原生的 macOS 命令和实用程序直接控制系统。

[!CAUTION] 这显然伴随着一定的风险。Anthropic 代理可以控制您 Mac 上的一切。请务必小心。 Anthropic 新推出的 Claude 3.5 Sonnet 模型拒绝执行诸如购买商品或下载非法内容等不安全的操作。

特性

• 原生 macOS GUI 交互（无需 Docker）
• 使用原生 macOS 命令进行屏幕截图
• 通过 cliclick 控制键盘和鼠标
• 支持多个 LLM 提供商（Anthropic、Bedrock、Vertex）
• 基于 Streamlit 的界面
• 自动屏幕分辨率缩放
• 文件系统交互与编辑能力

先决条件

• macOS Sonoma 15.7 或更高版本
• Python 3.12+
• Homebrew（用于安装额外依赖）
• cliclick (brew install cliclick）——用于鼠标和键盘控制

设置说明

1. 克隆仓库并进入目录：

git clone https://github.com/deedy/mac_computer_use.git
cd mac_computer_use

2. 创建并激活虚拟环境：

python3.12 -m venv venv
source venv/bin/activate

3. 运行设置脚本：

chmod +x setup.sh
./setup.sh

4. 安装 Python 依赖：

pip install -r requirements.txt

运行演示

设置您的环境和 Anthropic API 密钥

1. 在 .env 文件中添加：

API_PROVIDER=anthropic
ANTHROPIC_API_KEY=<key>
WIDTH=800
HEIGHT=600
DISPLAY_NUM=1

设置屏幕尺寸（建议保持在 XGA/WXGA 分辨率范围内），并将您的密钥填入 Anthropic 控制台。

2. 启动 Streamlit 应用程序：

streamlit run streamlit.py

界面将可在 http://localhost:8501 访问。

屏幕尺寸注意事项

我们推荐使用以下分辨率以获得最佳性能：

• XGA：1024×768（4:3）
• WXGA：1280×800（16:10）
• FWXGA：1366×768（约 16:9）

更高的分辨率将自动缩放到这些目标分辨率，以优化模型性能。您可以通过环境变量设置分辨率：

export WIDTH=1024
export HEIGHT=768
streamlit run streamlit.py

[!IMPORTANT] 此参考实现中使用的 Beta API 可能会发生变化。请参阅 API 发布说明，以获取最新信息。

mac_computer_use 快速上手指南

mac_computer_use 是 Anthropic Computer Use 的 macOS 原生分支。它无需 Docker，直接利用 macOS 原生命令和工具（如 cliclick）让 AI 代理控制你的 Mac 系统，提供原生的图形界面交互、屏幕捕获及键鼠控制能力。

⚠️ 安全警告：该工具赋予 AI 代理完全控制系统的能力（包括文件操作、应用执行等）。请务必在受信任的环境下运行，并谨慎授权。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：macOS Sonoma 15.7 或更高版本
• Python 版本：Python 3.12+
• 包管理器：Homebrew
• 核心依赖：cliclick（用于模拟鼠标和键盘操作）

安装前置依赖

使用 Homebrew 安装必要的工具：

brew install cliclick

安装步骤

按照以下步骤克隆项目并配置运行环境：

1. 克隆仓库并进入目录：

   git clone https://github.com/deedy/mac_computer_use.git
   cd mac_computer_use
   

2. 创建并激活 Python 虚拟环境：

   python3.12 -m venv venv
   source venv/bin/activate
   

3. 运行初始化脚本：

   chmod +x setup.sh
   ./setup.sh
   

4. 安装 Python 依赖包：

   💡 国内加速建议：如果 pip 下载缓慢，建议使用清华或阿里镜像源。

   pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
   

基本使用

1. 配置环境变量

在项目根目录下创建 .env 文件，填入你的 Anthropic API Key 及屏幕参数。

touch .env

编辑 .env 文件，内容如下：

API_PROVIDER=anthropic
ANTHROPIC_API_KEY=<你的_Anthropic_API_Key>
WIDTH=800
HEIGHT=600
DISPLAY_NUM=1

• API Key：请前往 Anthropic Console 获取。
• 分辨率：推荐设置为 XGA (1024x768) 或 WXGA (1280x800) 以获得最佳模型性能。过高的分辨率会被自动缩放。

2. 启动演示界面

运行 Streamlit 应用以启动交互界面：

streamlit run streamlit.py

启动成功后，终端会显示访问地址（通常为 http://localhost:8501）。在浏览器中打开该地址，即可通过聊天界面指挥 AI 操作你的 Mac。

3. 自定义分辨率运行（可选）

你也可以直接在命令行指定分辨率启动：

export WIDTH=1024
export HEIGHT=768
streamlit run streamlit.py