claude-usage-tracker：Windows 系统托盘里的 Claude 用量追踪工具

📋 What is this tool?

The claude-usage-tracker acts as a silent assistant for your daily work with Claude. It sits in your Windows system tray and watches your usage stats in the background. This tool shows you how much of your message limit remains, tracks your weekly spend, and provides a clear view of your current session context. You receive alerts when you approach your limit so you never face an unexpected interruption.

⚙️ System Requirements

This application works on any standard Windows computer. You need the following:

Windows 10 or Windows 11.
An active internet connection to sync your usage data.
Basic disk space for the installation files.
A recent version of the Claude web interface or API session.

🚀 How to set up the tracker

Visit the official releases page to access the latest installer.
Look for the file named claude-usage-tracker-setup.exe under the Assets section.
Click the file to start the download.
Open the downloaded file once the process finishes.
Follow the on-screen prompts to install the software on your machine.
Launch the program from your Desktop or the Start Menu.

🔍 Features

System Tray Widget: The icon stays in your taskbar. Hover over it to see your current usage levels.
Burn-rate Alerts: Get notifications before you hit your usage ceiling.
Session Context Tracking: Monitor how much context you consume within your current chat window.
Weekly Summaries: Open the dashboard to view your usage patterns over the last seven days.
Auto-Updates: The app checks for new versions and keeps your tracker current.

🛠 Using the dashboard

The dashboard provides a visual breakdown of your limits. Open it by clicking the system tray icon and selecting "Open Dashboard." The interface shows a progress bar for your hourly and weekly limits. If you see the bar turn yellow, you have used a significant portion of your quota. A red bar indicates you need to wait before sending more messages.

⚠️ Privacy and Security

Your data stays on your machine. The tracker does not store your passwords or session tokens in a readable format. It only reads the public usage stats provided by your account session. We do not sell or share your activity logs with third parties.

💡 Troubleshooting common issues

If the tracker does not show your usage, check these steps:

Ensure your internet connection is stable.
Restart the application from the system tray.
Confirm that you are logged into your Claude account in your primary web browser.
Reinstall the application if the dashboard fails to load.

❓ Frequently asked questions

Does this app slow down my computer? The tool uses very little memory. It stays idle until you request a data update.

Is this official software? No. This is an open-source project created by the community. It is not affiliated with Anthropic.

Where can I request new features? You can submit a request on the issues page of this repository.

Can I run this on a work computer? Most IT departments allow this tool as it does not require administrative privileges for basic operation. Consult your IT policy if you feel unsure.

📈 Understanding your limits

Claude imposes limits based on your plan. High levels of prompt complexity or long chat history consume your quota faster. This tracker helps you manage those spikes by showing your usage rate in real-time. Use the dashboard to plan your workflows around peak hours. Stay productive by monitoring your usage patterns and adjusting your interactions accordingly. The tool provides the visibility required to maintain your workflow without interruption.