1. はじめに
このドキュメントでは、Codex CLIをMixrouteに接続する手順を説明します。Codex CLIは、ターミナルで動作するコマンドラインのAIコーディング支援ツールです。公式の設定ディレクトリ~/.codex内の設定ファイルを変更することで、安定性が高く管理しやすいマルチモデルのアクセス環境を構築できます。
2. 前提条件
設定を始める前に、以下の準備が完了していることを確認してください。- Codex CLIのインストール:開発環境にツールパッケージがグローバルにインストールされていることを確認してください。
- Mixrouteの認証情報(APIキー)を取得:
- Mixrouteの公式コンソールにアクセスし、アカウントを登録するかログインしてください。
- APIキー管理ページに移動し、専用のAPIキー(通常は
sk-で始まります)を生成してコピーします。
- ネットワーク接続を確認:開発用デバイスの現在のネットワーク環境から、Mixrouteのサービスアドレス
https://api.mixroute.aiにアクセスできることを確認してください。
3. 設定段階
Codex CLIの主要な設定は、ユーザーディレクトリ内の.codexフォルダーにあります。設定は主に、インターフェースとモデルのパラメーターを扱うconfig.tomlと、キーの安全な保存を扱うauth.jsonの2つのファイルで行います。
3.1 設定ディレクトリを見つける、または作成する
Windowsユーザー: キーボードでWin+Rを押し、%userprofile%\.codexと入力してEnterを押します。
MacOS / Linuxユーザー: ターミナルで~/.codexディレクトリに移動するか、ファイルマネージャーで開いてください。
重要:Codex CLIを初めてインストールする場合、このディレクトリやその中のファイルが存在しないことがあります。ディレクトリと、以下に記載する2つのファイルを手動で作成してください。
3.2 Config.tomlの設定
.codex/config.tomlファイルを作成または編集し、以下のMixroute設定をコピーして保存します。
注:
base_urlは/v1で終わる必要があり、末尾にスラッシュを付けないでください。- 大半のサードパーティ製プロキシゲートウェイは
/chat/completionsを実装しているため、wire_apiは"chat"のままにしておくことをお勧めします。404エラーが発生した場合は、プラットフォームの具体的な互換性に応じて"responses"への変更を試すことができます。
3.3 auth.jsonを設定する
.codex/auth.jsonファイルを作成または編集します。セキュリティのため、TOMLファイルにAPIキーを直接記述せず、こちらのJSONファイルに保存してください。
"sk-yourMixrouteKeyxxxxxxxxxxxx"を、準備段階で取得した実際のMixroute APIキーに置き換えてください。
4. 検証とテスト
設定が完了したら、ターミナルでCodex CLIを起動して会話をテストします。- Codexが正常に応答すれば、Mixrouteへの接続は成功しています。
- 認証エラーや接続失敗などのエラーが発生した場合は、
auth.json内のキーの形式が正しいか(二重引用符を含む)、またconfig.toml内のbase_urlが正確にhttps://api.mixroute.ai/v1に設定されているかを、よく確認してください。