Claude Token Monitor - VS Code Extension

Latest Version: 1.0.0 ✨

Real-time monitoring of Claude AI token usage with automatic plan detection, live mode, and interactive multilingual dashboard.

🌟 Key Features

🌍 Complete Multilingual Support

• 11 Languages: Polish, English, German, French, Spanish, Italian, Portuguese, Russian, Chinese, Japanese, Korean
• 🔍 Smart Detection: Automatically detects your operating system language (Windows/Mac/Linux)
• ⚙️ Manual Override: Change language anytime in extension settings
• 🎯 Intelligent Fallback: Defaults to English when system language is not supported
• 🔄 Dynamic Switching: Change language without restarting VS Code

🚀 Advanced Monitoring

• 📊 Real-time Token Tracking: Live monitoring of Claude AI usage with automatic updates
• 🔥 Dynamic Burn Rate: Speed-test style real-time token consumption indicator
• 🎯 Smart Plan Detection: Automatically detects Claude Pro/Max plans from usage patterns
• ⏱️ Session Management: Track session duration and token limits
• 💰 Financial Tracking: Daily, weekly, and monthly cost analysis with data export

🖥️ Seamless Integration

• ⚡ One-Click Launch: Start Claude AI directly from VS Code with intelligent terminal selection
• 📱 Dedicated Sidebar: Custom activity bar icon and panel for easy access
• 🎨 Clean Interface: Professional dark theme UI with intuitive controls
• 🔧 Flexible Configuration: Customizable refresh rates, limits, and display options

🌐 Supported Languages

🚀 Quick Start

Installation from VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Claude Token Monitor"
4. Click Install

Command Line Installation

code --install-extension wilendar.claude-usage-monitor

📋 Prerequisites

1. Install ccusage globally:

   npm install -g ccusage
   

2. Claude Code Access: Ensure you're logged into Claude Code and have an active session

3. Verify Installation: Test that ccusage blocks --json works in your terminal

🎮 How to Use

1. Open Extension: Click the Claude Token Monitor icon in the Activity Bar (sidebar)
2. Start Monitoring: Click the "Start Claude" button to launch Claude AI
3. View Real-time Data: Monitor tokens, burn rate, costs, and session progress
4. Financial Analysis: Click "📊 Financial Details" for comprehensive usage statistics
5. Settings: Access configuration via the ⚙️ Settings button

💰 Financial Tracking

Smart Cost Analysis

• 📅 Daily Tracking: Detailed daily usage and costs
• 📊 Weekly Summaries: Aggregated weekly statistics with active day counting
• 📈 Monthly Reports: Complete monthly breakdowns by model usage
• 💾 Auto-Save: Financial data automatically saved to .claude-monitor/financial-data.json
• 📋 Export Ready: Data available in JSON format for external analysis

Supported Models

• Claude 3.5 Sonnet - Premium model with advanced capabilities
• Claude 3.5 Haiku - Fast, efficient model for quick tasks
• Claude 3 Opus - Most powerful model for complex reasoning
• And more - Automatic detection of new Claude models

⚙️ Configuration Options

Access all settings through the extension's settings panel:

Language Settings

• Auto-detect (default): Uses your operating system language
• Manual Selection: Choose from 11 supported languages
• Live Switching: Change language without restart

Monitoring Settings

• Global Refresh Rate: 0.5-60 seconds (default: 2s)
• Token Refresh Rate: 0.5-60 seconds (default: 2s)
• Time Refresh Rate: 1-60 seconds (default: 5s)
• Model Detection Rate: 5-300 seconds (default: 60s)

Advanced Options

• Token Limit Warnings: Set custom warning thresholds
• Live Monitoring Mode: Ultra-fast 0.5-10s refresh for intensive monitoring
• Manual Session Times: Override automatic session detection
• Terminal Integration: Automatic PowerShell/Command Prompt selection

🖥️ System Compatibility

⚠️ Testing Status

Currently tested and verified on:

• ✅ Windows 10/11 with Claude Code - Fully supported and tested
• ✅ PowerShell 7+ and Windows PowerShell 5.1 - Both supported
• ✅ Command Prompt - Fallback option available

Other platforms:

• 🔶 macOS - Not tested (MacBooks are expensive, coffee donations welcome! ☕💸)
• 🔶 Linux - Not tested yet, but should work with proper ccusage setup

If you test on macOS or Linux, please report your experience via GitHub issues!

🔍 Visual Indicators

Burn Rate Status

• 💤 Idle (0 tokens/minute) - Animated idle state
• 🐌 Low (< 50K tokens/min) - Single, double, or triple snail based on intensity
• ↗️ Moderate (200K-800K tokens/min) - Trending up arrows (1-3x based on rate)
• 🚀 High (800K-2M tokens/min) - Rocket emojis (1-3x based on consumption)
• ⚡ Very High (2M-4M tokens/min) - Lightning bolts (1-3x based on intensity)
• ♨️ Extreme (4M-8M tokens/min) - Hot springs emojis (1-3x based on rate)
• 🔥 Insane (8M+ tokens/min) - Fire emojis (1 per million tokens, max 10)

Session Status

• 🟢 Active: Claude session running and monitored
• 🟡 External: Claude detected but started outside the extension
• 🔴 Inactive: No active Claude session detected
• ⚠️ Error: Connection or monitoring issues

🛠️ Troubleshooting

Common Issues

❌ "ccusage command not found"

# Solution: Install ccusage globally
npm install -g ccusage

❌ Extension not detecting Claude sessions

• Ensure Claude Code is running and authenticated
• Verify ccusage blocks --json returns valid data in terminal
• Check that you have an active Claude conversation

❌ Terminal won't launch Claude

• Extension automatically tries PowerShell 7+ then falls back to Windows PowerShell 5.1
• Ensure PowerShell is installed and accessible in your system PATH
• Check VS Code terminal permissions

❌ Language not switching

• Verify your system language is supported (see table above)
• Try manual language selection in extension settings
• Restart VS Code if auto-detection isn't working

🙏 Acknowledgments

Special thanks to the ccusage developers for creating the essential command-line tool that makes real-time Claude AI monitoring possible:

• ccusage npm package: https://www.npmjs.com/package/ccusage
• Without ccusage, this extension wouldn't exist!

This extension serves as a user-friendly VS Code interface for the powerful ccusage monitoring capabilities.

☕ Support Development

Enjoying Claude Token Monitor? Consider supporting continued development:

Every coffee helps with:

• 🚀 New feature development
• 🐛 Bug fixes and improvements
• 🌍 Additional language support
• 🖥️ Testing on macOS and Linux
• 📚 Better documentation

📄 License

MIT License © 2025 Kamil Wiliński

🎯 Professional Claude AI token monitoring for VS Code with complete multilingual support

Extension ID: wilendar.claude-usage-monitor
Marketplace: Install from VS Code Marketplace