Codex Auth: Kommandozeilen-Tool für Multi-Account-Switching und Limit-Überwachung

Codex Auth ist ein Erweiterungswerkzeug für die Kommandozeile (CLI) eines Drittanbieters, das für OpenAI Codex-Benutzer entwickelt wurde und dessen Hauptzweck es ist, die mühsame Verwaltung mehrerer Konten und die Beschränkung von Anfragen zu lösen, mit denen Entwickler bei der Verwendung von KI-Programmierassistenten konfrontiert sind.OpenAI Codex als leistungsstarker Agentic-Programmierpartner hat systemeigene Beschränkungen in Bezug auf mehrere Umgebungen für die Authentifizierung und die Anzeige des Kontingentstatus. Codex Auth füllt diese Lücke, indem es den Nutzern ermöglicht, zentral zu verwalten und nahtlos zwischen mehreren Anmeldeinformationen auf dem lokalen Gerät zu wechseln.

Das Tool wurde mit Blick auf Ergebnisorientierung und Automatisierung entwickelt und ist nicht nur ein Kippschalter, sondern auch ein visuelles Planungszentrum. Über das intuitive Terminal Interactive Interface (TUI) können Entwickler in Echtzeit das Verbrauchsverhältnis der einzelnen Pakettypen (z. B. Pro, Team, Pro Lite), den 5-Stunden-Hochfrequenzverbrauch und den wöchentlichen Gesamtverbrauch ablesen. Darüber hinaus bietet das Tool eine innovative “Auto-Switch”-Funktion: Wenn ein aktiver Account einen bestimmten Schwellenwert erreicht, wird er automatisch im Hintergrund auf einen Standby-Account umgeschaltet, um sicherzustellen, dass die KI-Programmierung nicht unterbrochen wird. Codex Auth ist vollständig kompatibel mit Windows, macOS und Linux und arbeitet nahtlos mit der Codex CLI, Desktop-Apps und VS Code-Plug-ins zusammen, was es zu einer unverzichtbaren Leistungsinfrastruktur für Unternehmensteams und KI-Entwickler macht.

Funktionsliste

• Interaktiver Wechsel zwischen mehreren KontenIntegrierte interaktive Terminalschnittstelle (TUI), die ein schnelles und nahtloses Wechseln der Zugangsdaten zwischen mehreren Codex-Konten über Auf- und Ab-Tasten, Zeilennummern oder benutzerdefinierte Aliasnamen unterstützt.
• Überwachung der Nutzung und der Pakete in EchtzeitEs unterstützt die Echtzeitanzeige des Abonnementplans eines Kontos sowie die 5-Stunden-Anrufrate des aktuellen Kontos und den wöchentlichen Nutzungsstatus durch Erfassung lokaler Sicherheitsprotokolle oder direkten Aufruf der zugrunde liegenden API.
• Automatische Umschaltung im HintergrundDas System überwacht automatisch und schaltet im Hintergrund nahtlos auf das nächste verfügbare Konto um, um Unterbrechungen zu vermeiden, die durch den offiziellen Mechanismus zur Begrenzung des Datenverkehrs ausgelöst werden, indem der Benutzer den Schwellenwert des Anrufkontingents anpassen kann (z. B. die Nutzungsrate auf 80% für 5 Stunden einstellen).
• Flexible Integration der Login-AuthentifizierungTiefe Integration der zugrundeliegenden Anmeldelogik, Unterstützung für den Aufruf von Standard-Webautorisierung (Web Auth) und Remote-Headless-Server-Gerätecode-Autorisierung (Device Auth), die nach der Eingabe automatisch im Management-Repository archiviert wird.
• Batch-Import und BereinigungspflegeUnterstützt den intelligenten Batch-Import (Import) von Verzeichnissen mit einzelnen und mehreren Dateien, die schnelle Synchronisierung von forensischen Dateien, die vom Team gemeinsam genutzt werden, und bietet interaktives Bereinigen von redundanten und abgelaufenen Dateien.
• Mandantenfähig und plattformübergreifendDie generierten Authentifizierungsstatus werden direkt an die Codex-CLI (@openai/codex), das VS-Code-Plugin und den Codex-App-Client übermittelt und sind vollständig kompatibel mit Windows-, macOS- und Linux-Architekturen.

