メインコンテンツへスキップ

​
はじめに

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

​
準備

始める前に、以下をご確認ください：
  1. Node.js をインストール済み Node.js 公式サイト からダウンロード・インストールしてください（最新 LTS、v20 以降を推奨）。npm から Codex CLI をインストールするために必要です
  2. APIMart API キーを取得済み APIMart コンソール にログインして API キーを取得してください（sk- で始まります）
ヒント： APIMart アカウントをお持ちでない場合は、まず APIMart で登録して API キーを取得してください。

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

以下のいずれかの方法でインストールしてください：
npm でグローバルインストール。すべての OS に対応：
npm install -g @openai/codex
権限エラーが出る場合は、コマンドの先頭に sudo を付けてください（macOS / Linux）。

​
インストールを確認

インストール後、以下のコマンドで正しく入っているか確認します： 
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_urlAPIMart の OpenAI 互換 URL。https://api.apimart.ai/v1 固定
wire_api通信プロトコル。最新の Codex では responses（Responses API）が必要
requires_openai_authtrue に設定すると、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-codexCodex 向けに最適化されたコーディングモデルエージェント型コーディングタスク
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” などのログインプロンプトが出る場合、設定が反映されていません。 確認手順：
  1. config.toml と auth.json が ~/.codex/ 配下にあるか確認
  2. config.toml の model_provider が apimart になっているか確認
  3. auth.json の JSON が正しい構文で、キーが完全に入力されているか確認

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

エラーコード意味解決方法
401 UnauthorizedAPI キーがない、または無効auth.json のキーが正しく、sk- で始まっているか確認
403 Forbidden権限不足またはキー期限切れコンソール でキーの状態を確認
また、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 に変更してください： 
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 つの方法があります：
  1. 対話 UI 内：/model コマンドで切り替え
  2. 設定を変更：config.toml の model フィールドを変更し、Codex CLI を再起動

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

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

​
サポート

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

APIMart を始める

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