本文へ移動
GetAPI
日本語
メニュー

GetAPI.ONE

GetAPI.ONE 用に Codex CLI を設定

公式の配布元から Codex CLI をインストールし、ONE キーを環境変数に保存し、Responses 対応のカスタムプロバイダーを設定して、有効な接続を確認します。

対象範囲と前提条件

このガイドの対象は端末の Codex CLI です。すべてのデスクトップクライアント、IDE 拡張、モデル、Codex 機能の互換性を保証するものではありません。

  • 利用可能な残高または適用可能なパッケージがある GetAPI.ONE アカウント。
  • 非公開で保存した、名前と範囲を指定した GetAPI.ONE キー。
  • Responses エンドポイントへの対応を明示した、現在のカタログから選んだモデル。
  • Codex CLI のインストールと、ユーザーレベルの Codex 設定の編集権限。

1. Codex CLI のインストールと確認

現在の公式 Codex CLI ページで OS に合うインストーラーを確認してください。2026-09-07 に確認した公式 macOS/Linux 単体インストーラーは以下のコマンドを使用します。Windows では Unix シェルのコマンドを無条件に実行せず、公式ページの Windows タブに従ってください。

公式 macOS / Linux インストーラー
curl -fsSL https://chatgpt.com/codex/install.sh | sh
インストール済みコマンドを確認
codex --version

2. 端末にキーを読み込む

Codex を起動する前に、現在のシェルにキーを設定します。これらの例には意図的にプレースホルダーを使用しています。

macOS / Linux シェル
export GETAPI_ONE_API_KEY="replace-with-your-private-key"
PowerShell の現在のプロセス
$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

3. ONE プロバイダーを設定

ユーザーレベルの Codex config.toml(通常は .codex ディレクトリ内)を開き、以下のプロバイダーを追加します。YOUR_RESPONSES_MODEL を、Responses エンドポイントへの対応を明示した現在の GetAPI.ONE カタログモデルに置き換えます。

ユーザーレベルの config.toml
model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"

[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"

4. 実行して確認

  1. 環境変数を永続化した場合は新しい端末を開きます。それ以外の場合は、変数を設定した現在の端末を使い続けます。
  2. プロジェクトディレクトリを開いて codex を実行します。表示されるプロバイダーとモデルが意図した設定と一致することを確認してください。
  3. 課金の可能性を受け入れた場合のみ、最小限のプロンプトを 1 つ送信します。
  4. 成功の確認には有効な CLI 応答と、それに対応する GetAPI.ONE コンソールのリクエスト記録または使用記録が必要です。このガイドの制作中にモデル呼び出しは行っていません。

順にトラブルシューティング

症状確認事項
codex: command not foundOS 用の公式インストーラーを再確認し、インストール先が PATH に含まれていることを確認します。
Missing API keyCodex を起動する同じ環境に GETAPI_ONE_API_KEY があり、env_key の綴りが正確であることを確認します。
401 / UnauthorizedONE キーをコピーし直し、有効であることと https://www.getapi.one/v1 と組み合わせていることを確認します。
404 / 互換性のないパスbase_url に /v1 が残っており、ゲートウェイが /v1/responses を公開していることを確認します。
Model not foundプレースホルダーを、キーのグループで利用でき、Responses エンドポイントの表示がある正確なカタログ名に置き換えます。
設定が変わらないCodex が読み込むユーザーレベルのファイルを編集したこと、model_provider が getapi_one を指すこと、端末またはクライアントを再起動したことを確認します。