ccusage - Claude Code Usage Monitor

Monitor your daily Claude Code costs directly in VS Code's status bar. Stay informed about your AI assistant usage with real-time cost tracking and detailed breakdowns.
Features
- Real-time Cost Monitoring - See your daily Claude Code usage cost at a glance in the status bar
- Smart Color Coding - Visual warnings help you stay within budget:
- 🟢 Normal: Less than $50
- 🟡 Warning: $50-$100
- 🔴 Error: Over $100
- Detailed Breakdowns - Click for comprehensive token usage by model
- Auto-refresh - Updates every 60 seconds (configurable)
- Instant Updates - File watcher detects new usage immediately
- Multi-model Support - Tracks all Claude models (Sonnet, Haiku, Opus)
Screenshots
Daily cost display in VS Code status bar
Click for detailed token usage breakdown
Installation
From VS Code Marketplace
- Open VS Code
- Press
Ctrl+P
/ Cmd+P
to open the Quick Open dialog
- Type
ext install ahmedhamedaly.ccusage
and press Enter
- Click the Install button
From Extensions View
- Open the Extensions view (
Ctrl+Shift+X
/ Cmd+Shift+X
)
- Search for "ccusage"
- Click Install
Requirements
- Claude Code must be installed and have usage data in
~/.claude/projects/
- VS Code 1.74.0 or higher
Usage
Once installed, ccusage automatically:
- Displays today's cost in the status bar (bottom right)
- Updates every 60 seconds
- Watches for new usage data and updates immediately
Click on the cost display to see a detailed breakdown of:
- Total tokens used
- Cost per model
- Input/output token counts
Commands
Access these commands via Command Palette (Ctrl+Shift+P
/ Cmd+Shift+P
):
ccusage: Show Details
- Display detailed usage breakdown
ccusage: Refresh
- Manually refresh the cost display
Configuration
Configure ccusage in VS Code settings:
{
"ccusage.refreshInterval": 60 // Refresh interval in seconds (default: 60)
}
Privacy
ccusage only reads local usage data from your machine. No data is sent to external servers. All calculations are performed locally.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature
)
- Commit your changes (
git commit -m 'Add some AmazingFeature'
)
- Push to the branch (
git push origin feature/AmazingFeature
)
- Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
Acknowledgments
Built for the Claude Code community to help monitor AI assistant usage and costs.
Enjoy monitoring your Claude Code usage! 🚀