CLI プロバイダー、アカウント、およびモデル

これらのコマンドは、上流プロバイダーの構成、アカウントの認証、資格情報プールの管理、Codex に公開されるモデル カタログの制御を行います。

プロバイダー

ocx provider <subcommand>

非対話型のプロバイダー管理。レジストリ エントリは名前によってシードされます。カスタム名には --adapter と --base-url の両方が必要です。

サブコマンド	サポートされているフラグ	アクション
list	--json, --jsonl	構成されたプロバイダーと残りのレジストリ エントリを一覧表示します。 --jsonl は設定済みプロバイダーごとに1行の JSON オブジェクトを出力します。
add <name>	--adapter <adapter>、--base-url <url>、--api-key <key>、--default-model <model>、--set-default、--force、--json、--sync	ローカルに保存します。--force は上書きを許可し、--sync は JSON と通常出力の両方で同期を試みます。
edit <name>	プロバイダーフィールドフラグ、--headers <json>、--json	キー プールを置き換えずに、検証済みのライブ プロバイダー フィールドを編集します。--headers はカスタム要求ヘッダーをマージします。{} または - を渡すとクリアします。
test <name>	--json	実際の上流モデルのエンドポイントを調査します。
show <name>	--json	API キーをマスクして設定を表示します。
remove <name>	--json	デフォルト以外のプロバイダーを削除します。最後のプロバイダーは削除できません。
set-default <name>	--json	既存のプロバイダーをデフォルトとして選択します。
selected <name>	--set <ids>、--clear、--json	プロバイダー モデルのホワイトリストを読み取るか更新します。
quota	--refresh、--json	プロバイダー クォータ レポートを読み取ります。
presets	--json	ダッシュボードプロバイダーのプリセットを一覧表示します。
account-mode	pool、direct、--json	プールされた Codex アカウント ルーティングまたは直接の Codex アカウント ルーティングを選択します。
import-cc-switch	--source <FILE>、--provider <id>、--apply、--restore、--allow-private-network、--json	CC-Switch の SQLite（cc-switch.db）または JSON ファイルからキーなしのプロバイダー項目をプレビュー・選択適用・復元します。

既定の add、remove、set-default はローカル設定を変更します。稼働中のプロキシを変更するには --live、ライブ削除にはさらに --yes が必要です。--sync --json も保存後に同期を試み、失敗時は保存を保持して非ゼロ終了と needsSync: true を返します。--live と --sync は併用できません。pacing と snapshot/apply の手順は英語版を参照してください。

ocx provider list --json
ocx provider list --jsonl
ocx provider test ark
ocx provider add anthropic --api-key sk-ant-... --set-default --sync
ocx provider add local-dev --adapter openai-chat --base-url http://localhost:11434/v1
ocx provider show anthropic --json
ocx models --provider anthropic --json
ocx models live --provider ark --json

--jsonl は設定済みプロバイダーのみを、1行につき1つの JSON オブジェクトとして出力します。各オブジェクトのフィールドは --json の configured 配列の要素と同じで、registryCount の集計は含みません。スクリプトは各行のオブジェクトを順に処理できます。--json と --jsonl は同時に指定できません。

カスタムヘッダーは認証情報の経路ではありません

--headers は秘密ではないリクエストメタデータ用です — ルーティングヒント、テナントや プロジェクトのセレクター、トレース ID など。認証情報を入れる場所ではなく、バリデーターは 標準的な認証ヘッダー名（Authorization、X-Api-Key、Cookie など）を apiKey / authMode を使うよう案内して拒否します。

ただし X-My-Token のような任意の名前までは判別できないため、その境界は利用者が守る 必要があります。理由は 2 つです。

• JSON はコマンドライン引数なので、秘密を入れるとシェル履歴とプロセス一覧に残ります。 CLI が何かを伏せるより先に、同じマシンの別プロセスが読み取れます。
• ヘッダー値は config.json に平文で保存されます。専用の保存・マスキング経路を持つ API キーとは異なります。

秘密にあたる値は --api-key か OAuth ログインを使ってください。

キーなしの CC-Switch プロバイダーインポート

ocx provider import-cc-switch --source ~/.cc-switch/cc-switch.db
ocx stop
ocx provider import-cc-switch --source ~/.cc-switch/cc-switch.db --provider my-provider --apply
# 別のターミナルでプロキシを起動（または ocx ensure を実行）してからキーを登録：
ocx start
printf '%s\n' "$API_KEY" | ocx account add-key my-provider

# ロールバック用の別経路（先にプロキシを停止；未編集のキーなし項目のみ削除）：
ocx stop
ocx provider import-cc-switch --restore

