https://api.acedata.cloud/v1 に送信します。
申請手順
Codex CLI を使用するには、まず Ace Data Cloud コンソール で API トークンを取得し、控えておきます。
未ログインまたは未登録の場合は、自動的にログインページにリダイレクトされ、登録・ログイン後に元のページに戻ります。
初回申請時には無料枠が付与され、Codex CLI サービスを無料で体験できます。
Codex CLI のインストール
Codex CLI は macOS、Linux、Windows、WSL をサポートしています。npm でのインストールか、macOS の場合は Homebrew を利用できます。npm インストール(推奨)
Node.js がインストール済みの場合、npm で直接インストール可能です。Node.js 18 以上が必要です。Homebrew インストール(macOS)
macOS ユーザーは Homebrew でもインストール可能です:インストール確認
インストール後、ターミナルを再起動してコマンドが使えるか確認します:command not found と表示された場合、ターミナルが新しい PATH を読み込んでいない可能性があります。ターミナルを閉じて再度開くか、インストールスクリプトの出力にある PATH 設定を確認してください。
Codex CLI の設定
インストール後、Codex CLI はデフォルトで OpenAI 公式サービスに接続しようとします。Ace Data Cloud を使うには、Codex の設定ファイルでカスタムのmodel_provider を指定し、API トークンを対応する環境変数にセットする必要があります。
ステップ1:環境変数の設定
API トークンはシェルの設定ファイル(例:~/.zshrc、~/.bashrc、~/.bash_profile)に書くことを推奨します:
{token} は Ace Data Cloud コンソールからコピーした API トークンに置き換えてください。
設定後、ターミナルを再起動するか、以下のように source コマンドで即時反映させます:
ステップ2:Codex 設定ファイルの編集
Codex CLI はグローバル設定ファイルとして~/.codex/config.toml を使用します。存在しない場合は新規作成してください:
~/.codex/config.toml に書き込みます:
OpenAI 公式ログインのキャッシュをクリア
以前に OpenAI 公式アカウントで Codex CLI にログインしている場合、ローカルにログイン状態がキャッシュされている可能性があります(通常は~/.codex/auth.json に保存)。Ace Data Cloud プロキシに切り替える前に、古いログイン情報をクリアすることを推奨します:
codex logout コマンドが使えない場合は、手動でキャッシュファイルを削除してください:
セッションの開始
プロジェクトディレクトリに移動して Codex CLI を起動します:設定の検証
Codex CLI 内で現在のモデルとプロバイダーを確認するには:acedatacloud プロバイダーが表示されれば成功です:
~/.codex/config.toml の保存状態や、現在のターミナルで ACEDATACLOUD_API_KEY が読み取れるかを確認してください:
動作原理
Codex CLI は元々 OpenAI Responses API プロトコルを使用しています。Ace Data Cloud はhttps://api.acedata.cloud/v1/responses で OpenAI Responses API 互換のプロキシサービスを提供しているため、Codex CLI はローカルにプロキシや追加プラグインを必要としません。
動作の流れ:
- Codex CLI は
~/.codex/config.tomlからmodel_providerを読み取り、対応する[model_providers.acedatacloud]設定をロードします。 - Codex CLI は
env_keyで指定された環境変数(ACEDATACLOUD_API_KEY)から API トークンを取得します。 - リクエストは
wire_api = "responses"プロトコルを使い、base_url + /responses(https://api.acedata.cloud/v1/responses)に送信されます。 - Ace Data Cloud は API トークンで認証・利用枠チェックを行い、リクエストを利用可能な上流モデルチャネルに転送します。
- リクエスト完了後、プラットフォームは実際の使用量に応じて利用量を記録し、利用枠を減算します。
codex コマンドと Codex CLI のネイティブな対話体験はそのままに、基盤となるモデルサービスだけを Ace Data Cloud に切り替えています。
モデルの設定
~/.codex/config.toml の model フィールドが Codex のデフォルトモデルを決定します。Ace Data Cloud の OpenAI Responses サービスは複数のモデルをサポートしており、主なものは以下の通りです:
一時的にモデルを切り替えたい場合は、Codex 起動時にコマンドライン引数で指定できます:
~/.codex/config.toml の model フィールドを直接変更して再起動してください。モデルの完全なリストは Ace Data Cloud OpenAI サービスドキュメント を参照してください。
プロジェクトの信頼レベル
Codex CLI はプロジェクトごとに異なる信頼レベルを設定でき、エージェントが実行可能な操作を制御します。~/.codex/config.toml の末尾に以下を追加します:
trusted:エージェントに完全な権限を付与し、コマンド実行やファイル修正が可能untrusted:制限付き権限で、未知のプロジェクトに適しています

