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

# Codex CLI で APIMart を使用する

> Codex CLI で APIMart API サービスを設定・使用する方法を詳しく解説します。簡単な設定でターミナルから複数の AI モデルを呼び出してプログラミングを支援します。

## はじめに

Codex CLI は OpenAI が公開しているオープンソースのターミナル向けプログラミングエージェントです。コマンドラインから直接ファイルの読み書き、コマンドの実行、バグ修正、コーディングタスク全体の遂行まで行えます。
APIMart を接続することで、GPT、Claude をはじめとする各種モデルを Codex CLI 上で自由に利用でき、より柔軟でお得な料金体系の恩恵を受けられます。

## 準備

始める前に、以下をご確認ください：

1. **Node.js をインストール済み**
   [Node.js 公式サイト](https://nodejs.org/) からダウンロード・インストールしてください（最新 LTS、v20 以降を推奨）。npm から Codex CLI をインストールするために必要です

2. **APIMart API キーを取得済み**
   [APIMart コンソール](https://apimart.ai/keys) にログインして API キーを取得してください（`sk-` で始まります）

<Note>**ヒント：** APIMart アカウントをお持ちでない場合は、まず [APIMart](https://apimart.ai) で登録して API キーを取得してください。</Note>

## ステップ 1：Codex CLI をインストール

以下のいずれかの方法でインストールしてください：

<Tabs>
  <Tab title="npm（推奨）">
    npm でグローバルインストール。すべての OS に対応：

    ```bash theme={null}
    npm install -g @openai/codex
    ```

    <Note>権限エラーが出る場合は、コマンドの先頭に `sudo` を付けてください（macOS / Linux）。</Note>
  </Tab>

  <Tab title="Homebrew（macOS）">
    macOS ユーザーは Homebrew でもインストールできます：

    ```bash theme={null}
    brew install codex
    ```
  </Tab>
</Tabs>

### インストールを確認

インストール後、以下のコマンドで正しく入っているか確認します：

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

バージョン番号が表示されればインストール成功です。

## ステップ 2：APIMart API を設定

Codex CLI は `~/.codex/` ディレクトリの設定ファイルでモデルプロバイダーを管理します。APIMart を指すカスタムプロバイダーを 1 つ追加するだけで済みます。

### 2.1 設定ディレクトリを確認

* **macOS / Linux：** `~/.codex/`
* **Windows：** `C:\Users\<ユーザー名>\.codex\`

<Note>ディレクトリが存在しない場合、ターミナルで `codex` を一度実行してから `Ctrl + C` で終了すると、自動的に作成されます。</Note>

### 2.2 API キーを設定

設定ディレクトリに `auth.json` ファイルを作成または編集し、APIMart キーを入力します：

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

| フィールド            | 説明                              |
| ---------------- | ------------------------------- |
| `OPENAI_API_KEY` | あなたの APIMart API キー（`sk-` で始まる） |

### 2.3 モデルプロバイダーを設定

設定ディレクトリに `config.toml` ファイルを作成または編集し、APIMart プロバイダーを追加します：

```toml theme={null}
# デフォルトで使用するモデル
model = "gpt-5.5"
# デフォルトプロバイダー — 下記 [model_providers.apimart] と対応
model_provider = "apimart"

# APIMart プロバイダー設定
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true
```

| フィールド                  | 説明                                                     |
| ---------------------- | ------------------------------------------------------ |
| `model`                | デフォルトで使用するモデル ID。下記モデル一覧から選択                           |
| `model_provider`       | デフォルトプロバイダー。`[model_providers.xxx]` 内の ID と一致させる       |
| `name`                 | プロバイダーの表示名。任意で設定可能                                     |
| `base_url`             | APIMart の OpenAI 互換 URL。`https://api.apimart.ai/v1` 固定 |
| `wire_api`             | 通信プロトコル。最新の Codex では `responses`（Responses API）が必要     |
| `requires_openai_auth` | `true` に設定すると、`auth.json` のキーで認証します                    |

両方のファイルを保存後、Codex CLI を再起動すると反映されます。

<Warning>`auth.json` は正しい JSON 形式、`config.toml` は正しい TOML 形式である必要があります。全角の引用符を使わないでください。設定が反映されません。</Warning>

## ステップ 3：使ってみる

### 設定を確認

任意のプロジェクトディレクトリで以下を実行し、設定が正しいことを確認します：

```bash theme={null}
codex "一文で自己紹介してください"
```

AI から返答があれば設定成功です。ログイン画面が表示されたり、`401` や `403` エラーが出る場合は、以下のよくある質問をご確認ください。

### 対話モード

`codex` をそのまま実行すると対話 UI に入ります。本格的なコーディングタスクに最適です：

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

入った後は自然言語で要件を伝えるだけです。例：

```
JSON を返すヘルスチェックエンドポイント付きの Express.js サーバーを作って
```

Codex はプロジェクトを分析してコードを生成し、コマンドを実行し、機密性のある操作の前には確認を求めます。

### 承認モード

初回起動時に Codex は操作の承認レベルを尋ねてきます：

| モード        | 説明                                    |
| ---------- | ------------------------------------- |
| **読み取り専用** | ファイルの読み取りのみ許可。あらゆる変更とコマンドは確認が必要       |
| **自動**     | 作業ディレクトリ内でファイルの読み書きやコマンド実行を自律的に実行（推奨） |
| **フルアクセス** | 確認なしでどんな操作も実行。慎重に使用してください             |

最初は **自動** モードから始めるのがおすすめです。対話 UI で `/approvals` と入力すればいつでも変更できます。

### モデルを切り替え

対話 UI で `/model` と入力すれば素早く切り替えられます。または `config.toml` の `model` フィールドを変更して再起動してください。

## サポートされるモデル

Codex CLI では、以下の GPT-5 系モデルを推奨します：

| モデル ID          | 特長                       | 推奨シーン                |
| --------------- | ------------------------ | -------------------- |
| `gpt-5.5`       | 最新フラッグシップ、コーディング最強       | Codex の第一候補、複雑な工学タスク |
| `gpt-5.4`       | 前世代フラッグシップ、強力            | 複雑なコーディング、設計         |
| `gpt-5.4-mini`  | 軽量版、高速かつコスパ良好            | 日常のコーディング、高速イテレーション  |
| `gpt-5.3-codex` | Codex 向けに最適化されたコーディングモデル | エージェント型コーディングタスク     |
| `gpt-5.2`       | 安定・バランス型                 | 通常のコーディングタスク         |

<Tip>
  **モデル選択のヒント：** 上記の GPT-5 系モデルは Codex CLI との相性が最も良いです。最高の体験を求めるなら `gpt-5.5` を優先してください。`gpt-5.3-codex` は Codex のエージェント型コーディングシーンに最適化されています。
</Tip>

## よく使うコマンド

Codex CLI でよく使うコマンドとショートカット：

| コマンド                    | 説明               |
| ----------------------- | ---------------- |
| `codex`                 | 対話 UI を開く        |
| `codex "タスク内容"`         | 初期指示付きで起動        |
| `codex exec "タスク内容"`    | 非対話モード。実行後すぐ終了   |
| `codex --model gpt-5.4` | モデルを指定して起動       |
| `codex --version`       | バージョン番号を表示       |
| `/model`                | 対話 UI 内でモデルを切り替え |
| `/approvals`            | 対話 UI 内で承認モードを変更 |
| `Ctrl + C`              | 対話 UI を終了        |

## よくある質問

### Q1: 起動すると ChatGPT のログイン画面が出る？

起動後に "Sign in with ChatGPT" などのログインプロンプトが出る場合、設定が反映されていません。

**確認手順：**

1. `config.toml` と `auth.json` が `~/.codex/` 配下にあるか確認
2. `config.toml` の `model_provider` が `apimart` になっているか確認
3. `auth.json` の JSON が正しい構文で、キーが完全に入力されているか確認

### Q2: 401 / 403 エラーが出る？

| エラーコード             | 意味              | 解決方法                                       |
| ------------------ | --------------- | ------------------------------------------ |
| `401 Unauthorized` | API キーがない、または無効 | `auth.json` のキーが正しく、`sk-` で始まっているか確認       |
| `403 Forbidden`    | 権限不足またはキー期限切れ   | [コンソール](https://apimart.ai/keys) でキーの状態を確認 |

また、`base_url` が `https://api.apimart.ai/v1` に設定されており、OpenAI 公式 URL ではないことを確認してください。

### Q3: 接続できない？

1. ネットワーク接続を確認
2. `config.toml` の `base_url` が正しく設定されているか確認
3. プロキシ使用時は、`api.apimart.ai` へのアクセスが許可されているか確認

### Q4: `wire_api = "chat"` がサポートされなくなった？

最新の Codex CLI（0.84.0 以降）では `chat` プロトコルが削除されました。`config.toml` の `wire_api` を `responses` に変更してください：

```toml theme={null}
wire_api = "responses"
```

APIMart は Responses API に対応済みです。変更後 Codex を再起動するだけで使えます。

### Q5: ツール呼び出しや実行でエラーが出る？

`config.toml` の `wire_api` が `responses` になっているか確認してください。互換性の問題に当たる場合は、推奨されている GPT-5 系モデル（例：`gpt-5.5`、`gpt-5.3-codex`）に切り替えると、Codex CLI と相性が良く安定します。

### Q6: auth.json ではなく環境変数を使いたい？

環境変数でもキーを設定できます。`config.toml` のプロバイダー設定を以下のように変更してください：

```toml theme={null}
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"
```

その後、環境変数 `APIMART_API_KEY` に APIMart のキーを設定すれば OK です。この場合 `auth.json` は不要です。

### Q7: モデルを切り替えるには？

2 つの方法があります：

1. **対話 UI 内**：`/model` コマンドで切り替え
2. **設定を変更**：`config.toml` の `model` フィールドを変更し、Codex CLI を再起動

### Q8: 利用状況や費用はどこで確認する？

[APIMart コンソール](https://apimart.ai/overview) にログインして、API 呼び出し統計、トークン消費の明細、費用トレンドをご確認ください。

## サポート

ご利用中に問題が発生した場合は：

* 📚 [APIMart ドキュメントセンター](https://docs.apimart.ai)
* 💬 [Discord コミュニティ](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 テクニカルサポート：[zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="APIMart を始める" icon="rocket" href="https://apimart.ai">
  今すぐ APIMart に登録して API キーを取得し、Codex CLI でマルチモデルのプログラミングアシスタントを体験しましょう！
</Card>