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

> Verbinden Sie Codex mit Novitas OpenAI-kompatiblem LLM-API-Endpunkt.

Codex ist ein KI-Coding-Tool, das in Ihrem Terminal ausgeführt wird. Sie können Codex mit Novitas OpenAI-kompatiblem LLM-API-Endpunkt verbinden und Novita-Modelle für Aufgaben wie Codeverständnis, Generierung, Refactoring und Debugging verwenden.

<Warning>
  Codex unterstützt derzeit nur die Responses API. Konfigurieren Sie `wire_api = "responses"` wie unten gezeigt und stellen Sie diese Integration nicht auf den Chat Completions-Modus um.
</Warning>

## Voraussetzungen

Bevor Sie beginnen, bereiten Sie die folgenden Werte vor:

* **API-Schlüssel**: Erstellen oder kopieren Sie einen API-Schlüssel aus der [Schlüsselverwaltung](https://novita.ai/settings/key-management).
* **Basis-URL**: `https://api.novita.ai/openai/v1`
* **Modell-ID**: Kopieren Sie die Modell-ID, die Sie verwenden möchten, aus dem Model Hub, zum Beispiel `deepseek/deepseek-v3.1`.

<Tip>
  Halten Sie Ihren API-Schlüssel geheim. Verwenden Sie ihn nur in Ihrer lokalen Codex-Konfiguration und committen Sie ihn niemals in ein Git-Repository.
</Tip>

## Codex installieren

Stellen Sie vor der Installation von Codex sicher, dass [Node.js 18 oder höher](https://nodejs.org/en/download/) auf Ihrem Rechner installiert ist.

Wenn Sie unter macOS Homebrew verwenden, können Sie Node.js mit folgendem Befehl installieren:

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

Überprüfen Sie Ihre Node.js- und npm-Versionen:

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

Installieren Sie die Codex CLI:

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

Überprüfen Sie die Codex-Version:

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

## API-Schlüssel konfigurieren

Öffnen Sie Ihre Shell-Konfigurationsdatei, zum Beispiel `~/.zshrc`:

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

Fügen Sie die folgende Umgebungsvariable hinzu:

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

Laden Sie Ihre Shell-Konfiguration neu und bestätigen Sie, dass die Variable verfügbar ist:

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

## Codex konfigurieren

Öffnen Sie die Codex-Konfigurationsdatei:

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

Fügen Sie die folgende Konfiguration hinzu und ersetzen Sie `model` durch die Novita-Modell-ID, die Sie verwenden möchten:

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

Wechseln Sie in Ihr Projektverzeichnis und starten Sie Codex:

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

Sie können nun eine Coding-Aufgabe eingeben, zum Beispiel:

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

Wenn Codex einen Authentifizierungs- oder Modellfehler zurückgibt, prüfen Sie Folgendes:

* `NOVITA_API_KEY` ist in der aktuellen Terminal-Sitzung verfügbar.
* `model` stimmt exakt mit der Modell-ID im Model Hub von Novita überein.
* `base_url` ist auf `https://api.novita.ai/openai/v1` gesetzt.