Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Computer use 是 macOS 上的研究预览版，需要 Pro 或 Max 计划。它在 Team 或 Enterprise 计划上不可用。它需要 Claude Code v2.1.85 或更高版本以及交互式会话，因此在使用
-p 标志的非交互式模式下不可用。您可以用 computer use 做什么
Computer use 处理需要 GUI 的任务：任何您通常必须离开终端并手动完成的事情。- 构建和验证原生应用：要求 Claude 构建 macOS 菜单栏应用。Claude 编写 Swift、编译它、启动它，并点击每个控件来验证它是否有效，然后您才打开它。
- 端到端 UI 测试：将 Claude 指向本地 Electron 应用并说”测试入门流程”。Claude 打开应用、点击注册，并截图每一步。无需 Playwright 配置，无需测试工具。
- 调试视觉和布局问题：告诉 Claude”模态框在小窗口上被裁剪”。Claude 调整窗口大小、重现错误、截图、修补 CSS，并验证修复。Claude 看到您看到的内容。
- 驱动仅限 GUI 的工具：与设计工具、硬件控制面板、iOS 模拟器或没有 CLI 或 API 的专有应用交互。
Computer use 何时适用
Claude 有多种方式与应用或服务交互。Computer use 是最广泛和最慢的，所以 Claude 首先尝试最精确的工具：- 如果您有该服务的 MCP server，Claude 会使用它。
- 如果任务是 shell 命令，Claude 会使用 Bash。
- 如果任务是浏览器工作且您已设置 Claude in Chrome，Claude 会使用它。
- 如果以上都不适用，Claude 会使用 computer use。
启用 computer use
Computer use 作为称为computer-use 的内置 MCP server 可用。默认情况下它是关闭的，直到您启用它。
设置后，要求 Claude 做需要 GUI 的事情：
按会话批准应用
启用computer-use 服务器不会授予 Claude 访问您机器上每个应用的权限。Claude 在会话中第一次需要特定应用时，您的终端中会出现一个提示，显示：
- Claude 想要控制哪些应用
- 任何额外请求的权限，例如剪贴板访问
- Claude 工作时将隐藏多少其他应用
| 警告 | 适用于 |
|---|---|
| 等同于 shell 访问 | Terminal、iTerm、VS Code、Warp 和其他终端和 IDE |
| 可以读取或写入任何文件 | Finder |
| 可以更改系统设置 | System Settings |
Claude 如何在您的屏幕上工作
理解流程有助于您预期 Claude 将做什么以及如何干预。一次一个会话
Computer use 在活动时持有机器范围的锁。如果另一个 Claude Code 会话已在使用您的计算机，新的尝试会失败并显示一条消息，告诉您哪个会话持有锁。首先完成或退出该会话。Claude 工作时应用被隐藏
当 Claude 开始控制您的屏幕时，其他可见应用被隐藏，以便 Claude 仅与批准的应用交互。您的终端窗口保持可见并被排除在屏幕截图之外，因此您可以观看会话，Claude 永远看不到自己的输出。 当 Claude 完成轮次时，隐藏的应用会自动恢复。随时停止
当 Claude 获取锁时，会出现 macOS 通知：“Claude is using your computer · press Esc to stop”。在任何地方按Esc 立即中止当前操作，或在终端中按 Ctrl+C。无论哪种方式，Claude 都会释放锁、取消隐藏您的应用，并将控制权返回给您。
当 Claude 完成时，会出现第二个通知。
安全性和信任边界
内置的护栏在不需要配置的情况下降低风险：- 按应用批准：Claude 只能控制您在当前会话中批准的应用。
- 哨兵警告：授予 shell、文件系统或系统设置访问权限的应用在您批准之前被标记。
- 终端被排除在屏幕截图之外：Claude 永远看不到您的终端窗口，因此您会话中的屏幕提示无法反馈到模型中。
- 全局转义：
Esc键从任何地方中止 computer use，并且按键被消耗，因此提示注入无法使用它来关闭对话框。 - 锁文件：一次只有一个会话可以控制您的机器。
示例工作流
这些示例展示了将 computer use 与编码任务结合的常见方式。验证原生构建
对 macOS 或 iOS 应用进行更改后，让 Claude 在一次通过中编译和验证：xcodebuild、启动应用、与 UI 交互，并报告它发现的内容。
重现布局错误
当视觉错误仅在某些窗口大小下出现时，让 Claude 找到它：测试模拟器流程
无需编写 XCTest 即可驱动 iOS 模拟器：与 Desktop 应用的差异
CLI 和 Desktop 表面共享相同的 computer use 引擎。一些 Desktop 特定的控件在 CLI 中还不可用：| 功能 | Desktop | CLI |
|---|---|---|
| 启用 | Settings > General 中的切换（在 Desktop app 下） | 在 /mcp 中启用 computer-use |
| 拒绝应用列表 | 在设置中可配置 | 尚不可用 |
| 自动取消隐藏切换 | 可选 | 始终开启 |
| Dispatch 集成 | Dispatch 生成的会话可以使用 computer use | 不适用 |
故障排除
”Computer use is in use by another Claude session”
另一个 Claude Code 会话持有锁。完成该会话中的任务或退出它。如果另一个会话崩溃，当 Claude 检测到该进程不再运行时，锁会自动释放。macOS 权限提示不断重新出现
授予 Screen Recording 后，macOS 有时需要重启请求进程。完全退出 Claude Code 并启动新会话。如果提示仍然存在，打开 System Settings > Privacy & Security > Screen Recording 并确认您的终端应用已列出并启用。computer-use 不出现在 /mcp 中
服务器仅在符合条件的设置上出现。检查：
- 您在 macOS 上。Computer use 在 Linux 或 Windows 上不可用。
- 您运行的是 Claude Code v2.1.85 或更高版本。运行
claude --version来检查。 - 您在 Pro 或 Max 计划上。运行
/status来确认您的订阅。 - 您通过 claude.ai 进行身份验证。Computer use 不适用于第三方提供商，如 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry。如果您仅通过第三方提供商访问 Claude，您需要单独的 claude.ai 账户来使用此功能。
- 您在交互式会话中。Computer use 在使用
-p标志的非交互式模式下不可用。
另请参阅
- Desktop 中的 Computer use：具有图形设置页面的相同功能
- Claude in Chrome：用于基于网络的任务的浏览器自动化
- MCP：将 Claude 连接到结构化工具和 API
- Sandboxing：Claude 的 Bash 工具如何隔离文件系统和网络访问
- Computer use 安全指南：安全 computer use 的最佳实践