ウェブダッシュボード
opencodex はプロキシが提供するローカルウェブダッシュボード(gui/ 配下の Vite/React アプリ)を含みます。
プロバイダー、Codex/ChatGPT アカウント、カタログモデル、サイドカー、サブエージェント設定、リクエストトラフィックを最も
早く管理できる画面です。
ocx guiブラウザで http://localhost:<port> を開きます。プロキシがオフなら先に自動で起動します。
開発中は実行中のプロキシと GUI 開発サーバーを別々に起動できます。
ocx startbun run dev:gui| 領域 | 機能 |
|---|---|
| ダッシュボード要約 | マルチエージェントモード、オンライン状態、バージョン、稼働時間、プロバイダー数、直近30日トークン合計、アクティブプロバイダーと利用可能なネイティブ/ルーティングモデルを表示します。 |
| サブエージェント委任 | v1 委任プロンプトに入れるネイティブまたはルーティングモデルとオプションの推論強度を選びます。スポーンごとのルーターではありません。下記の説明を確認してください。 |
| サイドカー | ウェブ検索モデルと強度、画像説明モデルを選択します。次回リクエストから適用されます。 |
| メンテナンス | Codex モデルカタログを再同期し、プロジェクトローカル設定のバイパス警告を確認し、latest/preview 更新を照会またはオプションのプロキシ再起動と共にインストールします。 |
| 起動安全性 | 注入された Codex ルーティングが再起動後も機能するか、サービスと launcher shim の状態、正確な修復コマンドと共に表示します。 |
| Windows トレイ | ユーザーのログイントレイを導入し、プロキシ開始・停止・再起動・ダッシュボード・状態をクリックで操作します。トレイは再起動サービスではありません。 |
| Codex 自動起動 | インストール済み Codex launcher shim に ocx ensure の実行を許可します。このトグルは shim やバックグラウンドサービスをインストールしません。 |
| プロバイダー | プロバイダーを追加、編集、有効化/無効化、削除し、対応する OAuth アカウントプールと API キープールを管理します。 |
| プロバイダー追加 | レジストリベースのプリセットからアカウントログイン、API キーサービス、ローカルサーバー、custom エンドポイントを検索します。 |
| Codex 認証 | ChatGPT/Codex プールアカウントを追加し、次回セッションアカウントを選び、5 時間 / 週間 / 30 日クォータを更新し、クォータ自動切り替えと一時的失敗フェイルオーバーを設定します。 |
| サブエージェント | spawn_agent オーバーライド一覧にネイティブまたはルーティングモデルを最大 5 つまで優先公開します。 |
| モデル | ネイティブ GPT とルーティングモデルをオン/オフし、プロバイダー許可リストとコンテキスト上限、v1/base/v2、v2 スレッド数を設定します。 |
| ログ | トークン、リクエスト強度、実際のモデル、プロバイダー、状態、リクエスト ID、所要時間、エラー詳細を含む最近のリクエストを自動更新します。 |
| 使用量 / デバッグ | トークン使用量の測定範囲と推移を見るか、オプションのプロバイダートランスポート/使用量抽出診断をオンにします。 |
| 停止 | プロキシとインストールされたバックグラウンドサービスを正常終了しネイティブ Codex を復元した後終了します(POST /api/stop)。 |
ログと使用量のコスト値は報告されたトークンで計算した API 定価換算値です。請求明細や 実際の請求証拠ではなく、サブスクリプション使用量またはプロバイダークレジットが代わりに適用される場合があります。
委任セレクターとスポーンルーティングの違い
Section titled “委任セレクターとスポーンルーティングの違い”ダッシュボードの サブエージェント委任 セレクターは injectionModel とオプションの injectionEffort を
保存します。v1 ターンでは opencodex が親エージェントに spawn_agent に渡す正確なモデルと推論
強度を伝えるガイドを注入します。モデルを選ぶと親の現在の推論強度に関係なくこのガイドが
有効化され、モデルを消去すると保存された強度も一緒に消去されます。
セレクターには有効化されたネイティブおよびルーティングモデルと Codex グローバル推論段階が表示されます。API は 選んだ強度がグローバル段階にあるか検査し、Codex は再び対象カタログ項目がその強度をサポートするか 検査します。
Codex 認証とアカウントプール
Section titled “Codex 認証とアカウントプール”Codex 認証ページはネイティブ ChatGPT/Codex ルートを管理します。
- アカウントを直接選ぶと次の新規 Codex セッションから変わります。すでにアカウントが紐付いた thread はこの手動切り替えだけでは 途中で移動しません。
- Thread affinity がリクエストごとにアカウントが揺れるのを防ぎます。クォータ自動切り替えがオンなら長く 実行される thread も定期的に再評価します。関連使用量がしきい値を超え、使用量が確実により低い 健全アカウントがあればそのアカウントに再紐付けできます。
- 新規セッションは使用量が最も低い健全アカウントを選べます。有料プランは既知の 5 時間、週間、30 日 枠のうち最も高い使用率でスコア付けし、Go/Free プランは 30 日枠のみ使います。
- クォータ更新はアカウント使用量を即座に再読み込みし、ルーティングと画面のアカウントカードが同じ値を見るようにします。
- プールリクエストログにはメールの代わりに
p3fa91cのような不透明なラベルを使います。
ダッシュボードがプロキシと通信する方式
Section titled “ダッシュボードがプロキシと通信する方式”GUI はプロキシの JSON 管理 API を使うシンクライアントです。主なエンドポイントは次のとおりです。
| エンドポイント | 用途 |
|---|---|
GET / PUT /api/settings |
設定を読むか Codex 自動起動をオン/オフします。 |
GET /api/startup-health |
秘密情報を含まないルーティング、サービス、shim、再起動安全性診断を読み取ります。 |
GET / POST /api/windows-tray |
Windows トレイの導入・表示状態を読み取り、install、start、stop、uninstall を実行します。 |
POST /api/sync |
共有モデルカタログを再構築し Codex モデルキャッシュを古い状態としてマークします。 |
GET /api/update/check · POST /api/update/run · GET /api/update/status |
自己更新作業を確認、実行、追跡します。 |
GET / PUT /api/sidecar-settings |
検索/ビジョンサイドカーモデル設定を読むか変えます。 |
GET / PUT /api/injection-model |
v1 委任ガイドモデルとオプションの強度を読むか変えます。 |
GET / PUT /api/v2 |
サーフェスモード、Codex 機能フラグ、v2 スレッド上限を読むか変えます。 |
GET /api/providers · POST /api/providers · PATCH /api/providers?name=... · DELETE /api/providers?name=... |
プロバイダー一覧の参照、追加/差替、有効化/無効化、削除。 |
GET /api/models · PUT /api/disabled-models |
ネイティブ/ルーティングモデル行を参照し共有 disabled model 一覧を更新します。 |
GET /api/key-providers · GET /api/oauth/providers |
API キーおよび OAuth プロバイダーカタログを読みます。 |
POST /api/oauth/login · GET /api/oauth/status |
プロバイダー OAuth ログインを開始し完了可否を確認します。 |
GET /api/codex-auth/accounts?refresh=1 |
メインおよびプールアカウントを参照しクォータを強制更新し、メインの hasCredential / terminal needsReauth 状態を返します。 |
PUT /api/codex-auth/active · PUT /api/codex-auth/auto-switch · PUT /api/codex-auth/failover |
次回セッションアカウントとプールルーティングポリシーを設定します。 |
POST /api/codex-auth/login · GET /api/codex-auth/login-status |
ブラウザログインでプールアカウントを追加します。 |
GET /api/logs?tail=50&provider=...&status=5xx |
tail、プロバイダー、正確な状態コードまたは状態等級で最近のリクエストメタデータを参照します。 |
GET / PUT /api/subagent-models |
spawn_agent に優先公開するモデル 5 つを読むか設定します。 |
POST /api/stop |
プロキシ/サービスを停止しネイティブ Codex を復元した後終了します。 |