プロバイダー

プロバイダーは一つの上流 LLM エンドポイントとそこへの到達方法を合わせたものです: アダプター、ベース URL、認証モード、そしてオプションのモデル一覧で構成されます。プロバイダーは ~/.opencodex/config.json の providers の下にあります。

OpenAI アカウントモード

プロバイダー ID	用途	認証情報/アカウットルール
`openai`	Codex ログイン	Pool(デフォルト)はメイン + 追加アカウントを選び、Direct は現在の caller/メインログインのみを使います。
`openai-apikey`	OpenAI API	設定された API キー/キープールのみを使い、Codex アカウントは読みません。

bare gpt-5.6-sol は Providers ページの Pool/Direct オプションに従い、 openai-apikey/gpt-5.6-sol は API を選択します。認証情報経路間のフォールバックはありません。API は context 922,000 / max input 922,000 で *-pro virtual ID は公開状態を維持し、wire でベースモデルと reasoning.mode: "pro" に切り替わります。

組み込み openai が欠落または無効な場合、ダッシュボードの Accounts ピッカーと Codex Auth から復元できます。欠落行は正規プリセットから作成され、正規の無効行は保存済みのモードやモデル設定を置き換えずに再有効化され、非正規の openai 行にはその復元経路は出ません。

プロバイダー概要のプール容量

Codex login を Pool モードで使うと、Providers の概要には任意の 1 アカウントではなく、プール全体の使用済み容量の推定値が表示されます。同じ行には現在の有効アカウントの生のクォータ使用率も表示されるため、プールの推定値と次のリクエストで使われるアカウントの状態を区別できます。

リセット情報がある場合は、次のリセット時刻と、その時点で回復するプール容量が表示されます。 対象範囲が不完全という警告は、プランやクォータが不明、読み取りが古い、アカウントが一時停止中、または再認証が必要などの理由で、安全に推定へ含められないアカウントがあることを示します。

期間別の対象範囲が一部不完全という警告は、含まれるアカウントの一部が、表示中のクォータ期間のうち一部だけを報告したことを示します。概要では各期間を分けたまま、影響を受ける期間を個別に不完全と表示し、欠けた値をその期間の使用量として扱いません。

この推定値は表示専用です。アカウント選択、セッション affinity、自動切り替え、cooldown、その他のルーティング判断には影響しません。個別アカウントの状態とルーティング設定は Codex Auth のアカウントプールを参照してください。

出荷版 v1 config は marker 2 の単一オプション行に自動移行されます。オリジナルは ~/.opencodex/config.json.pre-openai-tiers-v2.bak に一度保存され、次のコマンドで復元します: cp ~/.opencodex/config.json.pre-openai-tiers-v2.bak ~/.opencodex/config.json。

認証モード

プロバイダー設定で使える authMode は 3 種類で、デフォルトは key です。組み込みレジストリはローカルプリセットを別に分類します。ローカルプリセットでは通常 authMode と apiKey を両方使いません。

`authMode`	認証方式	用途
`key`	API キーを送信します(`Authorization: Bearer …`、またはアダプターにより `x-api-key` / `api-key`)。キーはリテラルまたは `${ENV_VAR}` 参照です。	大半のプロバイダー。
`forward`	受け取った Codex 認証ヘッダーをプロバイダーにそのまま中継します — キーを保存しません。ChatGPT ログインのパススルーです。	OpenAI(`openai-responses` アダプター)。
`oauth`	保存された OAuth アクセストークンを読み込み bearer キーとして使い、期限切れ前に自動更新します。	xAI、Anthropic、Kimi、Kiro、Google Antigravity、Cursor、Command Code、GitHub Copilot、Nous Portal。

retryOn429（同一キーでの 429 リトライ）は API キープロバイダー（authMode: "key"）のみに適用されます。OAuth・forward・ローカルプリセットは除外されます — 同じトークンを再送すべきではなく、ローカルランタイムには保存すべきリモートキーがありません。オプトインです: オプションが無ければ無効、オブジェクトがあれば enabled: false でない限り有効です。

1. ChatGPT ログイン(forward / パススルー)

デフォルトプロバイダーはAPI キー不要です。既存の codex login の認証情報を OpenAI Responses バックエンドにそのまま転送します:

{
  "openai": {
    "adapter": "openai-responses",
    "baseUrl": "https://chatgpt.com/backend-api/codex",
    "authMode": "forward"
  }
}

厳選されたヘッダーセットのみ転送されます(FORWARD_HEADERS: authorization、ChatGPT アカウント ID、 OpenAI beta/originator/session — アダプター参照)。この経路はウェブ検索とビジョンのサイドカーを動かす経路でもあります。

ChatGPT パススルーカタログには GPT-5.6 Sol/Terra/Luna の名前空間なしスラッグ (gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna)も含まれます。実際の呼び出し可否はアカウント権限に依存します。

2. アカウントログイン(OAuth)

プロバイダープリセットはアカウントログインを使えます。実験的な非公式デバイスフローブリッジ経由の GitHub Copilot もその一つです。認証情報は ~/.opencodex/auth.json に保存され、自動更新されます。ocx login codex も受け付けますが、これは上記のプロバイダーではありません。 Codex アカウントプールのログイン (ocx account login codex と同じフロー) に転送されます。プールは独自の台帳を持ち、この経路はプロキシの起動を必要とします。chatgpt と openai は同じ経路の別名です。

ocx login xai          # xAI Grok
ocx login anthropic    # Anthropic Claude (Pro/Max)
ocx login kimi         # Moonshot Kimi
ocx login nous         # Nous Portal (デバイスグラント; 無料 + 有料モデル)
ocx login kiro         # kiro-cli 認証情報の取り込み(トークンフォールバック対応)
ocx login google-antigravity
ocx login cursor       # Cursor 専用 PKCE ログイン
ocx login command-code # Command Code のブラウザ OAuth (または ~/.commandcode/auth.json を取り込み)
ocx login devin       # Cognition/Devin: Devin CLI の資格情報を優先インポート、なければ Auth0 ブラウザサインイン
ocx login dsh-account # DeepSeek Harness Desktop (~/.dsh/.credentials.yaml の許可を取り込み)
ocx login github-copilot  # GitHub デバイスフロー → Copilot トークン (Copilot Pro/Business)
ocx login codex        # Codex アカウントプール (別名: chatgpt, openai / プロキシの起動が必要)
ocx logout <provider>

