Codex profiles: save, rename, and rotate safely
Juggling several OpenAI accounts gets messy fast. CodexUse keeps each one as a named profile you can save, rename, and switch between without touching credentials by hand.
What a Codex profile is in CodexUse
One profile equals one OpenAI account. Each profile stores:
- Authentication: Your login credentials for that account
- Identity: Account email for easy identification
- Usage tracking: Rate limit status for that account (Pro)
Codex profile naming conventions
A good name tells you which account is active at a glance. Pick a pattern and stick to it.
| Pattern | Example | Use case |
|---|---|---|
| Purpose-based | personal, work, testing |
Simple setups with clear boundaries |
| Client-based | client-acme, client-initech |
Freelance/agency work with multiple clients |
| Team-based | team-backend, team-frontend |
Shared accounts across team functions |
| Tier-based | plus-main, plus-reserve |
Distinguishing subscription types |
Naming rules
- Keep it short: You will see these names in the tray menu and profile list
- No spaces: Use hyphens or underscores instead
- Be specific: "account1" tells you nothing; "personal-plus" tells you everything
How to save a Codex profile
- Open CodexUse
- Click "Add Profile"
- Enter a descriptive name
- Complete the one-time browser authentication
- Your profile is saved and ready to use
Renaming Codex profiles
To rename a Codex profile in CodexUse:
- Open CodexUse and go to the profile list
- Click the profile you want to rename
- Edit the display name field
- Save. The change updates the display name only and does not affect credentials
Rotating Codex profiles for rate limits
Rotation means switching accounts mid-session to spread usage, so no single account hits a rate limit while the others sit idle.
Manual rotation strategy
- Check the radar (Pro): Before starting work, see which profiles have headroom
- Start with the coolest: Use the profile with the lowest recent usage
- Switch at 60-70%: Do not wait for 429s; rotate proactively
- Reserve one profile: Keep one account unused for emergencies
Automatic rotation (trial and Pro)
CodexUse Pro can auto-roll to another Codex profile when remaining usage reaches the configured % left threshold. Configure the threshold, re-arm level, and priority order in settings.
Deleting Codex profiles safely
Deleting a profile removes it from CodexUse only. The OpenAI account itself is untouched, and you can re-add it anytime.
Before deleting:
- Confirm it is not currently active (switch to another profile first)
Troubleshooting
| Symptom | Likely cause | Action |
|---|---|---|
| Profile shows "expired" or "needs reauth" | Refresh token was invalidated | Delete the profile and add it again with fresh authentication |
| Two profiles showing same email | Added the same account twice | Delete the duplicate |
| Cannot rename profile | Name already exists or is empty | Choose a unique name and try again |
Best practices summary
- Name thoughtfully: Future you will thank present you
- Rotate proactively: Do not wait for 429s to switch accounts
- One account, one profile: Avoid duplicating the same credentials
- Document your setup: Keep a note of which profile is for which client or workspace
Related
How should I name Codex profiles?
Use short, descriptive names: "personal", "client-acme", "work-team". Avoid spaces.
Can I save multiple Codex profiles?
Yes. CodexUse stores your profiles locally. The 7-day trial includes unlimited profiles; Pro keeps them unlocked after the trial.
What is Codex profile rotation?
Switching between accounts during work sessions to distribute rate limit usage and avoid 429 errors.