DEV Community

Tuğkan
Tuğkan

Posted on

Track Multiple Claude Code Accounts from One Menu Bar with ClaudeHub

#swift #claude #opensource

If you use multiple Claude Code subscriptions, you have probably asked this question:

Which account still has usage available?

I use multiple Claude Code accounts, each with its own five-hour and weekly usage limits. I wanted a simple way to check all of them without repeatedly switching accounts.

That is why I built ClaudeHub.

ClaudeHub is a free and open-source macOS menu bar app that displays usage information for multiple Claude Code subscription profiles in one place.

ClaudeHub menu bar

What does ClaudeHub show?

For each configured account, ClaudeHub can display:

  • Five-hour usage
  • Seven-day usage
  • Model-specific limits
  • Time remaining until each limit resets
  • Extra usage information when available
  • Last update time

Only the ClaudeHub icon appears in the menu bar. Clicking it opens a list of your accounts and their latest usage information.

Usage is refreshed automatically every five minutes. You can also update it manually using Refresh Now.

Keeping each account separate

Claude Code supports custom profile directories through the CLAUDE_CONFIG_DIR environment variable.

This makes it possible to keep each account in a separate directory:

CLAUDE_CONFIG_DIR="$HOME/.claude-accounts/account1" claude auth login
CLAUDE_CONFIG_DIR="$HOME/.claude-accounts/account2" claude auth login
CLAUDE_CONFIG_DIR="$HOME/.claude-accounts/account3" claude auth login
Enter fullscreen mode Exit fullscreen mode

Each command creates an isolated Claude Code profile and starts the browser login flow for that account.

Your normal Claude Code configuration remains unchanged:

~/.claude
Enter fullscreen mode Exit fullscreen mode

The additional accounts are stored separately:

~/.claude-accounts/account1
~/.claude-accounts/account2
~/.claude-accounts/account3
Enter fullscreen mode Exit fullscreen mode

Installation

Download the latest version from the releases page:

Download ClaudeHub

Then follow these steps:

  1. Open the downloaded .dmg file.
  2. Drag ClaudeHub into the Applications folder.
  3. Create an isolated Claude Code profile for each account from Terminal.
  4. Open ClaudeHub.
  5. Select Accounts > Add Existing Claude Profile...
  6. Choose one of the profile directories you created.
  7. Enter the label you want to see in the menu.
  8. Repeat the process for the remaining accounts.

ClaudeHub will then display all configured accounts in the same menu.

Keychain access

Claude Code stores authentication credentials in macOS Keychain.

When ClaudeHub accesses a profile for the first time, macOS may ask for your Mac password. Choose Always Allow if you do not want to approve the same access every time ClaudeHub starts.

Choosing Allow may grant access only for the current run. In that case, the password prompt can return when you reopen the app.

ClaudeHub does not write tokens to its configuration files or logs. Credentials are held in memory only while the app is running.

What happens when a token expires?

When a normal access token is about to expire, ClaudeHub uses the installed Claude Code CLI to renew the session.

This happens automatically:

  • It does not open a browser.
  • It does not invoke a Claude model.
  • It does not consume subscription usage.
  • It normally does not require another login.

A manual login is only required if the account was logged out, the refresh token was revoked or the session became invalid.

Run the login command again using the same profile directory:

CLAUDE_CONFIG_DIR="$HOME/.claude-accounts/account2" claude auth login
Enter fullscreen mode Exit fullscreen mode

After completing the login, quit and reopen ClaudeHub. You do not need to remove the profile from ClaudeHub or add it again.

What happens after restarting the Mac?

Your profiles and authentication sessions are not removed when the computer restarts.

ClaudeHub stores the account labels and profile directory paths locally. Claude Code keeps the authentication credentials in macOS Keychain.

After restarting the Mac, you only need to open ClaudeHub again. A new browser login is not normally required.

If you want ClaudeHub to launch automatically, add it under:

System Settings > General > Login Items
Enter fullscreen mode Exit fullscreen mode

Technical overview

ClaudeHub is a native macOS application built with:

  • Swift
  • AppKit
  • Swift Package Manager
  • macOS Security Framework
  • URLSession
  • GitHub Actions

The app currently supports Apple Silicon Macs running macOS 13 or newer.

Language support

ClaudeHub follows the macOS system language.

It currently includes:

  • English
  • Turkish
  • French
  • Spanish

If the current system language is not supported, ClaudeHub falls back to English.

The product name remains ClaudeHub in every language.

Privacy

ClaudeHub is designed to store as little information as possible.

  • It never modifies your normal ~/.claude configuration.
  • It does not write tokens to configuration files.
  • It does not include tokens in logs.
  • It does not collect telemetry.
  • It does not contain advertising or analytics SDKs.
  • It stores only the account label and profile directory path locally.
  • Usage requests are sent directly to Anthropic.

The project is open source, so its behavior can be reviewed directly in the source code.

Open source

You can inspect the source code, open an issue or contribute to the project:

github.com/tugkanboz/claude-hub

Top comments (0)