К основному содержанию
плагин CX Codex

codex-multi-auth — плагин для Claude Code: функции и установка

Плагин codex-multi-auth для Claude Code и Codex управляет пулом аккаунтов ChatGPT для официального Codex CLI. Он переключает аккаунты и проверяет их состояние.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-multi-auth@awesome-codex-plugins
Открыть на GitHub

Что делает codex-multi-auth

codex-multi-auth хранит локальный пул OAuth-аккаунтов ChatGPT и помогает выбирать, какой аккаунт будет обслуживать следующий запрос. Команда status показывает состояние пула, check проверяет аккаунты, а forecast оценивает следующий выбор. Для ротации запросов Codex нужно запускать через codex-multi-auth-codex или mcodex.

В комплекте есть команды для диагностики и исправления локального состояния, отчёты в JSON и управление лимитами. Данные аккаунтов хранятся в ~/.codex/multi-auth; для отдельных проектов можно настроить собственные пулы. Нужны Node.js версии 22.19 или выше и официальный Codex CLI в PATH.

Какие задачи решает

  • переключить активный аккаунт Codex
  • проверить состояние аккаунтов ChatGPT
  • посмотреть, какой аккаунт выберется для следующего запроса
  • исправить повреждённое локальное состояние авторизации

Примеры запросов агенту

  • Добавь аккаунты ChatGPT в пул и покажи его состояние.
  • Проверь здоровье аккаунтов и спрогнозируй, какой выберется следующим.
  • Запусти Codex через codex-multi-auth-codex, чтобы запросы ротировались между аккаунтами.

Как установить codex-multi-auth

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-multi-auth@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о codex-multi-auth

Как установить codex-multi-auth в Claude Code?

Выполни /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install codex-multi-auth@awesome-codex-plugins.

Что делает codex-multi-auth?

Он управляет локальным пулом OAuth-аккаунтов ChatGPT для официального Codex CLI. Плагин позволяет переключать аккаунты, проверять их состояние и включать ротацию запросов через обёртку.

Что нужно для работы codex-multi-auth?

Нужны Node.js версии 22.19 или выше и официальный Codex CLI, доступный через PATH.

Исходный текст

codex-multi-auth · MIT
# codex-multi-auth

