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

# Codex CLI

> Codex CLI mit EvoLink.AI verbinden

## Überblick

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/codex-interface.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=576a53ca051d07b3622d3fb16570560d" alt="Codex CLI Interface" width="1730" height="923" data-path="images/integration-guide/codex-interface.png" />

Codex CLI ist das offizielle Kommandozeilen-Tool von OpenAI für codebezogene Aufgaben im Terminal. Im Vergleich zu allgemeinen Chat-Tools legt es den Schwerpunkt auf entwicklungsbereite Ausgaben mit klareren, umsetzbaren Codeänderungen.
Durch die Integration von Codex CLI mit **EvoLink API** können Sie über eine einheitliche OpenAI-kompatible Schnittstelle mit einem Schlüssel und einer Base-URL auf die Modelle von EvoLink (wie die **GPT-Serie**) zugreifen.

## Voraussetzungen

Stellen Sie vor der Konfiguration sicher, dass Sie Folgendes haben:

### 1. Node.js und npm installieren

**Warum erforderlich?** Node.js ist die Laufzeitumgebung für CLI-Tools (so wie Sie WeChat auf Ihrem Handy installieren müssen, um zu chatten, müssen Sie Node.js auf Ihrem Computer installieren, um CLI-Tools auszuführen).

**Falls bereits installiert:** Führen Sie `node -v` und `npm -v` aus, um die Version zu prüfen. Bei v20+ können Sie diesen Schritt überspringen.

**Erstinstallation:**

