CodexのAPIキーとChatGPTログイン:設定と課金の違い

ChatGPTログイン、OpenAI公式APIキー、独立した課金のResponsesプロバイダーを比較します。ユーザー用config.tomlでBetterTokenを設定し、地域とカードの制限を確認します。本格的な作業の前に、残高、認証方式、モデルの送信先、利用記録を照合して課金先を確かめます。

目次
CodexのAPIキーとChatGPTログイン:設定と課金の違い

Codexにログインできない場合や、利用料が意図していないアカウントの請求に計上されている場合は、プランを変える前に認証方法を確認してください。Codexをローカルで使う開発者の場合、ChatGPTログインではプランの利用枠や機能を使い、OpenAIのAPIキーではOpenAI Platformで別途課金されます。カスタムResponsesプロバイダーを使う場合は、codex login statusだけでなく、選択したプロバイダーと利用記録も確認します。

支払いに使うアカウントを選びます

2026-11-22時点のOpenAIの認証ドキュメントでは、サブスクリプションの契約に基づくログインと、APIキーを使ったアクセスが別の方法として説明されています。外部プロバイダーを追加すると、モデルの利用料は別の経路で課金されます。ChatGPTのサブスクリプションが付くわけではありません。

アクセス方法必要なもの利用料の計上先適した用途
ChatGPTログイン対応地域のChatGPTアカウント。有料機能には対象プランと利用可能な支払い方法プランの利用枠と、適用されるChatGPTクレジットまたは従量課金プランに含まれるローカル利用や、対象アカウントで使えるCodex cloudの機能が必要な場合
OpenAI公式APIキーOpenAI Platformのキー、APIの課金設定または使用可能なAPIクレジット、対応地域。支払いが必要な場合は利用可能な決済方法ChatGPTの利用枠とは別に、OpenAI PlatformでAPI料金を適用ローカルのCLI作業や信頼できる環境での自動化を、API組織に請求したい場合
BetterTokenのカスタムプロバイダー自分のBetterTokenアカウント、APIキー、利用可能な残高。支払い方法はコンソールによって異なります選択したモデルのトークン単価に基づき、BetterToken残高から支払い独立した課金でローカルのCodexを使いたい場合。ルーブル払いも選択肢に含まれます

ローカルCLIセッション用にBetterTokenを設定します

インストール済みの公式Codex CLIで、BetterToken経由のCodexアクセスを利用します。現在のトークン料金とキャッシュ料金を確認し、コンソールを開いてください。

テストに十分な利用可能残高があることを確認します。足りなければ、その時点でコンソールに表示される決済方法で入金し、利用可能な残高が更新されたことを確認してください。その後、BetterTokenのアカウント設定手順に従って、自分のAPIキーを作成します。

この例では、2026-11-22時点で提供モデルの一覧にResponses API対応として掲載されているgpt-6.2-solを使用します。BetterTokenのCodexガイドに記載された、環境変数による認証方式です。

Codexを終了し、現在の設定のバックアップを作り、自分以外の人に見られない場所へ保存します。以下の内容をユーザー設定の~/.codex/config.tomlに反映し、ルートキーはすべてのTOMLテーブルより前に置いてください。同じキーやテーブルがすでにある場合は、その内容を置き換えます。同じ定義を重ねて追加しないでください。CODEX_HOMEを設定している場合は、そのディレクトリ内のconfig.tomlを編集します。

model = "gpt-6.2-sol"
model_provider = "bettertoken"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
env_key = "BETTERTOKEN_API_KEY"
requires_openai_auth = false
supports_websockets = false

Bashでreadが入力を待ったらキーを貼り付け、Enterを押します。キーを入力している間、その文字列は画面に表示されません。機密のプロジェクト資料がないディレクトリからテストを始めてください。

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
codex --sandbox read-only "Reply with exactly CODEX_ROUTE_OK. Do not use tools."

Codexはエクスポートされた環境変数からキーを読み取り、https://www.bettertoken.ai/v1/responsesへResponsesリクエストを送ります。この設定ではauth.jsonの置き換えや、OpenAIのログイン手順へのBetterTokenキーの入力は不要です。環境変数を引き継げるよう、同じターミナルからCodexを起動してください。

テストで指定したCODEX_ROUTE_OKという応答が返ったら、BetterTokenコンソールでモデル、リクエスト時刻、状態、請求額が一致する記録を探します。応答が返ることは接続の確認になります。一方、内容が一致する利用記録では、リクエストを実際に処理したプラットフォームを確認できます。大きなリポジトリを開く前に、請求額を確認してください。

