Claude Code Usage

by Narlei Moreira · v1.0.6

Deck macOS Claude Code

Source code

About

Monitor your Claude Code subscription usage in real time. Shows the 5-hour rolling limit and the weekly limit (all models) directly on your Ulanzi Deck button, with color-coded thresholds and reset countdown. Credentials are read securely from the macOS Keychain — no API key required.

What’s new — v1.0.6

## What's new?

- **Multilingual support.** The property inspector now displays in your system language. Supported languages: English, 简体中文, 繁體中文, 日本語, 한국어, Deutsch, Français, Español, and Português (Brasil). Falls back to English for unsupported locales.

## 1.0.3

- **Fixed the Weekly Limit display during rate limiting.** When Claude returns a 429, only the metric that was actually rejected now shows the "stopped" state — the other key keeps showing its real utilization and reset countdown instead of going blank.

## Installation

**Requirements:** macOS, Ulanzi Studio 3.0.11+, and Claude Code CLI signed in (`claude auth login`).

1. Download `com.claude.usage.ulanziPlugin.zip` below
2. Unzip and move the folder into:
   ```
   ~/Library/Application Support/Ulanzi/UlanziDeck/Plugins/
   ```
3. Quit and reopen Ulanzi Studio
4. Drag **5-hour Limit** or **Weekly Limit** from the **Claude Code** category onto a key

That's it — the button updates every 5 minutes. Click it any time to force a refresh.