内置浏览器

侧边面板里一个 Agent 也能操作的浏览器,用来打开和试用你正在做的应用。

Kettu 的侧边面板里有一个浏览器。Agent 可以打开它正在做的应用,查看页面、点来点去,你在一旁看着;你自己也能用它。

打开浏览器

点顶栏的浏览器。每个会话有自己的页面。在地址栏里输入网址:只写地址时补上 https://,像 localhost:3000 这样的本地地址补上 http://。顶部有后退、前进、重新加载、在浏览器中打开(在你的默认浏览器里打开当前页面)和最大化。

Agent 打开页面时,如果侧边面板没在显示别的内容,浏览器会自己打开。如果正在显示别的窗格,浏览器按钮上会出现一个圆点。

Agent 能做什么

浏览器的工具来自 Kettu 内置的 MCP 服务器。Agent 可以用它们:

  • 打开网址、后退、重新加载
  • 读取页面结构,截图
  • 点击、输入、按键、滚动、选择选项
  • 等待某段文字出现
  • 读取控制台消息和网络请求,在页面里运行 JavaScript

Agent 操作时,会出现一条提示:Claude Code 正在使用浏览器(显示的是当前会话的 Agent),旁边是停止。点停止,或者你自己在页面里输入或点击,控制权就到了你手里。这时提示变成控制权在你手里,Agent 的浏览器操作都会失败,直到你点交还。

哪些 Agent 能用

Claude Code 和 Codex 能用浏览器工具。其他 Agent 要支持通过 HTTP 连接的 MCP 服务器才能用;不支持的,设置 › MCP 服务器里会写明。不想让某个 Agent 的会话带上 Kettu 的工具,就在那里关掉它的开关,比如在 Codex 中使用 Kettu 的工具。关掉后,这个 Agent 从下次启动起就没有 Kettu 的任何工具了,不只是浏览器。

Agent 打开的站点

本地开发服务器不用问就能打开:localhost、127.0.0.1、[::1],以及以 .localhost 或 .test 结尾的域名。其他站点都会先问你,问题同时出现在对话里和浏览器窗格里:

回答效果
本次会话允许这个会话的页面可以打开该站点
此项目始终允许以后项目里的每个会话都可以打开它
拒绝Agent 的这一步操作失败

2 分钟内没有回答,请求会以未在限定时间内得到答复结束。等待期间,如果 Kettu 不在前台,它会像授权请求一样给你发通知,见通知。设置 › 浏览器 › 始终允许的站点列出了每个项目允许的站点,可以移除。

登录状态和网站数据

所有会话共用一个浏览器配置,重启后也还在,所以一个网站只需登录一次。设置 › 浏览器 › 清除浏览数据会删掉 Cookie、网站存储和缓存,你在所有网站上的登录都会退出。

浏览器不做的事

它只打开 http 和 https 页面,不打开本地文件。下载会被拦截,并提供一个按钮改在默认浏览器里打开页面;页面请求摄像头、麦克风这类权限时一律拒绝。