ocx provider import-cc-switch は通常の CC-Switch SQLite データベースまたはレガシー JSON ファイルから、非秘密メタデータフィールドの明示的な許可リスト（プロバイダー ID、アプリ種別、ベース URL、アダプター、既定モデル）の値のみを射影します。入力を走査するためソースと埋め込み設定のバイト列を一時的に読み取りますが、秘密フィールド・自由記述の表示名・TOML コメントはバイト単位でスキップされ、文字列へのデコード・書き込み・ログ出力は一切行われず、一時バイトバッファは finally でゼロ消去されます。ベース URL パスの厳格な規則（http(s)://host[:port] に空パスまたは /v1・/api/v1・/compatible-mode/v1 などの小文字 [a-z0-9._-] による 1〜4 個の API パスセグメント）と識別子／モデルの構文検査は多層防御として機能し、不適合な値をエコーせずに拒否します。ソースファイルは O_NOFOLLOW | O_NONBLOCK の記述子検証付きで一度だけ開かれ、SQLite は一時ファイルを作らずメモリ上で読み取り専用展開されます。複数ハードリンク（nlink > 1）を持つ SQLite ファイルは別名パスによるサイドカー検査回避を防ぐため拒否され、隣接する -wal または -journal ファイルが空でない場合は CC-Switch を終了（またはデータベースをチェックポイント）して再試行するよう求めて拒否します。信頼できるローカルの CC-Switch ソースのみを使用し、出力されたすべての ID・モデル・baseUrl を確認してから資格情報を登録してください：

• プレビュー（既定）： --source <FILE> が必要で、何も書き込まず、検出・対象・競合・無効の件数を報告します。
• 適用（--apply）： --source <FILE> とプロキシの停止（ocx stop）が必要で、Remote Link Child では拒否されます。--provider <id> を繰り返して対象を絞り込むか、ループバックやプライベートネットワークのベース URL には --allow-private-network を指定します。事前のプレビューなしでも、--apply はキーなしのプロバイダー項目とロールバックジャーナル $OPENCODEX_HOME/cc-switch-provider-import-journal.json を書き込む前にすべてのプロバイダー ID・既定モデル・接続先 URL を出力します（テキストモードでは stdout、--json モードでは stderr）。アクティブなジャーナルが存在する間、2 回目の --apply は拒否されます。出力内容を確認したらプロキシを起動（別ターミナルで ocx start または ocx ensure）し、printf '%s\n' "$API_KEY" | ocx account add-key <provider>（パイプ標準入力）または ocx login <provider> で資格情報を追加します。
• 復元（--restore）： 資格情報登録の続きではなく独立したロールバック経路であり、プロキシの停止（ocx stop）が必要で、Remote Link Child では拒否され、--source・--provider・--allow-private-network は受け付けません。auth.json をバイト単位で読み取り専用検査（読み取り不能または不正形式時はフェイルクローズ）し、インポート時のキーなし状態と一致したままで、かつ defaultProvider に選択されておらず、ルーティング・コンボ（combos）・フォールバックポリシー（fallback policy）・OAuth アカウント・API キーのいずれからも参照されていないプロバイダーのみをアクティブなジャーナルから削除します。

認証

ocx login <provider>

プロバイダーの登録済みログイン フローを開始します。 OAuth プロバイダーはブラウザを開き、自動更新された認証情報を ~/.opencodex/ に保存します。 API キー ログイン プロバイダーは、キー ダッシュボードを開き、キーの入力を求め、可能な場合は検証し、結果のプロバイダー設定を保存します。名前が欠落しているか不明な場合、このコマンドは現在受け入れられている OAuth および API キーのプロバイダー ID を出力します。

ocx status / ocx doctor が再認証が必要であるか、端末の更新失敗を報告した後、同じコマンドを使用して 再認証します (またはダッシュボードで再認証を使用します)。 Codex プール アカウントは上記の OAuth / API キーのプロバイダーではありませんが、ocx login codex から到達できます。このコマンドはアカウントプールのログインに転送されるため、ocx login codex --reauth は ocx account reauth codex と同じです。ダッシュボードの Codex アカウントプール (再認証) でも行えます。この経路はプロキシ内部で動くため、プロキシの起動が必要です。

ocx login xai
ocx login anthropic

ocx logout <provider>

保存されているプロバイダーの OAuth 資格情報を削除します。

アカウントとキープール

ocx account <subcommand>

実行中のプロキシを介してプロバイダー アカウントと API キー プールを一覧表示し、切り替えます。出荷されたヘルプ画面は次のとおりです。

