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

1. Open VS Code
2. Press Ctrl+P / Cmd+P to open the Quick Open dialog
3. Type ext install ahmedhamedaly.ccusage and press Enter
4. Click the Install button

From Extensions View

1. Open the Extensions view (Ctrl+Shift+X / Cmd+Shift+X)
2. Search for "ccusage"
3. 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.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• Report Issues
• Source Code

Acknowledgments

Built for the Claude Code community to help monitor AI assistant usage and costs.

Enjoy monitoring your Claude Code usage! 🚀