# 看清 AI 预算到底花在了哪里

Specivo 告诉你团队里每个人在 AI 上花了多少钱，花在了哪个项目、哪个功能、哪个工作项上。从公司总额出发，一路下钻到单个智能体会话。

- 自动从 Claude Code、Codex、Gemini CLI 和 OpenCode 采集
- 每个会话都关联到它所处理的工作项
- 部署在你自己的服务器上，离开笔记本的只有用量数字

## 问题所在

你的团队每天都在用 Claude Code、Codex、Cursor 等 AI 工具，有的走个人订阅，有的用公司席位，有的用 API 密钥。账单来自不同渠道，没有一张能说清钱是谁花的、花在了哪个功能上。

- **团队里谁在 AI 上花得最多**？按人查看花费，以及每个人用了哪些工具、这些用量由什么方式付费。
- **这个功能在 AI 上花了多少**？每条用量记录都归到智能体当时处理的工作项上，因此每个功能、缺陷或任务都带有自己的 AI 成本。
- **账单主要是哪个工具或模型产生的**？把同一笔花费按工具、模型、提供商或成本类型分组，点开任意一行就能看到背后的明细。

## 从公司到会话

先打开项目，再到人员，再到功能，最后是背后的会话：日期、工具、模型、token 数和花费。在任何一层都可以切换分组方式。

页面上以一家虚构公司 ACME Waste & Recycling 近三个月的数据为例，提供了一份交互式演示报表。

- 报表：覆盖整个公司的管理报表、每个项目的花费报表、每个项目的 AI 用量标签页、每个工作项上的 AI 用量，以及每个人的“我的 AI 用量”。
- 按人员、项目、工作项、工具、模型、提供商、成本类型或 git 分支分组，并可增加第二级“再按”分组。
- 按人员、工具、模型、成本类型和日期筛选，每一行都可以链接到背后的明细记录。
- 每条记录显示日期、人员、工具、模型、token 数、成本类型、花费、项目、工作项和分支。

## 按功能计成本

每条用量记录都归到智能体当时处理的工作项（功能、缺陷或任务）上。Specivo 依据以下线索自动判断：

1. 智能体自己对 Specivo 的工具调用
2. 环境变量 `SPECIVO_ISSUE`
3. 提交记录
4. 分支名称
5. 代码仓库

在多个任务之间切换的长会话，会按工作项拆分。在工作项创建之前做的调研，同样计入该工作项。手动移动过的记录绝不会被覆盖。没有对应工作项的用量会归到项目上或标为未分配，之后可以手动归属。

## 这个功能花了多少？打开工作项就知道。

每个工作项都有 AI 用量标签页。它汇总这个功能背后的所有智能体会话（包括子工作项）：支出、API 等值、Token 数、参与的人、他们用的工具和模型，以及费用每周如何累积。支出可按人、按工具、按模型查看；背后的每一次会话分页列出；你只会看到项目角色允许你看到的内容。

## 每个人，每种工具

查看每个人在 AI 上花了多少、用了哪些工具，以及用量由什么方式付费：个人订阅、公司席位，还是按量计费的 API 密钥。

- 每个人都能在“我的 AI 用量”页面查看自己的用量。
- 项目角色决定每个人能看到哪些 AI 用量。
- 个人订阅费用只对有权限的人可见。

## 工作原理

1. **安装上报工具**。`ai-usage` 是一个开源命令行工具（MIT 许可，Python 编写），支持 Windows、macOS 和 Linux。它读取 Claude Code、Codex、Gemini CLI 和 OpenCode 的本地日志。
2. **照常工作**。它的钩子会在智能体每轮对话结束后上报用量。没有人需要手动记录。
3. **打开报表**。公司、项目、工作项和个人视图，细到每一条记录。

```bash
ai-usage init
ai-usage hooks install --tool all
```

## 报表

- 花费随时间的变化，按人员、工具、模型或项目堆叠，自动按日、周或月汇总
- token 随时间的变化：输入与输出，以及缓存
- 按人员、项目、模型和工具的分项统计
- 同一份数据可导出 CSV，也可通过 REST API 和 MCP 读取

## 所有成本类型

花费包括按量计费的 API 费用，加上每个订阅的费用，后者按该订阅覆盖的用量分摊。成本类型：订阅、API（按量计费）、本地、免费。

- **个人订阅**：为 Claude Pro 和 Max、ChatGPT Plus 和 Pro、Cursor Pro、GitHub Copilot、Google AI Pro 和 Ultra 以及 SuperGrok 提供预设。
- **团队席位与自定义套餐**：团队席位等企业套餐，以及任意自定义套餐。支持任意货币，并可设置汇率。
- **模型价格**：内置 300 多个模型的价格表，并保留历史价格。管理员可以覆盖任何价格。没有价格的用量会被标记出来，绝不会被悄悄算作零。

花费旁边还有两个额外指标：API 等值，即同样的 token 按按量计费价格折算的金额（是估算值，不是账单）；以及杠杆率，即 API 等值除以套餐费用。

## 隐私与私有化部署

上报工具只把用量数字（每个模型、每个会话和每天的 token 数）发送到你自己的 Specivo 服务器。它绝不会发送提示词、代码或文件内容。上报工具是开源的（MIT 许可），其 API 密钥存放在操作系统的钥匙串中。Specivo 运行在你的服务器上，离线部署也不例外。

### 每一部分都是开源的

任何人都能看到采集了什么、发送了什么、发到了哪里：

- [Specivo 服务端](https://github.com/specivo/specivo)（AGPL-3.0）：在你自己的服务器上存储用量并生成报表。
- [ai-usage 上报工具](https://github.com/specivo/ai-usage-reporter)（MIT）：准确了解它采集了什么、发送了什么。随附的接收契约定义了所发送内容的 JSON 格式。
- [智能体技能](https://github.com/specivo/specivo-agent-skills)（MIT）：让 Claude Code、Codex 和 Cursor 自行上报用量。

## 为智能体而生

借助 Specivo 的 MCP 服务器和面向 Claude Code、Codex、Cursor 的智能体技能，智能体可以自行上报用量。在 `CLAUDE.md` 或 `AGENTS.md` 里加一行即可开启。你还可以让智能体根据账单帮你登记订阅。

## 开始使用

- [查看在线演示](https://specivo.io/zh-cn/live-demo/)
- [15 分钟完成私有化部署](https://specivo.io/zh-cn/self-host-specivo-docker/)