Codex CLI

CometAPI で OpenAI Codex CLI をセットアップします: config.toml で openai_base_url またはカスタムプロバイダーを設定し、API キーを auth.json に保存して、最新のモデルでコーディングを始めましょう。

このガイドでは、CometAPI をモデルプロバイダーとして使用して Codex CLI を実行する方法を説明します。

公式リファレンス:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

モデルの提供状況は頻繁に変わります。以下の例では your-model-id を使用しています。これを CometAPI Models page にある、現在利用可能なコーディング向けモデル ID に置き換えてください。

​

前提条件

Requirement	Details
OS	macOS 12+、Linux（Ubuntu 20.04+ / Debian 10+）、または WSL2 経由の Windows 11
Node.js	22+（LTS 推奨）
Git	2.23+ 推奨
CometAPI key	CometAPI Dashboard で取得できます（sk- で始まります）

​

Codex CLI をインストールする

npm i -g @openai/codex

または Homebrew 経由:

brew install --cask codex

インストールを確認します:

codex --version

​

CometAPI を設定する

Codex から CometAPI を参照する方法は 2 つあります。ワークフローに合う方を選んでください。

Simple: openai_base_url

最も簡単な方法です。組み込みの OpenAI プロバイダーを 1 行で CometAPI にリダイレクトできます。 カスタムプロバイダーを定義する必要はありません。

~/.codex/config.toml を作成します:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Named provider

名前付きの cometapi プロバイダーを定義します。--profile または model_provider を使って 複数のプロバイダーを切り替えたい場合に便利です。

~/.codex/config.toml を作成します:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

env_key は、API キーを保持している環境変数名を Codex に伝えるものです。 Codex は実行時に OPENAI_API_KEY の値を読み取ります。これは実際のキーそのものではありません。

​

API キーを保存する

~/.codex/auth.json を作成します:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

sk-your-cometapi-key を実際の CometAPI キーに置き換えてください。

このファイルは必須です。 auth.json に有効な OPENAI_API_KEY エントリーがないと、 Codex は API key auth is missing a key を表示して終了します。

​

Codex を開始する

cd your-project
codex

初回起動時、Codex はテーマの選択と安全設定の確認を求めます。

​

セッションごとに model を上書きする

config.toml を編集せずに、1 回の実行だけ別の model に切り替えるには:

codex --model your-model-id

​

代替方法: 環境変数

auth.json の代わりに、キーを直接 export することもできます:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

これでキーは現在のターミナルセッションでのみ設定されます。永続化するには、export 行を ~/.zshrc または ~/.bashrc に追加してください。

​

トラブルシューティング

Symptom	Fix
API key auth is missing a key	~/.codex/auth.json に "OPENAI_API_KEY": "sk-..." が含まれていることを確認してください
Login prompt appears unexpectedly	古い ~/.codex/auth.json を削除し、CometAPI キーを使って再作成してください
Model not found	現在利用可能なモデルは Models page で確認してください
Connection timeout	config.toml の openai_base_url または base_url が https://api.cometapi.com/v1 になっていることを確認してください
Windows issues	Codex は Windows 上で WSL2 を必要とします。ネイティブの CMD/PowerShell はサポートされていません