Usage: ocx account <list|history|current|use|clear|refresh|auto-switch|alias|priority|pause|resume|pause-exhausted|strategy|sticky|remove|clear-cooldown|add-key|import|import-orca|login|reauth|code|cancel|reset-credits|grok-reset-coupons|main> ...

list [provider]     Codex account pool, OAuth accounts and API keys (identifiers shown masked as the API returns them).
history openai <pool-account-id> [--limit <1-200>]  Recent routing decisions for one Codex pool account.
current <provider>  Show the active account or key.
use <provider> <id|alias|main|auto> Switch the active credential; 'main' selects the Codex App login, 'auto' clears the selection unless an account carries that id.
clear <provider>  Clear the manual Codex account selection unconditionally.
refresh <provider>  Force-refresh Codex or provider quota reports.
auto-switch <provider> <on|off|status|threshold N>  Control the Codex pool threshold.
alias <provider> <id|alias> <display-name|->  Set or clear an account's display name; '-' clears it.
pause <provider> <id|alias|main>  Hold an account out of automatic selection.
resume <provider> <id|alias|main>  Return a paused account to automatic selection.
pause-exhausted <provider>  Pause every account whose quota is spent.
clear-cooldown <openai|anthropic> <id|alias|main>  Drop a cooldown the proxy set after an upstream failure.
strategy <provider> [<quota|round-robin|fill-first|reset-first>]  Pool placement strategy; omit the value to read it.
sticky <provider> [<1-100>]  Requests a bound thread keeps on one account; omit the value to read it.
priority <provider> <id|alias|main> [first|earlier|normal|later|last|-100..100|reset]  Selection order; omit the value to read it.
remove <provider> <id|alias|main> --yes  Remove a stored account or key after an existence check.
add-key <provider> [--label <label>]  Add a key read only from piped stdin.
login/reauth/code/cancel  Run browser or manual-code auth from a headless shell.
reset-credits <id|main> [--consume --yes]  Inspect or consume Codex reset credits.
grok-reset-coupons [<id>] [--consume --yes] [--token-id <token-id>] [--operation-id <uuid>]  Inspect or redeem Grok reset coupons.
import <provider> --format <format> (--file <path>|--stdin)  Import credentials from a named external format.
import-orca --source <dir> --registry <file> [--apply]  Preview or apply imports from Orca-managed Codex homes.
main <doctor|list|register|add|reauth|switch|recover>  Manage the Codex App login the pool calls 'main'.
Codex pool selection applies to the next request after clearing existing affinity; in-flight requests keep their captured account.

サブコマンドはプロキシが実行されている必要があり、記録されたランタイムポートを自動解決します。ただし import-orca は例外で、プレビューはローカルのみ、import-orca --apply はプロキシの停止が必要です。操作が成功した場合は 0 で終了します。無効な使用法、不明なプロバイダーまたはアカウント/キー ID、到達不能なプロキシ、または API エラーが発生した場合は 1 で終了します。資格情報フィールドは、管理 API が返したとおりに表示されます (マスキングを含む)。生の API キーと OAuth トークンは決して返されません。表示の利便性は、ダッシュボードと同様にクライアント側で合成されます。main は、openai アカウント プール内の Codex アプリ ログインの CLI エイリアスであり、電子メールのない OAuth アカウントは Account N として表示され、プラン/ラベル列はプラン、マスクされた電子メール、ラベル、およびマスクされたキーにわたってフォールバックされます。

--json アカウント行では、次の一般的な形状が使用されます (オプションのフィールドが使用できない場合は省略されます)。

{
  "provider": "openai",
  "type": "codex | oauth | api-key",
  "id": "__main__",
  "label": "plus",
  "email": "m***@example.com",
  "plan": "plus",
  "priority": 0,
  "masked": "sk-ab****wxyz",
  "active": true,
  "needsReauth": false,
  "quota": null
}

ocx account list [provider] [--json] [--all] [--quota [--refresh]]

保存済みの ChatGPT プールアカウントは、ネイティブ Codex ホームがないホストでも、 ダッシュボードやアカウント更新時を含めて一覧表示できます。一覧表示によって Codex ホームが 作成されたり、ネイティブのメインアカウントからサインアウトしたりすることはありません。 Codex クライアント連携を無効にしても、既存のネイティブログインのクォータ観測は無効になりません。 明示的に指定した CODEX_HOME のパスが無効な場合は、引き続き設定エラーを返します。 OPENCODEX_HOME のストレージが安全でない場合は、ネイティブ Codex ホームがなくてもエラーを返します。 既定の Codex ホームのパス解決では、ファイル、リンク先が存在しないシンボリックリンク、辿れない親ディレクトリもエラーになります。