[![npm version](https://img.shields.io/npm/v/codex-multi-auth.svg)](https://www.npmjs.com/package/codex-multi-auth)
[![npm downloads](https://img.shields.io/npm/dw/codex-multi-auth.svg)](https://www.npmjs.com/package/codex-multi-auth)
[![CI](https://github.com/ndycode/codex-multi-auth/actions/workflows/ci.yml/badge.svg)](https://github.com/ndycode/codex-multi-auth/actions/workflows/ci.yml)
[![MIT license](https://img.shields.io/npm/l/codex-multi-auth.svg)](LICENSE)

<img width="1270" height="729" alt="codex-multi-auth terminal dashboard for Codex CLI multi-account OAuth account status" src="https://github.com/user-attachments/assets/0cecb77e-a6d3-432a-ba48-3577db0c7093" />

`codex-multi-auth` is a multi-account OAuth manager for the official `@openai/codex` CLI. It keeps a named pool of ChatGPT sign-ins on your machine, lets you switch the active account, and — when you run Codex through its optional wrapper — rotates accounts across live requests through a loopback-only proxy. It never installs or shadows a `codex` binary; the official OpenAI install keeps owning that command.

Use it when one Codex account is not enough: you hit rate limits or quota windows, you split work across organizations and workspaces, you want per-project account pools, or you run unattended agents that need JSON diagnostics and safe repair commands instead of one opaque auth file.

Using OpenCode rather than the Codex CLI? The sibling project [`oc-codex-multi-auth`](https://github.com/ndycode/oc-codex-multi-auth) is the plugin that manages the same kind of account pool there.

## What it does

- **Account pool** — OAuth login for multiple ChatGPT accounts, stored locally under `~/.codex/multi-auth` (files `0600`, directories `0700`), with per-project pools under `projects/<project-key>/`.
- **Switching and selection** — pin an account, pick the forecast-best one, follow saved account order within customized priority tiers with sequential scheduling, or let health- and quota-aware hybrid selection rotate for you.
- **Runtime rotation** — a default-on, loopback-only proxy that forwards Responses API, model-discovery, image, thread-goal, and Codex dictation/transcription traffic through managed accounts during wrapper-launched Codex sessions.
- **API capability evidence** — opted-in API/ZDR routes receive daily billable checks while the router runs; status distinguishes configured access programs from verified responses. See [check behavior and controls](docs/reference/commands.md#codex-multi-auth-check).
- **Diagnostics and repair** — status, live health checks, quota forecasts, JSON reports, and `fix`/`doctor`/`verify` commands that recover stale or damaged local state.
- **Luna Reserve fallback** — treats `gpt-reserve` as a separately metered Luna allowance, automatically falls back after a genuine Luna quota 429, and exposes the Reserve percentage through `limits --json --refresh`.
- **Local governance** — file-backed usage ledger, budget guards, account tags/weights/pause/drain policies, routing profiles, and an optional loopback bridge with bearer tokens for local OpenAI-compatible clients.
- **Desktop routing (optional)** — a reversible bind of the packaged Codex app plus user-level launcher helpers; official app binaries are never patched.

## The four binaries

| Binary | Role |
| --- | --- |
| `codex-multi-auth` | The account manager. Runs all management subcommands locally (`login`, `status`, `web`, `switch`, `forecast`, `rotation`, `fix`, ...). The `auth` prefix is optional: `codex-multi-auth login` ≡ `codex-multi-auth auth login`. |
| `codex-ma` | Short alias for `codex-multi-auth`, including the local real-time web dashboard. |
| `codex-multi-auth-codex` | Opt-in wrapper. Handles `auth ...` locally and forwards every other command to the official Codex CLI, enabling the rotation proxy for request-bearing commands. |
| `mcodex` | Convenience launcher over the wrapper, with optional `--monitor` and `--tmux` modes. No account logic of its own. |
| `codex-multi-auth-app-launcher` | User-level OS launcher routing helper (Windows shortcut, macOS wrapper app, Linux `.desktop`). |

## Install

Requirements: Node.js >= 22.19, and the official Codex CLI on `PATH` (`npm i -g @openai/codex`, Homebrew, or a release binary).

```bash
npm i -g codex-multi-auth
```

> [!NOTE]
> The legacy scoped prerelease `@ndycode/codex-multi-auth` is migration-only. Install `codex-multi-auth` for all new setups; see [docs/upgrade.md](docs/upgrade.md) to migrate.

## Quick start (5 minutes)

```bash
# 1. Sign in a ChatGPT account (browser OAuth, loopback callback on localhost:1455)
codex-multi-auth login

# 2. Repeat login to add more accounts, then inspect the pool
codex-multi-auth status
codex-ma web --no-open

# 3. Probe account health and preview which account would serve next
codex-multi-auth check
codex-multi-auth forecast --live
```

Headless or remote shell? Use `codex-multi-auth login --device-auth` — no callback port needed. Blocked browser? See [alternate login paths](docs/getting-started.md#log-in).

Run Codex through the wrapper so requests rotate across the pool:

```bash
codex-multi-auth-codex          # interactive TUI, rotation on by default
codex-multi-auth-codex exec "summarize this repo"
mcodex                          # same wrapper, shorter name
```

## Command map

`codex-multi-auth` ships 31 subcommands. The full surface — every flag, hotkey, and JSON mode — is in [docs/reference/commands.md](docs/reference/commands.md).

| Group | Commands | Purpose |
| --- | --- | --- |
| Accounts | `login`, `list`, `status`, `switch <i>`, `unpin`, `workspace` | sign in, inspect the pool, pin or switch the active account, select or enable/disable workspaces |
| Selection | `forecast`, `best`, `why-selected`, `check`, `limits`, `models` | preview, explain, and probe which account serves the next request |
| Runtime | `rotation status` `enable` `disable` `bind-app` `unbind-app` `reset-runtime` `reset-rate-limits` | inspect and control live rotation and the app bind |
| Repair | `fix`, `doctor`, `report`, `verify`, `verify-flagged`, `uninstall` | diagnose and repair storage, flagged accounts, and install residue; machine-readable health report |
| Governance | `usage`, `budget`, `account`, `monitor`, `history`, `resets` | usage ledger, budget limits, tags/weights/pause/drain, snapshots |
| Local clients | `bridge`, `integrations` | bearer tokens and client snippets for the loopback bridge |
| Config | `config explain` `template`, `init-config`, `debug bundle`, `features` | effective-config report, config templates, sanitized debug bundle |

Everyday examples:

```bash
codex-multi-auth switch 2                     # pin account #2
codex-multi-auth report --live --json         # full machine-readable health report
codex-multi-auth fix --live --model gpt-6.1-sol   # live repair probes with a chosen model
codex-multi-auth doctor --fix                 # diagnose and apply the safest fixes
codex-multi-auth usage --since 24h --by model # local usage ledger summary
codex-multi-auth rotation status              # is live rotation enabled?
```

## Runtime rotation, in one paragraph

With rotation on (the default), request-bearing wrapper commands — `exec`, `review`, `resume`, `fork`, `app`, and the bare TUI — route through a local proxy that picks the healthiest account per request, refreshes tokens as needed, and fails over across the pool on rate limits within a bounded retry budget. The proxy listens on loopback only, authenticates its own clients with a per-process token, forwards only Responses API, model-discovery, image, thread-goal, and `POST /transcribe` calls, and never writes account emails or tokens to client headers or logs. Transcription preserves the incoming multipart audio body and boundary, uses managed ChatGPT OAuth, and does not replay ambiguous audio uploads across accounts. Plain `codex` is never touched: rotation exists only inside `codex-multi-auth-codex`/`mcodex` sessions, or inside the packaged desktop app after an opt-in, reversible bind. Turn it off with `codex-multi-auth rotation disable` or `CODEX_MULTI_AUTH_RUNTIME_ROTATION_PROXY=0`.

### Quota cache revalidation

Local rate-limit blocks are valid for at most one hour. The next request then
rechecks upstream, including for a hard-pinned account, so an out-of-band quota
reset does not require a manual switch. A fresh upstream rejection starts a new
bounded wait; this does not reset quota or spend reset credits.

## Where state lives

| What | Path |
| --- | --- |
| Accounts, settings, quota cache, usage ledger, policies, observability | `~/.codex/multi-auth/` |
| Per-project account pools | `~/.codex/multi-auth/projects/<project-key>/` |
| Official Codex state (kept by the official install) | `~/.codex/` |
| Override the multi-auth root | `CODEX_MULTI_AUTH_DIR=<path>` |

Full path map: [docs/reference/storage-paths.md](docs/reference/storage-paths.md).

## Troubleshooting in 60 seconds

```bash
codex-multi-auth doctor --fix
codex-multi-auth check
codex-multi-auth forecast --live
```

Common symptoms — wrong active account, OAuth callback port `1455` already bound, Windows/WSL port contention, `EBUSY`/`EPERM` on Windows — are covered in [docs/troubleshooting.md](docs/troubleshooting.md).

## Documentation

| Doc | What it covers |
| --- | --- |
| [docs/index.md](docs/index.md) | Product overview — what it does at runtime and who needs it |
| [docs/README.md](docs/README.md) | Full documentation portal and sitemap |
| [docs/getting-started.md](docs/getting-started.md) | Install, first login, day-1 commands |
| [docs/features.md](docs/features.md) | Feature tour |
| [docs/architecture.md](docs/architecture.md) | Components, request flow, trust boundaries |
| [docs/configuration.md](docs/configuration.md) | Settings and environment overrides |
| [docs/reference/commands.md](docs/reference/commands.md) | Every command, flag, and hotkey |
| [docs/reference/public-api.md](docs/reference/public-api.md) | Public API stability tiers and semver contract |
| [docs/troubleshooting.md](docs/troubleshooting.md) | Recovery playbooks |
| [docs/faq.md](docs/faq.md) | Common questions |
| [docs/upgrade.md](docs/upgrade.md) | Version and legacy-package migration |
| [docs/privacy.md](docs/privacy.md) | Data handling and local storage behavior |
| [config/README.md](config/README.md) | Modern vs. legacy catalog templates |
| [CHANGELOG.md](CHANGELOG.md) | Release history (short version) |

## Release notes

- Current stable: [v2.24.0](docs/releases/v2.24.0.md) — `npm i -g codex-multi-auth`
- Earlier stable lines: [v2.6.0](docs/releases/v2.6.0.md), [v2.5.0](docs/releases/v2.5.0.md)
- Full release archive: [docs/README.md#release-history](docs/README.md#release-history)

## Terms and license

`codex-multi-auth` uses OAuth account credentials and is intended for personal development use. It is an independent open-source project, not an official OpenAI product; you are responsible for your own usage and policy compliance, and for production or commercial workloads you should use the OpenAI Platform API. "ChatGPT", "Codex", and "OpenAI" are trademarks of OpenAI.

MIT license — see [LICENSE](LICENSE).

© hashgraph-online · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
acedatacloud acedatacloud Управляет аккаунтом AceDataCloud через management API: балансом, API-ключами, заказами и каталогом сервисов. Подключается к задачам через Claude Code и другие IDE. CX Codex +1 127установок mixpanel-auth официальный Mixpanel Скилл mixpanel-auth для Codex и ChatGPT управляет аутентификацией Mixpanel Headless через auth_manager.py: проверяет сессию, переключает аккаунты и проекты, запускает OAuth-вход. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо create-auth better-auth Скилл create-auth проводит агента через планирование и настройку аутентификации в TypeScript/JavaScript-проекте на Better Auth: от сканирования кода до страниц входа. CX Codex +1 15 300установок okx-cex-auth okx Скилл okx-cex-auth настраивает OAuth-вход в OKX CLI, проверяет сессию и помогает восстановить авторизацию после ошибки. CX Codex +1 6 200установок cyrus-setup-claude-auth cyrusagents Скилл cyrus-setup-claude-auth прописывает учётные данные Claude в ~/.cyrus/.env, чтобы Cyrus запускал ИИ-сессии. Пригодится при первом запуске или смене аккаунта. CX Codex +1 1 100установок adding-auth spencerpauly Скилл adding-auth проводит агента по шагам добавления аутентификации в веб-приложение на NextAuth.js: провайдеры OAuth, сессии и защищённые маршруты. CX Codex +1 417установок

Из того же набора391

Весь набор →
codex-reviewer Плагин codex-reviewer проводит независимое ревью планов и написанного кода в проектах под управлением Claude. Помогает находить логические дыры до мёржа. CX Codex ★ 1 596звёзд репо codex-quota-title Плагин codex-quota-title показывает остаток квоты Codex и время сброса в заголовке окна Codex Desktop. Работает на Windows и сохраняет исходный заголовок. CX Codex ★ 1 596звёзд репо codex-quota-optimizer Плагин codex-quota-optimizer для Claude Code направляет задачи к подходящей модели и сужает контекст. Он также задаёт послойную проверку изменений. CX Codex ★ 1 596звёзд репо codex-process-jobs Плагин codex-process-jobs запускает долгие команды сборки, тестов или бенчмарков как изолированные фоновые процессы на macOS и Linux с сохранением логов и статуса. CX Codex ★ 1 596звёзд репо codex-howto Плагин codex-howto для Claude Code и Codex устанавливает девять скиллов, ведущих задачу от скоупа через тесты и ревью к отчёту с доказательствами. CX Codex ★ 1 596звёзд репо codex-auto-resume Плагин codex-auto-resume для Claude Code и Codex отслеживает лимиты Codex в Windows, ждёт сброса и автоматически возобновляет ту же сессию через codex queue. CX Codex ★ 1 596звёзд репо codex-agents-workflow Плагин codex-agents-workflow для Claude Code помогает собирать и запускать повторно используемые рабочие процессы агентов. Включается для настройки ролей и провайдеров или восстановления запусков. CX Codex ★ 1 596звёзд репо ateam Плагин ateam превращает Codex в команду из шести ролей: исследователь, PM, архитектор, разработчик, QA и ревьюер. Пайплайн настраивается, роли вызываются упоминанием. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой