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 タブに従ってください。
curl -fsSL https://chatgpt.com/codex/install.sh | shcodex --version2. 端末にキーを読み込む
Codex を起動する前に、現在のシェルにキーを設定します。これらの例には意図的にプレースホルダーを使用しています。
export GETAPI_ONE_API_KEY="replace-with-your-private-key"$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"3. ONE プロバイダーを設定
ユーザーレベルの Codex config.toml(通常は .codex ディレクトリ内)を開き、以下のプロバイダーを追加します。YOUR_RESPONSES_MODEL を、Responses エンドポイントへの対応を明示した現在の GetAPI.ONE カタログモデルに置き換えます。
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. 実行して確認
- 環境変数を永続化した場合は新しい端末を開きます。それ以外の場合は、変数を設定した現在の端末を使い続けます。
- プロジェクトディレクトリを開いて codex を実行します。表示されるプロバイダーとモデルが意図した設定と一致することを確認してください。
- 課金の可能性を受け入れた場合のみ、最小限のプロンプトを 1 つ送信します。
- 成功の確認には有効な CLI 応答と、それに対応する GetAPI.ONE コンソールのリクエスト記録または使用記録が必要です。このガイドの制作中にモデル呼び出しは行っていません。
順にトラブルシューティング
| 症状 | 確認事項 |
|---|---|
| codex: command not found | OS 用の公式インストーラーを再確認し、インストール先が PATH に含まれていることを確認します。 |
| Missing API key | Codex を起動する同じ環境に GETAPI_ONE_API_KEY があり、env_key の綴りが正確であることを確認します。 |
| 401 / Unauthorized | ONE キーをコピーし直し、有効であることと https://www.getapi.one/v1 と組み合わせていることを確認します。 |
| 404 / 互換性のないパス | base_url に /v1 が残っており、ゲートウェイが /v1/responses を公開していることを確認します。 |
| Model not found | プレースホルダーを、キーのグループで利用でき、Responses エンドポイントの表示がある正確なカタログ名に置き換えます。 |
| 設定が変わらない | Codex が読み込むユーザーレベルのファイルを編集したこと、model_provider が getapi_one を指すこと、端末またはクライアントを再起動したことを確認します。 |