プロバイダーを使用しない場合、Codex プール、OAuth アカウント、および設定された API キー プールが一覧表示されます。 --all が存在しない限り、空のプロバイダーはスキップされます。プロバイダーを使用すると、その資格情報ファミリーのみがリストされます。人間の出力では PROVIDER TYPE ID PLAN/LABEL PRIORITY STATUS を使用します。手動で選択した Codex 行には selected というマークが付けられます。利用可能な Kiro アカウントが 2 つ以上保存されている場合、既定では 429 を受けると別のアカウントへ自動的に切り替え、既知の残り利用枠が最も多いアカウントを優先します。この切り替えはアカウントの存在によって有効になり、無効にはできません。oauthAccountFailover.enabled: false が断るのは 429 復旧ではなく、送信前にアカウントを選ぶ動作だけです。ocx account login kiro はアカウントを 1 件ずつプールへ追加します。結果が空であっても成功です。 --json は次を返します:

{ accounts: AccountRow[], notes: string[] }

ocx account current <provider> [--json]

アクティブなアカウントまたはキーを表示します。手動ピンのない Codex プールは、優先度を考慮した自動選択を報告します。最も優先度の高い適格ティアが選ばれ、そのティア内でクォータルーティングのもと最低使用量のアカウントが選ばれます。アクティブな認証情報を持たない別のファミリーは、その状態を報告し、依然として 0 を終了します。--json は次を返します。

{ provider, type, activeId: string | null, autoSwitchThreshold?: number, account: AccountRow | null }

ocx account use <provider> <account-or-key-id|alias|main|auto> [--json]

auto は手動の選択を解除し、プールが自身の戦略で再び配置するようにします — ただし id が auto の Codex アカウントが存在する場合は完全一致の id が優先され、ocx account clear <provider> が常に自動選択を復元します。Codex アカウントは id の代わりに ocx account alias で付けたエイリアスでも指定でき、priority、pause、resume、clear-cooldown、remove、alias でも同様です。Codex アカウントでは auto、main、__main__ は大文字・小文字を区別せず予約語として扱われるため、エイリアスとして設定できません。OAuth アカウントと API キーの表示名には従来のルールが適用されます。

既存の Codex アカウント、OAuth アカウント、または API key を選びます。openai で main は Codex App ログインを 選択します。Codex Pool の選択は process-local affinity を消去し、既存の表示タスクを含む次のリクエストから適用されます。プロキシ再起動や affinity eviction 後もタスクは未紐付けになり得ますが、処理中のリクエストは取得済みアカウントを維持します。この選択は Pool routing のみを制御し、Direct mode は caller-owned/native main credential を使い続けます。使用量ベースのプロアクティブ切り替え、401/403 再認証、429/retry-after cooldown、除外、出力前 429/402 の障害回復により、後で別の適格 Pool アカウントが選ばれる場合があります。これらの回復経路は使用量ベース切り替えが off でも有効です。アカウント変更後も OpenCodex は会話コンテキストを再生しますが、provider prompt cache は再ウォームアップが必要な場合があります。 不明なプロバイダーや id は終了コード 1 です。--json は次を返します。 401/403 では、そのアカウントへのプロセスローカルな affinity を解除し、再認証を要求します。 429 では Retry-After を尊重してアカウントの cooldown を開始し、affinity を解除したうえで、 別の適格な Pool アカウントへリクエストを切り替えることがあります。これらの障害回復は autoSwitchThreshold: 0 でも有効であり、0 が無効にするのは使用量に基づく予防的な切り替えだけです。

{ ok: true, provider, type, activeId }

ocx account pause|resume anthropic <id|alias> [--json]

CLI コマンドは Anthropic OAuth アカウントを id または一意の別名で一時停止・再開します。別名は完全一致を優先し、次に大文字と小文字を区別せず照合します。ダッシュボードと同じ PUT /api/oauth/accounts/pause に { provider: "anthropic", accountId, paused } を送信します。paused はアカウントに保存され、GET /api/oauth/accounts にも表示されます。プロアクティブなプールが無効でも、停止中のアカウントは選択、セッションの紐付け、429 の切り替え候補から除外されます。全アカウントが停止中なら、再開するまでリクエストは 403 を返します。送信済みのリクエストは継続し、認証情報と健全性の状態は保持されます。再起動や再ログインでも停止は維持され、アカウント削除時に消えます。アカウント別のしきい値はこの操作に含まれません。

ocx account clear <provider> [--json]

アカウント id を解決せずに Codex アカウントの手動選択を解除するため、auto という id のアカウントが存在しても機能します。Codex プール専用です。他のプロバイダー種別には復元する自動選択がありません。

