Codex Multi-Account

Two Codex accounts.
One AgentsRoom. Zero shell tricks.

Run a personal Codex CLI login on one project and a work login on another, in the same window, at the same time. Pin one Codex account per project. Override per agent when you need to. Sign in directly from the Settings panel, no CODEX_HOME exports, no extra tool to install.

AgentsRoom Multiple Accounts panel in Settings showing Claude and Codex tabs, with a Codex Work account and a Codex Personal account, including sign-in status badges

The Multiple Accounts panel in Settings, unified for Claude and Codex. Pick a Codex account per project and per agent.

Why use several Codex accounts

Real reasons developers run more than one Codex account, in plain words.

Keep work and personal cleanly separated

Your employer's Codex account stays on the work projects. Your personal OpenAI account stays on your weekend projects. No accidental cross-pollination of prompts, no work credentials hitting a side project, no personal sessions logged on the work account.

Bill consumption per client

When a client gives you Codex access, sessions for that client run on their account. Their tokens get burned, not yours. Each account has its own usage history so refacturation stays straightforward.

Avoid quota collisions

If your work account has a tight OpenAI quota, a long agent run on a personal weekend project does not eat into it. Each account has its own limits, its own rate-limiting state, its own usage history.

Run a test account next to a prod account

Spin up a separate Codex account for noisy experiments, throwaway agents and prompt drafts. Keep the prod account clean. Switch between them per agent, per project, in two clicks.

Different orgs, different policies

Some OpenAI accounts are tied to enterprise SSO with mandatory logging or telemetry. Keeping a personal account separate means your personal coding stays on your personal terms, with credentials, sessions and history isolated at the directory level on disk.

Pair coding for two humans on one machine

If two developers share a workstation occasionally, each can sign in with their own Codex account. AgentsRoom remembers both, the right one fires up depending on the project or the agent.

Built directly into AgentsRoom

No external switcher, no shell scripts, no logout-login dance.

One Codex account per project

Pin a Codex account on a project. Every agent in that project inherits it by default. Open a Work project and a Personal project in the same window, each running its own Codex account underneath.

Override per agent

Need a single agent on a different account? Edit the agent, pick another Codex account, save. The override only applies to that agent. The rest of the project keeps the project-level account.

Sign in inside the app

Click "Add an account" and AgentsRoom opens an embedded mini terminal running codex login with the right CODEX_HOME. Complete the OAuth flow in the browser, paste the code back. The status badge flips to Signed in the moment credentials land on disk.

Global default account

Set one Codex account as the global default. Every new project starts on that account unless you override. Change the default later and every non-pinned project follows automatically.

Strict on-disk isolation

Each account lives in its own directory driven by CODEX_HOME: tokens, sessions, configuration. Two accounts never share an identity, and deleting an account in AgentsRoom never touches another account's data. Preferences and extensions are the one thing you can choose to share, with a single switch.

Share your own setup across accounts

One switch loads your own ~/.codex prompts, skills and global AGENTS.md into the home AgentsRoom generates for Codex, instead of leaving it empty. Credentials and history stay isolated.

One account per folder of projects

Pin a Codex account on a sidebar folder and every project filed under it starts on that account, sub-folders included. A Work folder on the work account, a Personal folder on the personal one. A project, or a single agent, can still override it.

A colour per account

Give each Codex account its own colour in Settings. It shows as a small dot on the agent avatar, on the terminal header and on the project tile, so which account is running is readable at a glance instead of being looked up.

The usage gauge follows the right account

The gauge in the status bar reads the quota of the account the agent in front of you actually runs on, provider by provider. A project pinned on Work stops showing the personal percentage, and the tooltip names the account it measures.

Quota broken down per project and per agent

Turn the quota breakdown on in the beta panel: the usage popover then splits each account's consumption across your projects and agents for the running window, every line carrying its provider mark and its account colour.

Temporary override scoped to one account

When you temporarily change the model or the reasoning effort, you choose what it applies to: every project, only the projects you pick, or only the agents that would otherwise run on one given account.

Temporary switch to another account

