mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-15 21:05:51 +00:00
137 lines
4.4 KiB
Markdown
137 lines
4.4 KiB
Markdown
# Computer Use 用户指南
|
||
|
||
Computer Use 让 Claude 直接操控你的电脑——移动鼠标、点击、输入文字、截图，就像一个远程助手坐在你面前操作一样。
|
||
|
||
## 支持平台
|
||
|
||
| 平台 | 状态 | 额外配置 |
|
||
|------|------|---------|
|
||
| macOS | 可用 | 需授予辅助功能 + 屏幕录制权限 |
|
||
| Windows | 可用 | 无需额外配置 |
|
||
| Linux | 不可用 | 后端待开发 |
|
||
|
||
## 快速开始
|
||
|
||
1. 启动 Claude Code：
|
||
|
||
```bash
|
||
bun run dev
|
||
```
|
||
|
||
Computer Use 默认已开启，无需额外参数。
|
||
|
||
2. 在对话中告诉 Claude 你想做什么，例如：
|
||
- "帮我打开系统设置"
|
||
- "截个屏看看当前桌面"
|
||
- "在 Finder 里点击那个文件"
|
||
|
||
3. 首次操控某个应用时，会弹出权限对话框让你确认。
|
||
|
||
4. 操作过程中随时按 **Esc**（macOS）或 **Ctrl+C**（Windows）中止。
|
||
|
||
## 权限说明
|
||
|
||
Computer Use 采用分级权限模型，保护你的安全：
|
||
|
||
| 级别 | 能力 | 适用场景 |
|
||
|------|------|---------|
|
||
| **full** | 所有操作：鼠标点击（左/右/中键）、拖拽、键盘输入、组合键 | 系统设置、Finder 等系统应用 |
|
||
| **click** | 仅左键点击和滚轮滚动 | IDE（VS Code、Cursor）、终端 |
|
||
| 未授权 | 所有操作被拒绝 | 需要通过 `request_access` 申请 |
|
||
|
||
IDE 类应用默认只有 click 权限，这是安全设计——防止 AI 在你的终端或编辑器中执行危险操作。如需完整控制，可以在权限对话框中手动提升。
|
||
|
||
## 可用操作
|
||
|
||
### 鼠标
|
||
|
||
| 操作 | 说明 |
|
||
|------|------|
|
||
| 移动鼠标 | 移动到指定坐标 |
|
||
| 左键点击 | 单击、双击、三击 |
|
||
| 右键点击 | 需要 full 权限 |
|
||
| 中键点击 | 需要 full 权限 |
|
||
| 拖拽 | 从 A 点拖到 B 点，需要 full 权限 |
|
||
| 滚轮 | 向上或向下滚动 |
|
||
|
||
### 键盘
|
||
|
||
| 操作 | 说明 |
|
||
|------|------|
|
||
| 按键 | 单个按键或组合键（如 Ctrl+C） |
|
||
| 输入文字 | 逐字符输入文本，需要 full 权限 |
|
||
| 长按 | 按住某个键一段时间，需要 full 权限 |
|
||
|
||
### 屏幕
|
||
|
||
| 操作 | 说明 |
|
||
|------|------|
|
||
| 截图 | 截取当前屏幕 |
|
||
| 切换显示器 | 多显示器环境下切换目标屏幕 |
|
||
| 缩放 | 放大屏幕某个区域 |
|
||
|
||
### 其他
|
||
|
||
| 操作 | 说明 |
|
||
|------|------|
|
||
| 获取鼠标位置 | 查询当前鼠标坐标 |
|
||
| 批量操作 | 一次执行多个操作，减少等待 |
|
||
| 等待 | 暂停指定秒数（最长 100 秒） |
|
||
|
||
## macOS 权限配置
|
||
|
||
首次使用前，需要授予两项系统权限。缺少任一项都会导致功能异常（见下方说明）。
|
||
|
||
### 辅助功能（Accessibility）
|
||
|
||
允许 Claude 控制鼠标和键盘。
|
||
|
||
1. 打开 **系统设置 → 隐私与安全性 → 辅助功能**
|
||
2. 点击左下角锁图标解锁（需要管理员密码）
|
||
3. 将运行 Claude Code 的应用添加到允许列表：
|
||
- Terminal → `Terminal.app`
|
||
- iTerm → `iTerm.app`
|
||
- Cursor → `Cursor.app`
|
||
- VS Code 终端 → `Electron` 或 `Visual Studio Code.app`
|
||
4. 确保应用旁边的开关已打开
|
||
|
||
**未授予时的现象**：鼠标移动、点击、键盘输入均无反应，工具执行成功但屏幕没有任何变化。
|
||
|
||
### 屏幕录制（Screen Recording）
|
||
|
||
允许 Claude 截取屏幕内容。
|
||
|
||
1. 打开 **系统设置 → 隐私与安全性 → 屏幕录制**
|
||
2. 将同一个应用添加到允许列表并开启开关
|
||
3. **需要重启该应用**才能生效（系统会提示 "xxx 需要重新打开"）
|
||
|
||
**未授予时的现象**：截图工具执行成功但返回空白图片，Claude 无法看到你的屏幕，所有点击操作变成"盲点"。
|
||
|
||
### 验证权限
|
||
|
||
授予两项权限后，重启 Claude Code，在对话中让 Claude 截一张图即可验证是否配置成功。如果截图内容正常显示，说明权限配置完成。
|
||
|
||
## Linux 依赖（暂不可用）
|
||
|
||
Linux 后端尚未开发。完成后需要安装以下工具：
|
||
|
||
```bash
|
||
sudo apt install xdotool scrot xclip wmctrl
|
||
```
|
||
|
||
仅支持 X11，Wayland 不支持。
|
||
|
||
## 常见问题
|
||
|
||
### 截图成功但看不到图片
|
||
|
||
检查 **系统设置 → 隐私与安全性 → 屏幕录制** 是否已授权。未授权时截图工具会执行成功但返回空白内容。
|
||
|
||
### IDE 中无法输入文字或右键
|
||
|
||
这是正常行为。IDE 类应用只有 click 权限，无法执行键盘输入、右键、拖拽等操作。如需完整控制，请在系统应用（如 Finder）中操作。
|
||
|
||
### 操作中途想停止
|
||
|
||
按 **Esc**（macOS）或 **Ctrl+C** 即可立即中止。
|