# Installer ccusage avec Homebrew, Nix

Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de ccusage pour les workflows d'agents IA.

## installation

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

Commandes d'installation supplémentaires:

### macOS

- Homebrew (100%):

```sh
brew install ccusage
```

  Preuve: local Homebrew formula metadata

### Linux

- Nix (92%):

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

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

## Faits du paquet

- **Clé du paquet:** brew:ccusage
- **Gestionnaire de paquets:** Homebrew
- **Page du gestionnaire de paquets:** <https://formulae.brew.sh/formula/ccusage>
- **Version:** 20.0.19
- **Résumé source:** CLI tool for analyzing Claude Code usage from local JSONL files
- **Page d'accueil:** <https://github.com/ccusage/ccusage>
- **Dépôt:** <https://github.com/ccusage/ccusage>
- **Licence:** MIT
- **Archive source:** <https://github.com/ccusage/ccusage/archive/refs/tags/v20.0.19.tar.gz>
- **Dernière mise à jour:** 2026-07-28T03:45:56Z
- **Généré:** 2026-08-04T22:13:35+00:00

## exécutables

- ccusage (cli)
- ccusage (alias)

## Dépendances de compilation

- rust

## Comportement d'installation

- hook post-installation: non défini
- Bouteille: disponible sur arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Version et fraîcheur

- page générée: 2026-08-04
- version du gestionnaire: 20.0.19
- gestionnaire mis à jour: 2026-07-28
- données locales: OK
- dépôt amont: https://github.com/ccusage/ccusage
- dernière version détectée: v20.0.19 (à jour)
## Historique du projet et usages

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.

### Historique du projet

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.

### Historique d'adoption

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.

### Modes d'utilisation

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.

### Pourquoi les passionnés de paquets s'y intéressent

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.

### Chronologie

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

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


## Notes de sécurité

Aucun manifest local de gestion des secrets correspondant n'a été trouvé pour ccusage. Les métadonnées de paquet restent publiées ici afin que la couverture future dispose d'une URL stable.



## 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
## Détails de la base source

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ccusage
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Autres enregistrements de gestionnaires de paquets

- 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


## Liens liés

- [Source-control packages](https://pkg.so/fr/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://pkg.so/fr/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://pkg.so/fr/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://pkg.so/fr/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [rust](https://pkg.so/fr/brew/rust/) - Build dependency declared by Homebrew.
- [gemini-cli](https://pkg.so/fr/brew/gemini-cli/) - Shares pkgdb curated category or tags: ai, cli, coding-agents, developer-tool.
- [kimi-cli](https://pkg.so/fr/brew/kimi-cli/) - Shares pkgdb curated category or tags: ai, cli, coding-agents, developer-tool.
- [codeburn](https://pkg.so/fr/brew/codeburn/) - Shares pkgdb curated category or tags: ai, cli, coding-agents, token-usage.
- [claude-code-router](https://pkg.so/fr/brew/claude-code-router/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [claude-cmd](https://pkg.so/fr/brew/claude-cmd/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [tweakcc](https://pkg.so/fr/brew/tweakcc/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [claudekit](https://pkg.so/fr/brew/claudekit/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [claude-code-templates](https://pkg.so/fr/brew/claude-code-templates/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [ccusage](https://pkg.so/fr/npm/ccusage/) - Same normalized package name appears in another local ecosystem. Shared terms: agents, ai, ccusage, cli, coding.
- [ccusage](https://pkg.so/fr/npm/ccusage/) - Same normalized package name in another local ecosystem.

## Combined YAML source

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


## Sources

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