隐私
一切都留在你的电脑里。
ccgauge 的设计原则简单粗暴：你的对话记录和 AI 花费跟我们没关系。仪表盘、CLI、MCP 服务全部本地运行， 运行时不发任何外网请求。
零外网调用
运行时不跟任何第三方服务通信。不跟 Anthropic。不跟 OpenAI。不跟 "ccgauge.dev"。 默认绑 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 开源。每一行碰到你数据的代码都看得见。