Codex

Codex kann mit dem kommerziellen Modellangebot von GWDG über Azure OpenAI genutzt werden.

Wählen Sie eine Einrichtung:

Was Sie für VS Code benötigen

  • einen kommerziellen Endpunkt und API-Schlüssel von support@gwdg.de
  • den Bereitstellungsnamen, der mit Ihrer Ressource verwendet werden soll
  • Visual Studio Code mit der OpenAI-Erweiterung

Codex für Visual Studio Code

1. VS Code-Erweiterung installieren

2. Azure OpenAI-Konfiguration

Während des Onboardings erhalten Sie möglicherweise bereits verwendbare config.toml- und .env-Dateien von GWDG.
Falls nicht, erstellen Sie die Dateien manuell mit der gleichen Struktur wie unten gezeigt.

Speichern Sie beide Dateien im Codex-Konfigurationsverzeichnis:

  • Windows: %USERPROFILE%\.codex\
  • macOS: ~/.codex/
  • Linux: ~/.codex/

Zielverzeichnisse:

  • Windows: %USERPROFILE%\.codex\config.toml und %USERPROFILE%\.codex\.env
  • macOS: ~/.codex/config.toml und ~/.codex/.env
  • Linux: ~/.codex/config.toml und ~/.codex/.env

Verwenden Sie die exakten Basis-URL, API-Schlüssel und Bereitstellungsname, die Sie von GWDG erhalten haben.
Die Standardkonfiguration sollte auf Ihre bereitgestellte Azure-Bereitstellung verweisen.

Nach dem Speichern der Dateien:

  • Starten Sie VS Code neu.
  • Öffnen Sie die Codex-Leiste.

3. Beispiel config.toml

model = "<ihr-gwdg-bereitstellungsname>"
model_provider = "azure"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.azure]
name = "Azure"
base_url = "https://<ihr-resource>.openai.azure.com/openai"
wire_api = "responses"
query_params = { api-version = "2025-04-01-preview" }
env_key = "AZURE_OPENAI_API_KEY"
env_key_instructions = "Setzen Sie AZURE_OPENAI_API_KEY in ~/.codex/.env"

4. Beispiel .env

AZURE_OPENAI_API_KEY=<ihr-API-Schlüssel>

Ersetzen Sie die Platzhalter durch die Werte aus Ihrem GWDG-Onboarding.

5. Sandbox

Für lokale Arbeit wird die Einstellung workspace-write mit aktivierten Genehmigungen empfohlen.
Codex verwendet lokale Sandbox-Steuerungen, um den Dateisystem- und Netzwerkzugriff zu beschränken.

Hinweis

KI-Modelle können Halluzinationen erzeugen und falsche Informationen generieren.
Überprüfen Sie generierte Ergebnisse immer kritisch, bevor Sie sie verwenden oder verarbeiten.

Dokumentation

Was Sie für die CLI benötigen

  • einen kommerziellen Endpunkt und API-Schlüssel von support@gwdg.de
  • den Bereitstellungsnamen, der mit Ihrer Ressource verwendet werden soll
  • eine lokale Terminal-Umgebung
  • npm für die Codex-CLI-Installation

Codex CLI

1. CLI installieren

Installieren Sie die Codex-CLI mit npm:

npm i -g @openai/codex

Offizielle Dokumentation:

2. Azure OpenAI-Konfiguration

Die Codex-CLI verwendet das .codex-Konfigurationsverzeichnis in Ihrem Heimatordner.
Erstellen Sie config.toml und .env im folgenden Pfad:

  • Windows: %USERPROFILE%\.codex\
  • macOS: ~/.codex/
  • Linux: ~/.codex/

Zielverzeichnisse:

  • Windows: %USERPROFILE%\.codex\config.toml und %USERPROFILE%\.codex\.env
  • macOS: ~/.codex/config.toml und ~/.codex/.env
  • Linux: ~/.codex/config.toml und ~/.codex/.env

Verwenden Sie die exakten Basis-URL, API-Schlüssel und Bereitstellungsname, die Sie von GWDG erhalten haben.

3. Beispiel config.toml

model = "<ihr-gwdg-bereitstellungsname>"
model_provider = "azure"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.azure]
name = "Azure"
base_url = "https://<ihr-resource>.openai.azure.com/openai"
wire_api = "responses"
query_params = { api-version = "2025-04-01-preview" }
env_key = "AZURE_OPENAI_API_KEY"
env_key_instructions = "Setzen Sie AZURE_OPENAI_API_KEY in ~/.codex/.env"

4. Beispiel .env

AZURE_OPENAI_API_KEY=<ihr-API-Schlüssel>

Ersetzen Sie die Platzhalter durch die Werte aus Ihrem GWDG-Onboarding.

5. CLI starten

Öffnen Sie ein Terminal in Ihrem Projektverzeichnis und führen Sie aus:

codex

Codex kann Ihr Repository untersuchen, Dateien bearbeiten und Befehle im aktuellen Verzeichnis ausführen.
Wenn noch kein Anbieter konfiguriert ist, fordert Codex bei erster Ausführung zur Anmeldung auf.
Für die GWDG-kommerzielle Einrichtung konfigurieren Sie zunächst den Azure-Anbieter und starten dann die CLI.

6. CLI aktualisieren

Um die Codex-CLI zu aktualisieren:

npm i -g @openai/codex@latest

7. Sandbox

Verwenden Sie workspace-write mit aktivierten Genehmigungen, es sei denn, Sie haben einen speziellen Grund, mehr zu erlauben.

Hinweis

KI-Modelle können Halluzinationen erzeugen und falsche Informationen generieren.
Überprüfen Sie generierte Ergebnisse immer kritisch, bevor Sie sie verwenden oder verarbeiten.

Dokumentation

Hinweise

  • Die Codex-CLI ist für macOS, Windows und Linux verfügbar.
  • Auf Windows dokumentiert OpenAI sowohl die native PowerShell-Nutzung als auch WSL2.

Weitere KI-Dienste

Neben Azure OpenAI bieten wir auch andere KI-Dienste an.
Eine Übersicht über alle verfügbaren KI-Dienste finden Sie hier: