Skip to content

Guides

Codex guides

How to run the official Codex App and the Codex CLI across several profiles on one Mac. Each profile is one OpenAI account or one custom model provider.

Custom model providers

5

Accounts and profiles

8

Switch Codex accounts without logging out

Stop logging out of Codex just to change accounts. Save multiple profiles, switch the active one locally, and keep work, client, and personal sessions separate.

Profiles · 2026-05-22

Codex profiles: save, rename, and rotate safely

Manage multiple Codex CLI profiles safely. Learn how to save Codex profiles, rename them, and rotate between accounts for rate limit management.

Profiles · 2026-08-22

Multi-account and multi-provider auth in one app

Run several OpenAI logins in one desktop app, or bind a profile to an OpenAI-compatible provider. Switch Codex CLI accounts without re-auth.

Accounts · 2026-08-22

Duplicate Codex accounts warning: what it means

CodexUse warns when multiple profiles resolve to one OpenAI identity. Learn why it appears and how to handle duplicate Codex profiles.

Profiles · 2026-05-22

Accounts Pool: shared quota for Codex accounts

Accounts Pool turns selected saved Codex accounts into one local API with shared quota, load balancing, and failover for another app.

Accounts Pool · 2026-08-22

How to connect another app to your pooled Codex accounts

Connect another OpenAI-compatible app to Accounts Pool so it gets one local API, pooled quota across selected accounts, load balancing, and failover.

Guide · 2026-05-22

Auto-roll guardrails: avoid Codex 429s automatically

Set CodexUse Pro auto-roll's Switch, Rejoin, and Alert lines - all a percentage of quota left - so profiles hand off before Codex stalls on a 429.

Auto-roll · 2026-08-22

Cloud sync for Codex profiles and settings

Use CodexUse cloud sync during an active trial or with Pro to push from your main machine and pull profiles, config.toml, and settings on another device.

Cloud Sync · 2026-08-22

Codex App, CLI, and setup

8

Codex App orchestrator for multiple accounts

Orchestrate Codex App windows with profile-matched accounts, plus Codex CLI profiles, rate-limit headroom, and safe restart behavior in CodexUse.

Codex Apps · 2026-08-22

Codex usage basics: commands, examples, pitfalls

Codex usage guide: installation, authentication, basic commands, configuration. Learn how to use the Codex CLI effectively with real examples.

Basics · 2026-08-22

Codex settings in config.toml: models, reasoning, sandbox, MCP

Where Codex keeps model, reasoning effort, approval policy, sandbox mode, and MCP servers, and how each CodexUse profile gets its own config.toml.

Settings · 2026-08-23

How to set up MCP servers for Codex

Add MCP servers to Codex by editing config.toml by hand, and keep each CodexUse profile's servers isolated from every other profile.

MCP · 2026-08-23

CodexUse CLI for terminal power users

Use the CodexUse CLI to switch profiles, manage Accounts Pool, and sync profile data without opening the desktop app.

CLI · 2026-05-22

CodexUse Homebrew install and update guide

Install CodexUse with Homebrew, verify the CLI landed in PATH, and update cleanly with the official cask workflow on macOS.

Homebrew · 2026-05-22

CodexUse updates and installers: what to expect

How CodexUse handles updates, restarts, and installers. Learn Apple Silicon macOS support, the 2.5.8 manual upgrade step, and where to download.

Updates · 2026-08-22

Codex on Linux with multiple profiles

Historical Linux workflow note for CodexUse CLI users. Desktop releases target Apple Silicon macOS, but CLI profile workflows still apply on Linux.

Linux · 2026-05-22

Rate limits and fixes

3

Comparisons and policy

3