プロバイダー	アダプター	ベース URL	備考
`xai`	`openai-chat`	`https://cli-chat-proxy.grok.com/v1`	OAuth は独立した Grok CLI サブスクリプションゲートウェイを使用します。API キーのオーバーライドは `https://api.x.ai/v1` を使用し、Priority Processing を注入する場合があります。ライブ一覧を優先し、フォールバックのデフォルトモデルは `grok-4.5`。
`anthropic`	`anthropic`	`https://api.anthropic.com`	Claude モデル; ライブモデル一覧は `/v1/models` から取得。
`kimi`	`openai-chat`	`https://api.kimi.com/coding/v1`	Kimi Code のモデル。`kimi-for-coding` は現在 K2.8 Preview を指し、100 万トークンのコンテキスト、`low`/`high`/`max` の推論、テキストと画像入力に対応します。`k3-256k` の上限は固定で 256K です。
`kimi-responses`	`openai-responses`	`https://api.kimi.com/coding/v1`	`kimi` と同じ OAuth ログインとモデル一覧を Responses 方式で使用します。推論内容はサーバー側で暗号化されたままですが、ツール呼び出しと結果は確認できます。
`nous`	`openai-chat`	`https://inference-api.nousresearch.com/v1`	Nous Research サブスクリプションゲートウェイ（Hermes Agent と同じバックエンド）。`portal.nousresearch.com` へのデバイスグラントログイン; access トークンはリクエストごとの inference JWT。有料 + `:free` モデルの混在カタログ（`tencent/hy3:free`、`stepfun/step-3.7-flash:free` など）はサインイン中のアカウントからライブ探索されます。Refresh トークンは単回使用で、更新のたびにローテーションされます。
`kiro`	`kiro`	`https://runtime.us-east-1.kiro.dev`	初回ログインは、インストール済みでサインインした `kiro-cli` セッションを取り込みます（Unix では `curl -fsSL https://cli.kiro.dev/install` \| `bash`、Windows PowerShell では `irm 'https://cli.kiro.dev/install.ps1'` \| `iex` でインストールしてから `kiro-cli login` を実行）。アカウントを追加は `kiro-cli` をログアウトして新しいブラウザログインを開始し、`kiro-cli` 自体のアカウントを切り替えてアカウント別プロファイルメタデータを保存します。既存の OpenCodex アカウントは保持され、キャンセルまたは失敗時には以前の `kiro-cli` セッションが復元されます。
`google-antigravity`	`google`	`https://daily-cloudcode-pa.googleapis.com`	Google OAuth を Cloud Code Assist wire で使用。ライブ探索は認証済みの CCA `v1internal:fetchAvailableModels` エンドポイントを使用し、ログイン中のアカウントで利用可能な agent モデルのみを公開します。管理されたカタログはフォールバックとして残ります。
`cursor`	`cursor`	`https://api2.cursor.sh`	実験的 PKCE ログイン、HTTP/2 トランスポート、アカウント別モデル探索をサポート。
`devin`	`devin`	`https://server.codeium.com`	実験的な非公式 Cognition/Devin ブリッジ。ログインはまず、インストール済み Devin CLI が保持する認証情報を取り込みます（`devin auth login` が `devin-session-token` を自身の `credentials.toml` に書き込みます）。なければ Auth0 のブラウザサインインを開き、貼り付けたトークンを `RegisterUser` で長期 API キーに交換します。`ocx login devin-cli` は非推奨エイリアスとして引き続き使えます。モデル一覧は `GetCascadeModelConfigs` でアカウントごとに取得し、ストリーミングは Connect-RPC 上の `runTurn` 経路のみを使います。ダッシュボードのプリセットには既定で含まれません。
`dsh-account`	`dsh-account`	`https://api.deepseek.com/anthropic`	実験的なインポート優先アカウントプロバイダー。インストールおよびサインイン済みの DeepSeek Harness (DSH) Desktop アカウントを再利用します。明示的なインポート時に `~/.dsh/.credentials.yaml` から厳格に読み取り専用で資格情報を読み込みます。DeepSeek API キー課金とは完全に独立しています。
`github-copilot`	`openai-chat`	`https://api.githubcopilot.com`	実験的。GitHub デバイスフロー + `copilot_internal` 交換（VS Code OAuth クライアント）。有効な Copilot サブスクリプションが必要で、公式のサードパーティ API ではありません。

Google Antigravity のアカウント・プロバイダーのクォータ確認は、モデル一覧へのフォールバックも含め、固定の Google エンドポイントを使用します。その宛先では透過 Fake-IP DNS に対応し、TLS 検証、リダイレクト拒否、プライベートアドレス検査を維持します。カスタム base URL はモデル要求にのみ適用されます。NO_PROXY は直接接続のポリシーを維持します。

Google ツールスキーマ損失診断

Google のツール宣言は、選択されたエンドポイントクラスに合わせてコンパイルされます。 ocx debug provider on、ダッシュボードの Logs トグル、または OCX_DEBUG=1 でプロバイダーデバッグを有効にすると、ポリシーの省略時または compatible の互換性変換でのスキーマ損失は [ocx:google:google-tool-schema-loss] レコードを出力します（ocx debug provider logs -f で追跡できます）。レコードに含まれるのは、レポートのバージョン、エンドポイントクラス、 lossy インジケーター、判定不能な比較の上限付き件数、上限付き件数を伴う固定の損失カテゴリ、切り詰めフラグだけです。ツール名、プロパティ名、パス、値、スキーマ本文は含まれません。ポリシーの省略時または compatible では変換を拒否せず観測します。reject-lossy では、初期コンパイルに損失がある場合、または上限付き比較が判定不能な場合、送信前に拒否します。拒否されたリクエストに別の損失レコードは出力されません。reject-lossy では、制約を消す Vertex または Cloud Code Assist の修復は同様に内容を含まない google-tool-schema-repair を出力し、変更送信を行わず元の 400 を返します。ポリシーの省略時または compatible では、修復済みリクエストを従来どおり再送します。直接 AI Studio はこの修復を行いません。ネイティブ出力スキーマは両方のポリシー経路の対象外です。デバッグコマンドのリファレンスも参照してください。

