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

# Codex

> Codex を Novita の OpenAI 互換 LLM API エンドポイントに接続します。

Codex は、ターミナルで動作する AI コーディングツールです。Codex を Novita の OpenAI 互換 LLM API エンドポイントに接続し、Novita モデルをコード理解、生成、リファクタリング、デバッグのタスクに使用できます。

<Warning>
  Codex は現在、Responses API のみをサポートしています。以下に示すように `wire_api = "responses"` を設定し、この連携を Chat Completions モードに切り替えないでください。
</Warning>

## 前提条件

開始する前に、次の値を準備してください。

* **API key**: [Key Management](https://novita.ai/settings/key-management) から API キーを作成またはコピーします。
* **Base URL**: `https://api.novita.ai/openai/v1`
* **Model ID**: Model Hub から使用したいモデル ID をコピーします。例: `deepseek/deepseek-v3.1`。

<Tip>
  API キーは秘密に保管してください。ローカルの Codex 設定でのみ使用し、Git リポジトリには絶対にコミットしないでください。
</Tip>

## Codex をインストールする

Codex をインストールする前に、[Node.js 18 以上](https://nodejs.org/en/download/) がマシンにインストールされていることを確認してください。

macOS で Homebrew を使用している場合は、次のコマンドで Node.js をインストールできます。

```bash theme={"system"}
brew install node
```

Node.js と npm のバージョンを確認します。

```bash theme={"system"}
node -v
npm -v
```

Codex CLI をインストールします。

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

Codex のバージョンを確認します。

```bash theme={"system"}
codex --version
```

## API キーを設定する

シェル設定ファイルを開きます。例: `~/.zshrc`。

```bash theme={"system"}
nano ~/.zshrc
```

次の環境変数を追加します。

```bash theme={"system"}
export NOVITA_API_KEY="<your-novita-api-key>"
```

シェル設定を再読み込みし、変数が利用可能であることを確認します。

```bash theme={"system"}
source ~/.zshrc
echo $NOVITA_API_KEY
```

## Codex を設定する

Codex 設定ファイルを開きます。

```bash theme={"system"}
mkdir -p ~/.codex
nano ~/.codex/config.toml
```

次の設定を追加し、`model` を使用したい Novita モデル ID に置き換えます。

```toml theme={"system"}
model_provider = "novita"
model = "deepseek/deepseek-v3.1"

[model_providers]
[model_providers.novita]
name = "Novita"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.novita.ai/openai/v1"
env_key = "NOVITA_API_KEY"
```

## Codex を起動する

プロジェクトディレクトリに移動し、Codex を起動します。

```bash theme={"system"}
cd <your-project-directory>
codex
```

これで、たとえば次のようなコーディングタスクを入力できます。

```text theme={"system"}
Read this project and summarize the main modules.
```

Codex が認証エラーまたはモデルエラーを返す場合は、次の点を確認してください。

* `NOVITA_API_KEY` が現在のターミナルセッションで利用可能であること。
* `model` が Novita の Model Hub の Model ID と完全に一致していること。
* `base_url` が `https://api.novita.ai/openai/v1` に設定されていること。