CodexUse logo CodexUse Download

How to switch Codex accounts without logging out

The Codex CLI only supports one account at a time. If you need to switch Codex accounts or change between different Codex profiles, you normally have to log out and go through the browser login flow again. CodexUse fixes this by letting you switch accounts from the system tray in under a second.

The problem: one account at a time

The Codex CLI stores your credentials locally. There is no built-in command to switch accounts or manage multiple Codex profiles. When you run codex and authenticate, it overwrites whatever credentials were there before.

To change your Codex account with the native CLI, you need to:

  1. Log out (remove the stored credentials)
  2. Run codex again
  3. Complete the browser login flow
  4. Wait for authentication to complete

This gets tedious fast if you switch Codex accounts multiple times a day.

Why you might need multiple Codex profiles

How to switch Codex accounts with CodexUse

CodexUse is a desktop companion for the Codex CLI that manages multiple Codex profiles. Each profile stores your account credentials so you can switch between them instantly.

Switching accounts

  1. Open CodexUse from the menu bar (macOS) or system tray (Linux)
  2. Click the profile you want to activate from the list
  3. See the confirmation in the status indicator. The switch is instant, no browser needed
  4. Run codex in your terminal. It now uses the selected account

Adding a new Codex profile

  1. Click Add Profile in CodexUse
  2. Give it a recognizable name (e.g., "client-acme" or "personal")
  3. Complete the one-time browser authentication
  4. The profile is saved and ready to switch to anytime

How to log out of Codex CLI

If you need to fully log out of Codex CLI (not just switch accounts), you have a few options:

With CodexUse, you rarely need to fully log out. Just switch to a different profile instead.

Troubleshooting

Symptom Likely cause Action
Switch shows success but CLI uses old account Terminal has cached environment Open a new terminal window or run codex again
Profile shows expired token error Refresh token was invalidated Delete the profile and re-add it with fresh authentication
Cannot switch Codex accounts CodexUse is not running Launch CodexUse from Applications

Best practices for multi-account workflows

Related

Can I switch Codex accounts without logging out?

Yes, with CodexUse. The native CLI only supports one account. CodexUse lets you save multiple Codex profiles and switch between them instantly.

How do I change my Codex account?

With CodexUse, click on a different profile in the app. No browser login needed.

How do I log out of Codex CLI?

Delete the profile in CodexUse, or remove the stored auth credentials manually. With CodexUse, you can just switch to a different profile instead of fully logging out.

Download CodexUse - free for 2 profiles