Superbased Observer

本地服务

superbased.app开发工具512 周前更新

文档代码仓库访问官网

关于 Superbased Observer

Superbased Observer 从本地会话日志跟踪 AI 编码 Agent 的成本与令牌用量，并可通过代理记录服务商报告的数据。它面向需要监控用量和预算的开发者，仪表板、命令行及可选 MCP 查询均在本机运行。

主要功能

01按 Agent、模型、会话和项目拆分成本
02可选代理测量令牌与缓存用量
03本地仪表板、监视器和命令行
04用量限额、成本预测与浪费检测
05护栏与跨 Agent 会话交接

适用场景

01比较不同项目的编码 Agent 开支
02查看缓存用量和即将触及的成本限额
03让 Agent 通过 MCP 查询过往会话

MCP 相关

可选的 MCP 服务允许 Agent 查询本地用量历史和跨工具会话上下文。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Obs，SuperBased 的吉祥物：一个小机器人，脸上是终端提示符，还披着斗篷

追踪每个 AI 编码 Agent 的费用，提前发现额度即将用尽。

查看 Claude Code、Codex、Cursor 及另外 37 款 AI 编码工具的费用，按会话和模型细分，
数据来自服务提供商实际计费的 Token。免费、采用 Apache-2.0 许可，并在你的机器上运行。

快速开始 · 文档 · 对比 · 更新日志 · 网站

SuperBased 控制面板中的会话详情：总费用、下一条消息的低、中、高费用估算、5 小时和每周额度，以及切换到更便宜模型的费用

一条命令即可试用

npx @superbased/observer

无需安装、配置或联网。它会读取编码 Agent 已保存在磁盘上的会话日志，按工具和模型列出过去 30 天的费用表，并在退出时删除临时数据库。

为什么选择 SuperBased

一个本地二进制文件，同时跟踪 Claude Code 的 token 用量、Codex 费用和 Cursor 支出，并助你加以控制。

精确匹配提供商的费用，而非估算。 可选的本地代理会记录提供商返回的 token：净输入、5 分钟与 1 小时缓存写入、推理 token，以及长上下文重新定价。仅记录日志的跟踪工具只能估算这些数据。
在一个地方查看所有编码 Agent。 40 个适配器会将 Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、Cline、Aider、Kiro、Devin、OpenCode、Junie 等工具的数据统一整理到一个本地数据库中。
本地优先，无需账户。 不收集遥测数据，也无需登录。监视器、仪表板、MCP 服务和命令行都不会代你发出外部请求；所有数据都存放在 ~/.observer/ 下的一个 SQLite 文件中。
提前了解下一笔账单。 跟踪提示词缓存并在缓存过期时发出提醒，预估下一条消息的低 / 中 / 高费用区间，并为通过代理的会话提供 5 小时和每周限额仪表。
为你自己的 Agent 设置防护措施。 防护工具会根据内置规则（破坏性命令、机密数据外传、MCP 固定、预算）和你自定义的规则检查每项 Agent 操作。它默认以观察模式运行；启用强制执行前，可通过 observer guard simulate 重放历史记录。
随时随地将你的 Agent 用作终端。 从仪表板启动 Agent CLI，使用真实终端；通过配对设备从你的 Tailscale tailnet 加入正在运行的会话；还可将会话从一个工具交接给另一个工具。

SuperBased 仪表板概览页：30 天支出、会话、操作和精确匹配代理记录的 API 轮次、缓存效率、按计费类别统计的费用趋势，以及按编码工具统计的操作趋势

对比一览

	SuperBased	ccusage	CodeBurn	Langfuse	Helicone	LiteLLM
专为	编码 Agent 的费用与控制	CC/Codex 费用计量	本地 CC 支出与预算工具包	大模型应用可观测性	大模型应用可观测性与网关	AI 网关
覆盖的编码工具	40 个适配器	Claude Code、Codex，以及配套包	根据其文档，为 31–36 个	每个应用分别插桩	每个应用分别插桩	任何经其路由的工具
提供商报告的 token（非估算值）	✓ 通过本地代理	部分支持（来自日志）	部分支持（来自日志）	✓（SDK）	✓（代理）	✓（代理）
区分 5 分钟与 1 小时缓存写入	✓	✗	✗	✗	✗	✗
计入推理与长上下文附加费用	✓	部分支持	部分支持	部分支持	部分支持	部分支持
完全本地运行，无需云服务	✓	✓	✓（可选的团队同步预览版）	自托管一套服务	自托管或 SaaS	自托管
Agent 可查询的历史记录记忆（MCP）	✓	✓（用量 MCP）	✓	✓（追踪 MCP）	✗	✗
跨工具交接会话	✓	✗	✗	✗	✗	✗
许可证	Apache-2.0	MIT	MIT	MIT（核心部分）	Apache-2.0	MIT

以上信息根据各项目的公开代码仓库核对（2026 年 7 月）。这些工具都各有所长，适用于其设计用途；完整对比介绍了更多工具，并说明了如何选择。

安装

渠道	命令
npm	`npm install -g @superbased/observer`
PyPI	`uv tool install superbased-observer`（或 `pipx install` / `pip install`）
VS Code	`code --install-extension superbased.superbased-observer`（Cursor、VSCodium 和 Windsurf：Open VSX）
安装程序	`curl -fsSLO https://github.com/superbasedapp/observer/releases/latest/download/install.sh && sh install.sh`