* Laden Sie es von der [offiziellen Node.js-Website](https://nodejs.org/) herunter und installieren Sie es (LTS-Version empfohlen)
* Falls Sie mit dem Installationsprozess nicht vertraut sind, lesen Sie die [Runoob - Node.js Installationsanleitung](https://www.runoob.com/nodejs/nodejs-install-setup.html)
* Empfohlen: **Node.js v20 oder höher**
* Installation überprüfen:

```bash theme={null}
node -v
npm -v
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/claude-node-npm-verify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=13be4f60f117fca3024b2b2c1d0fd208" alt="Node.js und npm Versionsüberprüfung" width="1730" height="923" data-path="images/integration-guide/claude-node-npm-verify.png" />

### 2. EvoLink API Key erhalten

* Melden Sie sich beim [EvoLink Dashboard](https://evolink.ai/dashboard) an
* Finden Sie die API Keys im Dashboard, klicken Sie auf die Schaltfläche 'Neuen Schlüssel erstellen' und kopieren Sie den generierten Key
* Der API Key beginnt normalerweise mit `sk-`

## Schritt 1: Codex CLI installieren

<Note>
  **Tipp:** Falls Sie nicht wissen, wie Sie ein Kommandozeilen-Terminal öffnen, siehe [FAQ - Wie öffne ich ein Kommandozeilen-Terminal](#13-wie-öffne-ich-ein-kommandozeilen-terminal)
</Note>

### 1. Globale Installation

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

**Erwartetes Ergebnis:** Download-Informationen scrollen durch, am Ende steht `added XX packages` (dauert 1-3 Minuten).

**Bei Fehlern:** `permission denied` bedeutet, dass Windows eine PowerShell mit "Als Administrator ausführen" benötigt, bei macOS/Linux fügen Sie `sudo` vor dem Befehl hinzu.

### 2. Installation überprüfen

```bash theme={null}
codex --version
```

**Erfolgskriterium:** Zeigt eine Versionsnummer an (z.B. `1.x.x`).

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/codex-version.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=02d0328b87db204a5c64cf7b5b7a30c2" alt="Codex CLI Version" width="1730" height="923" data-path="images/integration-guide/codex-version.png" />

## Schritt 2: EvoLink API konfigurieren

Codex CLI unterstützt einen benutzerdefinierten Provider über eine Konfigurationsdatei, keine Änderung des Quellcodes erforderlich.

<Tabs>
  <Tab title="Methode 1: GUI-Bedienung">
    ### 1. Konfigurationsverzeichnis öffnen

    <Tabs>
      <Tab title="Windows">
        Drücken Sie `Win + R`, fügen Sie Folgendes ein und drücken Sie Enter, um das Codex-Konfigurationsverzeichnis zu öffnen:

        ```
        %userprofile%\.codex
        ```

        <img src="https://mintcdn.com/muyutechnology/hdDK-GS-iVpfdhZR/images/integration-guide/encodexwin-r.png?fit=max&auto=format&n=hdDK-GS-iVpfdhZR&q=85&s=c0ceff6634145bbb3ab064fa03a66071" alt="Windows Win+R Terminal öffnen" width="568" height="334" data-path="images/integration-guide/encodexwin-r.png" />
      </Tab>

      <Tab title="macOS">
        Drücken Sie im Finder `Command + Shift + G`, fügen Sie den folgenden Pfad ein und drücken Sie Enter:

        ```
        ~/.codex
        ```
      </Tab>

      <Tab title="Linux">
        Öffnen Sie das Konfigurationsverzeichnis in Ihrem Dateimanager:

        ```
        ~/.codex
        ```
      </Tab>
    </Tabs>

    <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/codex-config-env-en.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=1f36780bdb4aa8721817aecef1bf9588" alt="Codex CLI Konfigurationsumgebung" width="3648" height="1184" data-path="images/integration-guide/codex-config-env-en.png" />

    ### 2. config.toml bearbeiten

    Finden Sie die Datei `config.toml` im Konfigurationsverzeichnis und bearbeiten Sie sie mit folgendem Inhalt:

    ```toml theme={null}
    model = "gpt-5.2"
    model_reasoning_effort = "medium"
    model_provider = "evolink"

    [model_providers.evolink]
    name = "EvoLink API"
    base_url = "https://direct.evolink.ai/v1"
    env_key = "OPENAI_API_KEY"
    wire_api = "responses"
    ```

    **⚠️ Wichtig:**

    * **Vollständig kopieren**, ohne Symbole auszulassen
    * Ersetzen Sie `"your-evolink-api-key"` durch den tatsächlichen API Key
    * Das TOML-Format ist empfindlich gegenüber Einrückungen und Symbolen
  </Tab>

  <Tab title="Methode 2: Ein-Befehl-Erstellung">
    <Tabs>
      <Tab title="Windows PowerShell">
        ```powershell theme={null}
        @"
        model = "gpt-5.2"
        model_reasoning_effort = "medium"
        model_provider = "evolink"

        [model_providers.evolink]
        name = "EvoLink API"
        base_url = "https://direct.evolink.ai/v1"
        env_key = "OPENAI_API_KEY"
        wire_api = "responses"
        "@ | Out-File -FilePath "$env:USERPROFILE\.codex\config.toml" -Encoding utf8
        ```

        <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/codex-one-command-config-win.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=fd396d27dcdf6c2db914c1d39e542bf9" alt="Codex Ein-Befehl-Konfiguration" width="1730" height="923" data-path="images/integration-guide/codex-one-command-config-win.png" />
      </Tab>

      <Tab title="macOS / Linux">
        ```bash theme={null}
        cat > ~/.codex/config.toml << 'EOF'
        model = "gpt-5.2"
        model_reasoning_effort = "medium"
        model_provider = "evolink"

        [model_providers.evolink]
        name = "EvoLink API"
        base_url = "https://direct.evolink.ai/v1"
        env_key = "OPENAI_API_KEY"
        wire_api = "responses"
        EOF
        ```
      </Tab>
    </Tabs>

    Nach Ausführung des Befehls wird die Konfigurationsdatei automatisch erstellt und beschrieben.
  </Tab>
</Tabs>

```toml theme={null}
model = "gpt-5.2"
model_reasoning_effort = "medium"
model_provider = "evolink"

[model_providers.evolink]
name = "EvoLink API"
base_url = "https://direct.evolink.ai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
```

Konfigurationsfelder:

* `model`: Standard-Modellname
* `model_reasoning_effort`: Reasoning-Tiefe (nach Bedarf anpassen)
* `model_provider`: Provider-Name, der zum folgenden Abschnitt passt
* `base_url`: EvoLink API-Endpunkt
* `env_key`: Name der Umgebungsvariable für den API Key
* `wire_api`: muss `responses` sein

### 2. API Key konfigurieren

<Tabs>
  <Tab title="Windows PowerShell">
    **Temporär (nur aktuelle Sitzung)**

    ```powershell theme={null}
    $env:OPENAI_API_KEY = "your-evolink-api-key"
    ```

    **Permanent**

    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your-evolink-api-key", "User")
    ```

    Starten Sie das Terminal neu, damit die Änderungen wirksam werden.

    **Konfiguration überprüfen**

    ```powershell theme={null}
    echo $env:OPENAI_API_KEY
    ```

    <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/codex-check-env.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=f455f371105f4bba6a0b898f247129dc" alt="Prüfen, ob die Umgebungsvariable erfolgreich hinzugefügt wurde" width="1730" height="923" data-path="images/integration-guide/codex-check-env.png" />

    Wenn Ihr API Key ausgegeben wird, war die Konfiguration erfolgreich.
  </Tab>

  <Tab title="macOS / Linux">
    **Temporär (nur aktuelle Sitzung)**

    ```bash theme={null}
    export OPENAI_API_KEY="your-evolink-api-key"
    ```

    **Permanent**
    Bearbeiten Sie `~/.bashrc` oder `~/.zshrc` und fügen Sie hinzu:

    ```bash theme={null}
    export OPENAI_API_KEY="your-evolink-api-key"
    ```

    Führen Sie dann `source ~/.bashrc` oder `source ~/.zshrc` aus, um die Änderungen zu übernehmen, oder starten Sie das Terminal neu.

    **Konfiguration überprüfen**

    ```bash theme={null}
    echo $OPENAI_API_KEY
    ```

    Wenn Ihr API Key ausgegeben wird, war die Konfiguration erfolgreich.
  </Tab>
</Tabs>

## Schritt 3: Codex CLI verwenden

### 1. Arbeitsverzeichnis aufrufen

```shell theme={null}
cd your-working-directory
```

**Hinweis:** Ersetzen Sie `your-working-directory` durch den tatsächlichen Pfad

### 2. Interaktiver Modus

```shell theme={null}
codex
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/codex-interface.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=576a53ca051d07b3622d3fb16570560d" alt="Codex CLI Interface" width="1730" height="923" data-path="images/integration-guide/codex-interface.png" />

### 3. Konfiguration überprüfen

```shell theme={null}
codex "Who are you"
```

**Erfolgskriterien:**

* AI-Antworttext wird angezeigt (mehrere Zeilen)
* **Keine** Fehler wie `401`, `403`, `API Key invalid`

**Bei Fehlermeldungen:**

* `401 Unauthorized`: API Key nicht gesetzt oder ungültig → Umgebungsvariable prüfen
* `403 Forbidden`: Unzureichende API Key-Berechtigungen → API Key überprüfen
* `Network error`: Netzwerkproblem → Verbindung prüfen

## FAQ

### 1. Was ist Codex CLI und wofür wird es verwendet?

Codex CLI ist das offizielle Kommandozeilen-Tool von OpenAI, das sich auf codebezogene Aufgaben konzentriert. Es legt den Schwerpunkt auf entwicklungsbereite Ausgaben mit klareren, umsetzbaren Codeänderungen.

### 2. Wie überprüfe ich Installation und Konfiguration bei der ersten Verwendung?

Führen Sie diese Befehle nacheinander aus:

* `node -v` und `npm -v`: Bestätigen, dass Node.js und npm installiert sind
* `codex --version`: Bestätigen, dass Codex CLI installiert ist
* `codex "Who are you"`: Bestätigen, dass die API-Konfiguration korrekt ist

### 3. Was ist der Unterschied zwischen interaktivem Modus und Einzelbefehlsmodus?

* **Interaktiver Modus**: Führen Sie `codex` aus, um eine fortlaufende Konversation für mehrstufige Interaktionen zu starten
* **Einzelbefehlsmodus**: Führen Sie `codex "Frage"` aus, um eine einzelne Antwort zu erhalten und zu beenden

### 4. Liest oder lädt Codex CLI automatisch meine lokalen Dateien und meinen Code hoch?

Nein. Codex CLI liest Dateiinhalte nur, wenn Sie diese ausdrücklich referenzieren oder autorisieren. Es wird empfohlen, es in einem dedizierten Projektordner zu verwenden.

### 5. Wie verwende ich Codex CLI zur Analyse lokaler Dateiinhalte?

Im interaktiven Modus können Sie Dateien referenzieren, indem Sie:

* Den Dateipfad eingeben, damit Codex ihn liest
* Dateien in das Terminalfenster ziehen
* Dateiinhalte kopieren und einfügen

### 6. Unterstützt Codex CLI chinesische Ein- und Ausgabe?

Ja, vollständig unterstützt.

### 7. Keine Ausgabe nach der Ausführung — was könnte die Ursache sein?

Häufige Ursachen sind:

* Netzwerkverbindungsprobleme
* Ungültiger API Key oder unzureichendes Guthaben
* Falsche `base_url`-Konfiguration
* Firewall oder Proxy blockiert Anfragen

### 8. Warum werden meine Konfigurationsänderungen nicht wirksam?

* Starten Sie Ihr Terminal neu
* Überprüfen Sie die `config.toml`-Syntax (TOML-Format)
* Überprüfen Sie den Pfad der Konfigurationsdatei:
  * Windows: `C:\Users\{username}\.codex\config.toml`
  * macOS / Linux: `~/.codex/config.toml`

### 9. Was verursacht 401/403-Fehler?

* **401-Fehler**: `OPENAI_API_KEY` nicht gesetzt oder ungültig
* **403-Fehler**: Unzureichende Berechtigungen oder abgelaufener Schlüssel
* Überprüfen Sie, ob `env_key` mit dem Namen Ihrer Umgebungsvariable übereinstimmt

### 10. Für welche Szenarien ist Codex CLI geeignet?

**Geeignet für:**

* Code schreiben, debuggen und refaktorisieren
* Schnelle Fragen und Antworten in Kommandozeilenumgebungen
* Analyse von Dateiinhalten

**Nicht geeignet für:**

* Komplexe GUI-Interaktionen
* Echtzeit-kollaboratives Bearbeiten

### 11. Wie wechsle ich das Modell?

Öffnen Sie die Konfigurationsdatei `config.toml` (unter `~/.codex/config.toml` oder `C:\Users\{username}\.codex\config.toml`) und ändern Sie das Feld `model`:

```toml theme={null}
model = "gpt-5.2"  # Ändern Sie den gewünschten Modellnamen
```

Speichern Sie die Datei und starten Sie Codex CLI neu, damit die Änderungen wirksam werden.

### 12. Wie lade ich Bilder hoch?

* Option 1: Den Bildpfad referenzieren
* Option 2: Ein Bild per Drag & Drop in das Terminal ziehen
* Option 3: Ein Bild direkt einfügen

Alle Methoden erfordern eine Benutzeraktion — Codex CLI liest oder lädt lokale Bilder nicht automatisch hoch.

### 13. Wie öffne ich ein Kommandozeilen-Terminal?

<Tabs>
  <Tab title="Windows">
    * Methode 1: Drücken Sie `Win + R`, geben Sie `cmd` oder `powershell` ein und drücken Sie Enter
    * Methode 2: Suchen Sie im Startmenü nach "Eingabeaufforderung" oder "PowerShell"
    * Methode 3: Halten Sie Shift gedrückt und klicken Sie mit der rechten Maustaste in einen Ordner, wählen Sie "PowerShell-Fenster hier öffnen"
  </Tab>

  <Tab title="macOS">
    * Methode 1: Drücken Sie `Command + Space`, um Spotlight zu öffnen, geben Sie `Terminal` ein und drücken Sie Enter
    * Methode 2: Gehen Sie zu "Programme" → "Dienstprogramme" → "Terminal"
  </Tab>

  <Tab title="Linux">
    * Methode 1: Drücken Sie die Tastenkombination `Ctrl + Alt + T`
    * Methode 2: Suchen Sie im Anwendungsmenü nach "Terminal"
  </Tab>
</Tabs>

## Hinweise

<Warning>
  Führen Sie Codex CLI in einem dedizierten Projektordner aus. Vermeiden Sie die Ausführung in sensiblen Verzeichnissen (wie Systemordnern oder Verzeichnissen mit Anmeldedaten). Codex CLI arbeitet ausgehend vom aktuellen Arbeitsverzeichnis.
</Warning>

<Tip>
  Der Wert `wire_api` in der Konfiguration muss auf `"responses"` gesetzt sein. `"chat"` ist veraltet.
</Tip>