Nous の refresh が終端失敗した場合は、再認証に ocx login nous を実行してください。

正規の Kimi Coding Plan プリセット（kimi アカウントログインと kimi-code API key）では、 opencodex は呼び出し元が指定した安定した prompt_cache_key だけを Chat Completions リクエストへ転送し、自ら生成しません。Kimi のドキュメントでは、Code Plan のキャッシュヒット率を高めるために安定したセッション/タスク key が必須とされています。key のないリクエストは keyless のままです。 opt-in した上流がこのフィールドを拒否しても、opencodex はフィールドを削除して再試行したり、保存済み設定を変更したりしません。他のプロバイダーは deny-by-default のままです。

kimi、kimi-code、kimi-responses の k3、k3[1m]、k3-256k に表示する料金は、デフォルトの 5 分間キャッシュ書き込み料金を含む API 価格に基づく推定値です。Code Plan の請求額や割り当て量を示すものではありません。1M 版の K3 は k3-256k の約 2 倍の割り当て量を消費します。kimi-for-coding は K2.8 Preview に切り替わったため、旧 K2.7 の料金は適用されません。ユーザーが modelCosts を指定しない限り推定料金は不明のままで、不明な料金を除外するルーティング規則では選択対象から外れることがあります。

ウェブダッシュボードからも OAuth を開始できます。

複数の OAuth アカウント

認証情報に固定アカウント ID やメールがある OAuth プロバイダーはログインを複数保持できます。 Providers ページでアカウントを追加し、別アカウントをログアウトせずにアクティブアカウントだけを切り替えられます。アカウント識別情報がない Kimi 認証情報は通常のログインではアクティブスロットを差し替えますが、明示的な アカウントを追加 では既存スロットを保持し、別の新しいスロットをアクティブにします。Kiro アカウントはプロファイル ARN をキーに保存されます。 chatgpt は Codex アカウントプールに別の保存場所があり、常に単一スロットのみ書き込みます。トークンは ~/.opencodex/auth.json に保存され、 /api/oauth/accounts はマスク済みメタデータのみを返します。

Cockpit Tools Antigravity のインポート

v1 で OpenCodex がインポートできるのは、google-antigravity プロバイダー向けの Cockpit Tools Antigravity JSON エクスポートのみです。Providers ダッシュボードでそのプロバイダーの Accounts タブを開き、ローカル JSON ファイルを選択します。ダッシュボードはファイル内容や認証情報の値を表示せず、インポート、更新、失敗、未対応の件数だけを表示します。他の Cockpit プロバイダーは v1 では未対応です。

CLI はファイルまたは標準入力からのみエクスポートを受け取り、コマンド引数への貼り付けはできません。

ocx account import google-antigravity --format cockpit-tools --file <path> [--json]
cat accounts.json | ocx account import google-antigravity --format cockpit-tools --stdin [--json]

インライン JSON と余分な位置引数は拒否されます。エクスポートファイルは非公開に保ち、インポート後は削除するか安全に保管してください。

Kiro 認証情報の取り込み

Kiro のログインには Kiro CLI が必要です。Unix では curl -fsSL https://cli.kiro.dev/install | bash、Windows PowerShell では irm 'https://cli.kiro.dev/install.ps1' | iex でインストールしてから、先に kiro-cli login でサインインしてください。kiro-cli セッションがない場合、ocx login kiro は貼り付けたアクセストークンまたは KIRO_ACCESS_TOKEN 環境変数にフォールバックします。

通常の ocx login kiro 取り込みは CLI の SQLite データベースを読み取り専用で開き、データベース、WAL、SHM を変更しません。

KIROCLI_DB_PATH は標準外の Kiro CLI SQLite データベースを選択します。指定するデータベースは既に存在している必要があります。
KIROCLI_TOKEN_KEY は複数の曖昧なトークン行がある場合に、取り込む正確な auth_kv 行のキーを指定します。選択がない場合、推測せずログインに失敗します。

取り込んだ認証情報は ~/.opencodex/auth.json に保存されます。アカウントを追加のロールバックは別処理で、以前のスナップショットを復元する際にデータベースを置き換え、現在の WAL、SHM、journal サイドカーを削除します。

ロールバックはスナップショットがある場合にのみ可能なため、セッションストアが存在するのに取得できない場合（ファイルが読めない、スキーマの不一致、トークン選択があいまい）、KIROCLI_DB_PATH / KIRO_CLI_DB_FILE が実際の CLI ストアと異なるインポート先を指す場合、またはプライマリ CLI データベースに認識できるトークン行がない場合、アカウントを追加は kiro-cli のログアウトを拒否します。通常の kiro-cli データパス上の壊れたデータベースを修復または削除し、インポート専用セレクタが設定されていれば解除してから再試行してください。既存の kiro-cli セッションがまったくない環境には影響しません。

DeepSeek Account (DSH)

dsh-account は、インストールおよびサインイン済みの DeepSeek Harness (DSH) Desktop アプリケーションの認証済みアカウント資格情報を再利用する、実験的なインポート優先アカウントプロバイダーです。

