コーディングツール

OpenCodex

OpenCodex を介して Codex を TokenLab に接続し、モデル固有の API ルーティングを行う

エージェントによるセットアップ

以下のタスクを、コンピュータ上で実行中のエージェントにコピーしてください:

Read https://tokenlab.sh/docs/ja/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.

接続の仕組み

OpenCodex は、Codex とモデル API の間に介在するローカルプロキシです。本ガイドでは OpenCodex 2.73.0 および Codex CLI 0.149.0 を使用します。

TokenLab プリセットの Chat Completions 統合は 2.72.0 でリリースされ、エンドツーエンドで検証済みです。バージョン 2.73.0 ではその統合が維持され、モデル固有の Responses および Anthropic Messages ルーティングが追加されました。以下に記載されたルートは、ストリーミングテキストおよび関数呼び出し/結果のラウンドトリップを使用して TokenLab で検証済みです。

Codex は Responses リクエストを ローカルの OpenCodex プロキシ に送信します。その後、OpenCodex が選択されたモデルのリクエストを TokenLab に送信します。ローカル接続における Responses リクエストは、モデルが TokenLab の Responses API を介して呼び出されることを意味するものではありません。

Codex で選択されたモデルOpenCodex → TokenLab
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3Responses: POST /v1/responses
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1Anthropic Messages: POST /v1/messages
gemini-3.8-flashChat Completions: POST /v1/chat/completions

プリセットの Base URL は https://api.tokenlab.sh/v1 です。これは変更しないでください。OpenCodex が適切な Messages または Responses URL を自動的に構築します。上記の Responses デフォルトおよび Claude ルーティングに含まれないモデルは、プリセットの Chat アダプターを使用します。

TokenLab は、対応を宣言しているモデルに対して Gemini のネイティブ API をサポートしていますが、OpenCodex 2.73.0 の TokenLab プリセットは Gemini を Chat Completions 経由で呼び出します。プロバイダー全体を Responses や Gemini に変更しないでください。その形式に対応していないモデルのリクエストまで変更されてしまうためです。

インストールまたはアップデート

npm インストールには Node.js 18 以降を使用してください:

npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --version

Codex もインストールされている必要があります。OpenCodex は インストール および Codex 接続手順 を提供しています。ネイティブ Windows と WSL では設定が異なります。セットアップと Codex は同じ環境で実行してください。

TokenLab の追加

TokenLab API Keys でキーを作成します。ターミナルでのセットアップについては、クイックスタート に従って TOKENLAB_API_KEY を設定し、コマンド履歴に値が残らないようにしてください。そのターミナルから OpenCodex を起動します。バックグラウンドサービスは、自身の起動環境でその変数が必要となります。

新規の OpenCodex インストールの場合は、ocx init を実行し、TokenLab を選択してキーをローカルに入力するか、リテラルの環境変数参照 ${TOKENLAB_API_KEY} を使用します。ウィザードの Codex 接続および自動起動の選択を確認してから適用してください。

既存のインストールの場合は、他のプロバイダーを置き換えずにプリセットを追加します:

ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'

シングルクォートはキーの値ではなく、環境変数への参照を保存します。このコマンドは PowerShell でも動作します。tokenlab が既に存在する場合は、--force で上書きするのではなく、ダッシュボードでそのプロバイダーを編集してください。

また、ダッシュボードの Add provider リストから TokenLab を選択し、そこでキーを入力することも可能です。OpenCodex は設定を $OPENCODEX_HOME/config.json(通常は ~/.opencodex/config.json)に保存します。

プロキシが実行されていない場合は起動し、ダッシュボードを開きます:

ocx start
ocx status
ocx gui

プロバイダーページで、Base URL と検出されたモデルを確認します。プリセットは GET /v1/models?category=chat を検出して tool-use 機能を持つモデルを保持します。画像、動画、音声、埋め込み、および意思決定モデルは除外されます。キーを使用した検出は、そのキーのモデル権限と配信ポリシーを反映します。

ocx sync を実行して Codex を接続し、モデルカタログを更新してから、新しい Codex セッションを開始します。これにより Codex のプロキシ接続とカタログが変更されます。既存のカスタムプロバイダー設定を確認し、同期前にバックアップを保持してください。アカウントや権限ポリシーを置き換える必要はありません。

モデルの選択とリクエストの検証

Codex のモデルピッカーで tokenlab/<model-id> エントリを選択するか、CLI 起動時に指定します:

codex -m "tokenlab/gpt-6.1-sol"

OpenCodex は tokenlab/ を使用してプロバイダーを選択します。TokenLab に送信されるモデル ID は gpt-6.1-sol です。モデル から現在利用可能な正確な ID を選択してください。

接続確認のために、以下を送信します:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

このリクエストは TokenLab の残高を使用します。返信内容と、それに対応するモデル、時刻、ステータスを リクエスト で確認してください。プロバイダーの検出と起動の成功だけでは、推論へのアクセスは検証されません。

