Interface And Keys

Interface and keys

clauth opens on the Overview tab. ← → move between tabs, ? lists every binding for the tab you are on, q twice quits.

Tabs

Tab	Holds	You can
Overview	account table, live 5h / 7d bars, chain position	switch accounts, reorder them
Usage	per-account window breakdown: 5h, 7d, per-model weeks, extra-usage spend, endpoint, merged env	refresh one account, toggle estimates and the pace marker
Tokens	global Claude Code token stats and API-equivalent cost	drill into models, change the period lens, count cache tokens
Setup	per-account endpoint, key, env, model routing, auto-start	edit any of it, log in, log out, disable, delete
Fallback	the auto-switch chain	reorder members, edit thresholds, flip gates, set a spend ceiling
Config	program-wide settings	change any of the rows in the table below
Status	incidents from status.claude.com with per-component health	open an incident's timeline or its page in a browser
Plugin	Claude Code wiring health and per-profile runtime state	apply one-key fixes

The active account is orange. Usage numbers are cached on disk, so they stay on screen when the API is rate-limited or unreachable.

Keys

Everywhere

Key	Action
← → (tab / ⇧tab at the top level)	previous / next tab
↑ ↓	move the selection, or scroll a detail pane
⏎	act on the selected row (see below)
n	new account
d	open the divergence resolver, when one is pending
x	dismiss the newest toast, then the footer alert
a	action menu for the current row
?	keybinding help for this tab
esc	step back out of a sub-pane
q	step back, or arm quit at the top level; press again to confirm
ctrl+c	quit from anywhere

Tab-dependent

Key	Behavior
r	Usage: refresh the selected account only. Tokens / Status / Plugin: reload that tab's data. Everywhere else: refresh every account
t	Tokens: cycle the period lens. Everywhere else: force-rotate every account's token, after a confirm
⏎	Overview: switch to the selected account. Tokens: open the model breakdown. Setup / Fallback: open a detail row, or commit an edit. Status / Plugin: open the detail
⇧↑ ⇧↓	Overview: reorder accounts. Fallback (chain focus): reorder chain members
space	Config: cycle a value. Setup model row and Fallback toggle rows: flip
+ -	Fallback detail: step rotate at or weekly at by 5
e	Usage: toggle burn estimates
p	Usage: toggle the ideal-pace marker
c	Tokens: count cache reads and writes in the token totals
f	Plugin: apply the selected row's fix

On macOS, t skips any account holding a live clauth start session: that session's login lives in a Keychain item clauth cannot write, so rotating it would sign the session out.

Action menus

a opens the actions available for whatever is selected. It lists what no key already does, so a screen whose ⏎ is the whole story carries no menu: Config, Fallback and Plugin have none. The footer only advertises a where something would open.

Entries above the rule act on the account named in the menu's title bar; entries below it act on the tab.

Tab	Account	Tab-wide
Overview	refresh usage, rotate access token, disable account / enable account, open provider console	refresh all accounts, new account
Usage	refresh usage, rotate access token, disable account / enable account, open provider console	refresh all accounts, toggle estimates, toggle pace marker
Tokens	none	period: lifetime / daily / weekly / monthly, show all models / show claude models / show other models, toggle cache counting, reload stats
Setup	duplicate account, save as preset, apply preset, open provider console	none
Status	none	refresh status, open in browser

The active period or model filter is omitted from the Tokens menu, so the entries you see are the ones that would change something. open provider console follows the same idea from the other direction: it appears only on an account whose endpoint clauth knows a key page for, so an OAuth account's menu is one entry shorter.

The Setup detail pane is itself a list of actions, so ⏎ on a row is the action. What the menu adds is what works on the account as a whole, from either the account list or a settings row. On the + new form there is no account yet, so nothing opens.

Entry	Does
duplicate account	asks for a name, then copies every setting onto a new account: endpoint, api key, env, models, thresholds. The stored login stays behind, as do the chain's preferred and last resort marks, which only one account may hold
save as preset	stores this account's base url and models under a name you type (Configuration). An existing preset asks first; a built-in's name is refused
apply preset	opens the picker, built-ins first. Applying replaces the endpoint and the whole model block, naming the fields first when any are set. d deletes a saved preset
open provider console	opens the page this account's api key is minted on, in your browser. Only for DeepSeek, Z.ai and Alibaba Model Studio endpoints, so it is absent on an OAuth account and on any endpoint clauth does not recognise. An Alibaba account gets its own plan's page: Token Plan and Coding Plan are separate products, on separate pages, per console

There is no remove field: an env row's ⏎ edits its value, and an empty value saves as empty, so the key stays. Drop one by editing the account's config.toml.

disable account from Overview or Usage asks first, since disabling drops the account from auto-switch, usage polling and status mid-flight; re-enabling is immediate. Neither runs for the active account or for one holding a live clauth start session; the pick names whichever is in the way.

Setup tab rows

Row	Sets
name	the profile name
auto-start	whether clauth opens the 5h window with a 1-token ping (Configuration)
base url	the API endpoint; blank means an OAuth account
api key	the key for that endpoint
model	the account's default model; space cycles presets, ⏎ types a full id
+ model override	expands to opus, sonnet, haiku, fable, subagent id overrides
env entries	extra environment variables merged into settings.json while this account is active; ⏎ edits a value, and an empty one keeps the key
disable account / enable account	hides the account from auto-switch and polling, keeping its files
+ login / re-login	what it runs depends on the account, the same three-way split clauth login has: an OAuth account mints a browser login, an api-key account re-enters its base url and key inline, and a Model Studio account opens the Alibaba console to capture the usage session its api key cannot stand in for (Configuration). That last one replaces the session and nothing else, since the endpoint and api key keep their own rows
log out	drops the stored credentials, keeps the profile
token	read-only state of a stored long-lived setup token: its remaining life, or expired / mis-filled with the fix beneath it (Configuration)
clear long-lived token	drops that token so the account's own OAuth login installs again; appears only when one is stored, arms on the first press, clears on the second. Faint and inert when the account has no other login to fall back to
delete account	removes the profile; arms on the first press, deletes on the second

Config tab rows

Row	Options	Default
theme	full, compatible	auto-detected
reset display	relative, clock, both	relative
clock	24h, 12h	24h
on mismatch	ask, overwrite, new, discard	ask
refresh	15 / 30 / 60 / 90 / 120 / 300 s, or a typed value from 10 s to 1 h	90s
refresh spent	keep polling accounts already at 100%	on
rotation	preemptive, lazy	preemptive
weekly limit	chain-wide 7d exhaustion line, 50-100%	98%
switch mode	static, burn-aware	static
burn floor	earliest projected-switch point, 90-100%	98%
burn horizon	how far ahead burn-aware projects	60s
quota spent	stay on active, switch off all	stay on active
allow extra usage	off, pay-as-you-go	off
extra usage spent	stay on active, switch off all	switch off all

clock is inert unless reset display shows one. burn floor and burn horizon are inert unless switch mode is burn-aware. extra usage spent is inert unless allow extra usage is on. What each of the auto-switch rows does: Auto-switch.

Plugin tab

Each row is a check on your Claude Code wiring: clauth on PATH, the mcpServers entry, the plugin install record, claude --version, and each profile's runtime state. f applies a fix on rows that offer one, behind a confirm that defaults to cancel:

Fix	When it appears
wire mcpServers into ~/.claude.json	the entry is missing, project-local only, or points somewhere stale
repair credentials	the active profile's stored login disagrees with the live one
relink credentials	the active profile's credential link is missing while its stored credentials are intact
install plugin	guidance only: the two /plugin commands to copy