Skip to main content
Codex CLI と Codex App はローカルタスクで config.toml と auth.json を共有します。この設定では OpenAI Responses 経由で BetterToken API Key を使用します。

​
主要設定

​
前提条件

​
インストール

​
ファイルの場所を確認してバックアップする

独自の CODEX_HOME を設定している場合は、そのディレクトリの config.toml と auth.json を編集してください。それ以外は macOS / Linux では ~/.codex、Windows では %USERPROFILE%\.codex を使用します。CLI と App は同じディレクトリを使用する必要があります。WSL のユーザーディレクトリは別です。 編集前に Codex を完全に終了し、両方のファイルを非公開の場所にバックアップしてください。ファイルがなければ作成します。既存の設定を置き換え、キーやテーブルを重複して追加しないでください。無関係な設定は残します。
この設定は ChatGPT ログインから API Key 認証に切り替えます。公式アカウントへのアクセスは維持されません。auth.json とバックアップを保護し、共有したりリポジトリにコミットしたりしないでください。

​
コマンドラインでの設定

BetterToken の自動設定スクリプトは、Codex のプロバイダー設定を書き込みます。Node.js が必要です。API Key または Model ID を引数で渡さなかった場合は、実行時に入力します。
インストール後、両方のファイルを以下の手動設定と照合し、相違点を修正してから Codex を起動してください。

​
手動設定

​
config.toml を編集する

model_provider、model、cli_auth_credentials_store はプロファイル内ではなく、すべての TOML テーブルより前のトップレベルに記述してください。プロバイダー ID とテーブル名を一致させます。このファイル認証では、選択したプロバイダーから env_key と experimental_bearer_token を削除してください。
例では GPT-6 Astra（gpt-6-astra）を使用します。別のモデルでは、モデル広場から完全な ID をコピーして model を置き換えてください。GPT、Kimi、GLM のファイル認証構造は共通です。自動設定は GPT で利用できます。

​
auth.json を編集する

auth.json は config.toml と同じディレクトリにあります。auth.json がない場合は、そのディレクトリに新規作成してください。ファイルの内容を次の JSON にし、YOUR_API_KEY を自分の BetterToken API Key に置き換えて保存してください。

​
接続の確認

両方のファイルを保存し、ターミナルで新しい Codex CLI セッションを直接起動します。
バックグラウンドプロセスを含めて Codex App を完全に終了し、再度開いて新しいローカルタスクを作成してください。使用する各クライアントで短いプロンプトを送信します。正常な応答でそのクライアントの接続を確認してください。

​
モデルの切り替え

model と、必要に応じて review_model を変更します。ファイルを保存し、実行中の Codex プロセスを停止してから再起動してください。Setup ダイアログまたはモデル一覧の Model ID を使用します。

​
よくあるエラー

401、403、ログイン要求が出た場合は、使用中のディレクトリ、auth.json の Key、auth_mode = apikey、cli_auth_credentials_store = file、requires_openai_auth = true を確認してください。プロバイダーやモデルのエラーでは、プロバイダー ID の一致、https://bettertoken.ai/v1、wire_api = responses、モデルの利用可否を確認します。変更が反映されない場合は設定の上書きを調べ、CLI と App が同じ CODEX_HOME を使用していることを確認してください。

​
高度な設定

​
対応プロバイダー

ここに示す対応状況は、このページで説明する BetterToken の設定方法に適用されます。
  • コマンドライン + 手動設定：生成されたコマンドを使うか、すべての手順を手動で設定します。
  • 手動設定：API Key、Base URL、Model を入力します。
  • 未対応：検証済みの直接接続方法はまだありません。

​
Codex 拡張機能

Codex VS Code 拡張機能は config.toml を共有しますが、公式ログインを維持するには別の認証設定が必要です。Codex 拡張機能の設定ガイドを参照してください。

​
関連する質問

​
公式リファレンス

​
技術情報

Codex は OpenAI Responses を使用します。base_url を https://bettertoken.ai/v1 に設定し、wire_api = "responses" を維持してください。Codex が /responses を追加します。