尧图网站建设 
零上传零遥测claude-usage本地用量统计工具的隐私保护与安全性设计全解析【免费下载链接】claude-usageA local dashboard for tracking your Claude Code token usage, costs, and session history. Pro and Max subscribers get a progress bar. This gives you the full picture.项目地址: https://gitcode.com/gh_mirrors/cl/claude-usageclaude-usage是一款专为 Claude Code 打造的本地用量统计工具它只读取你电脑上的本地日志零上传、零遥测即可生成 Token 用量图表、成本估算与会话历史并支持 Pro / Max 订阅进度条。本文带你完整拆解它的隐私保护与安全性设计看看数据不出本机是如何做到的。一、数据从哪来全部来自本地日志claude-usage 不接入任何云端 API它的数据源只有一个——Claude Code 在你本机写下的会话日志~/.claude/projects/**/*.jsonl → scanner.py 解析 → ~/.claude/usage.dbSQLite也就是说整条数据流100% 发生在你的机器内部。扫描器 scanner.py 只做两件事逐行解析 JSONL 记录中的 Token 数与模型信息然后写入本地 SQLite 数据库。数据库里存了什么打开 scanner.py 的建表语句可以看到sessions、turns、agents三张表只记录Token 计数、时间戳、模型名称、项目名等聚合统计字段不存储对话原文——你的代码内容和聊天记录始终留在原始日志里不会被二次搬运。二、零遥测没有后台连上报心跳都没有这是 claude-usage 最硬核的隐私设计之一零第三方依赖️整个工具只用 Python 标准库sqlite3、http.server、json、pathlib不需要pip install没有供应链依赖风险也不存在任何遥测 SDK。唯一的网络行为可被明确审计网页版仪表盘底部有一个检查更新链接它由浏览器直接请求公开发布 API 的元数据不携带任何用量数据、无需认证结果在本地缓存 24 小时且网络失败时静默处理——在 dashboard.py 中一目了然VS Code 扩展内置界面则完全不触发该检查。没有账户体系无需登录、不采集设备指纹、不收集崩溃日志。简单说这个工具没有任何代码路径会把你的用量数据发往互联网。三、默认只监听 localhost局域网也访问不到仪表盘本质是一个本地 Web 服务。看 dashboard.py 的serve()函数默认绑定地址是localhost:8080只有当用户主动传入--host 0.0.0.0或设置HOST环境变量时才会监听所有网卡。这意味着场景谁可以访问默认启动仅本机localhost明确指定0.0.0.0同局域网需用户主动配置安全姿态是默认安全暴露需显式选择符合最小暴露面原则。四、Docker 模式只读挂载 网络隔离如果你倾向用容器运行scripts/run-docker.sh 提供了教科书级的隔离配置~/.claude以只读ro方式挂载——容器能读日志但无法修改或删除你的原始数据容器运行在独立 Docker 网络中与宿主机其他容器隔离SQLite 数据库存放在独立的命名卷claude-usage-data里跨重启持久化又不污染你的家目录镜像本身也很干净Dockerfile 基于python:3.12-slim仅复制 3 个 Python 文件无多余服务。五、VS Code 扩展只走本机回环地址VS Code 扩展把同一套仪表盘嵌进侧边栏其实现同样保守面板以http://127.0.0.1:端口/的 iframe 形式加载只走本机回环。端口由 vscode-extension/src/port-allocator.ts 分配并稳定复用保证 UI 状态折叠区域等在刷新后不丢失。Python 源码直接打包进.vsix扩展侧没有任何远程数据通道。六、快速上手3 条命令开始git clone https://gitcode.com/gh_mirrors/cl/claude-usage cd claude-usage python3 cli.py dashboard浏览器打开http://localhost:8080即可看到完整的用量图表。其他常用命令见 README.mdscan增量扫描、today、week、stats。七、核心文件速查文件隐私/安全要点scanner.py只读解析本地 JSONL写入本地 SQLite不存储对话原文dashboard.py默认绑定localhost唯一网络行为是可选的更新检查cli.py终端命令入口全部本地计算Dockerfile scripts/run-docker.sh只读挂载 隔离网络 独立数据卷vscode-extension/src/仅127.0.0.1回环通信无远程数据通道tests/测试使用临时文件隔离数据库绝不触碰真实数据总结为什么说它零上传零遥测检查项结论数据是否离开本机❌ 全部在本机读取、存储、计算是否有遥测/上报❌ 无任何代码路径发送用量数据是否有第三方依赖❌ 纯 Python 标准库Web 服务是否暴露❌ 默认仅localhost原始日志是否被修改❌ 只读访问Docker 模式强制只读挂载对于在意隐私的开发者claude-usage 证明了透明的本地工具同样可以给出完整画面——Token 消耗、成本估算、会话历史、订阅进度一个都不少。【免费下载链接】claude-usageA local dashboard for tracking your Claude Code token usage, costs, and session history. Pro and Max subscribers get a progress bar. This gives you the full picture.项目地址: https://gitcode.com/gh_mirrors/cl/claude-usage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 零上传零遥测：claude-usage本地用量统计工具的隐私保护与安全性设计全解析
零上传零遥测claude-usage本地用量统计工具的隐私保护与安全性设计全解析【免费下载链接】claude-usageA local dashboard for tracking your Claude Code token usage, costs, and session history. Pro and Max subscribers get a progress bar. This gives you the full picture.项目地址: https://gitcode.com/gh_mirrors/cl/claude-usageclaude-usage是一款专为 Claude Code 打造的本地用量统计工具它只读取你电脑上的本地日志零上传、零遥测即可生成 Token 用量图表、成本估算与会话历史并支持 Pro / Max 订阅进度条。本文带你完整拆解它的隐私保护与安全性设计看看数据不出本机是如何做到的。一、数据从哪来全部来自本地日志claude-usage 不接入任何云端 API它的数据源只有一个——Claude Code 在你本机写下的会话日志~/.claude/projects/**/*.jsonl → scanner.py 解析 → ~/.claude/usage.dbSQLite也就是说整条数据流100% 发生在你的机器内部。扫描器 scanner.py 只做两件事逐行解析 JSONL 记录中的 Token 数与模型信息然后写入本地 SQLite 数据库。数据库里存了什么打开 scanner.py 的建表语句可以看到sessions、turns、agents三张表只记录Token 计数、时间戳、模型名称、项目名等聚合统计字段不存储对话原文——你的代码内容和聊天记录始终留在原始日志里不会被二次搬运。二、零遥测没有后台连上报心跳都没有这是 claude-usage 最硬核的隐私设计之一零第三方依赖️整个工具只用 Python 标准库sqlite3、http.server、json、pathlib不需要pip install没有供应链依赖风险也不存在任何遥测 SDK。唯一的网络行为可被明确审计网页版仪表盘底部有一个检查更新链接它由浏览器直接请求公开发布 API 的元数据不携带任何用量数据、无需认证结果在本地缓存 24 小时且网络失败时静默处理——在 dashboard.py 中一目了然VS Code 扩展内置界面则完全不触发该检查。没有账户体系无需登录、不采集设备指纹、不收集崩溃日志。简单说这个工具没有任何代码路径会把你的用量数据发往互联网。三、默认只监听 localhost局域网也访问不到仪表盘本质是一个本地 Web 服务。看 dashboard.py 的serve()函数默认绑定地址是localhost:8080只有当用户主动传入--host 0.0.0.0或设置HOST环境变量时才会监听所有网卡。这意味着场景谁可以访问默认启动仅本机localhost明确指定0.0.0.0同局域网需用户主动配置安全姿态是默认安全暴露需显式选择符合最小暴露面原则。四、Docker 模式只读挂载 网络隔离如果你倾向用容器运行scripts/run-docker.sh 提供了教科书级的隔离配置~/.claude以只读ro方式挂载——容器能读日志但无法修改或删除你的原始数据容器运行在独立 Docker 网络中与宿主机其他容器隔离SQLite 数据库存放在独立的命名卷claude-usage-data里跨重启持久化又不污染你的家目录镜像本身也很干净Dockerfile 基于python:3.12-slim仅复制 3 个 Python 文件无多余服务。五、VS Code 扩展只走本机回环地址VS Code 扩展把同一套仪表盘嵌进侧边栏其实现同样保守面板以http://127.0.0.1:端口/的 iframe 形式加载只走本机回环。端口由 vscode-extension/src/port-allocator.ts 分配并稳定复用保证 UI 状态折叠区域等在刷新后不丢失。Python 源码直接打包进.vsix扩展侧没有任何远程数据通道。六、快速上手3 条命令开始git clone https://gitcode.com/gh_mirrors/cl/claude-usage cd claude-usage python3 cli.py dashboard浏览器打开http://localhost:8080即可看到完整的用量图表。其他常用命令见 README.mdscan增量扫描、today、week、stats。七、核心文件速查文件隐私/安全要点scanner.py只读解析本地 JSONL写入本地 SQLite不存储对话原文dashboard.py默认绑定localhost唯一网络行为是可选的更新检查cli.py终端命令入口全部本地计算Dockerfile scripts/run-docker.sh只读挂载 隔离网络 独立数据卷vscode-extension/src/仅127.0.0.1回环通信无远程数据通道tests/测试使用临时文件隔离数据库绝不触碰真实数据总结为什么说它零上传零遥测检查项结论数据是否离开本机❌ 全部在本机读取、存储、计算是否有遥测/上报❌ 无任何代码路径发送用量数据是否有第三方依赖❌ 纯 Python 标准库Web 服务是否暴露❌ 默认仅localhost原始日志是否被修改❌ 只读访问Docker 模式强制只读挂载对于在意隐私的开发者claude-usage 证明了透明的本地工具同样可以给出完整画面——Token 消耗、成本估算、会话历史、订阅进度一个都不少。【免费下载链接】claude-usageA local dashboard for tracking your Claude Code token usage, costs, and session history. Pro and Max subscribers get a progress bar. This gives you the full picture.项目地址: https://gitcode.com/gh_mirrors/cl/claude-usage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考