CLI エージェント、ルーティング、および統合

これらのコマンドは、エージェントのポリシーとルーティングを制御し、稼働中のプロキシを検査し、サポートされているクライアントを opencodex に接続します。

エージェントポリシー

ocx agent <status|injection|effort|subagents|fallback|sidecar> ...

ヘッドレス マルチエージェントロスター、エフォート キャップ、プロンプト インジェクション、フォールバック、サイドカー設定を管理します。現在のポリシーには status を使用します。サーフェス モード、委任、エフォート、およびフォールバック動作がどのように組み合わされるかについては、サブエージェントサーフェス を参照してください。

ocx agent subagents set ark/model-a,openai/gpt-5.5

ocx v2 <status|on|off|mode <v1|default|v2>|threads <n>>

Codex multi_agent_v2 機能フラグとスリーステート マルチエージェント サーフェス モードを管理します。

サブコマンド	アクション
status (デフォルト)	現在の v2 フラグ、マルチエージェント モード、およびスレッドの同時実行性をレポートします。
on	multi_agent_v2 機能を有効にし、カタログを再同期します。
off	multi_agent_v2 機能を無効にし、カタログを再同期します。
mode v1	すべてのモデルを強制的に v1 にし、ネイティブ v2 を無効にして、アクティブなスレッド制限を保持します。
mode default	上流のモデル サーフェス ピンを尊重します。
mode v2	すべてのモデルを強制的に v2 にし、ネイティブ v2 を有効にして、アクティブなスレッド制限を維持します。
threads <n>	アクティブな v1/v2 スレッド制限を少なくとも 1 の整数に設定します。

ocx v2 status
ocx v2 mode v1
ocx v2 mode default
ocx v2 on
ocx v2 threads 16

mode サブコマンドは、multiAgentMode を opencodex 設定に書き込み、Codex カタログを再同期します。モードとフラグの遷移により、現在の数値スレッド制限が有効な v1/v2 Codex キー間で移動します。移行が失敗すると、元の config.toml が復元されます。変更は新しい Codex セッションに適用されますが、実行中のセッションでは固定されたサーフェスが維持されます。

コンボルーティング

ocx combo <list|show|set|remove> ...・ocx route combo ...

コンボフェイルオーバーとラウンドロビン仮想モデルを管理します。 ocx route combo は階層別名です。 combo は現在サポートされているルーティング リソースです。ターゲットはprovider/model[:weight],provider/model[:weight]を使用します。

ocx combo list
ocx route combo set reliable --targets ark/model-a:2,openai/gpt-5.5

ルーティングの動作と設定ガイダンスについては、「コンボ」を参照してください。

可観測性とデバッグ

ocx observe <logs|usage|storage|memory|debug|claude-inbound|injection> ...

プロキシ リクエスト、使用状況、ストレージ、メモリ、およびデバッグ データを検査します。直接のエイリアスは次のとおりです。

