Community编程与开发github.com

ashley-seymour/claude-skills

在第一步使用内置浏览器(Claude 桌面应用中的浏览器面板,也称为应用内浏览器、浏览器面板、Claude 浏览器或“您自己的浏览器”)之前,请先阅读此技能。其工具在桌面应用中运行时名为 `mcp__Claude_Browser__*`,在云端会话链接到用户电脑时名为 `mcp__remote-devices__Claude_Browser__*`;这些工具启用前,可能只有一个 `enable__mcp__remote-devices__Claude_Browser` 工具。它涵盖了面板的持久登录、标签页和 preview_start、以文本形式阅读页面、站点批准、面板无法打开的内容,以及无法访问时该怎么做。本技能不适用于 Claude in Chrome(`mcp__claude-in-chrome__*` 工具),后者有专门的技能,也不决定使用哪个浏览器。

claude-skills 是什么?

本技能详细描述了 Claude 桌面应用中的内置浏览器面板(又称浏览器面板、应用内浏览器或“您自己的浏览器”)的使用方法和注意事项。它明确了浏览器工具在不同运行环境下的命名规则:在桌面应用内直接运行时使用 `mcp__Claude_Browser__*` 前缀,而在云端会话(通过网页、手机或桌面应用启动并连接到用户电脑)时则使用 `mcp__remote-devices__Claude_Browser__*` 前缀。技能重点涵盖了如何通过 `enable__mcp__remote-devices__Claude_Browser` 工具首次启用浏览器、浏览器面板与侧边栏其他内容(如工件、文档)的切换逻辑、以及建议 Claude 在要求用户手动操作前先检查面板可见性的最佳实践。此外,技能还提供了以下关键操作指导:使用 `preview_start` 高效打开新标签页、优先使用 `get_page_text` 和 `read_page` 以文本形式阅读页面内容而非截图、处理站点批准与拒绝的流程(包括通过 `request_access` 工具申请访问权限),以及浏览器无法打开 `file://` 或本地 `localhost` 服务器时的替代方案。最后,技能还解释了当云端会话无法连接到桌面应用中的浏览器面板时应如何向用户报告。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ashley-seymour/claude-skills/tree/HEAD/.trash/1792396014664-17492-PVvHm9/built-in-browser

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

内置浏览器

内置浏览器是 Claude 桌面应用中一个真实的浏览器面板,与用户的 Chrome 浏览器是分开的。当会话本身在桌面应用内运行时,其工具名为 mcp__Claude_Browser__*;当会话在云端运行(通过网页、手机或桌面应用启动)并连接到用户电脑时,其工具名为 mcp__remote-devices__Claude_Browser__*。无论哪种情况,前缀后面的名称都是相同的,Claude 会使用实际存在的前缀,而本技能在提及工具时,指的是前缀后面的部分。

如果唯一存在的内置浏览器工具是 enable__mcp__remote-devices__Claude_Browser,Claude 应首先调用它:它会在本次对话中打开内置浏览器,一旦运行,mcp__remote-devices__Claude_Browser__* 工具就会出现。

用户能看到什么

浏览器面板与工件、文档和文件预览共享桌面应用的侧边栏,该面板一次只显示其中一个。当浏览器面板正在显示时,用户可以看到 Claude 所看到的内容,并可以随时浏览或接管。当面板中打开了其他内容,或者面板已关闭时,内置浏览器会继续工作,但用户无法看到它。

在要求用户亲自在浏览器面板中执行操作(如点击按钮、登录、完成验证步骤)之前,Claude 应先调用 tabs_context,其结果会说明浏览器面板是正在显示、隐藏还是未打开。如果面板未打开,Claude 应首先打开页面并再次检查。如果面板处于隐藏状态,Claude 应首先要求用户在 Claude 桌面应用中恢复浏览器显示:在 Mac 上按 Cmd+Shift+B,在 Windows 上按 Ctrl+Shift+B,或者关闭侧边栏中其他任何打开的内容,然后点击地球图标(浏览器按钮)。随后 Claude 再说明要在浏览器中做什么。Claude 之所以要询问,是因为使用浏览器并不会自动恢复面板显示,而且面板显示什么内容是由用户决定的。Claude 还应在对话中说明它在浏览器中发现或做了什么,因为用户可能没有一直关注面板。

登录状态持久化且属于用户

内置浏览器维护自己的持久化配置文件,该配置文件在桌面应用的各会话之间共享。用户或之前的会话可能已经登录了某些网站,而 Claude 完成的登录操作也会持久化以供后续使用。Claude 应将现有会话视为用户本人的:它从不注销、更改凭据,或在任务需求之外对账户进行操作。

标签页

内置浏览器支持标签页。通过 preview_start 配合 url 参数,可以在一次调用中在新标签页中打开该 URL 并返回一个 tabId,同时保留现有标签页不变,因此如果目标地址已知,Claude 应优先使用 preview_start 而不是先使用 tabs_create 再使用 navigate。navigate、read_page、get_page_text、find、computer、form_input 以及控制台和网络读取器等工具都通过 tabId 指定要操作的标签页;省略 tabId 则默认操作当前活动标签页,而 tabs_context 用于列出所有打开的标签页。

