Skip to main content
Codex CLI は OpenAI が提供するオープンソースのローカルプログラミングエージェントで、あなたのターミナル上で動作します。コードの読み取り、ファイルの修正、コマンドの実行、エラーの説明、日常的な開発作業の支援が可能です。 Codex CLI はカスタムモデルプロバイダーをサポートしており、Ace Data Cloud が提供する OpenAI Responses 互換のプロキシを利用して、OpenAI の公式アカウントを別途契約することなく使用できます。設定完了後、Codex CLI はリクエストを 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 コマンドが使えない場合は、手動でキャッシュファイルを削除してください:
OpenAI 公式アカウントでログインしたことがなければ、このステップは不要です。

セッションの開始

プロジェクトディレクトリに移動して Codex CLI を起動します:
Codex の対話画面が表示されたら、以下のように直接要望を入力できます:

設定の検証

Codex CLI 内で現在のモデルとプロバイダーを確認するには:
以下のように acedatacloud プロバイダーが表示されれば成功です:
異なるプロバイダーが表示される場合は設定が反映されていません。~/.codex/config.toml の保存状態や、現在のターミナルで ACEDATACLOUD_API_KEY が読み取れるかを確認してください:
また、Ace Data Cloud コンソール - 利用履歴 でリクエスト履歴や課金状況を、Ace Data Cloud コンソール - アプリケーション一覧 で残りの利用枠を確認できます。

動作原理

Codex CLI は元々 OpenAI Responses API プロトコルを使用しています。Ace Data Cloud は https://api.acedata.cloud/v1/responses で OpenAI Responses API 互換のプロキシサービスを提供しているため、Codex CLI はローカルにプロキシや追加プラグインを必要としません。 動作の流れ:
  1. Codex CLI は ~/.codex/config.toml から model_provider を読み取り、対応する [model_providers.acedatacloud] 設定をロードします。
  2. Codex CLI は env_key で指定された環境変数(ACEDATACLOUD_API_KEY)から API トークンを取得します。
  3. リクエストは wire_api = "responses" プロトコルを使い、base_url + /responseshttps://api.acedata.cloud/v1/responses)に送信されます。
  4. Ace Data Cloud は API トークンで認証・利用枠チェックを行い、リクエストを利用可能な上流モデルチャネルに転送します。
  5. リクエスト完了後、プラットフォームは実際の使用量に応じて利用量を記録し、利用枠を減算します。
つまり、元の codex コマンドと Codex CLI のネイティブな対話体験はそのままに、基盤となるモデルサービスだけを Ace Data Cloud に切り替えています。

モデルの設定

~/.codex/config.tomlmodel フィールドが Codex のデフォルトモデルを決定します。Ace Data Cloud の OpenAI Responses サービスは複数のモデルをサポートしており、主なものは以下の通りです: 一時的にモデルを切り替えたい場合は、Codex 起動時にコマンドライン引数で指定できます:
または ~/.codex/config.tomlmodel フィールドを直接変更して再起動してください。モデルの完全なリストは Ace Data Cloud OpenAI サービスドキュメント を参照してください。

プロジェクトの信頼レベル

Codex CLI はプロジェクトごとに異なる信頼レベルを設定でき、エージェントが実行可能な操作を制御します。~/.codex/config.toml の末尾に以下を追加します:
意味は以下の通りです:
  • trusted:エージェントに完全な権限を付与し、コマンド実行やファイル修正が可能
  • untrusted:制限付き権限で、未知のプロジェクトに適しています

さらに詳しく