別名	同等のリソース
`ocx logs [filters] [–follow] [–json	–jsonl]`
`ocx usage [–range <today	1d
ocx storage [--json]	ocx observe storage
ocx memory [--json]	ocx observe memory

ocx observe usage --range 30d --json

一部の使用履歴を集計できない場合、人向けの出力は読み取れる行がない場合も警告を表示します。表示される合計値は読み取れる記録のみを反映します。フィルターに一致する読み取れる記録がない場合は、合計欄の代わりに警告と案内を表示します。除外した記録には一致するものが含まれる可能性があります。--json は応答の usageIncomplete 診断と理由をそのまま保持します。

ocx debug <provider|usage|injection|claude> <on|off|status|reset|logs [-f]>

実行中のプロキシの管理 API を通じて、ランタイム デバッグ オーバーライドを読み取りまたは変更します。

ocx debug provider on|off|status|reset
ocx debug provider logs [-f|--follow]
ocx debug usage on|off|status|reset
ocx debug usage logs [-f|--follow]

スコープがない場合、ocx debug は使用状況を出力し、プロキシが停止すると、次回起動環境がデフォルトになります。プロバイダーのデバッグのデフォルトは OCX_DEBUG=1 です (従来の OCX_DEBUG_FRAMES=1 も機能します)。使用法デバッグのデフォルトは OPENCODEX_USAGE_DEBUG=1 からです。

APIアクセス

ocx access <key|endpoints|models|test> ...

OpenCodex アドミッション API キーを管理し、外部エンドポイントとモデルを検査します。 ocx api-key <list|create|remove> ... は ocx access key の別名です。

ocx access key create deployment

クライアントの統合

ocx integration <claude|grok> ...

サポートされている Claude と Grok の統合を管理します。以下の直接コマンド ファミリは、クライアント固有のコントロールを公開します。

ocx claude [claude args...]

プロキシが実行されていることを確認し、ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1、および config.claudeCode のモデル スロットを使用してクロード コードを起動します。ルーティングされたモデルは、Claude Code 2.1.129 以降の安定したスロット エイリアスを介してネイティブ /model ピッカーに表示されます。古いバージョンでは、ANTHROPIC_MODEL または /model <id> で選択します。ユーザーがエクスポートした ANTHROPIC_* 変数が常に優先されます。

Claude デスクトップ プロファイル コマンドは次のとおりです。

ocx claude desktop [apply]                         Save and apply the four-family profile
ocx claude desktop show [--json]                   Show routes, families, and defaults
ocx claude desktop move <route> <family> [--default]
ocx claude desktop default <family> <route|none>
ocx claude desktop export <path|->                 Export versioned JSON (`-` = stdout)
ocx claude desktop import <path> [--apply]         Validate and import JSON

ファミリは opus、fable、sonnet、および haiku です。新しいルートは opus で始まります。 none は、そのファミリーが空の場合にのみ有効です。従来の適用フラグ --static、--hybrid、および --discovery-only は引き続きサポートされます。クロードコードの設定にはocx claude config <status|set> ...を使用してください。

ocx opencode [opencode args...]

プロキシが実行されていることを確認し、OpenCode のインライン ランタイム層 (OPENCODE_CONFIG_CONTENT) で生成された provider.opencodex および providers.opencodex ブロックを使用してオープンコードを起動します。既存のインライン設定は保持され、今回の起動ではこの 2 つのキーのみが置き換えられます。グローバルまたはプロジェクトの opencode.json ファイルは、既存の上書きについて警告するために読み取られることがありますが、ディスク上のファイルは変更されません。ルーティングされたモデルは opencodex/<provider>/<model> として表示されます。後でプレーン opencode を起動すると、以前とまったく同じように動作します。

ocx grok <status|exclude|include|set|clear|apply> ...

Grok Build モデル フェンスを管理および適用します。

クライアント設定のエクスポート

ocx export --client <opencode|pi|omp|hermes|openclaw|kimi|gajae|dsh|mcode|zcode|prime|aside|raycast|omo>

実行中のプロキシに接続するクライアント設定を出力します。このコマンドは、ベース URL、モデル一覧、およびクライアントに応じた認証情報参照または opencodex-loopback プレースホルダーを含む opencodex プロバイダーブロックを、選択したクライアントのネイティブ形式でシリアル化します。

プロキシが実行されている必要があります。このコマンドはライブ ポートを解決し、/api/models を読み取り、Codex が現在認識できるモデルのみを出力します。

旗	アクション
--client <opencode|pi|omp|hermes|openclaw|kimi|gajae|dsh|mcode|zcode|prime|aside|raycast|omo>	必須。クライアントの設定形式を選択します。
--json	構成 JSON のみを標準出力に出力するため、リダイレクトはバイト正確な出力をキャプチャします。 --out 書き込みメモを含むすべての診断は stderr に送られます。
--out <path>	設定を <path> に書き込みます。既存のファイルの置き換えを拒否します。
--force	--out が既存のファイルを置き換えることを許可します。

ocx export --client opencode                     # config plus destination, merge warning, and counts
ocx export --client pi --json > pi-models.json   # JSON document for a pipe or a diff
ocx export --client omp --out ./omp-models.yml    # native OMP YAML
ocx export --client opencode --out ~/opencodex-opencode.json

--json がない場合、選択したクライアントのネイティブ形式で生成された設定が先頭に続き、正規の宛先パス、マージ警告、クライアント固有の起動前ガイダンス、およびコンテキスト制限を省略する行数を含むモデル数が続きます (クライアントはこれらに対して独自のデフォルトを適用します)。

クライアント	正規の宛先	ダウンロードファイル名	環境変数
opencode	~/.config/opencode/opencode.json (設定すると XDG_CONFIG_HOME が勝ち)	opencode.json	OPENCODEX_OPENCODE_API_KEY
pi	~/.pi/agent/models.json (PI_CODING_AGENT_DIR が設定時に優先。相対値は拒否されます)	pi-models.json	なし - ブロックにリテラル opencodex-loopback が入ります
omp	~/.omp/agent/models.yml (デフォルト。空の場合も OMP_PROFILE が PI_PROFILE より優先されます)	omp-models.yaml	なし - リテラル opencodex-loopback
hermes	~/.hermes/config.yaml	hermes-config.yaml	OPENCODEX_HERMES_API_KEY
openclaw	~/.openclaw/openclaw.json	openclaw.json5	OPENCODEX_OPENCLAW_API_KEY
kimi	~/.kimi-code/config.toml	kimi-config.toml	なし - loopback placeholder
gajae	~/.gjc/agent/models.yml	gajae-models.yaml	OPENCODEX_GAJAE_API_KEY
dsh	$DSH_HOME/settings.yaml（既定 ~/.dsh/settings.yaml）	settings.yaml	なし — 秘密ではないループバック bearer プレースホルダー
mcode	~/.minimax/config.yaml (MINIMAX_DATA_DIR、次に旧 MAVIS_DATA_DIR が設定時に優先。相対値は拒否されます)	mcode-config.yaml	なし — loopback placeholder
zcode	~/.zcode/v2/config.json (ZCODE_DATA_DIR が設定時に優先。相対値は拒否されます)	config.json	なし — loopback placeholder
prime	~/.prime/agent/models.json (PRIME_AGENT_CODING_AGENT_DIR が設定時に優先。相対値は拒否されます)	prime-models.json	なし — loopback placeholder
aside	~/.aside/u/<account>/models.json。Aside 自身の accounts.json が現在のアカウントとして指す account を使います。マニフェストが読めない場合は、既定のアカウントに落とさず拒否します	aside-models.json	なし — loopback placeholder
raycast	~/.config/raycast/ai/providers.yaml (macOS と Windows で同じ。Raycast は XDG_CONFIG_HOME を尊重しません)	raycast-providers.yaml	なし — loopback のみ。api_keys エントリは書き込まれません
omo	~/.omo/agent/models.json (OMO_CODING_AGENT_DIR、次に SENPI_CODING_AGENT_DIR、次に PI_CODING_AGENT_DIR の順で設定時に優先。相対値は拒否されます)	omo-models.json	なし — loopback placeholder

Raycast のエクスポートは、providers シーケンスに id: opencodex 要素を 1 つだけ持つ独立した providers.yaml 文書です。内容は name: OpenCodex、プロキシの /v1 ベース URL、および abilities 付きのルーティング済み全モデルです (tools と system_message は常にサポート、vision はカタログの入力モダリティから、reasoning_effort はモデルに effort ラダーがある場合、temperature は推論モデルではオフ)。Custom Providers は Raycast Pro の機能で、Raycast はこのファイルを監視しているため、保存した変更は再起動なしで反映されます。形式は manual.raycast.com/ai/custom-providers に記載されています。api_keys エントリは書き込まれないため、このエクスポートは loopback 専用で、loopback 以外のバインドは拒否されます。

opencode は {env:OPENCODEX_OPENCODE_API_KEY} を補間します。opencodex が生成する Pi のエクスポートには環境変数が不要で、リテラルのプレースホルダー opencodex-loopback が入ります。この値は必須です。Pi はモデル リストを構築する際に apiKey を解決し、既存の設定に未設定の環境変数参照がある場合はプロバイダー全体を隠すためです。ループバックでは、生成されたプレースホルダーをプロキシが検査することはありません。

マージし、決して置き換えないでください

ocx export は実際のクライアント設定を書き込むことはありません。宛先は手動でマージできるように出力されます。--out は、--force なしで既存のファイルを上書きすることを拒否します。これは、設定を置き換えると、その中にすでに含まれている他のプロバイダー、エージェント、および MCP エントリが破壊されるためです。

キーはシリアル化されません。生成される設定には、文書化された環境参照か、秘密ではないループバック用プレースホルダーのいずれかが入ります。ループバック プロキシ (127.0.0.1、デフォルト) にはアドミッション キーはまったく必要ありません。プロキシがループバックを超えてバインドする場合は、対応する OPENCODEX_OPENCODE_API_KEY、OPENCODEX_HERMES_API_KEY、または OPENCODEX_OPENCLAW_API_KEY を設定します。OPENCODEX_GAJAE_API_KEY は gjc の provider 認証値を環境から渡しますが、remote admission header は送れないため、生成される gjc 統合はループバック専用のままです。アドミッションキーの発行方法については、リモートアクセス を参照してください。上流プロバイダー自体のキーは完全に別のものであり、プロバイダー ごとに構成されます。

同じペイロードが GET /api/client-config によって提供され、ダッシュボードの [API] タブにレンダリングされるため、CLI、API、および GUI は同じバイトを使用します。

ランタイムと構成

ocx system <status|settings|startup|diagnostics|sync|codex-app-server|codex-restart|update|codex-cli-update> ...

ヘッドレス ランタイムの設定、起動、同期、診断、更新を管理します。

ocx system codex-restart --yes は ocx sync --restart-codex と同じモジュールで Codex app-server を再起動し、デスクトップ アプリも完全に終了して再起動します。プロキシ自体が Codex アプリ内で動いている場合、完了できない引き渡しを約束せず、実行可能な案内とともに拒否します。

ocx system settings --stream-mode eager-relay

ocx system update は OpenCodex 自体を更新します。Codex CLI は次の独立した読み取り専用コマンドで検査します。

ocx system codex-cli-update check --json

check はパッケージレジストリに問い合わせず、設定済みのインストール候補について、秘匿化された実行ファイルの場所や所有権を示す根拠を含む来歴情報を、範囲を限定して検査します。公開ランチャー由来の信頼済みコンテキストが真正性を裏付けるのは候補のスナップショットだけであり、Codex が正常に実行されたことではありません。この単発コマンドは Codex を一切実行しないため、環境または永続化された状態から得た候補は報告対象にとどまります（managed: false、通常は selection_unattested）。selectionAttested は常に false です。JSON 出力には candidateAvailable、candidateVersion、candidateSource、selectionAttested: false が含まれます。Bun またはソースから直接起動するとランチャーの証明がないため、環境由来および永続化された候補を無視し、POSIX では candidate_unavailable を報告することがあります。Windows では、この最初のスライスは候補や構成のパスに対するファイルシステム I/O を一切行いません。信頼済みランチャーが取り込んだ絶対パスの環境候補だけを、アプリ同梱またはバージョンマネージャーとして字句的に報告でき、それ以外の Windows 候補はすべて失敗時閉鎖になります。このスライスは永続化された選択状態を一切読み取らないため、環境候補がキャプチャされていない Windows 実行では candidate_unavailable ではなく windows_inspection_deferred を報告します。コマンドは Codex CLI が導入されているかどうかを観測できないので、候補が存在しないと断定せず、検査が延期されたことを報告します。このコマンドは Codex やパッケージマネージャーの実行、shim の修復、設定やキャッシュ状態への書き込み、プロセスの停止、インストールを行いません。アプリ同梱、認識済みのバージョンマネージャー、未検証のスタンドアロン、曖昧な shim の各候補は管理対象外または不明として報告され、管理対象と判定されることはありません。

Windows で CODEX_CLI_PATH=codex のような単純なコマンド名、リモートパス、デバイスパスが候補としてキャプチャされた場合は、candidate_path_unavailable を報告します。候補は取得されていますが、そのパスはこの検査の対象になりません。

ocx config <show|get|set|unset|validate|export|import> ...

検証された OpenCodex 設定を検査し、安全に変更します。 show および get はシークレットをマスクします。インポートは書き込む前に検証され、--yes が必要です。