Tabbit博客

Codex 接入 Tabbit CLI:安装与会话验证

安装 Codex 的 Tabbit 技能,检查本地浏览器连接,再验证新任务能否读取已有会话中的页面。

本文目录
  1. 安装技能并检查 CLI
  2. 读取一个页面并核对结果
  3. 模拟会话能否跨任务复用
  4. 按出问题的环节排查

先安装 Tabbit 的 Codex 技能,确认本地 tabbit-cli 连得上正确的 Tabbit 浏览器,再交给 Codex 一个只读任务。选择自己有权限访问的页面,并提前记下一项可核验的结果。在我们的 macOS 实验中,一个新的 Codex 任务成功读取了本地受保护报告中的三条模拟记录。会话由另一个 Tabbit 任务建立。

本文只覆盖接入和首次读取。选工具可看 Codex 浏览器与 Tabbit CLI 对比。需要沿用浏览器档案或细化授权时,可参考让智能体连接现有浏览器。

安装技能并检查 CLI

按 Tabbit CLI 官方快速入门安装并启动 Tabbit。启动 Codex,让 Tabbit 为检测到的客户端安装技能,然后重启 Codex。macOS 上可检查 ~/.agents/skills/tabbit/SKILL.md。技能提供操作指令,CLI 启动器负责发送浏览器请求,排查时要分别确认。

在新的 Codex 对话里打开 /skills 技能选择器,查看是否列出 tabbit。如果界面没有 /tabbit 快捷方式,可以在列表中选择,或明确要求 Codex 使用已安装的技能。我们另外用 Codex App Server 的 skills/list 强制刷新列表,找到了已启用的用户级 tabbit 技能。

在 macOS 终端运行以下命令。第二行直接使用本次测试的启动器路径,可以绕开终端 PATH 的影响。

codex --version
"$HOME/.local/bin/tabbit-cli" --version
"$HOME/.local/bin/tabbit-cli" diagnose

实测版本是 Codex CLI 0.166.0 和 Tabbit CLI 1.22.6.0,浏览器为 Tabbit Dev。诊断结果在本机查看即可,原始输出可能包含浏览器信息。启动器文件不存在时回到官方安装说明。文件能运行但连接失败时,先确认启动的是想用的 Tabbit 版本,再重新诊断。浏览器任务与普通标签页的关系可见 Tabbit AI 浏览器介绍。

读取一个页面并核对结果

选一个属于你或已获授权的页面,在预期的 Tabbit 浏览器档案中手动打开,记下标题或可见记录数。将准确网址附在提示词中。

使用已安装的 tabbit 技能,在新的任务标签页打开我提供的准确网址。
只返回页面标题和可见记录数。若要求登录,请说明并停下。
不要提交、下载或修改内容。

把返回结果和页面对照。诊断成功说明 CLI 能连到浏览器。标题或记录数正确,才证明任务读到了这次指定的内容。只搜网页无法核验受保护页面,可参考网页搜索与浏览器控制的区别。

模拟会话能否跨任务复用

我们在本机搭了一个报告页,内含三条模拟记录。第一次用 Tabbit 读取时服务器返回 HTTP 401。另一个任务访问测试地址,设置模拟的 HTTP-only 会话 Cookie。随后启动一个新的 codex exec --ephemeral,它运行一个范围受限的本地命令,在另一个 Tabbit 任务中读取报告。清除这个模拟 Cookie 后,我们再次测试。

本地报告显示模拟记录 RB-18、RB-29 和 RB-40
检查观察结果
建立会话前读取HTTP 401,零条记录
建立会话后新启 Codex 任务返回 RB-18、RB-29 和 RB-40,与页面一致
独立 Tabbit CLI 读取HTTP 200,显示相同三条记录
清除模拟会话后读取HTTP 401,零条记录

Codex 最终退出码为 0,答案与预期一致。整个实验未使用真实站点凭据,也没有改动报告数据。不同任务可以共用同一档案的模拟会话,给任务取名只是在区分工作流程。另一个实际流程可见 Tabbit 与 Codex 商品上架案例。

按出问题的环节排查

现象下一步
Codex 找不到技能新建对话,打开技能列表,检查安装路径。
终端找不到 tabbit-cli用绝对路径运行启动器,核对版本。
diagnose 失败确认想用的 Tabbit 浏览器正在运行且可以连接。
连接成功,目标页要求登录在同一档案里手动打开网址,需要时自行登录,再重试读取。
回答看起来正常,数量却不对核对网址、标题和实际渲染的记录。保留命令回执以便定位。

有 Codex 用户报告另一种浏览器接入可以选中已登录标签页,但读取 DOM 超时。Webcmd 作者也记录过一次操作看似成功、检查后才发现评论没有发布的经历。两个案例用的是各自的接入方式,都说明需要看最终页面结果。Codex 问题 #36278 · Webcmd 实操帖

浏览器命令超时时,先查回执和页面状态再重试。以后需要写入时,可在提交前确认准确的目标与内容,并在提交后验证结果。更多背景见什么是智能体浏览器与 Tabbit CLI 评测。若你的项目采用专用运行环境,可以单独参考 Codex 接入 Playwright MCP。从新机器开始,则从 Tabbit 下载页安装后,依次完成版本、连接和页面读取检查。

常见问题

如何让 Codex 使用 Tabbit CLI?

安装 Tabbit 浏览器并启动 Codex,重启后确认 tabbit 技能已出现,再检查 CLI 版本和连接,最后让 Codex 读取一个明确授权的页面。

/tabbit 是 Codex 内置命令吗?

它是 Tabbit 文档中的技能调用方式。如果界面没有该快捷方式,可在 Codex 的 /skills 列表里选择 tabbit,或明确要求使用已安装的 tabbit 技能。

新任务可以沿用登录状态吗?

我们验证了同一 Tabbit 浏览器档案中的不同任务可以共享一个模拟 HTTP-only 会话。切换档案或会话过期后,网站可能要求重新登录。

diagnose 成功,但页面打不开怎么办?

分别核对浏览器档案、目标网址和网站权限。先在相同档案中手动打开目标页,判断是否需要登录。

需要先装 Playwright MCP 吗?

这里走 Tabbit 的本地 CLI。Playwright MCP 是另一套浏览器连接方式,使用自己的浏览器和权限配置。

下一步

让 Tabbit 与你并肩工作。

跨标签页调研、自动化重复的浏览器工作,让每一处上下文都触手可及。