Essential toolkit for Claude Code CLI users - track usage, manage sessions, and optimize costs.
Features
Usage Tracking
Monitor your Claude Code usage in real-time from the VSCode status bar.
API Mode (pay-per-token billing):
- Token counts and estimated costs from local session files
- Toggle between session and today's usage
Subscription Mode (Pro/Max plans):
- Real-time usage limits from Anthropic's API (accurate across all devices)
- 5-hour and 7-day windows with exact reset times
- Optional "Today's Tokens" view for cost estimation
Multi-Account Pool
Manage multiple Claude subscription accounts and automatically switch when approaching limits.
- Monitor usage across all accounts
- Get prompted to switch at configurable threshold (default 90%)
- Auto-switch at 100% if alternative available
- Per-account usage cards in tooltip
Wake-up Scheduler
Pre-warm your 5-hour usage window before you start work (Subscription mode).
- Schedule daily wake-up times
- Multi-account support: wakes all accounts simultaneously via API
- Handles system sleep: catches up on missed wake-ups when Mac wakes
- Cost: ~$0.01 per account per wake-up (using Haiku)
Installation
- Search for "Claude Code Dev Tools" in VSCode Extensions
- Click Install
Prerequisites: Claude Code CLI installed and authenticated.
Quick Start
The extension adds a status bar item showing your current usage:
- API Mode:
$(database) 45.2K tokens or $(currency-dollar) $0.0234
- Subscription Mode:
$(clock) 2h 34m | 65% or $(database) 28.4K tokens
Click to cycle display modes. Hover for detailed breakdown.
Commands (Cmd+Shift+P)
| Command |
Description |
| Cycle Display Mode |
Toggle between tokens/cost or limits/tokens |
| Refresh Usage Data |
Manual refresh |
| Trigger Wake-up Now |
Immediately trigger wake-up for all accounts |
| Switch Claude Account |
Switch to a different account |
| Show Account Pool |
Display pool status |
Configuration
Key Settings
{
"claudeDevTools.authMode": "auto", // "auto", "api", or "subscription"
"claudeDevTools.accountPool.enabled": false, // Enable multi-account pool
"claudeDevTools.accountPool.threshold": 90, // Switch prompt threshold (%)
"claudeDevTools.wakeup.enabled": false, // Enable wake-up scheduler
"claudeDevTools.wakeup.times": ["06:00", "11:00", "16:00", "21:00"] // Wake-up times (HH:MM)
}
Multi-Account Setup
- Enable: Set
claudeDevTools.accountPool.enabled to true
- Log in to accounts using Claude Code CLI - the extension auto-detects new credentials
- Label each account when prompted
Note: Restart Claude Code CLI after switching accounts.
Wake-up Setup
- Enable: Set
claudeDevTools.wakeup.enabled to true
- Set your preferred times:
claudeDevTools.wakeup.times
- Keep VSCode running (can be in background)
The scheduler polls every minute and handles system sleep gracefully - when VSCode resumes, it detects missed executions and runs immediately.
macOS: Wake from Sleep
The extension catches up on missed wake-ups when your Mac wakes, but does not wake it from sleep. To wake your Mac automatically:
- Open Terminal
- Run:
sudo pmset repeat wake MTWRFSU 06:00:00
- Replace
06:00:00 with your wake-up time
MTWRFSU = every day (Mon-Sun)
- Enter your password when prompted
- Verify:
pmset -g sched
Managing wake schedules:
- List all:
pmset -g sched
- Remove all repeating:
sudo pmset repeat cancel
- Remove one-time by index:
sudo pmset schedule cancel wake 0
Alternative: System Settings → Battery → Options → Schedule → Set "Start up or wake"
Authentication Mode
The extension auto-detects your billing mode:
- VSCode setting (
claudeDevTools.authMode)
- Environment variables (
CLAUDE_CODE_USE_FOUNDRY or ANTHROPIC_API_KEY)
- OAuth credentials (subscription)
- API key
Tip: If launched from GUI (Dock/Finder), VSCode can't see terminal environment variables. Either launch from terminal (code .) or set authMode manually.
Troubleshooting
| Issue |
Solution |
| Status bar shows error |
Check Claude CLI is installed and authenticated |
| No active usage (Subscription) |
Re-authenticate with claude login |
| Account switch not working |
Restart Claude Code CLI (it caches credentials) |
| Wake-up not triggering |
Ensure VSCode is running; check Output panel for errors |
| Wake-up missed (Mac was asleep) |
Use sudo pmset repeat wake to wake Mac at scheduled time (see Wake-up Setup) |
| Mixed data between modes |
Set authMode explicitly; delete ~/.claude/.mode-session-tracking.json to reset |
License
MIT