DeepSeek API キーから独立: dsh-account はユーザーの認証済み DeepSeek セッションクォータ（通常/ボーナスウォレット残高および総支出）を使用しますが、deepseek プロバイダーはプラットフォーム API キー残高から課金されます。この2つの資格情報ドメインおよびルーティングは厳格に分離されており、相互にフォールバックすることはありません。
明示的インポートのみ: OpenCodeX は DeepSeek Harness がインストールされサインインされているか（~/.dsh/.credentials.yaml）を検出しますが、ユーザーの明示的な操作（ocx login dsh-account または Web ダッシュボードでのインポートクリック）なしにトークンを自動的にコピー、インポート、または使用することはありません。
DSH 資格情報ストアへの読み取り専用: OpenCodeX は ~/.dsh/.credentials.yaml を厳格に読み取り専用として扱います。OpenCodeX が DeepSeek Harness に属するファイルの書き込み、変更、削除、またはアクセス権の変更を行うことは決してありません。
隔離された資格情報の複製とログアウト: インポート時、OpenCodeX は DeepSeek の信頼できる認証エンドポイント（/auth-api/v0/users/current）に対してトークンを検証し、OpenCodeX 認証ストアに独自の複製を保存します。OpenCodeX でアカウントをログアウトまたは削除しても、OpenCodeX のローカル複製が削除されるだけであり、上流のリモートセッションログアウトがトリガーされたり、DeepSeek Harness Desktop からサインアウトされたりすることはありません。
バックグラウンドトークン自動ローテーションなし・401 時の再インポート: DSH セッショングラントには自動バックグラウンド更新エンドポイントがありません。上流から HTTP 401（ACCOUNT_TOKEN_INVALID）が返された場合、OpenCodeX はアカウントを needsReauth としてマークし、ルーティングを停止します。アクセスを再開するには、ユーザーが ocx login dsh-account で明示的に再インポートする必要があります。
サードパーティ免責事項: OpenCodeX は、サードパーティクライアントによるセッショングラントの再利用について、DeepSeek 公式からの承認や保証を主張するものではありません。

3. API キーカタログ

opencodex には組み込みプリセットが 104 個含まれています。キー方式 84、OAuth 16、ローカル 3、デフォルト ChatGPT 転送プリセット 1 です。ダッシュボードの Add provider ピッカーはキー発行ページを開き、入力したキーを検証した後保存します(検証はプロバイダー固有です)。主な項目は以下のとおりです:

ClinePass は Cline API キーで公式サブスクリプションカタログと Chat Completions エンドポイントに接続します。運営主体は Cline の利用規約に記載された Cline Bot Inc. です。cline-pass/cline-pass/kimi-k3 のようなルーティング ID は意図した形式です。先頭は opencodex のプロバイダー、残りの cline-pass/kimi-k3 は upstream に送信する完全なモデル slug です。使用量はアカウントのローリング 5 時間、週次、月次の各上限で共有されます。 2026-08-13 の実機検証で、すべての静的 ClinePass モデルが gateway input で low、medium、high、xhigh、max を受け付けることを確認しました。 opencodex は要求された tier をそのまま保持し、バックエンド固有の正規化は ClinePass 側に委ねます。

Cline は同じ API キー・エンドポイントを従量課金で使い、100 以上のモデルにアクセスできます (OpenRouter 形式の ID、例: anthropic/claude-sonnet-4-6)。Cline の期間限定無料モデルは Cline IDE/CLI のみで API からは使えません。minimax/minimax-m2.5 は API で利用できる無料試用モデルとして文書化されています。

プロバイダー	ベース URL
OpenAI (API キー)	`https://api.openai.com/v1`
Anthropic (API キー)	`https://api.anthropic.com`
OpenRouter	`https://openrouter.ai/api/v1`
Cline	`https://api.cline.bot/api/v1`
ClinePass	`https://api.cline.bot/api/v1`
Ollama Cloud	`https://ollama.com/v1`
Google Gemini · Google Vertex AI	`https://generativelanguage.googleapis.com` · `https://aiplatform.googleapis.com`
Azure OpenAI	`https://{resource}.openai.azure.com/openai`
Umans AI · Neuralwatt	`https://api.code.umans.ai` · `https://api.neuralwatt.com/v1`
Mistral	`https://api.mistral.ai/v1`
MiniMax · MiniMax (CN)	`https://api.minimax.io/v1` · `https://api.minimaxi.com/v1`
DeepSeek	`https://api.deepseek.com`
Cerebras	`https://api.cerebras.ai/v1`
Chutes	`https://llm.chutes.ai/v1`
DeepInfra	`https://api.deepinfra.com/v1/openai`
Hyperbolic	`https://api.hyperbolic.xyz/v1`
Nscale Serverless Inference	`https://inference.api.nscale.com/v1`
Vultr Serverless Inference	`https://api.vultrinference.com/v1`
Baseten Model APIs	`https://inference.baseten.co/v1`
Command Code	`https://api.commandcode.ai/provider/v1`
SambaNova Cloud	`https://api.sambanova.ai/v1`
Nebius Token Factory	`https://api.tokenfactory.nebius.com/v1`
Crusoe	`https://api.inference.crusoecloud.com/v1`
DigitalOcean Serverless Inference	`https://inference.do-ai.run/v1`
Scaleway Generative APIs	`https://api.scaleway.ai/v1`
Featherless AI	`https://api.featherless.ai/v1`
Novita AI	`https://api.novita.ai/openai/v1`
Together	`https://api.together.xyz/v1`
Fireworks	`https://api.fireworks.ai/inference/v1`
Moonshot (Kimi API) · Kimi (coding)	`https://api.moonshot.ai/v1` · `https://api.kimi.com/coding/v1`
Hugging Face	`https://router.huggingface.co/v1`
NVIDIA NIM	`https://integrate.api.nvidia.com/v1`
Z.AI (GLM Coding)	`https://api.z.ai/api/coding/paas/v4`
Zhipu AI (BigModel)	`https://open.bigmodel.cn/api/paas/v4`
BigModel Coding Plan — Responses (静的モデル一覧)	`https://open.bigmodel.cn/api/v1`
Qwen Cloud	トークンプラン(デフォルト): `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` · 従量課金: `https://dashscope.aliyuncs.com/compatible-mode/v1` · またはカスタム
Tencent Cloud Coding Plan	`https://api.lkeap.cloud.tencent.com/coding/v3`
SiliconFlow	`https://api.siliconflow.cn/v1`
Volcengine Ark · Coding Plan · Agent Plan	`https://ark.cn-beijing.volces.com/api/v3` · `https://ark.cn-beijing.volces.com/api/coding/v3` · `https://ark.cn-beijing.volces.com/api/plan/v3`
Xiaomi MiMo	`https://api.xiaomimimo.com/anthropic`
Xiaomi MiMo (OpenAI Chat)	`https://api.xiaomimimo.com/v1`
Kilo	`https://api.kilo.ai/api/gateway`
OpenGateway	`https://apis.opengateway.ai/v1`
GitLab Duo	`https://cloud.gitlab.com/ai/v1/proxy/openai/v1`
Cloudflare AI Gateway	`https://gateway.ai.cloudflare.com/v1/{account-id}/{gateway}/anthropic`
…その他多数	opencode zen、Vercel AI Gateway、Venice、NanoGPT、Synthetic、Qianfan、Alibaba、Parallel、ZenMux、LiteLLM