每个渠道都提供相同的预构建纯 Go 二进制文件，支持 Linux（x64、arm64）、macOS（Intel、Apple Silicon）和 Windows x64。安装程序（Windows：install.ps1）还提供更小的版本（minimal、developer、managed），会根据 SHA256SUMS 及其 Ed25519 签名校验每个压缩包，从不运行 sudo，并支持通过 --from-dir 离线安装。运行 sh install.sh --help 查看所有选项。

开始使用

observer start    # proxy + watcher + dashboard; opens http://localhost:8081
observer scan     # backfill history from the session logs already on disk

通过代理路由 Agent，以获取与提供商完全一致的令牌。在仪表板中打开 Compression，点击工具的状态标签，然后选择 通过 observer 代理路由：它会预览确切的配置变更，并仅在你确认后写入。一次性替代方案： observer claude / observer codex，或 ANTHROPIC_BASE_URL=http://localhost:8820。
照常使用 Agent。 几分钟内即可看到会话、费用和缓存数据。
可选： observer init 还会注册 MCP 服务，让 Agent 能查询自身历史记录（它会在每轮对话中添加工具架构，因此默认不启用）。

observer doctor 会检查安装情况；observer status 会显示已捕获的内容。

终端页面：Claude Code、Codex、Antigravity CLI 和 Copilot CLI 作为实时终端并排运行于同一个仪表板中

## 你将获得

仪表板（localhost:8081）：概览、实时、会话、费用、方案与限额、缓存、安全、设置等；可按工具和项目筛选，也适合在手机上查看。
可核对的费用：按会话、模型、项目和工具统计，区分缓存读取与写入，并可深入查看会话中的每次 API 调用。
跨工具记忆：可选的 MCP 服务，让 Agent 能查询同一代码库中其他 Agent 已读取、运行或弄坏的内容；还支持使用 observer <tool> --continue-from <session> 进行交接。
浪费检测：检测过时的重复读取、重复命令，以及多个 Agent 争用的文件。
终端：由守护进程管理的 PTY 终端，支持多人加入、实时费用驾驶舱，并可在重启后原生恢复。
你的编辑器和 Shell：VS Code 扩展（状态栏、侧边栏、仪表板标签页）、一行命令 observer statusline，以及可完成所有操作的 CLI（observer usage、cost、predict、tail）。

会话页面：每个编码 Agent 会话占一行，显示工具、模型、开始时间、已用时间、操作和费用，以及标签总计

_{会话：所有 Agent 的每个会话，以及费用和标签。}

缓存页面：实时提示词缓存及其过期倒计时、缓存比率、读取和写入次数，以及提供商覆盖情况

_{缓存：查看哪些提示词缓存处于预热状态，以及何时会失效。}

支持的 Agent 包括 Claude Code、Codex、Cursor、Copilot 和 Copilot CLI、Gemini CLI、Cline 和 Cline CLI、Antigravity、OpenCode、OpenClaw、Pi、Hermes、Kilo Code、Qwen Code、Kiro CLI、Kiro Crew、Crush、Kimi Code、Grok、Devin、Aider、Qoder、goose、droid、Open Interpreter、Command Code、Junie、Poolside、Zed、Mistral Code、Muse、Prime Agent、DeepSeek、zcode、Freebuff、Cowork 和 Grok Bot；还可通过可选的浏览器扩展支持网页版 ChatGPT、Claude、Gemini、Copilot 和 Perplexity。各工具的设置说明：superbased.app/docs/track。

会话详情

点击任意会话即可打开其详情视图。以下是其中的四个标签页：

_{概览：费用、按计费层级划分的令牌，以及所用模型。}	_{消息：每条消息及其模型、工具调用和费用。}
_{费用与限额：下一条消息的费用，以及剩余限额。}	_{缓存：会话的实时缓存、命中、写入和重写情况。}

隐私

SuperBased 不发送遥测数据，也不需要账号。它会存储路径、命令和简短摘录，在写入任何内容之前清除机密信息，并默认将代理和仪表板绑定到 127.0.0.1。代理会将你自己的请求原样转发给你已在使用的提供商。使用 observer uninstall --all --purge 即可删除所有内容。详情请见：PRIVACY.md。

文档

快速入门和安装选项
连接你的 Agent和按工具跟踪成本
指南：仪表板、 Token 和成本跟踪、缓存跟踪、成本预测器、终端、安全防护、 MCP 服务
参考：命令行、配置、测量诚实性

面向组织

在整个工程组织中运行编码 Agent？SuperBased 还提供跨开发者、预算和策略的集中可见性，以及 SSO 登录。请参阅面向组织的 SuperBased，或发送邮件至 [email protected]。

社区

问题请前往 Discussions，错误报告和适配器请求请前往 Issues，安全问题请通过 SECURITY.md 报告。欢迎提交拉取请求：请参阅 CONTRIBUTING.md （构建需要 Go 1.26+，不使用 CGO）。如果 SuperBased 帮你避免了意外账单，点个星标能让更多人发现它。