ocx account clear-cooldown <openai|anthropic> <id|alias|main> [--json]

保存済み認証情報を変更せず、プロセスローカルな障害 cooldown を解除します。Codex Pool アカウントには openai、Anthropic OAuth アカウントには anthropic を使い、その他の provider は拒否されます。どちらもアカウント id または一意の alias を受け付けますが、 main は Codex Pool 専用です。

ocx account clear-cooldown anthropic <id-or-alias>

有効な cooldown がなくても成功し、JSON では cleared: false になります。Anthropic の cooldown を解除するとアカウント generation も進むため、古い quota probe が解除済み状態を 復元したり、古い quota ベースの eligibility を公開したりできません。

ocx account refresh <provider> [--json]

Codex プールの場合は、ocx account refresh openai [--json] を使用します。アカウント クォータを強制的に更新し、利用可能な週次/月次のパーセンテージとリセット時間を出力します。不足しているクォータ データは、0% ではなく不明として報告されます。その JSON エンベロープは { accounts: AccountRow[] } で、Codex の各行に quota があります。

OAuth プロバイダーと API キー プロバイダーの場合、これによりプロバイダー クォータ レポート エンドポイントが強制的に更新されます。これは、トークンの再ログインや単純なアカウント リストの再読み取りではありません。 --json は { provider, report: ProviderQuotaReport | null } を返します。サポートされているクォータ レポートがないプロバイダーは、no quota report available for <provider> を出力して 0 を終了します。不明なプロバイダーと管理 API のエラーは 1 を終了します。失敗またはタイムアウトしたアップストリーム クォータ プローブは、代わりに null または古いレポートに劣化し (終了 0)、ダッシュボードのクォータ バーと一致します。

ocx account auto-switch <provider> <on|off|status|threshold <0-100>> [--json]

openai Codex プールのしきい値を制御するか、汎用 OAuth プールのしきい値を保存します。on は 80%、off は 0%、threshold <n> は 0–100 を保存します。汎用プールのしきい値は pool.kernel が有効で strategy: "fill-first" の場合にのみ選択へ反映されます。フラグが無効なら、保存してもしきい値による切り替えは有効になりません。いずれの場合もプロバイダーの有効化設定と 429 エラー時のローテーションは変更されません。汎用プールの照会と変更の結果はサーバーの確認値を使用します。汎用プールの poolEnabled は保存された設定で、null は未指定です。継承後の実効状態ではありません。inert: true は保存済みで未適用、inert: false はプールが適用中であることを示します。inert が無い場合は機能が不明であり、その場合も enabled: true とは表示しません。API キープロバイダー、不正な値は拒否されます。

ocx account auto-switch anthropic … --account <id>

Anthropic OAuth では ocx account auto-switch anthropic threshold 90 --account <id> でアカウント別の整数 0–100 を保存します。off --account <id> は 0、on --account <id> は 80、inherit --account <id> は継承へ戻し、status --account <id> は読み取り専用です。--json も使えます。カードにも同じカスタム設定があります。未設定/null は anthropicAccountPool.autoSwitchThreshold（既定 80）を継承し、0 はそのアカウントの使用量による切り替えのみ無効にします。再起動・再ログインで保持され、削除時に消えます。手動選択、affinity、使用量不明・全候補消耗時のフォールバック、モデルルート制限は維持されます。プール無効時は適用されず、一時停止と 429 復旧は引き続き有効です。

openai: { provider, autoSwitchThreshold: number, enabled: boolean }
generic OAuth: { provider, autoSwitchThreshold: number | null, enabled: boolean, poolEnabled: boolean | null, inert: boolean | null }

ocx account priority <provider> <account-id|alias|main> [<-100..100|first|earlier|normal|later|last|reset>] [--json]

Codex pool のアカウント別選択順を読み書きします。値が大きいほど先に使われ、既定は 0、範囲は -100 から 100 です。順序を持つのは openai の Codex pool だけなので、他のプロバイダーは終了コード 1 です。main は Codex Desktop ログインを指し、他の pool アカウントと同じように並べ替えられます。 ocx account priority openai main last とすれば予備として最後に回せます。

プリセット語は小さな整数の別名です。first が +2、earlier が +1、normal が 0、later が -1、last が -2 です。reset は既定に戻し、保存されたエントリを削除します。値を省略すると 読み取りになり、現在の順序を書き換えません。

