terminal-browser:把真正的 Chromium 塞进终端,还能在 Claude Code 旁边分屏开网页

terminal-browser 是一个把真正的 Chromium 塞进终端里的浏览器。不是 w3m、lynx 那种把网页转成文字的"终端浏览器",而是网页原样渲染成像素显示在终端格子里,能点、能滚、能开 DevTools。它这两天冲上 TypeScript 趋势榜,我猜跟它顺手做了个 Claude Code 插件有关:在 Claude Code 里敲 /browser,旁边就能分出一个浏览器窗格。

它解决什么问题

现在不少人一天大半时间泡在终端里跟编码 agent 打交道,但一到"看一眼页面效果"就得切到外面的浏览器,来回切窗口很碎。terminal-browser 的思路是:网页就放在 agent 同一个终端标签页里,开个分屏,左边聊天改代码,右边刷新看结果。

另一个场景是远程开发。服务跑在远程机器的 localhost 上,平时要么配端口转发,要么开 SSH 隧道。它的 --ssh 模式直接把浏览器的所有网络请求通过 SSH 走远程机器,本地打开就能访问对方的 localhost。

核心功能

  • 真浏览器:底层是 Electron 的离屏渲染,从 GPU 读 Chromium 画好的像素,再用 kitty 图形协议画进终端。键鼠事件从终端读取后转成合成事件喂给 Chromium,macOS 上还用一个后台 Swift 小程序补读触控板事件,所以平滑滚动、无限画布这类网页也能用
  • 标签页、地址栏、命令面板、页内查找、DevTools,快捷键基本照搬普通浏览器(macOS 用 cmd,Linux 用 ctrl)
  • 给 agent 用:terminal-browser action 是一套兼容 agent-browser 的命令行接口,agent 可以直接操作已经打开的浏览器。还有"选中元素发给 agent"(ctrl+g)和录制页面操作的功能
  • 分屏打开:--split right 在当前终端右侧分出一个窗格
  • 嵌入模式:可以嵌到别的 TUI 里,仓库里有示例。底层渲染能力也拆成了独立的 JS 库 pixel,想在终端里做图形界面的可以拿去用

怎么用

macOS / Linux 一行安装:

curl -fsSL https://terminal-browser.sh/install | bash   # 或者 brew install terminal-browser

常用命令:

terminal-browser                          # 启动
terminal-browser open https://example.com # 打开指定网址
terminal-browser --split right            # 在右侧分屏打开
terminal-browser open --ssh user@host http://localhost:3000  # 请求走远程机器
terminal-browser ls                       # 列出已打开的浏览器
terminal-browser upgrade                  # 升级

装 Claude Code 插件的话,先在 ~/.claude/settings.json 里打开实验性的函数钩子:

{
  "env": { "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1" }
}

然后:

claude plugin marketplace add zenbu-labs/terminal-browser
claude plugin install terminal-browser@terminal-browser

之后在 Claude Code 里输入 /browser 就能开。插件还暴露了一个 browser.open 接口,别的插件可以借它做 /tldraw、/open-pr 这种一键在侧边打开某个页面的命令。

值得注意的地方

门槛主要在终端上。必须用支持 kitty 图形协议的终端,比如 Ghostty、kitty、cmux、VS Code 终端,以及基于 libghostty 的终端。系统方面目前只支持 macOS 和 Linux,Windows 用户暂时用不上。

Claude Code 插件这块作者自己也标了"实验性",限制写得挺坦白:

  • 除了图形协议,还要求终端支持 kitty 的 unicode placeholder,基本就是 Ghostty 和 kitty
  • 套了 tmux 之类的多路复用器,插件目前用不了(独立运行的 terminal-browser 在 tmux 里可以)
  • 在 Claude Code 里帧率超过 50 左右界面可能花屏,鼠标位置偶尔有偏差
  • 依赖 Claude Code 还不稳定的函数钩子 API,升级后可能会坏

所以我的看法是:如果你本来就是 Ghostty / kitty 用户,每天在终端里跑 agent,它很值得装上试试,"agent 改完我在旁边直接看"的体验是别的方案给不了的。远程开发看 localhost 的 --ssh 模式也挺实用。要是你在 Windows 上或者用的终端不支持图形协议,就先收藏观望。

同类里比较早的尝试是 awrit,作者在致谢里也提到了。terminal-browser 在输入处理、UI 和 agent 集成上走得更远。

项目信息