macOS
Homebrew已验证 · 100%
brew install ccusagelocal Homebrew formula metadata
安装
其他安装命令
Linux
Nix已验证 · 92%
nix profile install nixpkgs#ccusagenixpkgs package indexes · pkgs/by-name/cc/ccusage/package.nix · 来源: api.github.com
概览
软件包摘要
CLI tool for analyzing Claude Code usage from local JSONL files
项目链接
命令和别名
- ccusage
历史
项目历史与用法
ccusage is a local CLI for analyzing token usage and estimated costs from coding-agent CLIs. It began as Claude Code usage analysis and expanded into unified reports for Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Hermes Agent, pi-agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, and Gemini CLI.
项目历史
The official guide says the original cc stood for Claude Code usage and now also fits Codex CLI usage. GitHub metadata shows the repository was created in May 2025, and the package metadata describes ccusage as analyzing coding-agent CLI token usage and costs from local data.
The project has moved quickly: official releases show the v20 series in 2026, and the docs emphasize all-local, read-only analysis with JSON and table output.
采用历史
The official README highlights direct execution through npx, bunx, pnpm dlx, and Nix, plus a Homebrew package in the input facts. Its adoption is tied to the rise of agentic coding CLIs that store token and model usage locally.
使用方式
Users run commands such as ccusage daily, weekly, monthly, session, or source-focused commands like ccusage codex daily. Configuration can come from CLI flags, a custom config, environment variables, .ccusage/ccusage.json, ~/.config/claude/ccusage.json, or ~/.claude/ccusage.json.
为什么软件包爱好者会关心
ccusage is package-nerd significant as a fast-moving observability tool for local AI coding workflows. It turns scattered JSONL and state files from multiple CLIs into a packageable, scriptable cost and token accounting surface.
时间线
- 2025: Official GitHub repository created.
- 2026: v20 series releases published.
- 2026: Official docs describe unified reports across many coding-agent CLI data sources.
Related projects
- Claude Code and Codex are core data sources described in the official guide.
- The README also lists OpenCode, Amp, Droid, Codebuff, Hermes Agent, pi-agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, and Gemini CLI as supported sources.
来源
安全态势
尚未找到受保护工具覆盖
没有找到 ccusage 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。
安装行为
- 未记录 Homebrew bottle 元数据。
建议审查
在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
.ccusage/ccusage.json~/.claude/ccusage.json~/.config/claude/ccusage.json
可执行文件
已安装的可执行文件
| 命令 | 类型 | 暴露范围 | 备注 |
|---|---|---|---|
ccusage | 可执行文件 | 已索引可执行文件 | 从本地可执行文件索引发现。 |
新鲜度
版本和新鲜度
这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。
页面生成时间2026-08-03
管理器版本20.0.19
管理器更新时间2026-07-28
本地数据未知
上游不可用
检测到的最新版本未检测到
- OK没有生成新鲜度警告。
安装元数据
软件包元数据
| 软件包键 | brew:ccusage |
|---|---|
| 版本 | 20.0.19 |
| 软件包管理器 | Homebrew |
| 主页 | https://github.com/ccusage/ccusage |
| 仓库 | https://github.com/ccusage/ccusage |
| 最后更新 | 2026-07-28T03:45:56Z |
| Pulse | updated |
| Bottle | 未记录 |
| 服务 | 未声明 |
源数据库匹配
其他软件包管理器记录
匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。
Nix95%
ccusage
nix profile install nixpkgs#ccusage- normalized package name match
- 匹配方式：Ccusage
来源线索
由仓库数据生成
此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。
Combined YAML source
View the package source record on GitHub.
使用的来源
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation