AgentsView 是一款本地优先的 AI 编程代理会话分析工具，用 Go + SQLite 构建，支持 20+ 种代理（Claude Code/Codex/Copilot 等）。可追踪 Token 用量与成本，查询比 ccusage 快 200 倍，本地存储不泄露隐私。
🎤 引言
用 Claude Code、Codex、Copilot 这类 AI 编程代理写代码，时间长了总会面临一个问题：每个月 Token 账单怎么来的？ 用的是哪个模型？哪个项目花得最多？会话里都跑了多少消息？
ccusage 是 Claude Code 官方出的查询工具，但数据一多就跑不动，2 万条会话可能要等好几分钟。很多人只能靠感觉估算成本，实际上心里完全没底。
AgentsView 就是来解决这个问题的。它是一个本地优先的 AI 代理会话分析工具，支持 20+ 种编程代理（Claude Code、Codex、Copilot CLI、Cursor、Pi、OpenHands 等），可以追踪 Token 用量、计算成本、查看会话历史。最夸张的是，在 2.2 万条会话的数据库上，它的查询速度比 ccusage 快 80~220 倍。
GitHub 上 2.5k+ Stars、541 Commits，MIT 协议，技术栈用 Go + Vue.js + SQLite，本地优先，支持 PostgreSQL 作为可选的共享后端。免费、开源、自托管，数据完全在自己机器上。
⭐ 核心功能
1. 支持 20+ 种 AI 编程代理
AgentsView 支持的代理覆盖范围相当广：
- Claude Code（以及官方桌面版）
- Codex（OpenAI 编程代理）
- GitHub Copilot CLI
- Cursor
- Pi
- Gemini
- OpenHands
- Kiro
- OpenClaw
- Qwen Code
- Warp
- 以及更多...
每个代理的会话格式不一样，AgentsView 内置了解析器，读取各代理在本地留下的会话文件（JSONL 格式），统一转换成结构化数据。
2. Token 用量与成本追踪
最核心的功能是 Token 统计。AgentsView 通过 LiteLLM 的费率表自动计算成本，也可以离线手动指定费率。
# 查看每日用量
agentsview usage daily
# 按模型分类统计
agentsview usage daily --breakdown
# 按代理和日期过滤
agentsview usage daily --agent claude --since 2026-04-01
# JSON 格式输出（适合脚本/状态栏）
agentsview usage daily --all --json
agentsview usage statusline输出里包含：输入 Token、输出 Token、缓存创建 Token、缓存读取 Token、模型分布、成本估算——所有 ccusage 能给的，它都能给，而且快得多。
3. 查询速度快 200 倍
这是 AgentsView 最让人印象深刻的点。ccusage 在大数据库上慢是因为每次都要从头解析 JSONL 文件。AgentsView 把解析后的结构化数据存进 SQLite，建了全文搜索索引，同样的查询它直接读索引，不用每次重新解析。
官方 Benchmark：在 22,000 条会话的本地数据库上，agentsview usage daily 耗时 0.1~0.2 秒，而 npx ccusage@latest daily 耗时 8~20 秒，差距 80~220 倍。数据量越大差距越明显。
4. 会话浏览器与分析仪表盘
agentsview serve 启动一个本地 Web 应用，可以看到：
- 分析仪表盘：按日期、项目、代理分类的用量热力图和趋势图
- 会话列表：支持全文搜索、按代理/日期/状态过滤
- 会话查看器：点进去可以看到单次会话的完整消息历史
- 代理会话目录监控：代理在后台跑的时候，AgentsView 可以实时显示新会话，不需要刷新
界面用 Vue.js 写，风格简洁，数据本地存储，不会上传到任何地方。
5. 本地优先，数据完全自主
AgentsView 默认把所有数据存在本地 SQLite 数据库里（.agentsview.db），不依赖任何云服务。如果团队需要共享数据，可以配置 PostgreSQL 作为共享只读后端，但核心数据始终在本地。
这对在意数据隐私的开发者很重要——Claude Code 的会话里可能有公司内部代码片段，上传到第三方平台有合规风险，本地存储就完全没这个问题。
📥 安装与使用
安装（一条命令）
# 方式一：uvx（推荐，最快）
uvx agentsview serve
# 方式二：Homebrew（macOS/Linux）
brew install kenn-io/tap/agentsview
# 方式三：下载二进制
# https://github.com/kenn-io/agentsview/releases装完一条命令就能跑，不需要配置数据库，不需要登录账号。
Docker 部署（可选）
如果想跑在服务器上作为团队共享面板：
docker run -p 18789:18789 \
-v ~/.agentsview.db:/data/agentsview.db \
-v ~/.agentsview:/root/.agentsview \
agentsview/agentsview serve --http 0.0.0.0:18789配置代理会话目录
AgentsView 会自动发现常用代理的会话目录，首次运行时会扫描本机配置：
- Claude Code：
~/.claude/projects/（Linux/macOS） - Codex：
~/.claude/projects/或对应配置路径 - Copilot CLI：
~/.copilot/ - Cursor：
~/.cursor/projects/ - Pi：
~/.pi/agent/sessions/ - OpenClaw：
~/.openclaw/agents/
如果代理的会话目录不在默认位置，可以在配置文件中手动指定：
# 查看自动发现的配置
agentsview config --show
# 添加自定义代理路径
agentsview config --add-agent kiro --path ~/.kiro/sessions/查询 Token 用量
# 查看今日用量
agentsview usage daily
# 查看近一周，按模型分类
agentsview usage daily --since $(date -v-7d +%Y-%m-%d) --breakdown
# 按项目过滤
agentsview usage daily --project my-awesome-project
# 输出 JSON 给脚本用
agentsview usage daily --all --json > usage.json🎯 适用场景
经常用 Claude Code / Codex 的开发者
如果每天都在用 AI 编程代理写代码，AgentsView 是成本管理的最佳拍档。你会惊讶于某些项目会话数量爆炸式增长，而某些模型的实际用量和预期完全不同。统计数据出来之后，才能合理规划 API 预算。
技术团队 Leader
团队里多人用 AI 代理，Leader 想了解谁在用、用什么模型、花多少钱。AgentsView 的 PostgreSQL 共享后端模式，可以让整个团队的数据汇总到一个面板，不需要每人发截图汇报。
关注隐私的开发者
Claude Code 的会话里可能包含业务逻辑、数据库结构、甚至密钥片段。用第三方云服务统计成本，数据安全没保证。AgentsView 本地存储，数据不离开本机，合规团队也可以放心用。
🔍 对比同类工具
| 工具 | 支持代理数 | 速度 | 本地存储 | 成本计算 | Web UI |
|---|---|---|---|---|---|
| AgentsView | 20+ | 快 80-220 倍 | ✅ | ✅ LiteLLM 费率 | ✅ |
| ccusage | 仅 Claude Code | 慢 | ❌ | ✅ | ❌ |
| Usage.sh | 有限 | 中 | 部分 | ❌ | ❌ |
| 透明知识库方案 | 需自建 | 取决于实现 | ✅ | ❌ | 可定制 |
ccusage 是 Claude Code 官方出的工具，但功能单一、不支持多代理、速度慢。AgentsView 相当于 ccusage 的 Pro Max 版本，支持更多代理、查询更快、还有完整的 Web UI。
⚠️ 注意事项
会话目录需要先有数据
AgentsView 依赖代理已经写好的会话文件。如果代理是第一次跑，还没有生成会话文件，AgentsView 只会显示空数据。确认代理正常工作一段时间后再来看数据。
PostgreSQL 后端是"只读共享"
如果配置了 PostgreSQL 作为共享后端，数据是从本地 SQLite 同步过去的，PostgreSQL 端只能读取不能写入。团队成员可以在只读后端上查看共享数据，但写入和配置还是在本地的 SQLite 上。
部分代理的 Token 用量需要代理本身记录
AgentsView 能读取多少 Token 信息，取决于代理本身在会话文件里记录了多少内容。有些代理的会话格式比较简略，可能不包含完整的 token 使用明细，这种情况下成本估算会显示为"未知"，而不是精确数字。
首次扫描大数据库需要一些时间
如果本机上已经有几万条历史会话，首次解析和导入 SQLite 会需要几分钟。导入完成后，后续增量同步就很快了。可以在第一次运行时加 --quiet 参数跳过已处理的会话。
✅ 总结
AgentsView 是一个很小但很实用的工具。它解决的问题很具体：当你用 AI 编程代理用了一段时间，根本不知道每个月在每个模型上花了多少Token、哪些项目跑得最勤、哪个代理用得最多。
它的核心优势在于：支持 20+ 种代理、查询速度比 ccusage 快 200 倍、完全本地存储不泄露隐私。Go + SQLite 的技术栈让它跑起来极其轻量，uvx agentsview serve 一条命令就能启动，不需要任何运维配置。
对于经常用 Claude Code、Codex、Copilot CLI 这类编程代理的开发者来说，装一个 AgentsView 的成本几乎为零，但带来的透明度价值很高——花几分钟配置好，之后每个月都能清楚看到钱花在了哪里。
推荐指数：★★★★★（适合所有 AI 编程代理重度用户）