プロバイダー

プロバイダーは一つの上流 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 1,050,000 / max input 922,000 で *-pro virtual ID は公開状態を維持し、wire でベースモデルと reasoning.mode: "pro" に切り替わります。

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

出荷版 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。

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)

OAuth ログインを使うプロバイダープリセットは 6 つです。認証情報は ~/.opencodex/auth.json に保存され、自動更新されます。ログイン CLI は chatgpt も受け付けます。このコマンドは ChatGPT 認証情報を発行し forward モードのプロバイダーエントリを作成します。

ocx login xai          # xAI Grok
ocx login anthropic    # Anthropic Claude (Pro/Max)
ocx login kimi         # Moonshot Kimi
ocx login kiro         # kiro-cli 認証情報の取り込み(トークンフォールバック対応)
ocx login google-antigravity
ocx login cursor       # Cursor 専用 PKCE ログイン
ocx login chatgpt      # 別途 ChatGPT OAuth ログイン
ocx logout <provider>

プロバイダー	アダプター	ベース URL	備考
`xai`	`openai-chat`	`https://api.x.ai/v1`	ライブ一覧を優先し、フォールバックのデフォルトモデルは `grok-4.5`。
`anthropic`	`anthropic`	`https://api.anthropic.com`	Claude モデル; ライブモデル一覧は `/v1/models` から取得。
`kimi`	`openai-chat`	`https://api.kimi.com/coding/v1`	Kimi K2.7/K2.6/K2.5 コーディングモデル。
`kiro`	`kiro`	`https://runtime.us-east-1.kiro.dev`	初回ログインは Kiro CLI をインストール（`curl -fsSL https://cli.kiro.dev/install
`google-antigravity`	`google`	`https://daily-cloudcode-pa.googleapis.com`	Google OAuth を Cloud Code Assist wire で使用。
`cursor`	`cursor`	`https://api2.cursor.sh`	実験的 PKCE ログイン、HTTP/2 トランスポート、アカウント別モデル探索をサポート。

正規の 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 のままです。

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

複数の OAuth アカウント

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

Kiro 認証情報の取り込み

Kiro のログインには Kiro CLI が必要です。curl -fsSL https://cli.kiro.dev/install | bash でインストールし、先に 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 セッションがまったくない環境には影響しません。

3. API キーカタログ

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

プロバイダー	ベース URL
OpenAI (API キー)	`https://api.openai.com/v1`
Anthropic (API キー)	`https://api.anthropic.com`
OpenRouter	`https://openrouter.ai/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`
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`
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`
Xiaomi MiMo	`https://api.xiaomimimo.com/anthropic`
Kilo	`https://api.kilo.ai/api/gateway`
GitHub Copilot · GitLab Duo	`https://api.githubcopilot.com` · `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

大半は bearer キーと共に openai-chat アダプターを使い、Anthropic 互換エンドポイントのみを公開する一部 (例: Xiaomi MiMo)は anthropic アダプター(x-api-key)を使います。

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

GLM の経路は 2 つあります: 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-*`	372,000
OpenAI (API キー)	`openai-apikey/gpt-5.6-` と `-pro`	1,050,000 (max input 922,000)
OpenRouter	`openrouter/openai/gpt-5.6-sol`、`openrouter/openai/gpt-5.6-terra`、`openrouter/openai/gpt-5.6-luna`	1,050,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 を埋める必要があります。

Cursor は別の実験的アダプターとして追跡します。adapter: "cursor" は ocx init とダッシュボード Add Provider ピッカーに実験的 local config 項目として表示され、Cursor の静的フォールバックモデルカタログメタデータを保存します。Cursor アクセストークンを設定すると opencodex は Cursor ライブ HTTP/2 トランスポートを使います。v2.7.1 フォールバックリストには 1M コンテキストの gpt-5.6-sol / terra / luna と 500K コンテキストの grok-4.5 / grok-4.5-fast が含まれ、ライブ探索結果に基づき現在のアカウントに表示するモデルを決定します。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 で OpenAI 互換、キーは ollama.com/settings/keys で発行されます。opencodex はクラウドラインナップをビジョン機能で分類し、ビジョンサイドカーがテキスト専用モデルにのみ動作するようにします。テキスト専用モデル(例: glm-5.2、deepseek-v4-pro、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 の両方を含みます。

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、…)は設定リファレンスを参照してください。