> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Codex CLI ターミナル使用チュートリアル > Codex 集成指南 - Ace Data Cloud Codex CLI は OpenAI が提供するオープンソースのローカルプログラミングエージェントで、あなたのターミナル上で動作します。コードの読み取り、ファイルの修正、コマンドの実行、エラーの説明、日常的な開発作業の支援が可能です。 Codex CLI はカスタムモデルプロバイダーをサポートしており、Ace Data Cloud が提供する OpenAI Responses 互換のプロキシを利用して、OpenAI の公式アカウントを別途契約することなく使用できます。設定完了後、Codex CLI はリクエストを `https://api.acedata.cloud/v1` に送信します。 ## 申請手順 Codex CLI を使用するには、まず [Ace Data Cloud コンソール](https://platform.acedata.cloud/console/applications) で API トークンを取得し、控えておきます。 ![](https://cdn.acedata.cloud/5hmkdg.jpg) 未ログインまたは未登録の場合は、自動的にログインページにリダイレクトされ、登録・ログイン後に元のページに戻ります。 初回申請時には無料枠が付与され、Codex CLI サービスを無料で体験できます。 ## Codex CLI のインストール Codex CLI は macOS、Linux、Windows、WSL をサポートしています。npm でのインストールか、macOS の場合は Homebrew を利用できます。 ### npm インストール（推奨） Node.js がインストール済みの場合、npm で直接インストール可能です。Node.js 18 以上が必要です。 ```bash theme={null} npm install -g @openai/codex ``` ### Homebrew インストール（macOS） macOS ユーザーは Homebrew でもインストール可能です： ```bash theme={null} brew install --cask codex ``` ### インストール確認 インストール後、ターミナルを再起動してコマンドが使えるか確認します： ```bash theme={null} codex --version ``` `command not found` と表示された場合、ターミナルが新しい PATH を読み込んでいない可能性があります。ターミナルを閉じて再度開くか、インストールスクリプトの出力にある PATH 設定を確認してください。 ## Codex CLI の設定 インストール後、Codex CLI はデフォルトで OpenAI 公式サービスに接続しようとします。Ace Data Cloud を使うには、Codex の設定ファイルでカスタムの `model_provider` を指定し、API トークンを対応する環境変数にセットする必要があります。 ### ステップ1：環境変数の設定 API トークンはシェルの設定ファイル（例：`~/.zshrc`、`~/.bashrc`、`~/.bash_profile`）に書くことを推奨します： ```bash theme={null} export ACEDATACLOUD_API_KEY="{token}" ``` `{token}` は Ace Data Cloud コンソールからコピーした API トークンに置き換えてください。 設定後、ターミナルを再起動するか、以下のように `source` コマンドで即時反映させます： ```bash theme={null} source ~/.zshrc ``` ### ステップ2：Codex 設定ファイルの編集 Codex CLI はグローバル設定ファイルとして `~/.codex/config.toml` を使用します。存在しない場合は新規作成してください： ```bash theme={null} mkdir -p ~/.codex touch ~/.codex/config.toml ``` 以下の内容を `~/.codex/config.toml` に書き込みます： ```toml theme={null} model_provider = "acedatacloud" model = "gpt-5" model_reasoning_effort = "high" [model_providers.acedatacloud] name = "Ace Data Cloud" base_url = "https://api.acedata.cloud/v1" env_key = "ACEDATACLOUD_API_KEY" wire_api = "responses" ``` 各フィールドの説明： | フィールド | 説明 | | ----------------------------------------- | ------------------------------------------------------ | | `model_provider` | デフォルトで使用するプロバイダー名。下の `[model_providers.]` のキーに対応 | | `model` | デフォルトで使用するモデルID | | `model_reasoning_effort` | 推論の強度。一般的な値は `low`、`medium`、`high` | | `[model_providers.acedatacloud].base_url` | Ace Data Cloud の OpenAI Responses プロキシのURL | | `[model_providers.acedatacloud].env_key` | Codex CLI が API トークンを読み取る環境変数名 | | `[model_providers.acedatacloud].wire_api` | プロトコルタイプ。OpenAI Responses API を使う場合は `responses` | ### OpenAI 公式ログインのキャッシュをクリア 以前に OpenAI 公式アカウントで Codex CLI にログインしている場合、ローカルにログイン状態がキャッシュされている可能性があります（通常は `~/.codex/auth.json` に保存）。Ace Data Cloud プロキシに切り替える前に、古いログイン情報をクリアすることを推奨します： ```bash theme={null} codex logout ``` `codex logout` コマンドが使えない場合は、手動でキャッシュファイルを削除してください： ```bash theme={null} rm -f ~/.codex/auth.json ``` OpenAI 公式アカウントでログインしたことがなければ、このステップは不要です。 ### セッションの開始 プロジェクトディレクトリに移動して Codex CLI を起動します： ```bash theme={null} cd /path/to/your/project codex ``` Codex の対話画面が表示されたら、以下のように直接要望を入力できます： ```text theme={null} このプロジェクトのディレクトリ構造を説明してください ``` ### 設定の検証 Codex CLI 内で現在のモデルとプロバイダーを確認するには： ```text theme={null} /model ``` 以下のように `acedatacloud` プロバイダーが表示されれば成功です： ```text theme={null} Model: gpt-5 Provider: acedatacloud ``` 異なるプロバイダーが表示される場合は設定が反映されていません。`~/.codex/config.toml` の保存状態や、現在のターミナルで `ACEDATACLOUD_API_KEY` が読み取れるかを確認してください： ```bash theme={null} echo $ACEDATACLOUD_API_KEY ``` また、[Ace Data Cloud コンソール - 利用履歴](https://platform.acedata.cloud/console/usages) でリクエスト履歴や課金状況を、[Ace Data Cloud コンソール - アプリケーション一覧](https://platform.acedata.cloud/console/applications) で残りの利用枠を確認できます。 ## 動作原理 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 + /responses`（`https://api.acedata.cloud/v1/responses`）に送信されます。 4. Ace Data Cloud は API トークンで認証・利用枠チェックを行い、リクエストを利用可能な上流モデルチャネルに転送します。 5. リクエスト完了後、プラットフォームは実際の使用量に応じて利用量を記録し、利用枠を減算します。 つまり、元の `codex` コマンドと Codex CLI のネイティブな対話体験はそのままに、基盤となるモデルサービスだけを Ace Data Cloud に切り替えています。 ## モデルの設定 `~/.codex/config.toml` の `model` フィールドが Codex のデフォルトモデルを決定します。Ace Data Cloud の OpenAI Responses サービスは複数のモデルをサポートしており、主なものは以下の通りです： | モデル | 説明 | | ------------------ | ---------------------------- | | `gpt-5` | 推奨デフォルトモデル。ほとんどのコーディングタスクに適合 | | `gpt-5-mini` | より軽量で応答が速い。簡単なタスク向け | | `gpt-5.5` | 新しいバージョンでより高性能 | | `gpt-5.5-pro` | 強化バージョン。複雑な推論タスクに適合 | | `gpt-4.1` | 前世代の主力モデル | | `o3` | 推論強化モデル。深い推論が必要なタスク向け | | `o4-mini-high-all` | 軽量推論モデル | 一時的にモデルを切り替えたい場合は、Codex 起動時にコマンドライン引数で指定できます： ```bash theme={null} codex --model gpt-5-mini ``` または `~/.codex/config.toml` の `model` フィールドを直接変更して再起動してください。モデルの完全なリストは [Ace Data Cloud OpenAI サービスドキュメント](https://platform.acedata.cloud/documents/openai) を参照してください。 ## プロジェクトの信頼レベル Codex CLI はプロジェクトごとに異なる信頼レベルを設定でき、エージェントが実行可能な操作を制御します。`~/.codex/config.toml` の末尾に以下を追加します： ```toml theme={null} [projects."/path/to/trusted/project"] trust_level = "trusted" [projects."/path/to/untrusted/project"] trust_level = "untrusted" ``` 意味は以下の通りです： * `trusted`：エージェントに完全な権限を付与し、コマンド実行やファイル修正が可能 * `untrusted`：制限付き権限で、未知のプロジェクトに適しています ## さらに詳しく * [Codex CLI 公式リポジトリ](https://github.com/openai/codex) * [Ace Data Cloud OpenAI サービスドキュメント](https://platform.acedata.cloud/documents/openai) * [Ace Data Cloud コンソール](https://platform.acedata.cloud/console/applications)