BetterTokenアカウントを作成する

ChatGPTログインと公式APIキーでは、どの機能を使えますか?

OpenAIに直接接続する場合は、公式のログイン手順を使います。プランの利用枠や機能を使うならChatGPTログイン、Platformで課金するならOpenAI発行のAPIキーを選びます。先ほど設定したBetterTokenのような外部プロバイダーを使う方法は、これらの公式ログインとは別の接続方法として扱います。

どちらの公式ログイン方法も、Codex CLI、IDE拡張機能、ChatGPTデスクトップアプリでのローカル作業に対応します。Codex cloudにはChatGPTログインが必要です。機能の提供状況ページでは、クラウドでのGitHubコードレビューとSlack連携はAPIキー認証の対象外とされています。

APIキー認証は、ローカル作業や信頼できる環境のCIジョブに使います。APIキーによるローカル作業を、ChatGPTログインが必要なクラウド機能の利用権の代わりとして選ばないでください。API経由で選べるモデルの範囲は、使用するAPIキーにどのモデルへのアクセスが認められているかによって決まります。ChatGPTの上位プランを契約しても、APIキーのセッションがサブスクリプションの利用枠に切り替わるわけではありません。

OpenAIに戻すには、ユーザー設定のルートにmodel_provider = "openai"を設定します。以前のOpenAI用のmodel設定も復元するか、公式ログインで利用できるモデルを選んでください。公式アカウントでのアクセスを確認せず、ゲートウェイの例にあるmodel = "gpt-6.2-sol"を残さないでください。

ゲートウェイ向けに設定したopenai_base_urlの上書きも削除します。保存済みの認証情報を入れ替える場合は、先にcodex logoutを実行します。ChatGPTでログインするにはcodex loginを実行してください。

公式APIキーでのログインには、OpenAIが発行したキーを使います。次のBashコマンドは、キーの値をコマンド本文に書かず、標準入力で渡します。

read -rs OPENAI_API_KEY && export OPENAI_API_KEY
codex login --with-api-key <<<"$OPENAI_API_KEY"
codex login status

ログイン後は新しいセッションを開始し、選択したOpenAIモデルで先ほどの読み取り専用テストを繰り返します。応答を確認したら、後述する課金確認の手順に沿って、今回選んだログイン方法に対応するChatGPTまたはOpenAI Platformの利用状況ダッシュボードを確認してください。

キーは公開しないでください。OpenAIの請求ガイドでは、プロモーションのAPIクレジットも含め、APIとChatGPTの課金が区別されています。サブスクリプションの特典を検討する際は、Codexの費用も対象だと決めつけず、APIクレジットの対象条件と除外事項を確認してください。

国やカードが対応対象外の場合はどうしますか?

公式APIキーを使っても、OpenAIの地域要件はなくなりません。2026-11-22時点で、ロシアはAPIの対応国一覧にも、ChatGPTとAPIの共通一覧にも含まれていません。

登録時やAPIキーの作成時に、"OpenAI's services are not available in your country."というエラーが出ることがあります。OpenAIの非対応国に関する方針は、非対応国からのアクセスでアカウントが停止される可能性を示しています。非対応国の支払い方法を使った場合も、サービスへのアクセスが遮断されるとしています。

支払いには別の条件があります。カード決済では、利用者の所在地とカード発行銀行の所在地の両方が対応地域である必要があります。カード決済が拒否された場合の案内によると、プリペイドカードではAPIクレジットを購入できません。

ロシアの利用者向けに、BetterTokenはルーブル払いに対応しています。公式ベンダーのサブスクリプションで通常必要となる外国発行カードは不要です。BetterTokenのAPIエンドポイントにはVPNなしで接続できます。この説明は第三者のダウンロード、ログイン、マーケットプレイス、更新には適用されません。支払い経路、利用可能なカード、手数料、入金反映の条件はコンソールによって異なります。

ブラウザーのデータを消去する対処は、現在対応国にいる場合に限ります。旅行後に地域の検出エラーが出る場合、OpenAIはCookieとキャッシュの削除や、別のブラウザーの使用を勧めています。解決しなければ、OpenAIサポートに連絡してください。

カスタムプロバイダーの設定が無視されるのはなぜですか?

プロバイダー設定はユーザー設定に置き、リポジトリ内の.codex/config.tomlには置かないでください。設定リファレンスでは、プロジェクト内のmodel_providerとmodel_providersは無視されると説明されています。そのリポジトリを信頼済みのプロジェクトとして扱っていても、プロバイダー設定を読み込む場所に関するこの制限は変わりません。

