# ccusage を Homebrew, Nix でインストール

ccusage のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:ccusage
```

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install ccusage
```

  証拠: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#ccusage
```

  証拠: nixpkgs package indexes: pkgs/by-name/cc/ccusage/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## パッケージ情報

- **パッケージキー:** brew:ccusage
- **パッケージマネージャ:** Homebrew
- **バージョン:** 20.0.19
- **ソース概要:** CLI tool for analyzing Claude Code usage from local JSONL files
- **ホームページ:** <https://github.com/ccusage/ccusage>
- **リポジトリ:** <https://github.com/ccusage/ccusage>
- **最終更新:** 2026-07-28T03:45:56Z
- **生成日時:** 2026-08-03T19:37:03+00:00

## 実行可能ファイル

- ccusage (エイリアス)

## インストール挙動

- Bottle: 利用不可

## バージョンと鮮度

- ページ生成日: 2026-08-03
- マネージャ版: 20.0.19
## プロジェクトの歴史と使われ方

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.

### ソース

- <https://api.github.com/repos/ryoppippi/ccusage>
- <https://github.com/ryoppippi/ccusage>
- <https://ccusage.com/guide>
- <https://formulae.brew.sh/api/formula/ccusage.json>


## セキュリティノート

ccusage に一致するローカルシークレット処理マニフェストは見つかりませんでした。将来の対応で安定したパッケージ URL を使えるよう、Nucleus パッケージメタデータはここに公開されています。



## 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

- Unix: .ccusage/ccusage.json, ~/.claude/ccusage.json, ~/.config/claude/ccusage.json
## 他のパッケージマネージャ記録

- Nix - ccusage: normalized package name match | nixpkgs package indexes: pkgs/by-name/cc/ccusage/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/ccusage.yml](https://github.com/mxcl/pkgdb/blob/main/combined/ccusage.yml)


## ソース

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
