Can Codus switch accounts automatically when usage runs low?
Yes. Open a provider's usage panel, then Switch status to see Account switching. Switch accounts before usage runs out enables the check; the default threshold is 95 percent. Codus checks fresh usage in the background and chooses an eligible account. Running responses finish before switching.
Background recovery requires Codus 0.2.186 or later. Codus 0.2.185 and earlier delegate these decisions to Brain 1; older versions call the option Let Brain 1 handle high usage.
Before you start
Have another signed-in account with available usage. Account switching and Claude/Codex handoffs are allowed by default, and Codus prefers a spare account on the same provider before it hands a session to the other provider. Moving accounts does not remove the provider's limits or purchase more usage.
Check or change the settings
- Click Claude or Codex in the status bar, then Switch status.
- Check Automatic switching and its On, Off or Paused status.
- Expand Switching settings. Allow agents to change accounts permits account moves; Allow switching between Claude and Codex separately permits provider handoffs.
- Set Check at to a whole percentage from 1 to 99 and click Save threshold.
- Decide whether to enable Allow automatic changes to pinned accounts. Leave it off to preserve those account assignments.
A choice you save here is kept across updates. Codus only turns these on by itself for settings that were never saved.
If nothing moves
In Codus 0.2.186 or later, Brain 1 can be busy, stopped or out of usage: routine recovery runs in Codus itself. The desktop must remain open. Each affected terminal still waits for its own response to finish.
Expand Recent activity, then View details on the affected check. Missing spare accounts, unconfirmed usage, permissions or pinned assignments can leave terminals unchanged. Retry usage check is offered when a check needs attention; Codus also rechecks automatically, with a delay between checks and after recent switches. A cancelled terminal stays excluded for that usage warning, including after an app restart; a new usage window or an explicit retry can make it eligible again. A model-specific usage window does not necessarily mean every model on the account is exhausted.
In 0.2.188 or later, pending warnings share one automatic usage check, with at least three minutes between these checks. That delay survives an app restart. Warnings for a previous account or an expired usage window are closed automatically. Stopped terminals do not trigger recovery checks.
Usage refresh delayed means the provider has temporarily limited requests for usage figures. For Claude, Codus waits until that account's saved retry time before checking it again, including after an app restart. The label alone does not mean the account has used all its allowance. Sign-in required and Usage out of date describe separate problems reading the account's login or current usage.
You never have to wait for the warning to clear. Switching a warned terminal yourself, or asking the Brain to switch it to a named account, goes ahead at the next safe prompt and settles the warning for that terminal. The only switch that waits is one Codus is already carrying out on that same terminal.
How do I know it worked?
Recent activity records the check and terminals left unchanged. The terminal list confirms successful moves as Verified. A warning, an On label or available spare usage alone does not prove a switch happened or guarantee uninterrupted work.
Stopped terminals are not launched just to apply an account choice. Account saved means the choice will apply when that terminal starts. Confirming account means it has started but Codus is waiting for its session receipt; it becomes Verified automatically after confirmation. Missing identity or conversation evidence can still prevent a safe switch.
In Codus 0.2.186 or later, Account ready identifies a confirmed fresh launch on the selected account before its first message. Codus does not require a conversation receipt for a terminal it can prove has never had a conversation. Drafts keep that switch waiting; unknown or previously used conversations still require preservation evidence.