Clauder

A VS Code extension that displays your Claude Code usage in the status bar. Monitor your 5-hour session and weekly limits at a glance.

Features

Status Bar Display

• Shows your current 5-hour session usage with time until reset
• Color-coded indicator that shifts from tan to red as usage increases
• Automatically shows weekly usage when approaching your weekly limit

Limit Detection

• Alerts you when you hit the 5-hour or weekly limit
• Automatically pauses polling and resumes when your limit resets

Detailed Tooltip

• Weekly usage for all models with reset day/time
• Weekly Sonnet-only usage (if applicable)
• Model breakdown with token counts and estimated costs

Requirements

• macOS (uses Keychain for OAuth credentials)
• Claude Code CLI installed and authenticated (claude command)

Installation

Install from the VS Code Marketplace or search for "Clauder" in VS Code Extensions.

How It Works

The extension reads your OAuth token from macOS Keychain (stored by Claude Code CLI) and fetches usage data from Anthropic's API.

Status bar examples:

61% | 2h 15m              Normal usage
61% | 2h 15m · W 92% | Sun 22   Weekly usage highlighted (>90%)
5h limit reached | 45m    Limit hit, shows time until reset

Hover for details:

Hover over the status bar item to see a breakdown of your weekly usage across all models, Sonnet-specific limits, and estimated costs.

Configuration

Commands

• Clauder: Refresh - Manually refresh usage data (or click the status bar)

Troubleshooting

"Not authenticated" message

Run claude in your terminal and complete the authentication flow. The extension reads credentials from the same Keychain entry used by Claude Code CLI.

Usage data not updating

Click the status bar item or run "Clauder: Refresh" from the Command Palette.

License

MIT