> ## 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

> Verbind Codex met Novita's OpenAI-compatibele LLM API-eindpunt.

Codex is een AI-codingtool die in je terminal draait. Je kunt Codex verbinden met Novita's OpenAI-compatibele LLM API-eindpunt en Novita-modellen gebruiken voor codebegrip, generatie, refactoring en debuggingtaken.

<Warning>
  Codex ondersteunt momenteel alleen de Responses API. Configureer `wire_api = "responses"` zoals hieronder getoond, en schakel deze integratie niet over naar Chat Completions-modus.
</Warning>

## Vereisten

Bereid de volgende waarden voor voordat je begint:

* **API-sleutel**: Maak of kopieer een API-sleutel vanuit [Sleutelbeheer](https://novita.ai/settings/key-management).
* **Basis-URL**: `https://api.novita.ai/openai/v1`
* **Model-ID**: Kopieer de model-ID die je wilt gebruiken vanuit de Model Hub, zoals `deepseek/deepseek-v3.1`.

<Tip>
  Houd je API-sleutel privé. Gebruik deze alleen in je lokale Codex-configuratie en commit deze nooit naar een Git-repository.
</Tip>

## Codex installeren

Zorg er vóór het installeren van Codex voor dat [Node.js 18 of hoger](https://nodejs.org/en/download/) op je machine is geïnstalleerd.

Als je Homebrew gebruikt op macOS, kun je Node.js installeren met:

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

Controleer je Node.js- en npm-versies:

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

Installeer de Codex CLI:

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

Controleer de Codex-versie:

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

## Je API-sleutel configureren

Open je shellconfiguratiebestand, bijvoorbeeld `~/.zshrc`:

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

Voeg de volgende omgevingsvariabele toe:

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

Laad je shellconfiguratie opnieuw en controleer of de variabele beschikbaar is:

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

## Codex configureren

Open het Codex-configuratiebestand:

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

Voeg de volgende configuratie toe en vervang `model` door de Novita-model-ID die je wilt gebruiken:

```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 starten

Ga naar je projectdirectory en start Codex:

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

Je kunt nu een codingtaak invoeren, bijvoorbeeld:

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

Als Codex een authenticatie- of modelfout retourneert, controleer dan of:

* `NOVITA_API_KEY` beschikbaar is in de huidige terminalsessie.
* `model` exact overeenkomt met de Model-ID in Novita's Model Hub.
* `base_url` is ingesteld op `https://api.novita.ai/openai/v1`.