> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

## 1. はじめに

このドキュメントでは、**Codex CLI**を**Mixroute**に接続する手順を説明します。Codex CLIは、ターミナルで動作するコマンドラインのAIコーディング支援ツールです。公式の設定ディレクトリ`~/.codex`内の設定ファイルを変更することで、安定性が高く管理しやすいマルチモデルのアクセス環境を構築できます。

## 2. 前提条件

設定を始める前に、以下の準備が完了していることを確認してください。

1. **Codex CLIのインストール**：開発環境にツールパッケージがグローバルにインストールされていることを確認してください。
2. **Mixrouteの認証情報（APIキー）を取得**：
   * Mixrouteの公式コンソールにアクセスし、アカウントを登録するかログインしてください。
   * APIキー管理ページに移動し、専用の**APIキー**（通常は`sk-`で始まります）を生成してコピーします。
3. **ネットワーク接続を確認**：開発用デバイスの現在のネットワーク環境から、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設定をコピーして保存します。

```toml theme={null}
# Set the global default provider to mixroute
model_provider = "mixroute"
# Set the default model (fill in according to models supported by Mixroute, e.g., gpt-5.4-mini, claude-sonnet-5, etc.)
model = "openai/gpt-5.4-mini"
model_reasoning_effort = "high"
disable_response_storage = true
model_verbosity = "high"

[model_providers.mixroute]
name = "mixroute API Gateway"
base_url = "https://api.mixroute.ai/v1"
# Use the compatible chat interface
wire_api = "chat"
# It is recommended to disable mandatory sk- verification for third-party gateways
requires_openai_auth = false
```

> **注:**
>
> 1. `base_url`は`/v1`で終わる必要があり、末尾にスラッシュを付けないでください。
> 2. 大半のサードパーティ製プロキシゲートウェイは`/chat/completions`を実装しているため、`wire_api`は`"chat"`のままにしておくことをお勧めします。404エラーが発生した場合は、プラットフォームの具体的な互換性に応じて`"responses"`への変更を試すことができます。

### 3.3 auth.jsonを設定する

`.codex/auth.json`ファイルを作成または編集します。セキュリティのため、TOMLファイルにAPIキーを直接記述せず、こちらのJSONファイルに保存してください。

```json theme={null}
{
  "OPENAI_API_KEY": "sk-yourMixrouteKeyxxxxxxxxxxxx"
}
```

`"sk-yourMixrouteKeyxxxxxxxxxxxx"`を、準備段階で取得した実際のMixroute APIキーに置き換えてください。

## 4. 検証とテスト

設定が完了したら、ターミナルでCodex CLIを起動して会話をテストします。

```bash theme={null}
codex
```

ターミナルに対話型インターフェースが表示されたら、簡単なテストプロンプト（例：「こんにちは。Pythonでhello worldスクリプトを書いてください」）を入力してみてください。

* Codexが正常に応答すれば、Mixrouteへの接続は成功しています。
* 認証エラーや接続失敗などのエラーが発生した場合は、`auth.json`内のキーの形式が正しいか（二重引用符を含む）、また`config.toml`内の`base_url`が正確に`https://api.mixroute.ai/v1`に設定されているかを、よく確認してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.