Codex は、ターミナルで動作する AI コーディングツールです。Codex を Novita の OpenAI 互換 LLM API エンドポイントに接続し、Novita モデルをコード理解、生成、リファクタリング、デバッグのタスクに使用できます。
Codex は現在、Responses API のみをサポートしています。以下に示すように wire_api = "responses" を設定し、この連携を Chat Completions モードに切り替えないでください。
前提条件
開始する前に、次の値を準備してください。
- API key: Key Management から API キーを作成またはコピーします。
- Base URL:
https://api.novita.ai/openai/v1
- Model ID: Model Hub から使用したいモデル ID をコピーします。例:
deepseek/deepseek-v3.1。
API キーは秘密に保管してください。ローカルの Codex 設定でのみ使用し、Git リポジトリには絶対にコミットしないでください。
Codex をインストールする
Codex をインストールする前に、Node.js 18 以上 がマシンにインストールされていることを確認してください。
macOS で Homebrew を使用している場合は、次のコマンドで Node.js をインストールできます。
Node.js と npm のバージョンを確認します。
Codex CLI をインストールします。
Codex のバージョンを確認します。
API キーを設定する
シェル設定ファイルを開きます。例: ~/.zshrc。
次の環境変数を追加します。
シェル設定を再読み込みし、変数が利用可能であることを確認します。
Codex を設定する
Codex 設定ファイルを開きます。
次の設定を追加し、model を使用したい Novita モデル ID に置き換えます。
Codex を起動する
プロジェクトディレクトリに移動し、Codex を起動します。
これで、たとえば次のようなコーディングタスクを入力できます。
Codex が認証エラーまたはモデルエラーを返す場合は、次の点を確認してください。
NOVITA_API_KEY が現在のターミナルセッションで利用可能であること。model が Novita の Model Hub の Model ID と完全に一致していること。base_url が https://api.novita.ai/openai/v1 に設定されていること。