OpenGateway は Sionic AI が運営する OpenAI 互換ゲートウェイです。Base URL は https://apis.opengateway.ai/v1 で、公開カタログには約 80 の active モデルがあります（2026-10-02 確認）。プリセットは公開 GET /v1/models から一覧を自動更新し、active な Chat Completions モデル（および Responses 専用で Responses にルーティングされる openai/o3-pro）を取得します。Sionic が提供する deepseek/deepseek-v4.1-flash-ultrafast と z-ai/glm-5.3-flash-ultrafast を先頭に表示します。 OpenGateway ダッシュボードでキーを作成し、 ocx provider add opengateway を実行するか、ダッシュボードで OpenGateway を選択してください。 Chat リクエストは設定済みの Bearer キーを使います。公開一覧はキーの有効性を検証しません。

OpenCode Zen（opencode-zen）は opencode.ai/auth の API キーで https://opencode.ai/zen/v1 を使用します。無料モデルは毎分約 15–20 リクエストの短時間レート制限に当たることがあります（コミュニティ計測。OpenCode は RPM を公表していません）。レート制限 429 に Retry-After がない場合、opencodex は案内と合成 Retry-After を追加し、有効な上流ヘッダーを優先します。同一キーの再試行は retryOn429 で有効にします。

正規の opencode-zen プロバイダーで API キー認証と公式ルート https://opencode.ai/zen/v1 または https://opencode.ai/inference/v1 を使用すると、Gemini は既定の googleMode: ai-studio で Google ネイティブ API を自動的に使用します。Zen のモデル ID は、-tiered 接尾辞のない Flash ID もそのまま保持します。Claude は googleMode に関係なく Anthropic Messages を使用します。保存済み設定の読み込み時、これらのネイティブモデルの適格な旧 Chat/Responses オーバーライドと、適格な Responses 専用 image_generation ホストツール設定のみを無視します。カスタムプロバイダー、キー認証以外のルート、その他の設定は変更しません。

opencode-free のサポートは削除されました。 OpenCode の上流無料枠の制限により、すべてのモデルが 403 permission_denied を返すためです（#7255）。既存設定の読み込み時は該当項目と依存するモデル参照をメモリ上で無効にし、プロセスごとに一度警告します。ファイルは変更しません。既定のプロバイダーだった場合、標準の OpenAI OAuth 経路を既定にします。opencode-go、API キー付きの opencode-zen、または別のプロバイダーを使用してください。OpenCode Zen 規約。

正常な Claude Desktop の割り当てと既定値は保持されます。ソースモデルの許可リストが空になるルールは無効になり、注入モデルが削除された場合はネイティブサブエージェント同期も無効になります。その後の設定保存では、削除済み参照を復元せず、正常な同時編集を保持します。

大半は bearer キーと共に openai-chat アダプターを使い、Xiaomi MiMo（xiaomi）などの Anthropic 互換プリセットは anthropic アダプター（x-api-key）を使います。Xiaomi には OpenAI Chat プリセットの xiaomi-mimo とトークンプランのプリセット mimo もあります。 3 つともデフォルトは MiMo V2.6（mimo-v2.6-pro、xiaomi-mimo では mimo-v2.6-flash）です。 Xiaomi は 2026-10-21 に mimo-v2.5 と mimo-v2.5-pro をリダイレクトなしで廃止するため、保存済みの V2.5 デフォルトはそれまでに切り替えてください。opencodex は自動で書き換えません。 Volcengine Coding Plan と Agent Plan は openai-responses アダプターでネイティブ Responses エンドポイントを使用します。検証済みの Ark Coding Plan のツール継続では、前のターンが返した Responses の reasoning item をそのまま返すと 400 InvalidParameter になるため、Coding Plan プリセットは継続入力を転送する前にその item を取り除きます。そのターンの reasoning 状態は失われるので、dropResponsesReasoningItems: false で無効にできます。すでに openai-chat で保存されている Coding Plan の設定は書き換えられず Chat のままです。切り替えるときは adapter を openai-responses に、responsesPath を /responses に手動で変更するか、プリセットを削除して追加し直してください。

Volcengine の 3 つの課金経路: volcengine は従量課金 Ark API、 volcengine-coding-plan は Coding Plan の割り当て、volcengine-agent-plan は Agent Plan の割り当てを使用します。同じ製品で発行されたキーとエンドポイントを組み合わせてください。 Plan 契約があっても通常の /api/v3 呼び出しには従量課金が発生する場合があります。 3 つの preset は選別済みの静的モデルカタログを使用します。Ark の /models はテキストに加えて Embedding、画像、動画、3D リソースも返し、Coding ゲートウェイも同じ広範なカタログを返します。 Agent Plan ゲートウェイには /models リソースがありません。従量課金のデフォルトは doubao-seed-2-1-pro-260628 で、静的カタログには現在の DeepSeek と GLM のテキストモデルも含まれます。Coding Plan のデフォルトは ark-code-latest、Agent Plan は deepseek-v4-flash です。