Hilfe verwenden

Willkommen bei Codex Auth! Um sicherzustellen, dass Sie den Wert dieses Tools in Ihrem aktuellen Entwicklungs-Workflow reibungslos maximieren können, lesen Sie bitte den detaillierten Betriebs- und Konfigurationsleitfaden unten. Das System ist streng modular aufgebaut, und sowohl die grundlegende lokale Bereitstellung als auch die erweiterte automatisierte Ressourcenplanung können über eine einfache Kommandozeile erfolgen.

I. Vorbereitung der Betriebsumgebung und Installationsprozess

Codex Auth läuft auf der Node.js-Laufzeitumgebung, und die zugrunde liegende Logik muss mit der nativen offiziellen Codex CLI Der Kunde passt.

Schritt 1: Installieren Sie die Vorgänger-Abhängigkeiten
Stellen Sie sicher, dass Sie Node.js auf Ihrem Betriebssystem installiert haben (Version 22+ empfohlen). Als Nächstes wird dringend empfohlen, zunächst das offizielle Codex CLI-Tool zu installieren, um automatisch das Standard-Umgebungsverzeichnis und die Konfiguration der Abhängigkeitsnachweise zu erstellen.

npm install -g @openai/codex

Schritt 2: Codex Auth installieren
Sie können das Tool global auf Ihrem Betriebssystem über den npm-Paketmanager installieren, so dass Sie es direkt in jedem Projektordner verwenden können. codex-auth Befehl:

npm install -g @loongphy/codex-auth

