ロシアで VS Code の Codex を使う：公式サインインと自分の API

Codex VS Code Extension は共有ファイル ~/.codex/config.toml を読み込みます。カスタムプロバイダーを使いながら、Extension の公式サインインを保持できます。この設定には OpenAI Responses、互換性のある Base URL、そして別の Bearer トークンが必要です。ファイルを変更したら、VS Code のウィンドウを再読み込みし、新しいセッションを作成してください。

custom provider には自分のキーを使用してください。 BetterToken アカウントを作成

Custom provider の値は最新の Codex VS Code ガイドで確認してください。この設定は OpenAI の公式サインインを置き換えるものではなく、Marketplace、アカウント、Extension の地域要件も変更しません。

始める前に

次のものを用意します。

• 公式 Marketplace から入手した最新版の Codex VS Code Extension。
• Extension または Codex App で完了した公式サインイン。
• 自分の BetterToken API Key。
• BetterToken Model Plaza の最新の Model ID。
• すでに設定済みの場合は、現在の config.toml のバックアップ。

Codex CLI、アプリ、IDE Extension はユーザーレベルで一つのファイルを共有します。そのため、古いカスタムプロバイダーは複数のインターフェースに同時に影響することがあります。編集前にファイルを開き、すでに存在するセクションを確認してください。

Codex をどこで実行するか決めていない場合は、まず Codex CLI と Desktop App の比較を読んでください。ターミナル、アプリ、VS Code、カスタムプロバイダーの認証の違いを分けて説明しています。

macOS と Linux のパス：

~/.codex/config.toml

Windows のパス：

%USERPROFILE%\.codex\config.toml

1. 公式サインインを確認する

Extension をインストールし、Codex パネルを開いて公式サインインを完了します。この手順より前にカスタムプロバイダーを追加しないでください。追加すると、アカウントのエラーと API のエラーを切り分けにくくなります。

サインイン後、対応する公式モードから短いリクエストを送ります。Extension が開かない、または認証コールバックが完了しない場合は、最初に公式 Codex IDE ドキュメントを使ってその問題を解決してください。

2. BetterToken プロバイダーを追加する

model_provider = "custom"
model = "YOUR_MODEL_ID"
review_model = "YOUR_MODEL_ID"
model_reasoning_effort = "high"

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "YOUR_API_KEY"

ユーザーの config.toml を開き、プロバイダー設定を一つだけ追加します。

正確な field、現在の Model ID、認証方法は Extension の現在の version に依存するため、この記事では固定しません。Codex VS Code 向けの現在の BetterToken ガイドを開き、ユーザーの config.toml にはそのガイドが示す value だけを設定してください。

YOUR_MODEL_ID は現在利用可能な正確な識別子に、YOUR_API_KEY は自分のキーに置き換えます。ファイルはユーザーの .codex ディレクトリにありますが、Git にコミットしたり、プロジェクトアーカイブや公開 Gist に含めたりしてはいけません。

認証 field、path、version は現在の VS Code Extension 専用 guide で確認してください。BetterToken API Key を auth.json に保存しないでください。

3. 二つの認証モードを混在させない

CLI、Desktop App、VS Code Extension では version に依存する異なる認証設定を使うことがあります。client 間で field をコピーせず、認証 field、path、version は現在の VS Code Extension 専用 guide で確認してください。

Codex CLI と Codex App：選び方とカスタムプロバイダーの接続では、二つのモードの選択を詳しく説明しています。現在の手順を確認せずに、あるクライアントのフィールドを別のクライアントへコピーしないでください。

すでに CLI を設定している場合は、現在の guide に従って active configuration を確認します。実際の token を含む設定や output を issue に貼り付けないでください。

4. VS Code を再読み込みする

ファイルを保存します。コマンドパレットを開き、次を実行します。

Developer: Reload Window

次に Codex パネルを開き直し、新しいセッションを作成します。古いセッションでは、以前のプロバイダーやモデルが残っていることがあります。

5. リクエストを確認する

テスト用ディレクトリを開き、ファイルを変更しないリクエストを送ります。

一行で答えてください：CODEX_PROVIDER_OK。ファイルを変更せず、コマンドを実行しないでください。

次の条件を満たせば設定は確認できています。

• Extension が公式にサインインした状態を維持している。
• 401、403、model not found なしで応答が返る。
• 選択した YOUR_MODEL_ID が使われる。
• BetterToken Dashboard に、対応するリクエスト、ステータス、Token 消費が表示される。

プラグインと Remote Control は公式サインインおよび現在の Codex バージョンに依存します。BetterToken が対象にするのはモデル API であり、これらの機能がすべての条件で使えることを約束するものではありません。

よくあるエラー

Extension が再度サインインを求める

公式サインインを復元し、認証 field と path を現在の VS Code Extension 専用 guide で確認してください。auth.json を BetterToken キーで置き換えないでください。

401 または 403

認証設定を現在の VS Code Extension 専用 guide と照合し、必要なら自分の key を注意して再入力してください。ファイル全体を公開しないでください。

Duplicate table

TOML では [model_providers.custom] を二回宣言できません。プロバイダーと認証モードを一つずつ残します。複数のバリエーションが必要な場合は、検証済みの設定を分けて保持し、意図して切り替えてください。

モデルが見つからない

二つの YOUR_MODEL_ID を完全な最新 ID に置き換えてください。記事やスクリーンショットにある古い名前は信頼できる情報源ではありません。

変更が反映されない

競合する古い provider または profile フィールドを削除して保存し、Developer: Reload Window を実行してから新しいセッションを開始します。問題が続く場合は VS Code を完全に終了し、Extension が実際に読み取るユーザーファイルを確認してください。

この高度な設定のフィールドは Codex の変更に伴って変わる可能性があります。再設定する前に、Codex VS Code 向け BetterToken ドキュメントと公式 Codex リファレンスを開いてください。