Codex Authは、OpenAI Codexユーザーのために開発されたサードパーティのコマンドライン（CLI）拡張ツールで、開発者がAIプログラミングアシスタントを使用する際に直面する煩雑なマルチアカウント管理とリクエスト制限の問題を解決することを主な目的としています。OpenAI Codexは、強力なAgenticプログラミングパートナーとして、認証とクォータステータス表示のための複数の環境という点でネイティブシステムの制限があります。Codex Authは、ユーザーがローカルデバイス上で複数の認証情報を一元管理し、シームレスに切り替えることを可能にすることで、このギャップを埋めます。
結果重視」と「自動化」を念頭に設計されたこのツールは、単なるトグルスイッチではなく、視覚的なスケジューリングセンターでもあります。直感的なターミナル・インタラクティブ・インターフェース（TUI）を通じて、開発者は各アカウントのパッケージ・タイプ（例：Pro、Team、Pro Lite）、5時間の高頻度使用量、1週間の合計使用量の消費比率をリアルタイムで把握することができます。さらに、このツールは革新的な「自動切り替え」機能を提供します。アクティブなアカウントがカスタマイズされた使用量のしきい値に達すると、バックグラウンドで自動的にスタンバイアカウントに切り替えられ、AIプログラミングのマインドストリームが中断されないようにします。Codex AuthはWindows、macOS、Linuxと完全な互換性があり、Codex CLI、デスクトップアプリ、VS Codeプラグインとシームレスに動作するため、エンタープライズチームやヘビーなAI開発者にとって不可欠なパフォーマンスインフラとなっている。
機能一覧
- インタラクティブなマルチアカウント・スイッチングターミナル・インタラクティブ・インターフェイス（TUI）を内蔵し、上下キー、行番号、カスタムエイリアスにより、複数のCodexアカウント間で素早くシームレスに認証情報を切り替えることができます。
- リアルタイムの使用量とパッケージの監視これは、ローカル・セキュリティ・ログを取得するか、基礎となるAPIを直接呼び出すことによって、アカウントが契約しているサブスクリプション・プラン、現在のアカウントの5時間の通話料金、および1週間の使用状況をリアルタイムで表示することをサポートしています。
- バックグラウンドでの自動切り替えシステムは自動的に監視し、公式のトラフィック制限メカニズムによって引き起こされる中断を避けるために、バックグラウンドで次の利用可能なアカウントにシームレスに切り替わります。ユーザーが通話クォータのしきい値をカスタマイズできるようにすることで、（例えば、5時間の使用率が80%に達するように設定）。
- 柔軟なログイン認証の統合ログイン・ロジックを深く統合し、標準的なウェブ認証（Web Auth）とリモート・ヘッドレス・サーバー・デバイスコード認証（Device Auth）をサポート。
- 一括インポートとクリーンアップ・メンテナンス単一ファイルおよび複数ファイルディレクトリのインテリジェントなバッチインポート（Import）、チームで共有するフォレンジックファイルの高速同期、冗長ファイルや期限切れファイルのインタラクティブなクリーンアップをサポートします。
- マルチクライアントおよびプラットフォーム対応生成された認証ステータスは、Codex CLI (@openai/codex)、VS Codeプラグイン、Codex Appクライアントに直接提供され、Windows、macOS、Linuxの各アーキテクチャに完全対応しています。
ヘルプの使用
Codex Authへようこそ！実際の開発ワークフローでこのツールの価値をスムーズに最大化するために、以下の詳細な操作と設定ガイドをお読みください。このシステムは厳密にモジュール化されており、基本的なローカルデプロイメントも高度な自動リソーススケジューリングも、シンプルなコマンドラインから行うことができます。
I. 動作環境の準備とインストール・プロセス
Codex AuthはNode.jsのランタイム環境上で実行され、基礎となるロジックはネイティブの公式なものと互換性がある必要があります。 Codex CLI クライアントにフィットする。
ステップ1：先行依存関係をインストールする
オペレーティング・システムにNode.jsがインストールされていることを確認してください（バージョン22以上を推奨）。次に、公式のCodex CLIツールをインストールし、デフォルトの環境ディレクトリと依存関係の証明設定を自動的に生成することを強くお勧めします。
npm install -g @openai/codex
ステップ2：Codex Authをインストールする
このツールは、npmパッケージ・マネージャーを介してオペレーティング・システム上にグローバルにインストールすることができるので、どのプロジェクト・フォルダでも直接使用することができる。 codex-auth 命令だ：
npm install -g @loongphy/codex-auth
(インストール不要の実装：クエリー関数をたまにしか使わないのであれば、インメモリー呼び出しに直接npxを使うことができる：npx @loongphy/codex-auth list）
基本操作：口座へのアクセスと照会
1.アカウントの追加とログイン
システム内で複数の ID クレデンシャルを管理する前に、それらを入力する必要があります。ターミナルに入力するだけです：
# 启动标准图形化登录流程
codex-auth login
システムが自動的にブラウザを立ち上げ、以下の手順を案内します。 ChatGPT アカウントログイン。Ubuntu Serverなど、グラフィカルインターフェースを持たないクラウドベースの仮想マシンで操作する場合は、デバイスコードログインモードを使用します：
codex-auth login --device-auth
この時、端末は検証コードの文字列を生成するので、ローカルコンピュータのブラウザにそのコードを入力して認証を完了すると、認証情報は自動的にサーバーハブに同期される。
2.グローバルアカウント状況へのアクセス（コアダッシュボード）
とおす list コマンドを使用すると、ホストされているすべてのアカウントの生存状況と負荷圧力を一目で見ることができます。これは開発中に最もよく使われるチェックです：
codex-auth list
美しいデータテーブルでは、各アカウント番号が ACCOUNT(メールアカウント）、PLAN(チームパッケージやプロライトパッケージなど）、5H USAGE(5時間ダイナミッククォータ消費率）と WEEKLY USAGE(週間総コール数に対する割合）。以下 --live パラメータは、リアルタイム投与リクエストを強制的にトリガーさせることができる：
codex-auth list --live
III.高度なスケジューリング：環境切替と電流制限の自動化
マルチアカウント管理の核心的な主張は、大規模な再構成中に単一のアカウントの演算能力が不足するシナリオに対処することである。
1.双方向スイッチングと指向性スイッチング
アクティブなアカウント * (ロゴ）クォータアラームが表示されたら、以下のコマンドを入力し、TUIセレクタを起動する：
codex-auth switch
インターフェイスは、ハイライトされたリストに現在のすべてのライブラリアカウントを一覧表示します。キーボードの上下の矢印を使用して、健全なアカウントを選択し、入力します。
アカウントのリスト番号または設定されたエイリアスに精通している場合は、インタラクティブ画面をスキップしてホットスワップを実行することができます：
codex-auth switch 02
codex-auth switch work-account
[キーノート］切り替えが完了したら、VS Codeのネイティブ・プラグインとデスクトップ・アプリケーションをクライアントを再起動するそうして初めて、認証ファイルを再読込できるようになる。コード編集のためのシームレスなリブートなし切り替えを望むなら、ネイティブCLIをアンインストールし、代わりにコア依存関係の修正バージョンを使用することを強く推奨する：
npm uninstall -g @openai/codex
npm install -g @loongphy/codext
2.オートスイッチ保護メカニズムの有効化
手作業による切り替えでコーディングの邪魔をしないでください。Codex Authはバックグラウンドで常駐し、クォータがレッドラインに達したことを監視すると、自動的に次の健全なアカウントに切り替えるように設定できます。
まず、自動モードを有効にする：
codex-auth config auto enable
次に、メルトダウンのしきい値を設定する。例えば、5時間の上限が80%まで消費されたとき、または1週間の上限が95%に達したときに、ツールが自動的にアカウントローテーションを実行するようにします：
codex-auth config auto --5h 80 --weekly 95
これは特に、自動テストパイプラインや毎晩のコンパイルスクリプトに適しており、AIエージェントに常に演算能力が供給されるようにする。
IV.資産メンテナンス：勘定伝票のインポートと更新
1.ビジネスとチーム資産の紹介
企業ITまたは研究開発チームのリーダーは、通常、フォレンジックJSONファイルを統一された方法で発行します。既存の管理プールにシームレスにマージするには、次のコマンドを使用します：
# 导入单独的鉴权文件，并指派别名为 team-alpha
codex-auth import /path/to/auth.json --alias team-alpha
# 批量扫描并导入某个目录下的所有合规配置
codex-auth import /path/to/auth_folder/
2.リフレッシュメカニズムのためのデータソースの管理
そのためには 5H USAGE 正確には、Codex Auth はデフォルトで API の直接接続を使用して HTTPS をポーリングします(これにはネットワークリソースが消費されます)。ネットワークに制約がある場合、あるいは保守的でローカルのリクエストログしか読みたくない場合は、APIポーリングをオフにすることができます：
# 开启（默认推荐，数据最精确）
codex-auth config api enable
# 关闭（改为读取 ~/.codex/sessions 本地日志，会有少许延迟）
codex-auth config api disable
最後に codex-auth status コマンドを使って、すべてのバックグラウンド・デーモンのコンフィギュレーションと生存をチェックする。
アプリケーションシナリオ
- フルスタックデベロッパーの重いノルマのピックアップ
OpenAI Codexを使用して、ライブラリ全体のコードのリファクタリングや、ファイル全体の静的型の導出など、高度に同時並行的なAgentタスクを実行する場合、開発者が現在のアカウントの5時間のリクエスト制限を使い果たすことは非常に簡単です。設定によりcodex-auth config auto自動ローテーション・メカニズムにより、開発者は3～5個のサブスクリプション・アカウントを1つの演算プールにまとめることができ、フロー制限の再開を待つためにコード生成プロセスを一時停止する必要がなくなる。 - 開発チームの基本演算リソースの共有割り当て
プロジェクトチームは ChatGPT Team のアカウントをいくつか調達し、コードレビューなどのルーチン作業を行うために若手プログラマと共有しています。管理者は認証ファイルをチームメンバーに配布し、チームメンバーはcodex-auth importバッチインポートを実行しlistこのビューは、各アカウントの負荷をリアルタイムで観察し、混雑したアカウントを手動で回避し、チーム内のリソース利用率を大幅に向上させる。 - リモートヘッドレスサーバーの自動スクリプトエスコート
CI/CDパイプラインやクラウドサンドボックス（NVIDIAがバックグラウンドで実行するようにデプロイしたCodexインスタンスなど）では、開発者がシステムのGUIを操作できないため、ネイティブクライアントに頼ってセッションの期限切れに対処するのは極めて難しい。そのためcodex-auth login --device-authクラウドネイティブ環境での認証バインディングを完了し、コマンドラインを使用して、テスト環境の複数のバージョン間で高速なID切り替えを可能にし、認証の失敗による継続的インテグレーションのクラッシュを防ぎます。
QA
- 利用限度額が遅れたり、ターミナルで更新されないのはなぜですか？
これは通常、データ更新モードがローカルログの読み取り専用（Local-only）に設定されているためです。ネイティブCodexは、多くの場合、新しいリリースのログフィードに含まれています。rate_limits: nullその結果、ローカルのファイルデータは、実際に起こったことから数時間遅れることになる。あなたはcodex-auth config api enableこの問題を回避するには、APIライブフェッチモードに切り替えてください。 - リアルタイムAPIフェッチをオンにしてもブロックが発生しないようにするには？
APIモードを有効にするということは、ツールがあなたのAccess Tokenを直接抽出し、公式のバックエンドエンドポイントにステータスの問い合わせリクエストを送信することを意味します。この動作は公式インタフェースをシミュレートして読み取るものであり、通常利用のロジックは満たすものの、人為的な改変により極端に高い頻度で同時アクセスされた場合、風営法のルールに抵触する可能性がある。通常のクエリの強度は準拠の範囲内であり、ツール自体は不可抗力の風制御のリスクを負わないが、ユーザは合理的な使用をする必要がある。 - 切り替えが完了した後も、Codex AppやVS Codeがクレジット不足を報告するのはなぜですか？
Native Codexとその公式拡張機能は、アプリケーションの起動時に一度だけフォレンジックファイルを読み込み、メモリ上に常駐するように設計されています。そのためcodex-auth switchコンフィギュレーションの変更に成功したら、IDE（VS Code）またはデスクトップ・アプリケーションを再起動して、コンフィギュレーション・ファイルを再読み込みさせる必要があります。再起動を省きたい場合は、ネイティブ・ライブラリをアンインストールし、カスタマイズされたバージョンの@loongphy/codext。 - 有効期限切れまたは無効なクーポン情報の消去をサポートしていますか？
サポートターミナルでの実行codex-auth removeグラフィカルなマルチセレクトメニューが表示され、無効または禁止されたアカウントプロファイルにチェックを入れて削除し、システム環境をクリーンに保つことができます。あるいはcodex-auth remove <别名>方向性削除。