(Installationsfreie Implementierung: Wenn Sie die Abfragefunktion nur gelegentlich benutzen, können Sie npx direkt für In-Memory-Aufrufe verwenden:npx @loongphy/codex-auth list）

II. grundlegende Vorgänge: Kontozugang und -abfrage

1 Konten hinzufügen und anmelden
Bevor Sie mehrere Identitätsnachweise im System verwalten können, müssen Sie diese eingeben. Geben Sie sie einfach in das Terminal ein:

# 启动标准图形化登录流程
codex-auth login

Das System ruft automatisch Ihren Browser auf und führt Sie durch die ChatGPT Kontoanmeldung. Wenn Sie mit einer Cloud-basierten virtuellen Maschine arbeiten, die keine grafische Oberfläche hat, wie z. B. Ubuntu Server, verwenden Sie den Gerätecode-Anmeldemodus:

codex-auth login --device-auth

Sie können den Code in den Browser des lokalen Computers eingeben, um die Autorisierung abzuschließen, und die Anmeldedaten werden automatisch mit dem Server-Hub synchronisiert.

2. der Zugriff auf den globalen Kontostatus (Kern-Dashboard)
passieren (eine Rechnung oder Inspektion etc.) list um auf einen Blick den Überlebensstatus und den Lastdruck aller gehosteten Konten zu sehen. Dies ist die am häufigsten verwendete Prüfung während der Entwicklung:

codex-auth list

In der schönen Datentabelle werden Sie sehen, dass jede Kontonummer dem ACCOUNT(E-Mail-Konto),PLAN(z. B. Team- oder Pro-Lite-Pakete),5H USAGE(Prozentsatz des dynamischen 5-Stunden-Kontingentsverbrauchs) und WEEKLY USAGE(Prozentsatz der gesamten wöchentlichen Anrufe). Gefolgt von --live kann die Auslösung einer Echtzeit-Dosierungsanforderung erzwingen:

codex-auth list --live

III. erweiterte Planung: Umgebungsumschaltung und automatische Strombegrenzung

Der Kernanspruch der Multi-Account-Verwaltung besteht darin, mit Szenarien fertig zu werden, in denen ein einzelnes Konto während einer umfangreichen Rekonfiguration keine Rechenleistung mehr hat.

1. interaktives und gerichtetes Schalten
Wenn Ihr aktives Konto (mit * (Logo) Wenn der Quotenalarm erscheint, geben Sie den folgenden Befehl ein, um den TUI-Selektor zu aktivieren:

codex-auth switch

Die Schnittstelle listet alle aktuellen Bibliothekskonten in einer hervorgehobenen Liste auf. Verwenden Sie die Pfeiltasten auf Ihrer Tastatur, um ein gesundes Konto auszuwählen, und geben Sie es ein. Die Zugangsdaten werden sofort ersetzt.
Wenn Sie mit der Listennummer des Kontos oder einem festgelegten Alias vertraut sind, können Sie den interaktiven Bildschirm überspringen und einen Hot Swap durchführen:

codex-auth switch 02
codex-auth switch work-account

[Key Notes]Nach der Umstellung müssen das native VS Code-Plugin und die Desktop-AnwendungStarten Sie den Client neuum die Authentifizierungsdatei erneut einzulesen. Wenn Sie einen nahtlosen Wechsel ohne Neustart für die Codebearbeitung wünschen, wird dringend empfohlen, die native CLI zu deinstallieren und stattdessen eine modifizierte Version der Kernabhängigkeiten zu verwenden:

npm uninstall -g @openai/codex
npm install -g @loongphy/codext

2. die Aktivierung des Auto-Switch-Schutzmechanismus
Lassen Sie nicht zu, dass manuelle Umschaltungen Ihren Programmierfluss unterbrechen. Sie können Codex Auth so konfigurieren, dass es als residenter Dienst im Hintergrund agiert und automatisch auf das nächste gesunde Konto umschaltet, wenn es feststellt, dass die Quote die rote Linie erreicht hat.
Aktivieren Sie zunächst den Automatikmodus:

codex-auth config auto enable

Legen Sie dann den Schwellenwert für das Abschmelzen fest. Wir möchten zum Beispiel, dass das Tool automatisch eine Kontorotation durchführt, wenn das 5-Stunden-Limit bis zu 80% ausgeschöpft ist oder das wöchentliche Limit 95% erreicht:

codex-auth config auto --5h 80 --weekly 95

Dies eignet sich besonders gut für automatisierte Testpipelines und nächtliche Kompilierungsskripte, um sicherzustellen, dass der KI-Agent über einen konstanten Vorrat an Rechenleistung verfügt.

IV. die Anlagenpflege: Import und Aktualisierung von Kontobelegen

1. die Einführung von Geschäfts- und Teamvermögen
Leiter von IT- oder F&E-Teams in Unternehmen geben forensische JSON-Dateien in der Regel auf einheitliche Weise aus. Verwenden Sie den folgenden Befehl, um sie nahtlos in einen bestehenden Management-Pool einzubinden:

# 导入单独的鉴权文件，并指派别名为 team-alpha
codex-auth import /path/to/auth.json --alias team-alpha
# 批量扫描并导入某个目录下的所有合规配置
codex-auth import /path/to/auth_folder/

2. die Verwaltung der Datenquellen für den Aktualisierungsmechanismus
Um die eben genannten 5H USAGE Um genau zu sein, fragt Codex Auth HTTPS standardmäßig über eine direkte API-Verbindung ab (was einige Netzwerkressourcen verbraucht). Wenn Sie Netzwerkeinschränkungen haben oder wenn Sie es vorziehen, konservativ zu sein und nur lokale Anfrageprotokolle zu lesen, können Sie das API-Polling deaktivieren:

# 开启（默认推荐，数据最精确）
codex-auth config api enable
# 关闭（改为读取 ~/.codex/sessions 本地日志，会有少许延迟）
codex-auth config api disable

Schließlich können Sie jederzeit die codex-auth status um die Konfiguration und das Überleben aller Hintergrund-Daemons zu überprüfen.

Anwendungsszenario

1. Starke Abholung von Full-Stack-Entwicklern
   Bei der Verwendung von OpenAI Codex zur Durchführung von hochgradig gleichzeitigen Agentenaufgaben, wie z. B. Refactoring des gesamten Bibliothekscodes, statische Typableitung für ganze Dateien usw., kann es für Entwickler sehr leicht passieren, dass das 5-Stunden-Anforderungslimit des aktuellen Kontos ausgeschöpft wird. Durch die Konfiguration von codex-auth config auto Mit dem automatischen Rotationsmechanismus können Entwickler 3 bis 5 Abonnementkonten in einen einzigen arithmetischen Pool packen und so sicherstellen, dass der Codegenerierungsprozess nicht unterbrochen werden muss, um auf die Wiederaufnahme der Flussbegrenzung zu warten.
2. Gemeinsame Zuweisung von Grundrechenmitteln für Entwicklungsteams
   Das Projektteam beschaffte mehrere ChatGPT-Teamkonten und teilte sie mit jüngeren Programmierern, um Routinearbeiten wie Codeüberprüfungen durchzuführen. Der Administrator verteilt die Autorisierungsdatei an die Teammitglieder, die die codex-auth import Führen Sie einen Stapelimport durch und übergeben Sie die list Die Ansicht zeigt die Auslastung der einzelnen Konten in Echtzeit an, wodurch überlastete Konten manuell vermieden und die Ressourcenauslastung innerhalb des Teams erheblich verbessert werden kann.
3. Automatisierte Skriptbegleitung für entfernte Headless Server
   In CI/CD-Pipelines oder Cloud-Sandboxen (z. B. Codex-Instanzen, die von NVIDIA für die Ausführung im Hintergrund bereitgestellt werden) ist es für Entwickler äußerst schwierig, mit dem Ablauf von Sitzungen umzugehen, indem sie sich auf den nativen Client verlassen, da sie die System-GUI nicht bedienen können. Die Verwendung des codex-auth login --device-auth Vollständige Authentifizierungsbindung in Cloud-nativen Umgebungen, während die Befehlszeile einen schnellen Identitätswechsel zwischen mehreren Versionen von Testumgebungen ermöglicht und sicherstellt, dass die kontinuierliche Integration nicht aufgrund von Authentifizierungsfehlern abstürzt.

QA

1. Warum verzögern sich meine Nutzungsgrenzen oder werden im Terminal nicht aktualisiert?
   Dies liegt in der Regel daran, dass der Datenaktualisierungsmodus so eingestellt ist, dass nur lokale Protokolle gelesen werden (Local-only). Native Codex findet sich oft in den Log-Feeds neuer Versionen rate_limits: nullDas Ergebnis sind lokale Dateidaten, die mehrere Stunden hinter den tatsächlichen Ereignissen zurückbleiben können. Sie können die codex-auth config api enable Wechseln Sie in den API-Live-Fetch-Modus, um dieses Problem zu umgehen.
2. Wie kann ich sicherstellen, dass die Aktivierung des Echtzeit-API-Abrufs nicht zu einer Blockierung führt?
   Wenn Sie den API-Modus aktivieren, extrahiert das Tool direkt Ihr Zugriffstoken und sendet eine Statusabfrage an den offiziellen Backend-Endpunkt. Diese Aktion wird gelesen, indem die offizielle Schnittstelle simuliert wird, und obwohl sie der Logik der normalen Nutzung entspricht, kann sie gegen die Regeln der Windschutzkontrolle verstoßen, wenn aufgrund menschlicher Änderungen extrem häufig gleichzeitig darauf zugegriffen wird. Gewöhnliche Intensität der Abfrage innerhalb des Geltungsbereichs der Compliance, das Tool selbst trägt nicht das Risiko höherer Gewalt Wind Kontrolle, muss der Benutzer vernünftig zu verwenden.
3. Warum meldet die Codex App oder der VS Code nach der Umstellung immer noch kein ausreichendes Guthaben?
   Native Codex und seine offiziellen Erweiterungen sind so konzipiert, dass sie die forensische Datei einmal beim Start der Anwendung lesen und im Speicher ablegen. Als Ergebnis, wenn Sie die codex-auth switch Nachdem Sie die zugrunde liegende Konfiguration erfolgreich geändert haben, müssen Sie die IDE (VS Code) oder die Desktop-Anwendung neu starten, damit die Konfigurationsdatei neu geladen wird. Wenn Sie auf den Neustart verzichten möchten, deinstallieren Sie die nativen Bibliotheken und installieren Sie die angepasste Version der @loongphy/codext。
4. Unterstützung für die Löschung abgelaufener oder ungültiger Gutscheininformationen?
   Unterstützung. Ausführen in einem Terminal codex-auth remove Es wird ein grafisches Mehrfachauswahlmenü angezeigt, in dem Sie ungültig gemachte oder gesperrte Kontoprofile ankreuzen und löschen können, um die Systemumgebung sauber zu halten. Alternativ können Sie auch die Funktion codex-auth remove <别名> Direktionale Löschung.