README.md
May 31, 2026 · View on GitHub
AIUsage
One dashboard for all your AI subscriptions
Track quotas, costs, and accounts across 10+ AI providers.
Built-in Claude Code proxy for any OpenAI-compatible model.
中文说明 · English
Sponsored by
500+ AI models · Text, image, video & audio · Top models included · Pay-as-you-go
Table of Contents
Features
| Feature | Description |
|---|---|
| 10+ AI Providers | Codex, Copilot, Cursor, Antigravity, Kiro, Warp, Gemini CLI, Amp, Droid, Claude Code — one dashboard |
| Multi-account | Multiple accounts per provider, independent refresh, one-click CLI switching |
| Usage Stats | Unified cost & token breakdown across Local Logs (Claude Code / Codex sessions) and Proxy Logs — per-model trends, time-period analysis, source-aware "All Sources" aggregation |
| Claude Code Proxy | Use Claude Code with DeepSeek, GPT, Ollama or any OpenAI-compatible model; Anthropic passthrough for usage logging |
| CodeX Proxy | Point Codex CLI at any OpenAI-compatible upstream; unified switcher across subscription accounts and API nodes, surgical config.toml merge |
| Menu Bar | Multi-account status bar icons, quota/cost metrics, quick-glance popover, colored progress bars |
| Credential Vault | macOS Keychain storage for all managed credentials |
Preview
|
 |
| Dashboard | Provider & Multi-account Monitoring |
 |
 |
| Claude Code Proxy · Node Management | Claude Code Proxy · Configuration |
 |
 |
| CodeX Proxy · Nodes & Subscriptions | Usage Stats (Claude & Codex) |
 |
|
| Menu Bar | |
Install
Download .dmg or .zip from the Releases page.
Proxies
AIUsage ships two independent proxies — one for Claude Code, one for CodeX (Codex CLI) — each with node management, usage logging and a unified switcher.
Claude Code Proxy
Use Claude Code CLI with any OpenAI-compatible model, or transparently log Anthropic API usage.
| Mode | What it does |
|---|---|
| OpenAI Proxy | Translates Claude API → OpenAI format. Works with DeepSeek, GPT, Azure, Ollama, etc. |
| Anthropic Passthrough | Forwards requests as-is, logs input/output/cache tokens for cost tracking |
Quick start: Open AIUsage → Claude Code Proxy → New Node → Configure → Activate. Settings are written to ~/.claude/settings.json automatically.
CodeX Proxy
Point the Codex CLI at any OpenAI-compatible upstream (Responses API), and switch between subscription accounts and API nodes from one place — they are mutually exclusive, so only one identity is ever active.
| Capability | What it does |
|---|---|
| OpenAI-compatible upstream | Routes Codex CLI through any responses-compatible endpoint |
| Unified switcher | One toggle across subscription accounts (~/.codex/auth.json) and API nodes (config.toml) |
| Surgical config merge | Injects managed blocks into ~/.codex/config.toml while preserving your own settings; global fragment + per-node TOML override |
Quick start: Open AIUsage → CodeX Proxy → New Node (or pick a subscription account) → Configure → Activate. ~/.codex/config.toml is merged automatically.
Acknowledgements
Inspired by CodexBar and Quotio.
Sponsor
Sucloud — AI API aggregation platform with 500+ models.
Full modality coverage (text, image, video, audio) including Claude, GPT, Gemini and more.
RMB payment supported, no overseas card required.
Support the Author
If AIUsage helps you, consider buying the author a coffee. Your support helps keep the project maintained and improved.
