ウェブダッシュボード
opencodex はプロキシが提供するローカルウェブダッシュボード(gui/ 配下の Vite/React アプリ)を含みます。
プロバイダー、Codex/ChatGPT アカウント、カタログモデル、サイドカー、サブエージェント設定、リクエストトラフィックを最も
早く管理できる画面です。
ocx guiブラウザで http://localhost:<port> を開きます。プロキシがオフなら先に自動で起動します。
開発中は実行中のプロキシと GUI 開発サーバーを別々に起動できます。
ocx startbun run dev:guiMaterial 3 のみ
Section titled “Material 3 のみ”パッケージ版ダッシュボードは Material 3 インターフェースだけを提供します。廃止済み UI、そのソース、
隣接ビルドへの fallback は削除されました。プロキシはパッケージ所有の gui/dist の build manifest が
Material 3 を示し、実行中パッケージと同じバージョンの場合だけ配信します。HTML は no-store です。
検証済みビルドがない、または古い場合は旧 UI を表示せず、再ビルド/再インストール案内と共に
ダッシュボードを利用不可として報告します。legacy layout の切替設定はありません。
| 領域 | 機能 |
|---|---|
| ダッシュボード要約 | マルチエージェントモード、オンライン状態、バージョン、稼働時間、プロバイダー数、直近30日トークン合計、アクティブプロバイダーと利用可能なネイティブ/ルーティングモデルを表示します。 |
| サブエージェント委任 | OpenCodex の委任ガイダンスとオプションの Codex ネイティブサブエージェント既定値で共有するネイティブ/ルーティングモデルと任意の推論強度を選びます。スポーンごとのルーターではありません。下記を参照してください。 |
| サイドカー | ウェブ検索モデルと強度、画像説明モデルを選択します。次回リクエストから適用されます。 |
| メンテナンス | Codex モデルカタログを再同期し、プロジェクトローカル設定のバイパス警告を確認し、latest/preview 更新を照会またはオプションのプロキシ再起動と共にインストールします。 |
| 起動安全性 | 注入された Codex ルーティングが再起動後も機能するか、サービスと launcher shim の状態、正確な修復コマンドと共に表示します。 |
| Windows トレイ | ユーザーのログイントレイを導入し、プロキシ開始・停止・再起動・ダッシュボード・状態をクリックで操作します。トレイは再起動サービスではありません。 |
| Codex 自動起動 | インストール済み Codex launcher shim に ocx ensure の実行を許可します。このトグルは shim やバックグラウンドサービスをインストールしません。 |
| プロバイダー | プロバイダーを追加、編集、有効化/無効化、削除し、対応する OAuth アカウントプールと API キープールを管理します。Claude（Anthropic）OAuth プールでは、ログイン済みの各アカウントに独自の 5 時間・週間レート制限バーが表示され（利用量は資格情報単位）、取得失敗時は直近の値を保持して一時利用不可と表示します。 |
| プロバイダー追加 | レジストリベースのプリセットからアカウントログイン、API キーサービス、ローカルサーバー、custom エンドポイントを検索します。 |
| Codex 認証 | ChatGPT/Codex プールアカウントを追加し、次回セッションアカウントを選び、5 時間 / 週間 / 30 日クォータを更新し、クォータ自動切り替えのオン/オフと 1～100% のしきい値、一時的失敗フェイルオーバーを設定します。 |
| サブエージェント | spawn_agent オーバーライド一覧にネイティブまたはルーティングモデルを最大 5 つまで優先公開します。 |
| モデル | ネイティブ GPT とルーティングモデルをオン/オフし、プロバイダー許可リストとコンテキスト上限、v1/base/v2、v2 スレッド数を設定します。 |
| ログ | トークン、要求された強度と（利用可能な場合は）実際に送信された強度、実際のモデル、プロバイダー、状態、リクエスト ID、所要時間、エラー詳細を含む最近のリクエストを自動更新します。アダプターが reasoning パラメーターを送信した場合、詳細表示に正確な wire field も表示されます。 |
| 使用量 / デバッグ | トークン使用量の測定範囲と推移を見るか、オプションのプロバイダートランスポート/使用量抽出診断をオンにします。 |
| ストレージ | CODEX_HOME のディスク内訳（セッション、アーカイブ、DB、添付）を読み取り専用で表示。任意のアーカイブクリーンアップ: 最古 N% をプレビューし、既定では CODEX_HOME/.trash へ隔離、または明示チェックで完全削除。自動クリーンアップ方針はオプトインで既定 OFF（storageCleanupPolicy.enabled）。Storage ページでしきい値/目標/スケジュール/モードを設定するか 今すぐ実行。隔離エントリは Storage ページから復元可能（JSONL + スレッド）。アクティブセッションは読み取り専用。最新/アクティブな state_*.sqlite がロック中はクリーンアップと復元を拒否。 |
| リモート接続 | IPv4、IPv6、ホスト名と実行中ポートを手入力して別の OpenCodex を開きます。移動先ダッシュボードが ADMIN 認証を行います。 |
| エクスポート | 対応形式/アーカイブでダッシュボードデータを出力します。保護されたパスワード transport がないため password 付き 7z は利用できません。 |
| 停止 | プロキシとインストールされたバックグラウンドサービスを正常終了しネイティブ Codex を復元した後終了します(POST /api/stop)。 |
別の OpenCodex に接続
Section titled “別の OpenCodex に接続”ナビゲーションレールまたはモバイルメニューから 別の OpenCodex に接続 を開きます。IPv4、IPv6、
DNS ホスト名のいずれかと 1～65535 のポートを入力します。既定値は 10100 です。相手が fallback
ポートで自動起動した場合は、単なる設定値ではなく ocx host status（または ocx status）が示す
identity-verified な実際の実行中ポートに置き換えてください。
接続 は検証した正確な HTTP origin の #/dashboard を新しいタブで開きます。相手のオンライン
確認、URL への token 追加、token 保存は行いません。移動先は data-plane API key とは別の、その
プロキシの ADMIN token を要求します。HTTP は暗号化されないため、直接接続は信頼できる LAN だけで
使い、それ以外では SSH tunnel を推奨します。
エクスポートアーカイブ
Section titled “エクスポートアーカイブ”安全な 7-Zip executable がある場合、暗号化なしの 7z は利用できますが、password 暗号化は無効です。 7-Zip は password を process arguments でしか受け取れず、同じマシンの別プロセスから見える可能性が あるためです。OpenCodex は保護された password-input channel ができるまで暗号化を有効にしません。
セクションへのリンク
Section titled “セクションへのリンク”レイアウトは 1 つだけなので、切り替える設定はありません。代わりに Dashboard の各セクションに URL があります。#dashboard は Overview、#dashboard/providers と #dashboard/models は残りの 2 つです。再読み込み・ブックマーク・戻る操作のいずれでも、表示していたセクションが保たれます。Logs も #logs と #logs/debug で同じように動作します。以前の #providers/workspace のブックマークは #providers に移動します。
ログと使用量のコスト値は報告されたトークンで計算した API 定価換算値です。請求明細や 実際の請求証拠ではなく、サブスクリプション使用量またはプロバイダークレジットが代わりに適用される場合があります。
モデルの表示
Section titled “モデルの表示”モデル スイッチは Codex での最終的な表示状態を示します。ルーティングモデルはプロバイダーの allowlist に含まれる（または allowlist がない）うえで、無効化されていない場合だけオンになります。オン操作は両方のフィルターを原子的に調整し、すべてオン は allowlist を解除して新しいモデルも含めます。
委任セレクターとスポーンルーティングの違い
Section titled “委任セレクターとスポーンルーティングの違い”ダッシュボードの サブエージェント委任 セレクターは injectionModel とオプションの injectionEffort を
保存します。選択値は OpenCodex が作成する委任ガイダンスで使われ、そのガイダンスは
multiAgentGuidanceEnabled で別に制御されます。モデルを消去すると保存済み effort も消去され、
ネイティブ既定値の同期も無効になります。
Codex ネイティブサブエージェント既定値として使用を有効にすると、OpenCodex が有効な Codex
ルーティングを管理している場合、次回の sync または restart で選択したモデルと effort がネイティブ
[agents] 既定値として適用されます。外部のユーザー管理 provider 設定は変更しません。この既定値は新しく作成される
Codex タスクだけに適用され、このオプション自体が委任を発生させることはありません。既存のユーザー所有
[agents] 既定値は上書きせず保持するため、要求した既定値と実際の Codex 既定値が異なる場合があります。
セレクターには有効化されたネイティブおよびルーティングモデルと 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 | 委任ガイダンスのモデル/effort、ガイダンストグル、Codex ネイティブサブエージェント既定値の同期トグルを読み取りまたは変更します。 |
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/selected-models · PUT /api/model-visibility | プロバイダー allowlist を読み取り、モデルまたはプロバイダーグループの最終表示状態を原子的に変更します。 |
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 を復元した後終了します。 |