启用工具深度解析:调用时机、触发条件与桌面自动化实战指南)
文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载本文聚焦 Claude Code 系统提示词仓库claude-code-system-prompts中tool-description-enable-computer-use这一工具描述文档深入拆解启用计算机使用Enable Computer Use工具的核心定位、调用时机、排除场景与调用顺序并结合仓库内相关联的 shared 变体、stub 指引、Computer Use MCP 技能与动作参数文档给出可直接落地的桌面自动化操作全流程。读完本文你将掌握何时该调用启用工具、何时严禁调用、启用后如何按应用授权与分级权限安全操作用户的电脑以及常见故障应用无响应、工具缺失的处置方式。一、工具定位一次调用、为整个对话开启桌面操控能力在 启用工具描述 中这个工具被定义为对话级的能力开关Enable computer use on the users own computer for this conversation, so you can see its screen and work in its applications (take screenshots, click, type, scroll, open apps).翻译过来即在本对话中启用用户自己电脑上的计算机使用能力让 Agent 可以看到用户的屏幕并在其应用程序中工作——具体操作包括截图screenshots、点击click、键入type、滚动scroll、打开应用open apps。几个关键定位特征值得强调作用范围是本对话for this conversation启用行为是会话级的不是一次性动作也不是针对单个应用的临时授权目标是用户自己的电脑the users own computer区别于浏览器内的自动化Chrome MCP它面向的是用户桌面上的原生应用native apps与跨应用工作流能力边界是看得见 动得了能够查看屏幕并通过鼠标键盘交互这决定了后续所有 computer-use 类工具截图、点击、输入等能否生效。从实现角度看该工具描述文件带有 frontmatter 元数据name: Tool Description: Enable computer useccVersion: 2.1.284说明它随每个 Claude Code 版本同步更新是内置工具描述体系builtin tool descriptions的一部分。二、调用时机四种必须调用call的情形原文档用when从句明确列出了必须调用启用工具的触发条件按优先级可归纳为四类2.1 用户在某个应用中请求做事when the user asks you to do something in an application on their computer即用户要求你在其电脑的某个应用程序里完成具体事务例如帮我在 Notes 里整理这段内容、打开照片 App 把这张图旋转 90 度。此时需要看到屏幕、操作界面就必须先调用启用工具。2.2 用户明确要求使用其电脑或屏幕or explicitly asks you to use their computer or their screen即用户明确表述用我的电脑看我的屏幕这类指令。即便任务本身尚未细化只要用户显式授权使用其电脑/屏幕就应立即启用。2.3shared 变体新增技能或任务步骤需要本机应用在 feature-gated 变体 shared descriptionccVersion: 2.1.288中触发条件进一步扩展when a step in a skill or task the user asked you to carry out needs an application on their computer即用户委派的技能skill或任务task中某一步骤需要用到用户电脑上的应用时同样需要调用启用工具。这意味着触发不局限于用户的原话还包括用户请求执行的任务链条中隐含的桌面操作需求。2.4shared 变体新增工具缺失时调用即补装shared 变体还补充了工具发现tool discovery层面的关键语义If the tools it turns on, or the tools for files on that computer, are missing from your tool list, calling it is how they are added, possibly a turn later.即如果启用工具所打开的能力computer-use 工具以及该电脑上的文件工具不在当前工具列表中调用它正是把它们添加到工具列表的方式——而且工具的加入可能延迟一个轮次possibly a turn later才完成。这一点对 Agent 的决策很重要不能因为当前列表里没有 computer-use 工具就断定不可用应当先调用启用工具进行探测。三、排除场景三种严禁调用Do not call it原文档用 Do not call it for ... 明确划出了必须克制、禁止调用的三类情形这是避免滥用桌面权限的纪律红线排除场景原文依据处理方式可从对话上下文直接回答的问题questions you can answer from the conversation直接用已有信息回答不启用可用网络搜索web search回答的问题...or with web search改用 web search / 检索工具只需要浏览器即可完成的工作work that only needs their web browser走 Chrome / claude-in-chrome 工具链请求仅仅是提到了某个应用merely because a request mentions an application不构成启用理由先判断实际需求最后一条尤其值得注意提到应用不等于需要在应用里操作。例如用户问我电脑上装的 Photoshop 支持导出 WebP 吗——这只是提及应用完全可以用对话知识或网络搜索回答不应触发桌面启用。这一约束与 计算机使用技能 中Look before you assert断言前先看屏幕的原则互为补充少做假设能低成本核实的就不动用桌面权限。四、调用顺序与优先级一次、提前、先于其他 computer-use 工具原文档对调用次序有非常严格的约定If you already have tools whose names start withmcp__remote-devices__computer_, use those directly instead of calling this. Otherwise call it once, before any other computer-use tool ...可以拆解为两条硬规则已有远程设备工具则跳过启用如果当前工具列表已经包含以mcp__remote-devices__computer_开头的工具例如通过远程设备 MCP 连接则直接使用这些工具不要再调用启用工具——启用工具只在裸环境下作为入口存在否则只调用一次且必须在任何其他 computer-use 工具之前启用是一个前置动作enable step调用一次即可不应重复调用在同一轮次中必须先完成启用再使用截图、点击、输入等后续工具。这一点与仓库中的 stub 指引ccVersion: 2.1.292完全对齐——后者正是针对已经拥有mcp__remote-devices__computer_工具的场景给出的替代指引The computer-use tools are themcp__remote-devices__computer_tools you have here; there is no separate enable step. Try the users request with them now, asking for access to the applications you need first, the way those tools describe.也就是说在 stub 场景下不存在独立的 enable 步骤Agent 应直接用现有 remote-devices 工具尝试任务并按这些工具自身的描述先请求所需应用访问权限。五、版本演进标准版与 feature-gated shared 变体同一启用工具在仓库中存在两个版本的描述文档可对照使用维度标准版shared 变体文件tool-description-enable-computer-use.mdtool-description-enable-computer-use-shared-description.mdccVersion2.1.2842.1.288触发条件用户请求在应用内做事 / 明确要求使用电脑或屏幕上述条件 技能/任务步骤需要本机应用工具补装语义未明确说明明确工具缺失时调用即可添加可能延迟一回合应用前提默认形态功能开关rollout flag开启时启用shared 变体的 frontmatter 明确标注它是 Feature-gated variant ... used instead of the standard one when its rollout flag is on——即当对应功能开关开启时用它替换标准描述。它把触发范围从用户显式请求扩展到用户委派的任务内部隐含的桌面需求并把调用 工具注册的机制写进了描述是理解该工具行为演进的关键文档。六、启用后的实战流程授权 → 分级 → 操作调用启用工具只是起点。结合 计算机使用技能启用后的完整桌面操作模型分为四步。6.1 工具选择层级先选最快最准的工具技能文档定义了严格的三级工具选择顺序tier应用专属 MCP如果目标应用已有专属 MCPSlack、Gmail、Calendar、Linear 等且已连接优先使用——API 驱动的工具更快更精准Chrome MCPmcp__claude-in-chrome__*目标是 Web 应用且没有专属 MCP 时用浏览器工具——DOM 感知远比点像素快若 Chrome 扩展未连接应请用户安装扩展而不是降级到 computer useComputer use原生桌面应用Maps、Notes、Finder、Photos、系统设置及任何第三方原生应用与跨应用工作流的正确选择——技能文档明确强调不要因为某个原生应用没有专属 MCP 就拒绝处理它的任务。同时技能文档提醒这是可用性选择而非错误处理——专属 MCP 出错时应调试或报告而不是默默降级到更慢的层级重试。6.2 访问授权流Access flow先 request_access 再动手before any computer-use action you must callrequest_accesswith the list of applications you need.每次 computer-use 操作之前必须先调用request_access并附上所需应用列表用户会逐个显式批准如果任务中途发现还需要别的应用必须再次调用request_access。技能文档特别举例Finder 与普通应用无异点击桌面、Dock 或 Finder 窗口包括 Go to Folder都需要 Finder 授权菜单栏例外只要最前端的应用frontmost app是你已获授权的应用操作菜单栏就不需要额外授权。6.3 分级应用权限Tiered appsread / click / full 三档某些应用按其类别被授予受限层级层级会显示在批准对话框中并随request_access响应返回层级覆盖应用能力限制read浏览器Safari、Chrome、Firefox、Edge、Arc 等截图可见但点击与键入被拦截导航、点击、填表改用 claude-in-chrome MCPclick终端与 IDETerminal、iTerm、VS Code、JetBrains 等可见且可左键点击但键入、按键、右键、修饰键点击、拖放被拦截shell 命令改用 Bash 工具full其余一切应用无限制层级由**最前端应用检查frontmost-app check**强制执行若 read 级应用在前端left_click会返回错误若 click 级应用在前端type与right_click会返回错误——错误信息会告诉你该应用的层级及替代做法。而open_application在任何层级都可用把应用带到前端属于 read 级操作。6.4 先看后断言Look before you assert技能文档要求用户询问应用状态什么开着、什么连着、应用能做什么时先截图核实再回答不要凭记忆断言若要说某应用不支持某操作必须基于刚看到的屏幕证据。此外list_granted_applications或一次新鲜的screenshot比错误的断言成本更低——这正是先核实再行动原则的落地。七、安全边界链接可疑默认化与金融操作禁区启用桌面操控后安全约束随之收紧技能文档给出了两条硬边界。7.1 链接安全可疑默认化Link safety绝不用 computer-use 工具点击网页链接在原生应用Mail、Messages、PDF 等中遇到链接不要left_click改用 claude-in-chrome MCP 打开 URL跟进任何链接前先看完整 URL可见的链接文字可能误导应悬停或检查真实目的地来自邮件、消息或未知发件人文档的链接默认可疑目的地 URL 陌生或可疑时先向用户确认再继续即使在 Chrome 扩展内可点击链接可疑检查依然适用。7.2 金融操作禁止代执行交易或转账Financial actions预算与记账类应用Quicken、YNAB、QuickBooks 等虽以 full 层级授权以便归类交易、生成报表、整理财务但严禁代用户执行交易、下单、汇款或发起转账——此类动作必须始终由用户亲自完成。八、故障排查stub 场景与无响应处置stub 指引 针对已有 remote-devices 工具的形态给出了详细的故障处置流程不要谎报已连接只有某次工具调用真正成功后才能告诉用户你的电脑已连接调用持续无响应说明用户电脑上的 Claude 应用没有应答——它可能被关闭或电脑处于休眠状态。应告知用户请在那台电脑上打开 Claude 应用并继续在本地能做的事本会话没有任何此类工具应告诉用户你的电脑当前不可用计算机使用功能并提示Claude 应用内 Settings → This computer → Computer use可能显示原因然后继续处理本地可完成的工作不要臆断权限被拒除非结果明确说明否则不要说权限被拒绝Dont say a permission was denied unless a result says so。九、关联能力全景从启用到动作的完整工具链理解启用工具还需知道它打开的是怎样的能力集合。仓库中与之配套的描述文档包括Computer Use MCP 技能工具选择层级、访问授权流、分级应用、链接安全与金融限制的完整操作规范mcp__computer-use__*工具集computer 工具描述浏览器内自动化主描述截图与鼠标键盘交互、按截图确定坐标、光标尖端居中点击等操作技巧——注意该工具面向 Chrome 浏览器场景与用户自己电脑的桌面应用场景互补但不混同computer action 参数动作枚举参数涵盖left_click、right_click、double_click、triple_click、type、screenshot、wait、scroll、key、left_click_drag、zoom、scroll_to、hover等 13 种动作。另外ToolSearch 加载指引 建议若 computer-use 工具位于延迟加载列表应一次性批量加载——用单次 ToolSearch 查询{ query: computer-use, max_results: 30 }关键词会按服务名子串匹配到全部工具不要用select:逐个加载那会一次往返加载一个工具。十、要点速览启用工具的决策清单判断动作工具列表已有mcp__remote-devices__computer_工具直接用跳过启用若调用无响应按 stub 指引排查用户在电脑应用中请求做事 / 明确要求使用其电脑或屏幕调用一次且在一切 computer-use 工具之前技能/任务步骤需要本机应用shared 变体场景同样调用一次computer-use 工具不在工具列表调用启用工具即可能添加可能延迟一回合不要直接断定不可用问题可从对话或 web search 回答不调用只需浏览器完成的工作走 claude-in-chrome 工具链不调用请求只是提到应用不调用启用后首次操作应用先request_access列出所需应用等用户批准任务中途需要新应用再次request_access遇到 read/click 级应用在前端按错误提示改用 claude-in-chrome 或 Bash 工具原生应用中遇到链接 / 涉及转账交易不点击链接改用浏览器 MCP/ 不代执行金融动作总结tool-description-enable-computer-use是 Claude Code 桌面自动化能力的总开关。它规定了一次性、前置、有边界的启用语义触发于用户要在电脑应用里做事克制于能靠对话/搜索/浏览器解决启用之后配套的访问授权流、应用分级权限、链接安全与金融操作约束共同构成完整的安全操作框架。理解这份工具描述即掌握了 Claude Code 在用户自有电脑上看得见、动得了、守得住的完整机制。赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐Claude Code Haha v0.1.4 桌面端体验优化与 Windows Computer Use 能力补强解析Claude Code Haha v0.1.4 桌面端体验优化与 Windows Computer Use 能力补强解析 导读 Claude Code Haha人工智能AI 应用桌面应用代码智能体MCP ClientsClaude Code 的 Computer Use MCP 使用指南工具选择层级、应用访问权限与安全边界Claude Code 的 Computer Use MCP 使用指南工具选择层级、应用访问权限与安全边界 本篇技术指南以 Claude Code 系统提示词文档提示工程人工智能Claude Code AskUserQuestion 工具深度解析触发条件、字段体系与 Plan Mode 协作规范Claude Code AskUserQuestion 工具深度解析触发条件、字段体系与 Plan Mode 协作规范 Claude Code 的 AskUs文档提示工程人工智能上一篇Skip-Softmax注意力稀疏化如何用Model Optimizer加速视频生成完整新手指南下一篇CiLocks apktool反编译教程彻底拆解一个APK的目录结构与资源创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考