順序が決めるのは「どのアカウントから見るか」であって「どれが使えるか」ではありません。選択は引き続き 適格なアカウントの中で行われ、まだ quota に余裕がある最上位 tier を取り、その中は accountPoolStrategy が選びます。一時停止、cooldown、再認証には影響しません。変更は新しいセッションだけでなく 次の未バインドリクエスト から適用されます。上位の順序に余裕が戻れば preemption が未バインドリクエストを直ちに引き上げます。既にアカウントに紐づいた thread は、通常はそのアカウントを 使い切るまで維持します。再認証エラーと quota cooldown はそれより早く紐付けを解除できます。一時的な失敗の連続は live な紐付けを削除しなくなりました。受理された書き込みは、どのアカウントの手動の「今すぐこのアカウントを使う」固定も解除します。すでに設定済みの順序を書き込んだ場合も同様で、これは現在選択中のアカウントを保ったまま固定を解除する唯一の方法です（管理 API でアクティブアカウントを解除しても固定は解除されますが、その選択自体も失われます）。プロキシに接続できない場合、 不明なアカウント id、受け付けない値はいずれも終了コード 1 です。--json は次を返します。

{ ok: true, provider, id, priority: number, preset: string | null }

ocx account login|reauth|code|cancel ...

ヘッドレスシェルから、ブラウザーまたは手動コードでアカウント認証を実行します。プロバイダーごとの構文は ocx account --help で確認できます。Codex のログインが保存済みでも、検証やモデルカタログの更新が保留中なら、通常出力と --json のどちらも終了コード 1 を返します。保存済みのログインは保持されるため、保留だけを理由に認証をやり直さないでください。通常出力ではカタログ更新の保留時に stderr へ ocx sync の案内を表示します。--json は stdout に解析可能な状態と保留フラグを返し、この案内は混ぜません。

ocx account remove <provider> <id|alias|main> --yes [--json]

この保護された非対話型削除には --yes が必要です。削除する前に、ID が存在することが確認されます。 ID が欠落している場合は、DELETE を送信せずに 1 が終了します。メインの Codex App ログインは削除できないため、remove openai main --yes は拒否されます。削除後、ファミリーは再度読み取られます。固定された Codex アカウントを削除すると、ピンがクリアされ、自動選択に戻ります。 OAuth は最初に残ったアカウントを昇格させるか、何も報告しません。 API キー プールは、最初に残っているキーを昇格するか、何も報告しません。 --json の成功と失敗の形状は次のとおりです。

{ ok: true, provider, id, removedActive: boolean, promotedActiveId: string | null, catalogRefreshPending?: boolean }
{ error: string } // stderr, exit 1

catalogRefreshPending は Codex 削除だけに含まれます。true でも削除は保存済みで、human output は stderr に ocx sync の案内を出して終了コード 0 のままです。OAuth account と API key の削除形状は変わりません。

ocx account add-key <provider> [--label <label>] [--json]

API キー プロバイダーのキーを追加してアクティブ化します。キーは、非 TTY パイプ/リダイレクトされた標準入力からの読み取り専用です。インタラクティブ TTY 入力、空の入力、OAuth/Codex プロバイダー、および API エラー終了 1。キーがラベル内に表示される場合も含め、キーがエコーされることはありません。シークレット マネージャーまたはヒア文字列を使用することをお勧めします。

ocx account add-key openrouter --label personal <<< "$OPENROUTER_API_KEY"
security find-generic-password -w openrouter | ocx account add-key openrouter --json

--json は { ok: true, id: string | null, label?: string } を返しますが、キーは決して含まれません。

ocx account reset-credits <id|main> [--consume --yes]

アカウントの Codex リセット クレジットを検査します。クレジットの消費は破壊的であり、--consume と --yes の両方が必要です。

ocx account grok-reset-coupons [<account-id>] [--consume --yes [--token-id <id>] [--operation-id <uuid>]] [--json]

xAI / Grok アカウントの残りリセット クーポンを検査または換金します。

--consume を付けずに実行すると、利用可能なクーポン トークンと有効期限ウィンドウを返します:

ocx account grok-reset-coupons
ocx account grok-reset-coupons acc_xai_01 --json

リセット クーポンの換金は請求状態を変更し、クーポン トークンを 1 つ恒久的に消費します。--consume には --yes が厳密に必要です:

ocx account grok-reset-coupons --consume --yes
ocx account grok-reset-coupons --consume --yes --token-id <token-id>

--operation-id <uuid>（有効な UUIDv4 である必要があります）を指定すると、冪等な確定が保証されます。ネットワークが切断されたりコマンドが再試行されたりしても、同一の操作 ID は 2 つ目のクーポンを消費する代わりに、永続化された結果を再生します。

ocx account main <subcommand>

OpenCodex のアカウントプールルーティングを変更せずに、名前付きのネイティブ Codex メインログインプロファイルを管理します。