Chutes の discovery: chutes preset は Chutes の固定された共有 OpenAI 互換 LLM gateway を使います。公開 /v1/models catalog から supported_features が tools を示す行だけを残し、スラッシュを含む model id と安全な live metadata を保持します。discovery は 256 KiB と raw 128 行に制限されます。 catalog は公開されているため、入力したキーの有効性は証明できませんが、chat request は設定済みの Bearer キーで認証されます。ユーザーが deploy した custom Chute host と LLM 以外の API は custom provider の範囲です。キーは Chutes dashboard で作成します。

DeepInfra の discovery: キー方式の OpenAI Chat Completions プロバイダー deepinfra は、 openai-chat アダプターと Bearer API キーを使います。registry が所有する DeepInfra のモデル一覧 URL から chat タグを持つ行だけを残し、スラッシュを含むネイティブモデル ID を保持します。live discovery は 512 KiB、raw 512 行に制限します。キーは DeepInfra dashboard で作成します。

Hyperbolic の discovery: preset は設定済みの bearer キーで /v1/models を読み、スラッシュを含むネイティブモデル ID を保持し、live discovery を 256 KiB と raw 256 行に制限します。serverless text / vision-language chat のみを対象とし、別系統の image、audio、GPU endpoint は対象外です。キーは Hyperbolic で作成します。

Nscale と Vultr の discovery: どちらの preset も認証付き /v1/models カタログを読み、ネイティブ ID を保持し、discovery を 256 KiB と raw 256 行に制限します。Nscale のカタログには modality フィールドなしで chat、image、embedding が混在するため、公式の tool-calling API 例で使われる meta-llama/Llama-3.1-8B-Instruct のみを許可します。Vultr は現在 kimi-k2-instruct だけに tool calling を明記しているため、そのモデルのみを公開します。ほかの行は同等の agent-tool 証拠が公開されるまで非表示です。 Nscale の service token は Nscale Console で作成し、Vultr の inference key は Vultr Console の subscription overview から取得します。

Command Code の discovery: プリセットは固定の Provider API ホストから Command Code の /provider/v1/models リストを読み、プロバイダー固有のモデル ID を保持し、discovery を 256 KiB と raw 256 行に制限します。ocx login command-code はブラウザーでの OAuth サインインに対応し、既存の Command Code CLI ユーザーは ~/.commandcode/auth.json からローカルの資格情報を取り込むこともできます。モデルカタログはアカウント単位で、ログイン後に認証済みの discovery エンドポイントから取得します。Provider API プリセット（commandcode）は設定済みの有効なキーを送信します。大半のモデル ID には Bearer ヘッダーで Chat Completions を使いますが、claude-* の ID には x-api-key で Anthropic Messages を使います。Command Code がそれらを /provider/v1/messages でのみ提供するためです。別のエンドポイントに commandcode という名前を再利用したプロバイダーは、独自の通信方式を維持します。OAuth プリセット（command-code）は保存済みアカウントの bearer を使って認証付き discovery を行い、/alpha/generate からの生成を NDJSON としてストリーミングします。ゲートウェイがテキストとして返した MiMo のツール呼び出しマークアップは、実際の呼び出しと重複する場合に取り除きます。MiMo モデルでネイティブの呼び出しが存在しない完全な宣言済みツール呼び出しは、正常に終了した場合にのみ復元します。中断またはフィルターされたターンではマークアップをテキストのまま残します。Provider API キーは Command Code Studio で作成します。

Command Code の quota: ダッシュボードと ocx account refresh は、正規ホスト https://api.commandcode.ai 上の /alpha/billing/credits ウィンドウ（5時間と週次）を照会します。OAuth プリセット (command-code) は保存済みアカウント bearer を使い、Provider-API キープリセット (commandcode) は設定済みの有効キーを使います。ユーザーが編集した類似ホストは照会しません。期間支出が返る場合は、残りの monthly / purchased / free credits を USD ウィンドウとして表示します。

OrcaRouter のブラウザーログイン（ocx login orcarouter-oauth）では、キー交換の成功応答本文は 64 KiB 以下の有効な UTF-8 JSON である必要があります。このキー交換リクエストの既存の 30 秒制限には、応答ヘッダーと本文全体の受信が含まれ、サイズ超過または不正な本文はキーの保存前に拒否されます。この制限はログイン時のキー交換にのみ適用され、推論リクエストのペイロードを制限するものではありません。scope の検証規則は変わらず、省略は許可され、明示された不正な値は拒否されます。

SambaNova Cloud の discovery: preset は固定 API ホスト上の SambaNova Cloud の公開 /v1/models 一覧を読み、プロバイダー固有の ID を保持し、discovery を 128 KiB と raw 128 行に制限します。カタログは認証不要のため、 CLI の login flow は公開レスポンスをキーの有効性の証拠にせず、キーを検証不能として報告します。chat リクエストは引き続き設定済み Bearer キーを使い、SambaNova がまだ対応していない並列 function call は無効にします。非公開の SambaStudio deployment endpoint は対象外です。キーは SambaNova Cloud で作成します。

Nebius Token Factory の discovery: preset は認証付きの verbose モデルカタログを取得し、architecture が text を出力する行だけを残して embedding と image-generation モデルを除外します。スラッシュを含むネイティブ ID と、報告された context / input modality metadata を保持し、discovery を 512 KiB と raw 512 行に制限します。dedicated deployment のホストは対象外です。キーは Nebius Token Factory で作成します。

Crusoe の discovery: キー方式のプリセットは openai-chat adapter を使用し、Bearer key は Crusoe の固定 Serverless Inference host にだけ送信します。/v1/models は未認証リクエストを 401 で拒否するため、list の成功を key の検証として扱います。discovery は zai-org/GLM-5.3 や moonshotai/Kimi-K2.6 のようなスラッシュ区切りのネイティブ id を Crusoe が返すままに保持し、256 KiB と raw 256 行に制限します。is_public: true かつ architecture.modality が text または multimodal の row だけを残すため、アカウント専用のデプロイや embedding・メディア系の row は除外されます。reasoning model は思考内容を Chat Completions の reasoning field で返し、 adapter はこれを読み取ります。reasoning_effort のラダー（low、medium、high）を受け付けるのは openai/gpt-oss-120b のみで、他の reasoning model はこの field をオン/オフの切り替えとして扱うため、 provider 全体の effort ラダーと parallel tool call は宣伝しません。レート制限は project と model ごとに適用され（超過時は 429、共有 deployment のスケール中は 503）、新規アカウントには $5 の無料クレジットが付与されます。キーは Crusoe Cloud console の Intelligence Foundry > Inference で作成します。

