clauth 0.1.8

A simple Claude Code account switcher - swap OAuth and API profiles in an instant
clauth-0.1.8 is not a library.

Release crates.io

Claude OAuth: clauth

A simple and fast Claude Code account switcher; select a profile, hit enter, done! Supports OAuth Claude Pro/Max accounts and API endpoint profiles.

? clauth
  ● work        Claude Max 5x  5h [████████░░] 82% (2h 15m) · 7d [█░░░░░░░░░] 12% (1d 6h)
    personal    Claude Pro     5h [███░░░░░░░] 28% (4h 02m)
    api-dev     https://api.notanthropic.com · API key set
  + New profile
  + New from current profile
  ⇄ Fallback chain  2 profiles
    Quit

Claude Code stores session state in two places: ~/.claude/.credentials.json and the env block inside ~/.claude/settings.json (base URL and API key). Switching accounts means editing both by hand, every time.

clauth keeps snapshots of both files for each profile; on switch it swaps .credentials.json and updates only the API variables in the env block of .settings.json — everything else stays intact.

Features

  • One-key switching: select a profile, switch, done; or clauth <profile> to switch directly by profile name
  • Usage bars: live 5-hour utilization fetched from the Anthropic API and refreshed every 30s, color-coded by threshold, with the next reset time alongside the bar. Max accounts also get a 7-day bar when the terminal is wide enough; Pro accounts have no weekly window in the API response so only the 5h bar is shown
  • Plan detection: queries /api/oauth/profile to identify the real plan tier — Pro, Max 5x, Max 20x, Team, Enterprise, Free — instead of trusting the unreliable subscriptionType tag in the OAuth credentials
  • Detailed window stats: the per-profile submenu also shows the 7-day rolling window and any paid extra-usage spend
  • Auto-switch on exhaustion: opt profiles into an ordered fallback chain with per-profile thresholds; when the active profile crosses its 5h limit (95% by default), clauth automatically switches to the next chain member that still has headroom. clauth must be opened for this to work
  • Non-destructive: only touches the two API-related keys in settings.json; all other config is preserved

Install

Supported platforms:

  • Linux
  • macOS
  • Windows (Git Bash / MSYS2)

Via cargo (recommended):

cargo install clauth

Via install script (no Rust toolchain required):

curl -fsSL https://raw.githubusercontent.com/uwuclxdy/clauth/mommy/install.sh | bash

Pass --nocargo to force a binary download even when cargo is available:

curl -fsSL https://raw.githubusercontent.com/uwuclxdy/clauth/mommy/install.sh | bash -s -- --nocargo

Build from source:

git clone https://github.com/uwuclxdy/clauth
cd clauth
cargo build --release
# binary at ./target/release/clauth

Updates

Binary installs check for updates silently in the background each time clauth starts. The updated binary takes effect on the next run. No action needed.

Cargo installs: cargo install clauth to upgrade.

Quickstart

Capture your current Claude Code session as a profile:

clauth
# Select "+ New from current profile"
# Enter a name, e.g. "work"

Create a second profile while logged in to a different account, then switch between them:

clauth
# Select the profile → "Switch to this profile"

Or switch directly by name — no menu, no prompts:

clauth work
# switched to 'work'

The active profile is marked with ●. Usage bars refresh every 30 seconds and are cached locally so they stay visible even if the Anthropic API is rate-limited or offline. The 7-day bar is appended only when the terminal is wide enough to fit every row's full line.

Profile types

Claude Pro / Max / Team / Enterprise (OAuth) — leave base URL blank. clauth captures the OAuth token from your running session and restores it on switch. The actual plan tier (including Max 5x / Max 20x) is detected from the Anthropic API and shown in the list.

API endpoint — set a base URL and (optionally) an API key. Works with the official Anthropic API or any compatible proxy.

You can edit a profile's URL and key at any time without losing its stored credentials.

Kicking the 5-hour timer

The 5-hour usage window only starts after a real inference call — OAuth token refresh alone doesn't trigger it. To make a profile's timer show up at clauth startup, opt in per-profile by setting kick_timer = true in ~/.clauth/profiles/<name>/config.toml:

kick_timer = true

When enabled, clauth refreshes the OAuth token and sends a 1-token Haiku ping (~22 input + 1 output token, fractions of a cent) for that profile on startup if no window is currently running. Default is off.

Automatic account switching

Open the Fallback chain entry in the main menu to build an ordered list of profiles that clauth can hop between automatically when one runs out of 5-hour budget.

How it works:

  • Each chain member has its own switch threshold (5h utilization %). Default is 95%; edit it from the chain entry's submenu.
  • After each usage refresh — both at startup and every 30 seconds while the menu is open — clauth checks the active profile. If it's a chain member and its 5h utilization is at or above its threshold, clauth walks the chain (starting at the slot after the active profile, wrapping) and switches to the first member whose own threshold hasn't been crossed. The active ● marker shifts to the new profile in place.
  • A threshold of 100% marks that profile as a last-resort slot. clauth still prefers any chain member with real headroom; only when every other member is past its threshold does it fall back to a 100%-threshold profile, even if that profile is itself capped. Claude Code will surface its own "out of 5h limit" message after the switch lands.
  • If no chain member is available as a target, clauth stays put. If the active profile isn't in the chain, auto-switch is disabled.
  • Profiles outside the chain are never auto-switched away from or auto-switched to — that's opt-in per profile.

Configuration lives in ~/.clauth/profiles.toml (fallback_chain array, ordered) and per-profile config.toml (fallback_threshold). Both files are safe to edit by hand, but the menu is the easier path.

Storage layout

~/.clauth/
  profiles.toml          # profile order, active marker, fallback chain
  profiles/
    work/
      config.toml        # base_url, api_key, kick_timer, fallback_threshold, env
      credentials.json   # OAuth token snapshot
      usage_cache.json   # last known utilization + plan info
    personal/
      ...

Contributing

Bug reports and pull requests welcome. Run cargo fmt before submitting.

License

MIT