隐私
一切都留在你的电脑里。
ccgauge 的设计原则简单粗暴：你的对话记录和 AI 花费跟我们没关系。一切都在本地运行， 关于你用量的任何信息都不会被传出去。仪表盘只有一个外网请求 —— 下载公开的模型价格表 —— 而且可以关掉。
只有一个外网请求，而且是下载
不跟 Anthropic。不跟 OpenAI。也不跟本站。仪表盘会拉取公开的 LiteLLM 价格表， 好让新发布的模型也能算对价格 —— 一个不携带任何你的信息的 GET。 设 CCGAUGE_OFFLINE=1 可关闭，回退到包内自带的价格快照。 CLI 报告和 MCP 服务则完全不发任何请求。默认绑 127.0.0.1。
零遥测
没有 analytics、没有错误上报、没有"匿名使用统计"。仪表盘不带跟踪像素，CLI 也不打电话回家。
无账号、无 API Key
不需要登录。ccgauge 不需要你的 API key —— token 数从 CLI 自己写的 JSONL 里读。
ccgauge 读什么
只读权限，全是你 CLI 早就写好的文件。ccgauge 不会编辑、删除它们，只解析。
| 读什么 | 读哪里 | 为什么 |
|---|---|---|
| Claude Code 的 JSONL 会话文件 | ~/.claude/projects/ | assistant tokens、模型、cwd、tool call、时间戳的来源。 |
| OpenAI Codex CLI 的 JSONL 会话文件 | ~/.codex/sessions/ | 同上，外加 Codex 累计 `token_count` 事件（ccgauge 会做正向 delta）。 |
| 可选的 config 目录覆盖 | $CCGAUGE_CONFIG_DIR | 指向其他根目录（比如从另一台机器拷过来的快照）。 |
ccgauge 写什么
所有写入都落在 ~/.ccgauge/。一个字节都不出本机。
| 写什么 | 写哪里 | 为什么 |
|---|---|---|
| 磁盘解析缓存 | ~/.ccgauge/cache/index-v2.json | 记忆已解析的 JSONL，让仪表盘启动更快。parserVersion bump 时会失效。 |
| MCP 独立缓存 | ~/.ccgauge/cache/index-mcp-v2.json | `ccgauge mcp` 单独用的索引文件，避免 MCP 进程和仪表盘抢同一份缓存。 |
| 后台服务状态 | ~/.ccgauge/state.json | 存 PID / port / log 路径，让 `ccgauge stop|restart|status` 能找到正在跑的实例。 |
| 后台服务日志 | ~/.ccgauge/ccgauge.log | 抓 detached server 的 stdout/stderr。用 `ccgauge logs -f` 跟。 |
可验证
不用相信我们的话。ccgauge 走 MIT 协议，源码在 GitHub。如果你机器有严格出网策略，两种自检方式：
- 断网跑。 把网线拔了 / 防火墙拒所有出站连接，再启 ccgauge。一切如常。
- 用 Little Snitch / pfSense / tcpdump 抓包。 ccgauge 进程整个生命周期里 node 的出站包数：精确的 0。
- 读源码。
打开
lib/data-loader/scan.ts和lib/providers/*看 ccgauge 解析了什么； 搜fetch(只能找到仪表盘自己 SSR 内部调用。
我们不做什么
- 把任何东西发给第三方服务器。
- 编辑或删除 CLI 的 JSONL 文件。
- 订阅 Anthropic / OpenAI 的 billing API —— 数字全部来自本地 JSONL × 内置单价表。
- 自动检查更新。你想升级时跑
npm i -g ccgauge@latest就行。
GitHub 上有完整源码
MIT 开源。每一行碰到你数据的代码都看得见。