DigitalOcean の discovery: preset は model access key を固定の共有 Serverless Inference ホストで使い、認証済み /v1/models の応答と DigitalOcean の公式ドキュメントで確認した Chat Completions allowlist の積集合だけを公開します。未知、Responses 専用、embedding、media generation の id は fail closed で除外し、 discovery を 256 KiB と raw 256 行に制限します。agent 固有 host と dedicated host は対象外です。キーは DigitalOcean Control Panel で作成します。

Scaleway の discovery: 認証済みモデル一覧と公式ドキュメントで確認した Serverless Chat Completions allowlist の積集合だけを公開します。未知、Responses 専用、embedding、transcription、その他の media-model id は fail closed で除外し、discovery を 128 KiB と raw 128 行に制限します。default Project の共有 endpoint を使用します。Project id 付き URL と dedicated deployment は custom provider で設定してください。 API キーは Scaleway console で作成します。

Featherless の discovery: 固定の OpenAI 互換ホストで認証し、chat と現在の plan に絞った人気順の先頭 100 model だけを取得します。各 row が plan で利用可能、Hugging Face gate なし、かつ features.tool_use: true と独立して報告しない限り fail closed で除外します。discovery は 128 KiB と raw 100 行が上限で、数万件の catalog 全体を download / cache しません。/v1/models は認証あり・なしの両方で呼び出せると文書化されているため、入力したキーの有効性は証明できませんが、chat request は設定済みの Bearer キーで認証されます。個人 plan は interactive / prototype 用途に限られ、任意の application には Scale plan が必要です。キーは Featherless dashboard で作成します。

Novita の discovery: キー方式のプリセットは openai-chat adapter を使用し、Bearer key は Novita の固定 OpenAI 互換 host にだけ送信します。公開 model list から model_type: chat と chat/completions endpoint の両方を報告する row だけを残し、discovery を 512 KiB と raw 256 行に制限します。catalog は公開されているため、login は list 成功を key の証明にせず「検証不能」と報告します。 model ごとに capability が異なるため、provider 全体の parallel tool call と OpenAI reasoning_effort は宣伝しません。キーは Novita key manager で作成します。

Baseten の対象範囲: このプリセットは Baseten の共有 Model APIs のみを対象とします。ローカル利用では個人の API キーを、共有/本番利用では Call Model APIs 権限を持つチームキーを使用してください。専用 Truss predict エンドポイントはホストとスキーマが異なるため、このプリセットではルーティングされません。このプリセットのライブディスカバリーは、レスポンス 1 MiB、モデルの生行 256 件が上限です。

A6API クレジットクォータ

openai-chat、authMode: "key"、正規の https://api.a6api.com または https://api.a6api.com/v1 を使うカスタムプロバイダーでは、ダッシュボードと ocx account refresh <provider> に A6API クレジット使用量が表示されます。プロバイダー名は任意です。アカウントの hard credit limit を基準にトークン単位を USD に換算し、使用率と残高を表示します。トークン期限は補充を意味しないため、クォータのリセットとしては表示しません。アクティブキーだけを正規ホストへ送信し、リダイレクトを拒否します。負数や整合しない請求合計からはレポートを生成しません。

Tencent Cloud Coding Plan の利用制限: Tencent はこのサブスクリプションを対話型コーディングツール専用としています。一般的な API 自動化、カスタムアプリのバックエンド、非対話型バッチ利用は禁止されており、プランキーが停止される場合があります。

GLM の課金経路: zai は Z.AI の国際コーディングプラン契約、zhipu-bigmodel は Zhipu の中国国内向け BigModel 従量課金エンドポイントです。ホストもキーも課金も別で、一方で発行したキーはもう一方では認証されません。

複数の API キー

キーベースのプロバイダーも複数キーを保持できます。Providers ページでキーを追加すると provider.apiKeyPool に保存してアクティブ化し、ルーティングとアダプターが以前と同じフィールドを読むように provider.apiKey にも反映します。同じドロップダウンでキーの切り替えや削除ができます。管理 API は /api/providers/keys でマスク済みキーのみを返します。

ターミナルでアカウントを切り替え

ダッシュボードを開かずに ocx account list、ocx account current、ocx account use で同じ Codex、 OAuth、API キープールを確認・切り替えできます。完全なコマンド、JSON 出力、新規セッション適用方式は CLI リファレンスを参照してください。

GPT-5.6 プレビュー経路

ライブモデルカタログの更新が遅れても ocx sync でモデルが消えないよう、GPT-5.6 Sol/Terra/Luna をフォールバックリストに入れています。

Codex 経路	事前登録されたモデル ID	Codex に表示されるコンテキスト
Codex ログイン(Pool または Direct)	`gpt-5.6-*`	922,000
OpenAI (API キー)	`openai-apikey/gpt-5.6-` と `-pro`	922,000 (max input 922,000)
OpenRouter	`openrouter/openai/gpt-5.6-sol`、`openrouter/openai/gpt-5.6-terra`、`openrouter/openai/gpt-5.6-luna`	922,000
Cursor	`cursor/gpt-5.6-sol`、`cursor/gpt-5.6-terra`、`cursor/gpt-5.6-luna`	1,000,000

ネイティブ GPT-5.6 項目は固定の上流推論段階に従います。例えば Luna には max はありますが ultra はありません。ルーティングモデルは各プロバイダーのメタデータと推論マッピングを使います。4 経路すべてで実際の利用権は上流アカウントが決定し、Cursor はライブ探索結果に基づき現在のアカウントで使えるモデルのみ残します。

