Claude & Codex Artikel 03 von 08

Codex einrichten

Codex sauber starten und direkt produktiv nutzen, mit Fokus auf nachvollziehbare Änderungen im Code.

Hier richtest du Codex im Terminal so ein, dass Aufgaben, Dateizugriff und Prüfungen sauber im Projektkontext laufen. Codex fühlt sich anders an als Claude Code. Ruhiger, fokussierter. Du gibst eine Aufgabe, es arbeitet, du prüfst das Ergebnis. Kein ständiger Dialog. Das ist eine Stärke, wenn man weiß was man will. Die Einrichtung dauert genauso wenig Zeit wie bei Claude Code.

Installation

Voraussetzung ist Node.js ab Version 18. Falls das noch nicht installiert ist:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

Installiert die aktuelle LTS-Version. Prüfen mit: node --version

brew install node

Homebrew noch nicht installiert? Zuerst: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)". Alternativ den Installer direkt von nodejs.org herunterladen.

winget install OpenJS.NodeJS.LTS

winget ist der eingebaute Paketmanager von Windows 10 und 11. Befehl in der PowerShell ausführen, npm wird automatisch mitinstalliert. Danach eine neue PowerShell öffnen damit der Befehl npm erkannt wird. Alternativ den LTS-Installer direkt von nodejs.org herunterladen.

Node.js läuft? Dann Codex installieren:

npm install -g @openai/codex

Codex ist danach als Befehl codex überall verfügbar.

API-Key einrichten

Codex nutzt die OpenAI API. Key erstellen unter platform.openai.com, dann als Umgebungsvariable setzen. Hier unterscheiden sich die Betriebssysteme:

export OPENAI_API_KEY=dein-key-hier

Damit der Key dauerhaft gesetzt bleibt, diese Zeile in ~/.bashrc oder ~/.zshrc eintragen und das Terminal neu starten.

$env:OPENAI_API_KEY="dein-key-hier"

Das gilt nur für die aktuelle PowerShell-Sitzung. Für eine dauerhafte Einstellung: Systemsteuerung → System → Erweiterte Systemeinstellungen → Umgebungsvariablen → Neue Variable anlegen mit Name OPENAI_API_KEY und deinem Key als Wert.

Sicherheitshinweis

Den API-Key niemals direkt in Code oder Projektdateien schreiben. Immer als Umgebungsvariable. So landet er nicht aus Versehen in einem öffentlichen Repository.

Wie Codex arbeitet

Du navigierst in ein Projektverzeichnis und rufst Codex mit einer Aufgabe auf:

codex "Füge dieser Funktion eine Fehlerbehandlung hinzu"

Codex analysiert das Projekt, macht die Änderungen in einem isolierten Arbeitsbereich und zeigt dir danach einen Diff. Du siehst genau was geändert wurde, kannst es übernehmen oder ablehnen. Kein Overwrite ohne dein Zutun.

Der Unterschied im Alltag

Claude Code

Du sitzt dabei

Aktiver Dialog, du steuerst jeden Schritt, siehst was passiert und kannst jederzeit eingreifen.

Codex

Du schickst es los

Aufgabe beschreiben, Codex arbeitet, Ergebnis prüfen. Weniger Aufwand bei klar definierten Aufgaben.

Das ist kein Vor- oder Nachteil. Es ist eine Frage was du gerade brauchst. Beides hat seinen Platz.

Erste Aufgaben für den Einstieg

Klein anfangen

Fang mit einer einzigen, klar beschreibbaren Aufgabe an. "Füge diesem Skript Logging hinzu" oder "Schreib Tests für diese Funktion."

Diff genau lesen

Schau dir jede Änderung an bevor du sie übernimmst. Nicht weil Codex fehleranfällig ist, sondern damit du verstehst was es getan hat.

Aufgaben präziser formulieren

Je genauer deine Beschreibung, desto besser das Ergebnis. "Refactore die Datei" ist zu vage. "Extrahiere die Datenbanklogik in eine eigene Klasse" ist gut.

Meine Empfehlung

Auch bei Codex arbeite ich mit Git. Commit vor der Aufgabe, dann Codex laufen lassen, dann Diff prüfen und übernehmen oder verwerfen. So habe ich immer einen sauberen Rückweg.

Was du jetzt kannst

Beide Tools sind eingerichtet. Im nächsten Artikel schauen wir uns an wie du Dateien sicher bearbeiten lässt, worauf du achten musst und wie du Fehler durch klare Arbeitsregeln vermeidest.

Der nächste sinnvolle Schritt

Wenn du diesen Teil verstanden hast, passen diese Seiten als Nächstes:

Häufige Fragen

Was ist beim Workspace wichtig?

Codex sollte im richtigen Projektordner laufen, damit es relevante Dateien liest und Änderungen an der passenden Stelle macht.

Warum gibt es Genehmigungen?

Genehmigungen schützen vor riskanten Aktionen, Netzwerkzugriffen oder Änderungen außerhalb des erlaubten Arbeitsbereichs.

Wie prüfe ich Codex-Änderungen?

Lies den Diff, starte passende Tests und kontrolliere die betroffenen Dateien fachlich, bevor du etwas übernimmst.

Zurück: Claude Code einrichten Weiter: Dateien ändern lassen und prüfen