prodex

One OpenAI profile pool for Codex CLI and Claude Code.

prodex gives you two entry points backed by the same OpenAI account pool:

It keeps each profile isolated, checks quota before launch, and rotates to another ready account before a request or stream is committed.

Use prodex when Codex CLI is your front end. Use prodex claude when Claude Code is your front end. The account pool, profile isolation, quota checks, and continuation routing stay in Prodex either way. Managed profiles also share persisted Codex state such as prompt history and session resumes, so cross-profile CLI state stays aligned.

Requirements

• An OpenAI account, plus at least one logged-in Prodex profile
• Codex CLI if you want to use prodex
• Claude Code (claude) if you want to use prodex claude

If you install @christiandoxa/prodex from npm, the Codex runtime dependency is installed for you. Claude Code is still a separate CLI and should already be available on your PATH when you use prodex claude.

Install

Install from npm:

npm install -g @christiandoxa/prodex

Or install from crates.io:

cargo install prodex

The npm package version is kept in lockstep with the published crate version.

Update

Check your installed version:

prodex --version

The current local version in this repo is 0.2.114:

npm install -g @christiandoxa/prodex@0.2.114
cargo install prodex --force --version 0.2.114

If you want to switch from a Cargo-installed binary to npm:

cargo uninstall prodex
npm install -g @christiandoxa/prodex

Start

Import your current login:

prodex profile import-current main

Or create a profile through the normal Codex login flow:

prodex login
prodex login --device-auth

Check the pool:

prodex profile list
prodex quota --all
prodex info

Use prodex for Codex CLI

prodex without a subcommand is shorthand for prodex run.

prodex
prodex run --profile second
prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
printf 'context from stdin' | prodex run exec "summarize this"

Use this path when you want Codex CLI itself to be the front end. Prodex handles profile selection, quota preflight, continuation affinity, and safe pre-commit rotation across your OpenAI-backed profiles.

Use prodex claude for Claude Code

prodex claude -- -p "summarize this repo"
prodex claude --profile second -- -p --output-format json "show the latest diff"

Use this path when you want Claude Code to be the front end while Prodex still routes requests through the same OpenAI-backed profile pool.

• prodex claude runs Claude Code through a local Anthropic-compatible proxy
• Claude Code state is isolated per profile in CLAUDE_CONFIG_DIR
• the initial Claude model follows the shared Codex config.toml model when available
• Claude's native opus, sonnet, and haiku picker entries are pinned to representative GPT models
• Prodex also seeds Claude's picker with the full Prodex GPT catalog
• Claude max effort maps to OpenAI xhigh when the selected GPT model supports it
• alias-backed GPT entries reuse Claude's native alias picker values so the picker and confirmation text stay aligned
• additional GPT entries stay on GPT model ids so the selected model banner keeps GPT naming while Claude can still expose effort controls
• use PRODEX_CLAUDE_BIN if claude is not on PATH
• use PRODEX_CLAUDE_MODEL to force a specific upstream Responses model
• use PRODEX_CLAUDE_REASONING_EFFORT to force the upstream reasoning tier

Example:

PRODEX_CLAUDE_MODEL=gpt-5.2 PRODEX_CLAUDE_REASONING_EFFORT=xhigh prodex claude -- -p "hello"

Common Commands

prodex profile list
prodex use --profile main
prodex current
prodex quota --all
prodex quota --all --once
prodex info
prodex doctor
prodex doctor --runtime

More

For a slightly longer walkthrough, see QUICKSTART.md.