ocx account main doctor [--json]
ocx account main list [--json]
ocx account main register <label> [--json]
ocx account main add <label>
ocx account main reauth --device [--no-wait] [--json]
ocx account main reauth status --flow <id> [--json]
ocx account main reauth cancel --flow <id> [--json]
ocx account main switch <profile-id-or-label> --yes [--json]
ocx account main recover [--rollback --yes] [--json]

ocx account main reauth --device --no-wait --json は成功時に単一の JSON オブジェクトを stdout に出力し、人向けの follow up: 行は出力しません。進行状況は、返された flowId を ocx account main reauth status --flow <id> --json に指定して確認できます。

各変更コマンドは、実行中のプロキシが返す正規化済みの有効な CODEX_HOME を表示します。このパスは 呼び出し元の CODEX_HOME と異なる場合があり、JSON 対応コマンドは同じ値を effectiveCodexHome として返します。

バージョン 1 はファイルベースの Codex 認証をサポートし、保存したプロファイルを AES-256-GCM で暗号化し、暗号鍵を OS の資格情報ストアに保持します。add は、生成された資格情報を取り込む前に公式 Codex ログインをステージングします。プロファイルを切り替える前に Codex を終了してください。切り替えに成功するとローカルのタスクと履歴は保持されますが、続行する前に Codex の再起動が必要です。doctor でプロファイル状態を確認し、recover で中断した切り替えを完了またはロールバックできます。switch にはプロファイル ID またはラベルを指定できます。

v1 の復旧マトリクスが対象とするのは、トランザクションファイルの rename による公開後に OpenCodex プロセスが終了した場合です。OS またはカーネルのクラッシュや突然の電源断に対する永続性は保証しません。atomicWriteFileAsync() はファイルまたは親ディレクトリに fsync を実行しません。

暗号化された vault、切り替えジャーナル、復旧マーカー、および journal-quarantine ファイルは、正規の <real CODEX_HOME>/.opencodex-native-main-profiles ディレクトリに保存されます。そのため、その Codex ホームを共有するすべての OpenCodex インスタンスは、同じ 1 つの所有者と同じ 1 つの復旧状態を参照します。平文のログインステージングは、各 <OPENCODEX_HOME>/native-main-profile-staging ディレクトリ配下にそれぞれ分離されたままです。

native-main トラフィックまたはジャーナル復旧を受け入れる前に、ライフタイム所有者が資格情報に対する排他的な権利を取得し、名前が正確に auth.json.ocx.<pid>.<sequence>.tmp と一致するクラッシュ残留ファイルだけを削除します。各候補は、変更されていない正規の CODEX_HOME 配下にあり、ハードリンク数が 1 の通常ファイルであり続けなければなりません。その内容を切り詰め、フラッシュしてからリンクを解除します。リンクまたは再解析ポイントへのすり替え、ファイル識別情報の変化、その他の曖昧さがある場合は native-main トラフィックを引き続き拒否し、名前が似ているだけのファイルは自動的には決して削除しません。これは、協調動作する OpenCodex のクラッシュから保護するためのものであり、同じ OS ユーザーとしてすでに実行中の悪意あるプロセスから保護するものではありません。そのユーザーと CODEX_HOME を格納するファイルシステムは引き続き信頼対象であり、切り詰めによってコピーオンライト方式のストレージ、スナップショット、または SSD の残留データから物理的に消去されることは保証されません。

プレビュー版では <OPENCODEX_HOME>/native-main-profiles を使用していました。このレイアウトが暗黙にインポートされることはありません。doctor が旧形式のプロファイル状態を報告した場合は、同じ CODEX_HOME を共有するすべての OpenCodex プロキシを停止してください。そのうえで、該当する *.vault.json、*.journal.json、復旧マーカー、および参照されている journal-quarantine ファイルをバックアップし、所有者だけがアクセスできる権限を維持したまま、すべて一緒に正規ディレクトリへ移動してください。別の方法として、古いプレビュー版の一式を削除し、ocx account main register を再度実行することもできます。同じ CODEX_HOME を共有するプロキシが 1 つでも稼働している間は、複数の旧ルートから 1 つを選ぶことも、両方のレイアウトを併用することも避けてください。Windows では、以前の大文字小文字を区別しないホーム識別子に紐付いたプレビュー状態は、移動せずリセットする必要があります。暗号化された AAD と OS キーリングの識別子は、意図的に再利用されないためです。

モデル

ocx models [subcommand]・ocx model <subcommand>

