Skip to content

integrations.md

Latest commit

 

History

History
92 lines (62 loc) · 2.46 KB

integrations.md

File metadata and controls

92 lines (62 loc) · 2.46 KB
Raw

客户端集成

默认本地网关

OpenAI Responses 基础地址: http://127.0.0.1:50124/v1
Anthropic Messages 基础地址: http://127.0.0.1:50124
API 密钥: sk-tabbit-local
模型名: tabbit/priority

开始前先启动本地网关：

tabbit2api start

如果你还没有 runtime profile，直接运行 tabbit2api 也可以，它会自动拉起登录并等待完成。

首次配置或登录异常时，建议先在官方 Tabbit 客户端确认网页聊天可用，然后关闭所有 Tabbit 窗口并刷新本地运行时 profile：

tabbit2api login --refresh

Codex 接入

示例文件：

Codex 使用 OpenAI Responses 兼容接口：

基础地址: http://127.0.0.1:50124/v1
API 密钥环境变量: TABBIT_API_KEY
模型名: tabbit/priority

Claude Code 接入

示例文件：

Claude Code 使用 Anthropic 风格接口：

基础地址: http://127.0.0.1:50124
API 密钥: sk-tabbit-local
模型名: tabbit/priority

注意：这里不要带 /v1。

OpenClaw 接入

OpenClaw 也走 Anthropic 风格接口，因此同样使用：

基础地址: http://127.0.0.1:50124

Hermes Agent 接入

Hermes Agent 使用 OpenAI Responses 兼容接口：

基础地址: http://127.0.0.1:50124/v1
API 模式: codex_responses
模型名: tabbit/priority

常见差异

  • Codex / Hermes Agent：通常用 /v1
  • Claude Code / OpenClaw：通常不用 /v1
  • 所有客户端都建议统一用 tabbit/priority

首次接入建议

  1. 运行 tabbit2api doctor
  2. 运行 tabbit2api start
  3. 访问 /health
  4. 再接客户端配置

常见错误

  • [492] 欢迎使用 Tabbit 浏览器...：通常是 Tabbit2API 的运行时 profile 没有有效登录态。关闭 Tabbit 后运行 tabbit2api login --refresh。
  • health ok 但客户端调用失败：/health 不会发起真实 Tabbit 消息请求，需要再用 POST /v1/responses 或客户端实际请求验证。
  • 可见只发了“你好”但仍失败：Codex / Claude Code 等客户端可能附带隐藏系统提示、工具说明和历史上下文，实际 prompt 会更长；错误消息中的 Prompt diagnostics 会显示发送给 Tabbit 的字符数。