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

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

OpenCode Zenpay-per-usecurated catalog

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

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

別個の「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 に分割されます：

これらは 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 ゲートウェイも Zen エンドポイントを使用しますが、キーを要求しません。そのカタログはプロバイダーが管理し、無料 ID（big-pickle と -free で終わるモデル ID）に絞り込まれています。可用性と制限は予告なく変わる可能性があるため、依存先ではなく試用として扱ってください。

./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 ガイド、インストール、トラブルシューティング。