ocx model は ocx models の別名です。サブコマンドを使用しない場合、構成されたプロバイダーに静的にシードされたモデルを一覧表示します。 --provider は 1 つの構成済みプロバイダーをフィルターし、--json はモデル メタデータを返します。 live は実行中のカタログを読み取ります。 add、edit、remove、および list-custom は手動カタログ エントリを管理します。 enable、disable、および provider は可視性を制御します。 selected はプロバイダー許可リストを制御します。 context はプロバイダーのコンテキストの上限を制御します。 shadow はバックグラウンドのシャドウ コール インターセプトを管理します。

add と remove は既定でローカル保存し、--live で稼働中のプロキシを変更します。ローカル --json 保存時にプロキシがなければ sync.status: "not-attempted"、needsSync: true、終了コード 0 を返します。試行した同期が失敗しても保存は維持され、終了コードは非ゼロです。list-custom はローカル一覧です。display-name は raw upstream ID、order は picker の public ID を使います。完全な並べ替え、featured 接頭部、native 順序のリセット制約は英語版を参照してください。

サブコマンド	サポートされているフラグ	アクション
list (デフォルト)	--provider <name>、--json	構成されたプロバイダーにシードされたモデルをリストします。
live	--provider <name>、--json	実行時に検出されたモデルを含む、実行中のカタログを読み取ります。行には、native/routed、custom、および enabled/disabled というフラグが付けられます。
add <provider> <modelId>	--display-name <name>、--context-window <tokens>、--modalities <text,image,audio>, --live, --json	カスタムモデルをローカルに、または --live で稼働中のプロキシに登録します。
edit <custom-id>	--model-id <id>、--display-name <name|->、--context-window <tokens|0>、--modalities <text,image,audio|->、--json	カスタムモデルを編集します。 - はフィールドをクリアします。 0 はコンテキスト ウィンドウをクリアします。
remove <custom-id|provider/modelId>	--yes, --live, --json	カスタムモデルを削除します。--live または --json では --yes が必要です。
list-custom	--json	他のサブコマンドで取得される custom-id を持つすべてのカスタム モデルを表示します。
enable <provider/model|native-model>	--native、--json	1 つのモデルを Codex に表示できるようにします。
disable <provider/model|native-model>	--native、--json	Codex から 1 つのモデルを非表示にします。
provider <name> <on|off>	--json	1 つのプロバイダーのすべてのモデルを 1 回の書き込みで有効または無効にします。
selected <provider>	--set <id,id...>、--clear、--json	プロバイダー モデルのホワイトリストを読み取るか置き換えます。 --clear はホワイトリストを削除し、すべてのモデルが提供されるようにします。
context <status|value <tokens> [--set-all]|provider <name> on [--value <tokens>]|provider <name> off|all <on|off>>	--json	コンテキスト ウィンドウ キャップをグローバルに、またはプロバイダーごとに読み取りまたは設定します。 value <tokens> --set-all はすべてのルーティング済みプロバイダーにも値を再適用します（ダッシュボードのトグルと同様）。指定しない場合は既定値のみが変更されます。 provider ... on --value <tokens> はそのプロバイダーのみに個別のキャップを設定します（--value は on でのみ使用できます）。
shadow <status|set> [model|-]	--enabled <on|off>、--json	Codex のバックグラウンド ヘルパー呼び出しの置換モデルを読み取るか、設定します。 - はモデルをクリアします。 status は sourceModels も報告し、プロキシがインターセプトするヘルパースラッグを示します (デフォルト: gpt-6-luna, gpt-5.6-luna; 0.144.x 以前のクライアントが使用した gpt-5.4-mini は明示的な sourceModels オーバーライドで復元できます)。

ocx models live --json                                  # what Codex can actually see right now
ocx models disable anthropic/claude-haiku-4             # hide one routed model
ocx models enable gpt-5.6-sol                           # no slash, so it is treated as native
ocx models provider zenmux off                          # hide a noisy provider wholesale
ocx models selected anthropic --set claude-opus-5,claude-fable-5
ocx models selected anthropic --clear                   # drop the allowlist again
ocx models add deepseek deepseek-v4 --display-name 'DeepSeek V4' --context-window 128000 --modalities text,image
ocx models list-custom --json                           # read the custom-id for edit/remove
ocx models remove deepseek/deepseek-v4 --yes

スラッシュの付いたモデル セレクターはルーティングされます (anthropic/claude-opus-5)。裸の ID はネイティブ OpenAI モデルとして扱われるため、--native は、ルーティングされているように見える ID の読み取りを強制する場合にのみ必要です。

--modalities は、text、image、および audio のみを受け入れます。 Codex はそのフィールドを閉じた列挙型として解析し、他の値を含むカタログ全体を拒否するため、add、edit、および管理 API はすべて、カタログ作成者が後で削除する必要があるものを保存するのではなく、不正な値を拒否します (#759)。