Claudex
reedchan7/claudex
Visualize seu uso de quota do Claude e OpenAI Codex em um comando
Ver no GitHubExtensão poderosa para o Claude Code CLI que oferece visualização instantânea de uso de quota e planos. Exibe budgets de sessão, limites semanais e créditos em barras de progresso coloridas, eliminando a necessidade de consultar interfaces web.
Instalação
npx convez-ai reedchan7/claudex1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Monitorar consumo de tokens em sessões de Claude Code
- Verificar limites semanais e status de créditos rapidamente
- Gerenciar múltiplos planos (Claude + OpenAI Codex) na CLI
- Otimizar workflows evitando excesso de quota
Veredito

Ferramenta útil para power-users do Claude Code, mas depende de endpoints não-documentados que podem mudar sem aviso. Use com cautela considerando as limitações de estabilidade mencionadas no aviso de risco.
README
A tradução para o português deste README ainda está na fila.
claudex
Supercharge the Claude Code CLI.
claudex is a power-user companion for the claude command line — a growing toolkit of extra commands that make your Claude Code workflow faster, slicker, and more fun. Think of it as the "missing extras" pack for Claude Code.
Two commands set the tone:
claudex usage— see your entire Claude plan budget at a glance: current session, weekly limits, Sonnet-only, and usage credits, all rendered as crisp colored bars in a single command.claudex codex usage— the same treatment for your OpenAI Codex / ChatGPT plan: subscription tier, 5-hour session window, weekly window, and any per-model limits.
No interactive session, no digging through a web app — just run the command and you're done. More commands are on the way.
[!WARNING] Unofficial & unaffiliated. claudex is a personal, non-commercial project. It is not affiliated with, endorsed by, or supported by Anthropic or OpenAI. It works by reusing the OAuth tokens that Claude Code and the Codex CLI already store locally, and calling undocumented endpoints (
api.anthropic.comandchatgpt.com) with the matchingUser-Agent. Those endpoints may change or disappear without notice, and this usage may be against the providers' Terms of Service. Use it at your own risk. No warranty — see LICENSE.
Example
claudex usage --all shows everything at once — run claudex usage or claudex codex usage on its own to see just that provider.
Reset times are shown in your local timezone. Add --show-timezone when you also want the timezone name in the output.
$ claudex usage --all
Claude Code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Current session
█████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 34% used
Resets 2:30pm, 2h 30m left
Current week (all models)
███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 6% used
Resets May 30 at 3am, 4d 11h left
Current week (Sonnet only)
██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3% used
Resets May 30 at 3am, 4d 11h left
Usage credits off
Codex
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Subscription: Pro
Current session (5h)
██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 4% used
Resets 6:19pm, 4h 35m left
Current week
█████████████████████████████░░░░░░░░░░░░░░░░░░░░░ 58% used
Resets May 31 at 2:55pm, 1d 1h left
GPT-5.3-Codex-Spark — Current session (5h)
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% used
Resets 6:44pm, 5h left
GPT-5.3-Codex-Spark — Current week
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% used
Resets Jun 6 at 1:44pm, 7d left
Progress bars are colored by utilization: green below 50%, yellow from 50–80%, red at 80% and above.
How it works
claudex reuses the credentials these CLIs already store on your machine — no extra login or API key required.
claudex usage (Claude)
It resolves the OAuth access token from the first available source:
- The
CLAUDE_CODE_OAUTH_TOKENenvironment variable, if set. - On macOS, the Keychain entry
Claude Code-credentials. - The credentials file at
$CLAUDE_CONFIG_DIR/.credentials.json(default~/.claude/.credentials.json).
It then detects your installed claude version (via claude --version) to send a matching User-Agent, calls GET https://api.anthropic.com/api/oauth/usage, and renders the response. If you can run claude, you can run claudex usage.
claudex codex usage (Codex / ChatGPT)
It reads the access token from ~/.codex/auth.json (written when you sign in with the Codex CLI — run codex), sends a codex-cli User-Agent plus your ChatGPT-Account-Id, calls GET https://chatgpt.com/backend-api/wham/usage, and renders the response. If you can run codex, you can run claudex codex usage.
Requirements
To run claudex (using a prebuilt binary), you only need:
- macOS or Linux (x86_64 or arm64). Windows is best-effort — no prebuilt binary; build from source.
- An authenticated Claude Code install for
claudex usage, and/or an authenticated Codex CLI install forclaudex codex usage, with an active subscription.
No Rust toolchain is required to run a prebuilt binary. Rust (edition 2024, so 1.85+) is only needed if you build from source.
Install
Install or upgrade (recommended)
Download the right prebuilt binary for your platform and install it — no Rust required:
curl -fsSL https://raw.githubusercontent.com/reedchan7/claudex/main/install.sh | sh
The same command also upgrades. Re-run it anytime: it detects an existing install, does nothing if you already have the latest version, and otherwise updates the binary you actually run, in place. Pass CLAUDEX_FORCE=1 to reinstall even when you're already up to date.
A fresh install lands in ~/.local/bin (override with CLAUDEX_INSTALL_DIR), creating the directory if needed. If that directory isn't on your PATH, the installer adds it to your shell profile (.zshrc / .bashrc / .bash_profile / fish config) automatically — restart your shell afterwards. Set CLAUDEX_NO_MODIFY_PATH=1 to manage PATH yourself.
Download manually
Grab the archive for your platform from the latest release, extract it, and put claudex on your PATH. Prebuilt targets:
| Platform | Asset |
|---|---|
| macOS (Apple Silicon) | claudex-<tag>-darwin-arm64.tar.gz |
| macOS (Intel) | claudex-<tag>-darwin-amd64.tar.gz |
| Linux (x86_64) | claudex-<tag>-linux-amd64.tar.gz |
| Linux (arm64) | claudex-<tag>-linux-arm64.tar.gz |
| Windows (x86_64) | claudex-<tag>-windows-amd64.zip |
Build from source
Requires the Rust toolchain:
cargo install --path .
# or
make install
This installs the claudex binary to ~/.cargo/bin.
Usage
claudex usage # show Claude plan usage limits
claudex codex usage # show Codex / ChatGPT plan usage limits
claudex usage --all # show Claude and Codex usage together
claudex usage --show-timezone # include the timezone name in reset times
claudex codex usage --show-timezone # include the timezone name for Codex usage
claudex --help # list available commands
claudex --version # print the version
If your Claude token lives somewhere non-standard (or you just want to be explicit), set it directly:
export CLAUDE_CODE_OAUTH_TOKEN="sk-ant-oat01-..."
claudex usage
Development
Common tasks are available through the Makefile:
| Command | Description |
|---|---|
make build | Build the debug binary |
make release | Build the optimized release binary |
make test | Run the test suite |
make fmt | Format the code with rustfmt |
make lint | Run clippy with warnings denied |
make check | Format check + lint + test (CI gate) |
make run | Run claudex usage |
make install | Install to ~/.cargo/bin |
make clean | Remove build artifacts |
License
MIT © Reed Chan