Codex CLI で APIMart を使用する

はじめに

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

準備

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

Node.js をインストール済み Node.js 公式サイトからダウンロード・インストールしてください（最新 LTS、v20 以降を推奨）。npm から Codex CLI をインストールするために必要です
APIMart API キーを取得済み APIMart コンソールにログインして API キーを取得してください（sk- で始まります）

ヒント： APIMart アカウントをお持ちでない場合は、まず APIMart で登録して API キーを取得してください。

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

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

npm（推奨）
Homebrew（macOS）

npm でグローバルインストール。すべての OS に対応：

npm install -g @openai/codex

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

macOS ユーザーは Homebrew でもインストールできます：

brew install codex

インストールを確認

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

codex --version

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

ステップ 2：APIMart API を設定

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

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

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

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

2.2 API キーを設定

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

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

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

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

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

# デフォルトで使用するモデル
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 を再起動すると反映されます。

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

ステップ 3：使ってみる

設定を確認

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

codex "一文で自己紹介してください"

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

対話モード

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

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`	安定・バランス型	通常のコーディングタスク

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

よく使うコマンド

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” などのログインプロンプトが出る場合、設定が反映されていません。 確認手順：

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

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

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

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

Q3: 接続できない？

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

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

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

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 のプロバイダー設定を以下のように変更してください：

[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 つの方法があります：

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

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

APIMart コンソールにログインして、API 呼び出し統計、トークン消費の明細、費用トレンドをご確認ください。

サポート

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

APIMart を始める

今すぐ APIMart に登録して API キーを取得し、Codex CLI でマルチモデルのプログラミングアシスタントを体験しましょう！

チャットアプリ

開発ツール

アプリケーションプラットフォーム

Codex CLI で APIMart を使用する

はじめに

準備

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

インストールを確認

ステップ 2：APIMart API を設定

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

2.2 API キーを設定

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

ステップ 3：使ってみる

設定を確認

対話モード

承認モード

モデルを切り替え

サポートされるモデル

よく使うコマンド

よくある質問

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

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

Q3: 接続できない？

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

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

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

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

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

サポート

APIMart を始める

​はじめに

​準備

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

​インストールを確認

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

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

​2.2 API キーを設定

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

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

​設定を確認

​対話モード

​承認モード

​モデルを切り替え

​サポートされるモデル

​よく使うコマンド

​よくある質問

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

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

​Q3: 接続できない？

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

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

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

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

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

​サポート

APIMart を始める

はじめに

準備

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

インストールを確認

ステップ 2：APIMart API を設定

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

2.2 API キーを設定

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

ステップ 3：使ってみる

設定を確認

対話モード

承認モード

モデルを切り替え

サポートされるモデル

よく使うコマンド

よくある質問

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

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

Q3: 接続できない？

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

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

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

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

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

サポート