A temporary override can also change the account the new agents run on: out of credit on your personal account, keep working on the work one, then everything goes back to normal when the override expires.

Move a running agent to another account

Change the account from the Switch Provider window, the agent sheet, the project or a folder: the agents already running follow immediately. They restart on the new account with their context carried over, instead of waiting for their next launch.

How it works under the hood

Built on Codex CLI's official multi-account mechanism.

01

CODEX_HOME drives everything

Codex CLI reads its tokens and configuration from the directory pointed at by CODEX_HOME. Default is ~/.codex. Setting this variable to another directory swaps the active account. AgentsRoom uses this official mechanism to power multi-account support.

02

Each account is a managed directory

When you click "Add an account", AgentsRoom creates ~/.agentsroom/codex-profiles/<id>/ and signs in there. You can also point an account at any existing Codex config folder by entering a custom path. AgentsRoom runs Codex against a generated home per project, so turn on "Use my personal CLI configuration" in Settings if you want your own ~/.codex prompts, skills and global AGENTS.md loaded into it.

03

Sign-in flow is embedded in Settings

AgentsRoom spawns a mini PTY running codex login with CODEX_HOME set to the new profile directory. Complete OAuth in the browser, paste the code back. AgentsRoom polls auth.json once a second so the Signed-in badge appears the moment the file lands on disk.

04

Cascade resolution at spawn time

When an agent starts, AgentsRoom resolves the effective Codex account in this order: agent override, project pin, settings default, system default ~/.codex. The right CODEX_HOME is set on the PTY environment before codex launches.

Alternatives to AgentsRoom

Other ways to handle multiple Codex accounts, and what AgentsRoom does differently.

CODEX_HOME by hand

The direct way: export CODEX_HOME=/path before launching codex. Manual, error-prone, and the moment you open a second terminal tab you forget which account you are on. AgentsRoom drives this variable for you, per-project and per-agent, and shows you the active account in the picker every time.

Two separate machines or two user sessions

Some teams use a separate machine or a separate OS user session per Codex account. Heavy, slow, and you cannot run a work agent and a personal agent in parallel. AgentsRoom runs both at the same time on the same machine, in the same window.

Logout and login each time

Run codex logout, then codex login on the new account, then again to switch back. Costs minutes per switch and breaks any running session. AgentsRoom keeps every account signed in permanently, switches with one click.

Shell scripts wrapping codex login

Some developers wrap codex in a shell function that exports CODEX_HOME based on the current directory. Brittle, hand-rolled, and invisible from the IDE. AgentsRoom encodes the same idea declaratively at the project level, with a UI badge that always tells you which account is active.

What AgentsRoom does that the others do not

AgentsRoom is the only IDE that surfaces multiple Codex accounts as a first-class concept, with a per-project pin, a per-agent override, an in-app sign-in flow via codex login, and a status badge per account. You sign in once per account, you pin accounts per project, you override per agent, and you stop worrying about which account is loaded. Multiple Codex accounts AND Claude accounts in the same window: a Codex Work agent, a Codex Personal agent and a Claude agent can all run side by side.

FAQ

How many Codex accounts can I add to AgentsRoom?

There is no hard limit. Each account is a directory on disk. Add a Work account, a Personal account, one account per client, a test account: AgentsRoom lists them all in the Settings panel and lets you pick any of them per project or per agent.

Do I need to install any extra tool to use multiple Codex accounts in AgentsRoom?

No. AgentsRoom drives Codex CLI's CODEX_HOME mechanism directly. No external switcher, no shell wrapper, no extra dependency. The sign-in flow is fully embedded in the Settings panel and runs the official codex login command.

Can two different agents in the same project run on two different Codex accounts at the same time?

Yes. The project pins a default account, but each agent can override it. Open a project pinned on the Work account, edit one specific agent to use the Personal account, and the two agents run in parallel on different Codex accounts in the same window.

What happens if I delete an account that some agents still reference?

Nothing breaks. The agents fall back to the default Codex account silently. The deleted directory is left on disk in case you want to point another profile at it later. You can rebind the orphaned agents to another account at any time from the Edit Agent dialog.

Are credentials shared with other AgentsRoom users or sent to a server?