model_providerはプロバイダーIDを選び、[model_providers.bettertoken]はそのIDの設定を定義します。base_urlはAPIのルートを指定し、env_keyはAPIキーの値そのものではなく、その認証情報を保持している環境変数の名前を指定します。独自のプロバイダーIDを使ってください。openai、ollama、lmstudioなどの組み込みIDは予約されています。

wire_apiで使える値はresponsesだけです。Chat Completionsのみに対応したゲートウェイでは、この設定を利用できません。ベースURLにはhttps://www.bettertoken.ai/v1を指定し、/responsesを含む完全なリクエストURLは指定しないでください。

認証方式は混在させないでください。OpenAIの説明では、requires_openai_auth = trueを設定するとCodexはenv_keyを無視します。この例では明示的にfalseにしています。ファイルによる認証設定からコピーしたtrueと組み合わせないでください。

supports_websockets = falseにより、この例ではHTTP/SSEを使います。最初のテストには追加の調整項目を入れないでください。service_tierなどのフィールドへの対応は、ゲートウェイ側で確認する必要があります。Codexに設定項目があるだけでは、ゲートウェイが対応しているとは判断できません。

設定が反映されない場合は、CODEX_HOMEと、コマンドラインや選択したプロファイルによる上書きを確認します。CLIでは、/debug-configで設定の各レイヤーとポリシーの参照元を確認できます。変更後はCodexを再起動し、新しいセッションを開始してください。ほかの接続確認は、カスタムプロバイダーの設定ガイドで説明しています。

どのアカウントに課金されたかを確認するには?

認証の状態だけで判断せず、現在の設定がどこへリクエストを送り、そのプラットフォームにどの利用記録が残るかを合わせて確認します。codex login statusが示すのは認証方式であり、請求の証明ではありません。env_keyを使うプロバイダーでは、ChatGPTに以前ログインした状態が残っているという理由だけで、モデルの利用料の請求先を判断しないでください。

Codexの起動に使った環境で、次を実行します。

codex login status

次に、そのセッションで選択されているmodel_providerと、接続先を示すbase_urlの設定値を確認します。セッション内の/statusには、使用中のモデルとトークン使用量が表示されます。長時間のタスクを実行する前に、表示されたモデルと使用量が、先ほど送った小さなテストリクエストに対応しているか照合してください。

ChatGPTログインの場合は、Codexの利用状況ダッシュボードで利用枠の消費を確認します。購入履歴は、ChatGPTアカウントまたはワークスペースの請求設定で確認してください。プランに含まれる利用では、リクエストごとに個別の金額が請求されるとは限りません。

公式APIキーの場合は、OpenAI Platformの利用状況レポートと、API組織の請求設定を使います。リクエストを送ったプロジェクト、使用したモデルとAPIキー、対象の集計期間を正しく選んでいるか確認してください。ダッシュボードの時刻はUTCで、直近の利用は表示まで時間がかかることがあります。

BetterTokenの場合は、コンソールのリクエスト記録と残高を確認します。ダッシュボードにはリクエスト時刻、モデル、状態、トークン使用量、請求額が表示されます。この請求は個人のOpenAI Platformアカウントには表示されず、ChatGPTの利用枠も消費しません。

テストが失敗したら、該当する原因を修正します

環境変数が見つからないというエラーが出た場合は、キーを再入力します。その変数を受け取れるよう、同じBashターミナルからCodexを起動してください。BetterTokenから401が返る場合は、BetterTokenのキーであり、現在も有効かを確認してください。402は残高不足を示します。

リクエスト形式を理由に拒否された場合は、プロトコルとベースURLを先ほどの最小構成と比較します。再テストの前に、そのプロバイダーのために追加した任意のフィールドを外し、まず最小構成に戻して確認してください。BetterTokenのResponsesリファレンスでは、無効なリクエスト形式やパラメーターに400を使用すると説明されています。

応答は返るのに期待した利用記録がない場合は、大きな処理を送る前に止めてください。選択中のプロバイダー、認証情報がどこから読み込まれているか、ダッシュボードで開いているアカウント、集計期間を再確認します。表示されたモデル名や、ログインが成功したという結果だけでは、そのリクエストがどのアカウントに請求されたかは確認できません。

LLM ワークフローを最適化しませんか?

単一 API でモデルを接続し、キーと AI コストを管理できます。

無料で始める