ストリーミングと関数呼び出しは、表にあるルートで動作します。画像入力と思考制御は選択したモデルに依存します。モデルの機能を確認し、そのモデルに対して OpenCodex が提供する effort(努力)の選択肢のみを使用してください。画像入力と思考リクエストは、Responses および Messages ルートの代表的なモデルで検証済みです。Gemini の画像入力は Chat ルートで検証済みです。思考をサポートするモデルが、必ずしも思考テキストを公開したり、すべての effort レベルをサポートしたりするわけではありません。

Responses モデルを Chat Completions で維持する

リストされている Responses モデルのいずれかで Chat パスを使用するには、OpenCodex 設定の 既存の providers.tokenlab オブジェクトに modelAdapters エントリをマージします。以下の例は、gpt-6-astra を Codex 用の Chat に維持するものです:

{
  "modelAdapters": {
    "gpt-6-astra": "openai-chat"
  }
}

これはプロバイダーフィールドの例であり、設定全体を置き換えるものではありません。他のモデルのオーバーライド、認証情報、プロバイダーを保持したまま、プロキシを再起動して新しい Codex セッションを開いてください。このモデルエントリのみを削除すると、Responses のデフォルトに戻ります。

Claude の Messages ルーティングは、標準の TokenLab エンドポイントに紐付いています。上記の Chat オーバーライドは Responses のデフォルトに適用されるものであり、Claude を Chat に切り替えるものではありません。Chat ネイティブなクライアントの場合、リストされている Responses モデルはこのオーバーライドなしで既に Chat を使用しています。OpenCodex プロバイダーのルーティング を参照してください。

配信ポリシーおよびその他の TokenLab ツール

このプリセットは X-TokenLab-Delivery-Policy ヘッダーを強制しません。TokenLab は API キーの配信ポリシーのデフォルトを使用します。Chat、Responses、または Messages の選択は、配信ポリシーの選択とは別です。TokenLab プロバイダー設定 を参照してください。

TokenLab Skills に統合手順が記載されています。これらはメインモデルのプロバイダーや API 形式を変更するものではありません。

OpenCodex 2.73.0 の JEV Auto は TypeSafe の意思決定バックエンドを使用します。 これは TokenLab をそのバックエンドとして提供しません。MCP を介して TokenLab の System One API を呼び出すことは別の操作です。TypeSafe の認証情報フィールドに TokenLab キーを入力しないでください。

同じエージェントで画像と動画を生成する

Codex は TokenLab MCP サーバー を使用して画像や短い動画を作成することもできます。各生成は同じ TokenLab 残高から支払われます。OpenCodex はモデルリクエストをルーティングするだけであり、Codex 自体が MCP サーバーを起動します。TOKENLAB_API_KEY が設定されているターミナルで、サーバーを Codex に追加します:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

MCP はメインモデルのプロバイダーや API 形式を変更しません。codex mcp list を実行し、tokenlab がリストされていることを確認してください。その後、新しい Codex セッションで試してください:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video はタスク ID を返します。エージェントは動画の準備ができるまで get_task_status を呼び出します。

トラブルシューティングとセットアップの復元

  • ピッカーに TokenLab が表示されない: ocx --version を確認してください。本ガイドは 2.73.0 を対象としています。ocx sync でカタログを更新し、新しい Codex セッションを開始してください。
  • 401 エラーまたは認証情報が見つからない: キーが有効であり、OpenCodex を実行しているプロセスから利用可能であることを確認してください。別のターミナルでの環境変数は、既に実行中のサービスを更新しません。
  • モデルが見つからない: 正確な ID、キーの権限、現在の可用性を確認してください。非チャットモデルや tool-use を持たないチャットモデルは、このプリセットに含まれていません。
  • サポートされていないリクエストまたは誤ったエンドポイント: 選択したモデルをルーティングテーブルと比較し、保存されているアダプターのオーバーライドを検査してください。必要な形式は モデル詳細 の tokenlab.accepted_request_formats です。モデルリストはその詳細フィールドの代わりにはなりません。Codex がローカルで Responses を使用しているという理由だけで、Claude や Gemini を Responses に送信してはいけません。
  • ツールや画像入力が失敗する: 元のエラーとリクエスト ID を保持してください。設定を変更する前に、モデルの機能とアクティブな OpenCodex ルートを確認してください。エラーを隠すために会話履歴やツールの結果を削除しないでください。

プロキシを介した Codex のルーティングを停止するには ocx stop を使用します。OpenCodex はプロキシを停止し、ネイティブの Codex 接続を復元します。ocx restore は、他のクライアントのためにプロキシを実行したまま、ネイティブ接続を復元します。他のクライアントと共有しているインストールを変更する前に、OpenCodex CLI リファレンス を確認してください。

このページの内容