最終更新

Codex の OpenCode Zen — Codex Router で従量課金モデルを使う

Codex で OpenCode Zen を使うとは、opencode プラットフォームの従量課金側を Codex Router 経由で Codex モデルピッカーへルーティングすることを意味します。定額の Go サブスクリプションと 1 つの保存キーを共有しますが、GPT モデルを含むより大きな Zen カタログから取得します。

OpenCodeOpenCode Zenpay-per-usecurated catalog

1 つのプロバイダーファミリー、2 つの課金エンドポイント

opencode は 1 つのアカウントで 2 つのエンドポイントを公開しています。Codex Router はそれらを 1 つの選択可能なファミリーと 1 つのキー(OPENCODE_API_KEY または OPENCODE_GO_API_KEY)として扱います:

エンドポイント課金Base URLカタログ
Go定額サブスクリプションhttps://opencode.ai/zen/go/v1テスト済みモデルをレジストリに同梱
Zen従量課金https://opencode.ai/zen/v1GPT モデルを含むより大きなライブカタログ

別個の「Zen キー」はありません。1 つの opencode アカウントキーで両方をカバーし、サブスクリプション側の詳細は OpenCode Go ガイドで説明しています。

Codex に Zen をセットアップする

先に Codex Router をインストールし(インストールガイド参照)、キーを保存してファミリーを有効化します:

./bin/model-router codex provider-key opencode-go set
./bin/model-router codex providers enable opencode-go

キーは opencode.ai/auth の opencode アカウントから取得します。保護されたユーザー単位ファイルに保存され、opencode 自身のエンドポイントにのみ送信されます。Windows では同じコマンドで ./model-router.ps1 codex を使い、その後 Codex を完全終了して再起動します。

Zen カタログをキュレーションする

Zen は事前選択モデルを同梱しないため、アカウントが現在見られるものから一覧を自分で構築します:

./bin/curate-models opencode-zen

キュレーションは Zen が公開するモデルを一覧表示し、必要なものをトグルで選択できるようにして、保護状態に保存します。別のエンドポイントを指定する必要がある場合にのみ OPENCODE_ZEN_BASE_URL を設定します。

1 つのキー背後のプロバイダー ID

カタログは内部で、エンドポイントと各モデルがアップストリームで話すプロトコルによって複数のプロバイダー ID に分割されます:

Provider IDプロトコル例
opencode-goChat CompletionsGLM、Kimi、DeepSeek、MiMo
opencode-go-messagesAnthropic MessagesMiniMax と Qwen モデル
opencode-go-responsesResponsesGrok 4.5 と 4.6、GPT 5.6 Luna
opencode-zenZen(従量課金)キュレーション済み Zen モデル

これらは 1 つのキーを共有し、まとめて切り替わります。Go の選択と Zen の選択が、1 つの認証情報であるにもかかわらずレジストリでは別プロバイダーのように見えるのはこのためです。

キュレーションした Zen モデルも同じように分割されます:Claude は opencode-zen-messages、GPT・Grok・Muse は opencode-zen-responses に入り、Gemini は Zen に対応するワイヤがないため拒否されます。変体は Go のキーと選択トグルを共有しつつ、Zen の別課金クールダウン範囲を保持します。./bin/curate-models opencode-zen で再キュレーションすると、既存の Chat エントリを対応するワイヤへ移行できます。

匿名の無料ゲートウェイ

別個の opencode-free ゲートウェイはリクエストに https://opencode.ai/inference/v1 を使い、ログインもキーも不要です。OpenCode の公開 CLI クライアント識別情報を送ります。プロバイダー管理のカタログは無料 ID(big-pickle と -free で終わるモデル ID)に絞り込まれています。可用性と制限は予告なく変わる可能性があるため、依存先ではなく試用として扱ってください。

現行の Zen 無料 ID はキュレーションでき、キー不要の free/auto プールにも加わります。提供終了 ID は引き続き除外されます。プールには beam-free、deepseek-v4.1-flash-free、mimo-v2.6-flash-free などと Kilo の無料モデルが含まれます。アクセスには IP ごとの制限や地域制限があり、OpenCode がプロンプトを記録する可能性があります。設定方法と制限はモデル概要を参照してください。

./bin/model-router codex providers enable opencode-free
./bin/curate-models opencode-free

連携を検証する

./bin/model-router codex doctor
./bin/model-router codex providers
./bin/test-model 'opencode-zen/MODEL_ID' --live --yes

プロバイダーは SHOW と ready を報告する必要があります。Codex を完全終了して再起動し、新規タスクを作成してピッカーを確認します。エントリがない場合は、モデルがピッカーに表示されないを参照してください。

FAQ

Codex の OpenCode Zen とは何ですか? OpenCode Zen は opencode の従量課金エンドポイントです。Codex Router の opencode-zen プロバイダーは、Zen のライブカタログからキュレーションしたモデルを、Go サブスクリプションと同じ保存キーを使って Codex ピッカーにルーティングします。

Codex Router は Zen モデルを事前選択しますか? いいえ。Zen エンドポイントは事前選択モデルを同梱しません。./bin/curate-models opencode-zen でライブカタログから必要なモデルをキュレーションします。

Go と Zen は同じ認証情報ですか? はい。両方のエンドポイントは 1 つの保存キーを共有し、ルーターは内部でそれらをプロバイダー ID ごとに分割します。どちらかを有効化・無効化するとファミリー全体がまとめて切り替わります。

関連:モデル概要、OpenCode Go ガイド、インストール、トラブルシューティング。