プロバイダー対応可否は「エージェント」製品かどうかではなく、opencodex に合う wire アダプターがあるかで決まります。現在のアダプター ID は openai-chat、openai-responses、anthropic、google(AI Studio、 Vertex、Antigravity/Cloud Code Assist モード)、azure / azure-openai、kiro、cursor です。 Amazon Bedrock ネイティブ API のような、これらの実装のいずれにも合わない独自プロトコルは直接サポートしません。 GitHub Copilot と GitLab Duo は独自の汎用 OpenAI 互換エンドポイントにマッピングされたマルチモデルゲートウェイです。Copilot は ocx login github-copilot で GitHub デバイスフロー OAuth ログインをサポートします(非公式ブリッジ — VS Code 公開クライアント ID でログイン後、短期 Copilot API トークンに交換し、有効な Copilot サブスクリプションが必要で GitHub ポリシー変更でブロックされる可能性あり)。GitLab Duo は Bearer サブスクリプショントークン(通常の API キーではない)で認証します。Cloudflare AI Gateway は URL にアカウント + ゲートウェイ ID を埋める必要があります。

Copilot は混在 wire カタログを提供します。モデル（gpt-5.3-codex、gpt-5.4、 gpt-5.4-mini、gpt-5.5、gpt-5.6-luna、gpt-5.6-sol、gpt-5.6-terra、gpt-6-astra, grok-4.5, grok-4.6, mai-code-1.1-flash, mai-code-1-flash-picker）はエージェント通信の /chat/completions を拒否するため、opencodex はこれらのモデルを組み込みデフォルトで Responses API 経由にルーティングし、他の Copilot モデルはすべて chat completions のままです。優先順位は次のとおりです: ハード wire ピン → 明示的な modelAdapters エントリ → レジストリのデフォルト → プロバイダー全体の adapter。組み込みデフォルトのないモデル（例: gpt-5.4-nano）を Responses に移すには、"modelAdapters": { "gpt-5.4-nano": "openai-responses" } を設定してください。

Cursor は別の実験的アダプターとして追跡します。adapter: "cursor" は ocx init とダッシュボード Add Provider ピッカーに実験的 local config 項目として表示され、Cursor の静的フォールバックモデルカタログメタデータを保存します。Cursor アクセストークンを設定すると opencodex は Cursor ライブ HTTP/2 トランスポートを使います。バンドル済みフォールバックリストには 1M コンテキストの gpt-5.6-sol / terra / luna、500K コンテキストの Grok 4.5 / 4.6 / 4.7 の通常・Fast 行、262K コンテキストの kimi-k3 が含まれ、ライブ探索結果に基づき現在のアカウントに表示するモデルを決定します。Grok 4.6 と 4.7 は両形式で low / medium / high / xhigh を公開し、 4.5 は high までです。Grok 4.5 と 4.6 の Fast リクエストは、対応するベースモデルを独立した effort と fast=true の requested_model パラメータとともに送信します。これらの平坦化された cursor-grok-{version}-{effort}-fast id は探索と picker の識別子としてのみ使われます。Grok 4.7 は cursor- プレフィックスなしで一覧に表示され、grok-4.7-{effort}-fast を直接送信します。 Cursor は Kimi K3 を effort サフィックス付きの wire id としてのみ提供するため、cursor/kimi-k3 は low / high / max のラダーを公開し、既定値はモデルドキュメントの API 既定値と同じ max です。Cursor サーバーが直接送るネイティブ read/write/delete/ls/grep/shell/fetch 実行は Codex 承認とサンドボックス経路をバイパスするためデフォルトで無効です。信頼できるローカル実験でのみ ~/.opencodex/config.json の providers.cursor に unsafeAllowNativeLocalExec: true を設定してください。ダッシュボードからは Providers → Cursor → Edit JSON で設定できます。完全な例は設定リファレンスを参照してください。 MCP、画面録画、computer-use はエグゼキューターフックで開かれており、ローカルエグゼキューターがない場合はポリシー遮断ではなく typed no-executor 結果を返します。Cursor OAuth とライブモデルディスカバリはこの実験的アダプターで有効化されており、Cursor は引き続きキーログイン一覧には表示されません。

Ollama Cloud

Ollama Cloud はホステッド型(ローカルではない)Ollama です。https://ollama.com/v1 を設定し、キーは ollama.com/settings/keys で発行します。opencodex は OpenAI 互換サーフェスではなく Ollama 自身の REST API(POST /api/chat)で接続し、モデル一覧はプロバイダーから動的に取得するため、新しい Ollama Cloud モデルは設定変更なしで現れます。opencodex はクラウドラインナップをビジョン機能で分類し、ビジョンサイドカーがテキスト専用モデルにのみ動作するようにします。テキスト専用モデル(例: glm-5.2、deepseek-v4-flash、gpt-oss、qwen3-coder、 minimax-m2.x、nemotron-3-*)は noVisionModels に列挙され、ビジョンネイティブモデル(例: kimi-k2.6、minimax-m3、gemma4、qwen3.5、gemini-3-flash-preview)は含まれません。マッチングは Ollama の :size タグに寛容なので gpt-oss は gpt-oss:120b と gpt-oss:20b の両方を含みます。

Ollama は現在、構造化出力は Ollama Cloud では未対応であるとドキュメントしています。正規の ollama-cloud に対する構造化出力リクエスト（text.format）は、自由文を黙って返す代わりに opencodex が明示的なエラーで拒否します。ローカル / カスタムの ollama-native エンドポイントは Ollama ネイティブの format 動作を保持します。

4. ローカルプロバイダー

opencodex をローカルの OpenAI 互換サーバーに向けてください — 通常は空キーで使います:

プロバイダー	ベース URL
Ollama (local)	`http://localhost:11434/v1`
vLLM	`http://localhost:8000/v1`
LM Studio	`http://localhost:1234/v1`

すべての OpenAI 互換エンドポイント

プロバイダーが Chat Completions を使うなら openai-chat アダプターが処理します — ダッシュボードで Custom を選ぶか ocx init で custom を選んだ後ベース URL を入力してください。すべてのプロバイダーフィールド (headers、noReasoningModels、noVisionModels、models、…)は設定リファレンスを参照してください。