No. Each account directory stays on your local machine. AgentsRoom never reads, copies or transmits credentials. The sign-in flow runs the official codex login CLI in a local PTY, OAuth happens between OpenAI and your browser as usual.

Can I mix Claude accounts and Codex accounts in the same project?

Yes. The Multiple Accounts panel in Settings handles both Claude and Codex accounts independently. A single project can have one Claude account pinned and one Codex account pinned. Each agent uses whichever provider and account it is configured for.

Can I pin a Codex account to a whole group of projects?

Yes. Sidebar folders carry their own defaults, and the Codex account is one of them. Pin Work on the folder holding your work repositories and every project inside starts on that account, including projects added later and projects in sub-folders. The resolution order is: agent override, project pin, nearest folder that pins an account, global default, then ~/.codex.

With several accounts signed in, which one does the usage gauge show?

The one you are actually spending, resolved separately for each provider: the account of the agent in the foreground first, otherwise the account this project would launch on, otherwise your primary account. The gauge tooltip names it, and the usage popover lists one section per signed-in account, so a work quota and a personal quota are never added into a single figure.

Can I see how much of an account's quota one project or one agent has used?

Yes, with the quota breakdown enabled in the beta panel. AgentsRoom takes the percentage published by the account for the running window and splits it across your projects and agents, weighted by the local cost of each session. It is an estimate and it is marked as such: consumption AgentsRoom cannot see, from another computer or from another tool, is missing from the calculation, so this is never an invoice.

Do my own Codex prompts and global AGENTS.md still apply?

Turn on "Use my personal CLI configuration" in Settings and yes. AgentsRoom runs Codex against a generated CODEX_HOME per project, which is what lets several accounts and several projects run side by side without colliding: Codex then reads its user layer from that directory, so your own ~/.codex prompts, skills and global AGENTS.md are not loaded until you share them. The switch links them into every generated home and keeps them up to date, while credentials, sessions and history stay isolated per account.

How do I switch from one Codex account to another without logging out?

You do not log out at all, and that is the point. Every account you add keeps its own signed-in state on disk, so switching is picking a different account from a dropdown rather than running codex logout and codex login again. Three places do the switching, from the widest to the narrowest: the global default in Settings, the account pinned on a project, and the override on one agent. Change any of them and the next agent you start runs on that account, while agents already running keep the account they were launched with. Nothing is re-authenticated, no browser opens, and no session is destroyed, which is exactly what a logout and login cycle would cost you every time. The account switcher also runs by itself if you want: with automatic switching on, an agent that hits its account's usage limit moves to the next account you signed in instead of stopping.

Same idea, different provider

You may also like: Claude Multi-Account

Multiple Codex accounts give you several Codex logins in one app. Claude Multi-Account does the same for Claude Code: run a Work Claude account, a Personal Claude account and a client Claude account side by side. Both features live in the same Multiple Accounts panel in AgentsRoom Settings.

See the Claude Multi-Account feature
Account auto-switch

Your agent hits a usage limit. It keeps working anyway.

When the Claude or Codex account an agent runs on exhausts its quota, AgentsRoom hands the same conversation to another account you are already signed in to, and the work continues.

See how it works
Scheduled Tasks

Put your recurring dev work on a schedule

Scheduled Tasks lets you program a recurring AI agent run on any project. Choose a name, a prompt and a frequency, and AgentsRoom launches the agent for you: every morning, every night, every hour or every Monday. It is a cron for coding agents, with no cron expression to learn.

See how it works

Further reading

Stop juggling shell variables. Pick the account from a picker.

Run a Work Codex account, a Personal Codex account and a client account in AgentsRoom, side by side, today.

FreeDownload AgentsRoom

Companion app: monitor your agents on the go

Bring your own: Claude, Codex, Antigravity CLI, or other AI provider.

Get the extension
Chrome Web Store

Push bugs and requests straight to your public backlog.

Multiple projects
Multi-provider
Multiple agents
Live status
File diff & commit
Mobile companion
Live preview
Agent teams
Browser automation
Backlog-driven dev
Prompt Library
Skills Library
View all features