通过 ToolSearch 加载

Claude 会批量加载内置浏览器工具,而不是一个一个地加载:如果这些工具在延迟加载列表中,Claude 应通过一次 ToolSearch 调用一次性加载它们,查询条件为其完整名称前缀,例如 { query: "mcp__remote-devices__Claude_Browser__", max_results: 64 }。

阅读页面

在阅读页面内容时,Claude 应优先使用 get_page_text 和 read_page 而不是截图,因为它们返回的是页面的实际文本和结构,而不是可见视口的像素。仅当视觉布局是重点,或者用户要求看到页面时,才应使用 computer 工具的 "screenshot" 操作。

站点批准、被阻止的站点和 request_access

根据用户的批准设置,Claude 在操作某个站点之前,用户可能需要批准该站点,而某些站点则被直接阻止。Claude 应等待待处理的批准,而不是试图绕过它。如果页面被拒绝或批准被拒绝,Claude 应告知用户并继续执行其他操作,而不是重试。

当工具带有 mcp__remote-devices__Claude_Browser__ 前缀时,批准可以在用户的任何设备上进行确认,这可能需要一些时间才能生效,同时会话中可能还有一个 request_access 工具。如果浏览器工具回复说该站点尚未被允许,并且存在 request_access 工具,Claude 应使用该站点的 URL 和范围“once”(或者当任务将反复使用该站点时使用“site”)调用 request_access,等待用户的回答,然后重试原始工具。如果没有 request_access 工具,则按上述方式处理被拒绝的站点:Claude 告知用户并继续执行其他操作。

内置浏览器无法打开的内容

内置浏览器无法打开 file:// 类型的 URL 或由 Claude 启动的本地 localhost 服务器,因为这些服务运行在 Claude 的 shell 环境中,而不是浏览器面板的环境中。如果 Claude 需要向用户展示其生成的 HTML,应改用工件(artifact)来实现。

当无法访问内置浏览器时

当工具带有 mcp__remote-devices__Claude_Browser__ 前缀时,浏览器面板运行在用户电脑上的 Claude 桌面应用中,而 Claude 本身运行在其他地方,因此只有在桌面应用保持打开且在线状态时才可访问。如果这些工具调用无法访问桌面应用(出现连接错误或无响应),Claude 应告知用户其电脑上的内置浏览器似乎处于离线状态,而不是重试,并根据会话的浏览器指导来决定是继续使用其他浏览器还是先询问用户。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

ashley-seymour/claude-skills

Arm, run and disarm an unattended away run (a night or a few hours). A queue of items is worked one per fresh `claude -p --agent away-orchestrator` process, relaunched by a watchdog under a Windows scheduled task, in its own worktree on branch away/<date>, ending in a morning report. Use only when the operator asks to arm, check or disarm an away run, or when running as away-orchestrator. Not for interactive project waves (project-workflow) or one-off `claude -p` scripts (headless-claude).

ashley-seymour/claude-skills

Use this skill when the user's prompt requires (1) researching a topic across multiple sources, comparing options or alternatives, analyzing trends or history, understanding markets or industries, or reviewing literature or studies and (2) synthesizing that research into a comprehensive, narrative report. If you're planning to search the web or internal knowledge bases, consider using this skill. This skill coordinates research subagents, so use it only when you have a tool for spawning subagents (the Agent or Task tool); otherwise, research the question directly.

ashley-seymour/claude-skills

Read this skill before the first step that uses Claude in Chrome, the browser extension whose tools are named mcp__claude-in-chrome__* (also called Chrome, the browser extension, or the external browser) and which acts in the person's real Chrome with their own sign-ins; before those tools are turned on there may be a single enable__mcp__claude-in-chrome tool instead. It covers loading the tools in one ToolSearch call, checking the person's open tabs and working in a new tab, site permissions, GIF recordings, console logs, dialogs to avoid, and when to stop and ask. It is not for the built-in browser (mcp__Claude_Browser__* or mcp__remote-devices__Claude_Browser__* tools), which has its own skill, and it does not decide which browser to use.

ashley-seymour/claude-skills

Read this skill before the first step of any request to do something in an app on the person's own computer (Notes, Finder, System Settings, any desktop app), to look at their screen, or for \"computer use\". Computer use (desktop control) lets Claude take screenshots of the person's desktop and control it with clicks, typing and scrolling through the Claude desktop app; its tools are named mcp__computer-use__* when the session runs in the desktop app and mcp__remote-devices__computer_* when a cloud session is linked to the person's computer; before computer use is turned on for a conversation there may be no such tools, only an enable__mcp__remote-devices__computer tool, which turns it on. It covers turning it on, picking the right tool, the access flow, and the safety rules for tiered apps, links and financial actions. It is not for websites, which go through Claude in Chrome or the built-in browser and their own skills.

相关技能