Skip to content
github-actions[bot] edited this page Aug 8, 2026 · 2 revisions

clauth wiki

Multi-account manager for Claude Code: switch accounts, watch 5h / 7d usage, auto-switch before a limit stops you.

The README is the tour. This wiki is the reference.

Pages

Page Answers
Install every install path, how updates get verified, shell completions
Quickstart first run, capturing profiles, every CLI command and flag
Interface and keys the eight tabs, every keybinding, the action menus
Configuration profiles.toml, per-profile config.toml, model routing, storage layout
Auto-switch the fallback chain: thresholds, gates, burn-aware mode, spend ceilings
Daemon clauth daemon, the status.json read contract for external readers
Claude Code plugin the MCP server, its five tools, delegate in full
Tokens and cost where the token dashboard reads from, what the cost figure means
Security where credentials live, what a switch touches, the platform split
FAQ common questions and what to check when something misbehaves

Quick answers

  • Settings live in ~/.clauth/profiles.toml (global) and ~/.clauth/profiles/<name>/config.toml (per account). Both are hand-editable.
  • Every setting in those files is editable in the TUI too: clauth, then the Setup / Fallback / Config tabs.
  • A switch rewrites ~/.claude/.credentials.json, parts of ~/.claude/settings.json, and the stale identity block in ~/.claude.json. Nothing else in ~/.claude/ moves.
  • clauth start <profile> runs a session in its own config dir, so it never disturbs the account your global claude is on.
  • Trust model, network activity, and vulnerability reporting: SECURITY.md.

Clone this wiki locally