aicx

Switch between Codex and Claude Code accounts without losing local conversation history.

aicx keeps credentials and settings separate for every account. Saved conversations are shared by default, so you can start with one account and continue with another.

Install

You need Linux, Python 3.11 or newer, and the official Codex or Claude Code CLI.

pip install aicx
aicx doctor

Set up two accounts

Log in with the official CLI, then let aicx adopt that account under a name.

Codex example

# First account
codex login
aicx adopt codex personal
codex logout

# Second account
codex login
aicx adopt codex work

adopt copies the current login, settings, and saved conversations. It does not change or remove the original Codex directory.

Claude Code example

# First account
claude auth login
aicx adopt claude personal
claude auth logout

# Second account
claude auth login
aicx adopt claude work

Profile names are yours to choose. personal, work, and client are only examples.

Use an account

Launch the provider with @account-name:

aicx codex @personal
aicx codex @work
aicx claude @personal

The last selection is remembered:

aicx codex
aicx claude

Provider arguments pass through normally:

aicx codex @work resume --last
aicx claude @personal --resume SESSION_ID

Accounts and usage

aicx accounts
aicx balance
aicx balance codex --profile work

Keep the balance view open and refresh it every 60 seconds:

aicx balance --watch

Choose another interval when needed:

aicx balance --watch --interval 15

The balance table shows usage, remaining percentage, reset time, and the time left until reset.

Conversation history

aicx synchronizes saved history before a provider starts and after it exits. This lets you exit a conversation and resume it with another account.

Do not open the same conversation from two accounts at the same time. History sharing supports sequential handoff, not concurrent editing.

# Manual synchronization
aicx sync codex
aicx sync claude

# Optional: disable sharing
export AICX_CODEX_HISTORY=isolated
export AICX_CLAUDE_HISTORY=isolated

Credentials remain private to each account profile. They are never shared with the conversation store.

TODO

• Test the complete workflow with multiple real Claude Code accounts. Multiple Codex accounts are tested.
• Add and test VS Code account integration.
• Add macOS support.

More documentation

• Command cheatsheet
• Architecture and storage
• Contributing

License

MIT