Coding Agent のセットアップ

Codex VS Code 拡張：API 設定と公式ログイン

Codex VS Code 拡張機能で共有する config.toml を設定し、BetterToken Responses と公式ログイン、プラグイン、Remote Control を併用します。

Codex VS Code 拡張機能は Codex CLI/App と ~/.codex/config.toml を共有します。公式ログイン、プラグイン、Remote Control を維持したい場合は、このページを使用してください。

主要設定

項目	値
API Key	`experimental_bearer_token = "YOUR_API_KEY"`
Base URL	`https://bettertoken.ai/v1`
Model	`gpt-6-astra`

事前準備

最新の Codex VS Code 拡張機能をインストール
拡張機能または Codex App で公式ログインを完了
BetterToken API Key を作成
model plaza または API Key の Setup ダイアログから Model ID をコピー

登録して BetterToken API Key を取得

アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。

インストール

VS Code Marketplace から拡張機能をインストールし、VS Code を再起動します。

手動設定

独自の CODEX_HOME を設定している場合は、そのディレクトリの config.toml を編集してください。それ以外は macOS / Linux では ~/.codex/config.toml、Windows では %USERPROFILE%\.codex\config.toml を使用します。

Codex を完全に終了し、既存の config.toml と auth.json をバックアップしてください。プロバイダーテーブルを重複して追加せず、既存のプロバイダー設定を更新します。

拡張機能を設定する

~/.codex/config.toml を編集します。

model_provider = "bettertoken"
model = "gpt-6-astra"

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

設定パラメーター

パラメーター	役割と配置	デフォルトと例
`model_provider`	ユーザー設定のトップレベル。下の設定 ID を選びます。	デフォルトは `openai`。この例は `bettertoken`。
`model`	トップレベル。モデル広場の完全な Model ID。	例は `gpt-6-astra`。必要に応じて変更します。
`name`	provider テーブル内。表示名のみ。	`BetterToken` は Model ID ではありません。
`base_url`	provider テーブル内。モデル API の Base URL。	`https://bettertoken.ai/v1` を使い、Codex が `/responses` を追加します。
`wire_api`	provider テーブル内。リクエストのプロトコル。	現在は `responses` のみ対応。省略時も同じ値です。
`requires_openai_auth`	provider テーブル内。OpenAI 認証と認証情報ストアを使います。	デフォルトは `false`。ここでは `true`。ログインファイルを維持するスイッチではありません。
`experimental_bearer_token`	provider テーブル内。外部 API リクエスト用 Bearer Key。	BetterToken API Key を指定します。公式ログインキャッシュは上書きしません。平文で保存されるため、OpenAI はこのフィールドの使用を推奨していません。
`supports_websockets`	provider テーブル内。Responses WebSocket 対応。	デフォルトは `false`。ここでは HTTP/SSE を使います。

公式ログインで生成された認証情報を維持し、API Key JSON に置き換えないでください。requires_openai_auth = true は公式の認証処理を使い、現在の provider の experimental_bearer_token がモデルリクエスト用の外部 Key を指定します。前者が有効なとき Codex は env_key を無視するため、Bearer Key を直接置き換えないでください。Key を含むファイルは共有しないでください。

別の認証情報の設定方法については、OpenAI の環境変数とコマンドによる認証の案内を参照してください。それぞれ独立した認証モードです。プロバイダーの auth テーブルを env_key、experimental_bearer_token、requires_openai_auth と併用しないでください。また、公式ログインを保持するこの例の設定を env_key に置き換えないでください。

設定の階層と古いキー

モデルや推論設定を [projects."<path>"] に入れないでください。プロジェクト固有のモデルは信頼済みプロジェクトの .codex/config.toml のトップレベルで設定できますが、provider と認証はユーザー設定に置きます。現在の profile は CODEX_HOME 内の NAME.config.toml を codex --profile NAME で選択します。古い [profiles.NAME] やトップレベルの profile は使いません。

ファイルを保存し、VS Code で Developer: Reload Window を実行して Codex パネルを開き直します。

接続を確認する

新しい拡張機能セッションを作成し、短いタスクを送信します。プラグインと Remote Control を利用でき、gpt-6-astra から応答が返れば設定は完了です。

モデルを切り替える

model と必要に応じて review_model を変更し、Developer: Reload Window を実行します。Setup ダイアログまたは model plaza の Model ID を使用してください。

よくあるエラー

エラー	対処方法
拡張機能が再ログインを求める	公式ログインを復元し、`requires_openai_auth = true` を維持します。
`401` または `403`	`experimental_bearer_token` を再度コピーします。`auth.json` は上書きしません。
テーブルが重複している	もう一方の `[model_providers.bettertoken]` テーブルを削除し、認証モードを 1 つにします。
モデルが見つからない	`gpt-6-astra` を現在利用できる完全な Model ID に置き換えます。
設定が適用されない	ファイルを保存し、Developer: Reload Window を実行します。