Codex Desktop App

Derzeit gibt es drei gängige Möglichkeiten, Codex zu verwenden:

Methode Geeignet für Empfehlung
Web-Version Leichtes Erlebnis ⭐⭐
CLI-Version Power-Entwickler ⭐⭐⭐⭐
Desktop-App Die meisten Menschen ⭐⭐⭐⭐⭐

Die Codex App ist der offiziell empfohlene Desktop-Client und bietet vollständige Funktionalität sowie ein reibungsloses paralleles Multi-Projekt-Erlebnis.


Download und Installation

Die Codex App unterstützt macOS (Apple Silicon) und Windows.

Download-Adresse:https://chatgpt.com/codex

PlattformDownload-Methode
macOSOffizieller Website-Download oder Homebrew
WindowsOffizieller Website-Download-Installer


Erste Verwendung

Nach der Installation folgen Sie diesen Schritten, um loszulegen:

1. Codex App öffnen

2. Melden Sie sich mit Ihrem ChatGPT-Konto oder OpenAI API Key an

Wenn Sie sich mit einem API Key anmelden, sind einige Cloud-Funktionen möglicherweise nicht verfügbar.

3. Nach erfolgreicher Anmeldung sieht die Oberfläche so aus:

Wenn Sie es zum ersten Mal verwenden, können Sie sich auf die Unterhaltungen und Projekte konzentrieren. Unterhaltungen funktionieren genau wie die reguläre ChatGPT-Webversion – Sie können auf die gleiche Weise chatten.

Ein Projekt kann als Kombination aus Folgendem verstanden werden: ChatGPT-Chat + IDE-Projektverzeichnis + Langzeitgedächtnis des AI-Agenten.

Ein Projekt ist an einen Ordner auf Ihrem Computer gebunden. Codex funktioniert nur innerhalb dieses Verzeichnisses.

Hier wähle ich „Add New Project“ und füge codex-example-test hinzu:

Sobald Sie sich darin befinden, sehen Sie den Projektnamen sowohl auf der linken als auch auf der rechten Seite. Sie können aus mehreren Projekten in der Liste auswählen:

4. Senden Sie Ihren ersten Prompt, um mit der Nutzung zu beginnen.


Oberflächenstruktur

Codex umfasst die folgenden Bereiche:

BereichFunktion
ProjektseitenleisteMehrere Projekte verwalten und schnell wechseln
ProjektlisteZeigt Sitzungen, Filterung und Archivierung
ÜberprüfungsbereichVon Codex vorgenommene Dateiänderungen anzeigen
TerminalbereichIntegriertes Terminal für jedes Projekt
Skills-AuswahlBenutzerdefinierte Skills durchsuchen und aktivieren

Bereich Ort Funktionsbeschreibung

Navigationsschaltflächen

Zurück-/Vorwärtspfeile in der oberen linken Ecke

Wird verwendet, um zwischen historischen Sitzungen oder Seiten zu wechseln, ähnlich wie Zurück/Vorwärts im Browser.
Neue Unterhaltung Oben im linken Menü Startet schnell eine temporäre KI-Unterhaltung, ohne in einen bestimmten Projektkontext einzusteigen. Geeignet für direkte Fragen, Code-Erklärungen, Befehlsgenerierung und andere leichte Aufgaben.
Suche Linkes Menü Historische Unterhaltungen, Projektinhalte, Dateien oder Aufgabenaufzeichnungen durchsuchen. Sehr wichtig in großen Projekten, entspricht dem globalen Sucheinstieg in einer KI-IDE.
Plugins Linkes Menü Plugin-Funktionen verwalten und aufrufen, wie GitHub, Terminal, Datenbank, Dateisystem, Browser-Tools und andere Erweiterungsfunktionen.
Automatisierung Linkes Menü Automatisierte Aufgaben erstellen, zum Beispiel: tägliche Berichte nach Zeitplan generieren, Repositories regelmäßig überprüfen, Skripte automatisch ausführen, Erinnerungsaufgaben usw.
Projekte Linker mittlerer Bereich Bereich zur Verwaltung von Projektarbeitsbereichen. Jedes Projekt ist normalerweise an ein Code-Repository, ein Verzeichnis oder einen Arbeitsbereich gebunden.
Neues Projekt Linker Projektbereich Erstelle ein neues Projekt. Nach der Erstellung ist es normalerweise mit einem lokalen Ordner, einem Git-Repository oder einer Remote-Code-Umgebung verknüpft.
Chats Linker unterer Bereich Globaler Chatverlauf-Bereich, wird zur Verwaltung von projektunabhängigen Unterhaltungen verwendet.
Filter-Schaltfläche

Trichter-Symbol auf der rechten Seite der Unterhaltungsleiste

Chatverlauf filtern, zum Beispiel nach Projekt, Zeit oder Typ.
Schaltfläche für neuen Chat Bearbeiten-Symbol auf der rechten Seite der Unterhaltungsleiste Eine neue unabhängige Chat-Sitzung erstellen.
Hauptarbeitsbereich Zentraler schwarzer Bereich Codex' Kerninteraktionsbereich. Enthält KI-Konversationen, Codegenerierung, Agent-Ausführung, Anzeige von Dateiänderungsergebnissen usw.
"Was sollen wir tun?" Mitte des Hauptbereichs Aufforderungstext auf dem Begrüßungsbildschirm, der Benutzer beim Starten von Aufgaben anleitet.
Eingabefeld Großes Eingabefeld in der unteren Mitte Geben Sie Codex Anweisungen in natürlicher Sprache ein, zum Beispiel: Code generieren, Fehler beheben, Projekte analysieren, Architektur refaktorieren usw.
@Plugin-Prompt Platzhaltertext des Eingabefelds Unterstützt durch@Aufrufen von Plugins oder Tools, wie z. B.@terminal、@github、@browserusw.
Datei-Erwähnungsfunktion Platzhaltertext des Eingabefelds Sie können Dateien direkt per Drag-and-drop ablegen oder Projektdateien referenzieren, damit die KI bestimmten Code analysiert.
"+"-Schaltfläche Unten links im Eingabefeld Anhänge, Dateien, Bilder oder zusätzlichen Kontext hinzufügen.
Standardberechtigungen Unten links im Eingabefeld Steuern Sie die Ausführungsberechtigungen des KI-Agenten, zum Beispiel: schreibgeschützt, Bearbeiten von Dateien erlauben, Ausführen von Befehlen erlauben usw.
Modellauswahl (in 5.5) Unten rechts im Eingabefeld Bereich zum Wechseln der aktuellen Modellversion. Ermöglicht normalerweise das Wechseln zwischen Modellen unterschiedlicher Fähigkeitsstufen.
Mikrofon-Schaltfläche Unten rechts im Eingabefeld Spracheingabefunktion.
Senden-Schaltfläche Runder Pfeil ganz rechts im Eingabefeld Aktuelle Aufgabe an Codex übermitteln.
"Projektarbeit starten" Unter dem Eingabefeld In den echten Projekt-Agent-Modus wechseln. Die KI versteht den Kontext anhand des gesamten Code-Repositorys statt eines gewöhnlichen Chats.
Globus-Symbol Obere rechte Ecke Funktionen im Zusammenhang mit Netzwerk- oder Fernverbindungen; können für Online-Modus, Synchronisierung oder Remote-Umgebung verwendet werden.
Schaltfläche oben rechts in der Seitenleiste Rechteckiges Symbol in der oberen rechten Ecke Steuert die Anzeige des zusätzlichen Panels auf der rechten Seite, wie Logs, Terminal, Dateibaum, Agent-Status usw.

Drei Betriebsmodi

Jedes Projekt kann einen von drei Betriebsmodi wählen:

ModeBeschreibungAnwendbare Szenarien
LokalIm lokalen Projektverzeichnis arbeitenTägliche Entwicklung, Ergebnisse direkt ansehen
WorktreeIn einem unabhängigen Git-Worktree arbeitenÄnderungen isolieren, parallele Entwicklung
CloudIn einer isolierten Cloud-Umgebung ausführenRemote-Delegation, parallele Verarbeitung

Modusauswahl

Wenn Sie ein neues Projekt erstellen, wählen Sie den Modus unterhalb des Eingabefelds:

  • Local: Direkt im aktuellen Verzeichnis arbeiten, Änderungen sind sofort sichtbar
  • Worktree: Einen unabhängigen Branch erstellen, der nach Abschluss in Local zusammengeführt werden kann
  • Cloud: Aufgaben werden in der Cloud ausgeführt, Ergebnisse werden über PR oder Berichte präsentiert

Der Worktree-Modus verwendet die Git-Worktree-Technologie und ermöglicht gleichzeitiges Arbeiten an verschiedenen Branches.


Review-Modus

Der Review-Modus ermöglicht es Ihnen, von Codex vorgenommene Änderungen anzuzeigen und zu genehmigen.

Funktionen des Review-Panels

MerkmalBeschreibung
Diff-AnsichtZeigt einen detaillierten Vergleich aller Dateiänderungen
Inline-KommentareKommentare zu bestimmten Codezeilen hinzufügen
Chunk-OperationenNach Code-Chunk akzeptieren oder ablehnen
Alles committenGit-Commit erstellen oder Änderungen pushen

Zwischen Review-Ansichten wechseln

Das Review-Panel unterstützt zwei Ansichten:

  • Alle Änderungen: Zeigt den Git-Status des Projekts an, einschließlich Nicht-Codex-Änderungen
  • Änderungen des letzten Turns: Zeigt nur die Änderungen des letzten Codex-Turns an

Review-Operationen

# Tastaturkürzel
Cmd + Option + B    # Review-Panel ein-/ausblenden
Cmd + Shift + P     # Befehlsmenü öffnen

# Überprüfungs-Workflow
1. Dateiänderungen anzeigen
2. Klicken Sie auf einen Codeblock, um ihn zu akzeptieren/Ablehnen
3. Kommentare hinzufügen
4. Commit oder Push

Automatisierungen

Mit Automatisierungen können Sie Codex so planen, dass er Aufgaben regelmäßig im Hintergrund ausführt.

Voraussetzungen

  • Codex App läuft
  • Das ausgewählte Projekt ist auf der Festplatte verfügbar

Eine Automatisierung erstellen

  1. Öffnen Sie das Automatisierungen-Panel in der Seitenleiste
  2. Klicken Sie auf "Neue Automatisierung"
  3. Trigger-Frequenz und Aufgabenbeschreibung konfigurieren
  4. Sandbox-Modus festlegen

Automatisierungsbeispiel

AufgabeBeschreibung
Automatische Skill-ErstellungSitzungsdateien scannen und Skills aktualisieren, um sie effektiver zu machen
Tägliches BriefingAktuelle Commits analysieren und eine Änderungszusammenfassung generieren
Bug-ÜberwachungTelemetriefehler prüfen und automatische Korrekturen versuchen

Ergebnisse von Automatisierungsaufgaben werden dem Triage-Posteingang hinzugefügt und automatisch archiviert, wenn keine Ergebnisse vorliegen.


Worktree-Verwaltung

Die Codex-App verfügt über integrierte Git-Worktree-Unterstützung.

Vorteile von Worktree

  • Mehrere Aufgaben parallel bearbeiten, ohne sich gegenseitig zu beeinträchtigen
  • Den Main-Branch sauber halten
  • Sich auf die Vordergrundarbeit konzentrieren, während Aufgaben im Hintergrund ausgeführt werden

Handoff-Prozess

Handoff ermöglicht das Wechseln zwischen Local und Worktree:

  1. Aufgaben im Worktree abschließen
  2. Einen Commit und PR erstellen
  3. Wähle Handoff zu Local, um mit dem Testen fortzufahren

Worktree erbt nur Dateien von Git; Dateien in .gitignore werden nicht mit dem Projekt verschoben.


Konfiguration von Local Environments

Definiere Worktree-Setup-Skripte und gängige Aktionen über Local Environments.

Setup-Skript

Skripte, die automatisch ausgeführt werden, wenn ein neuer Worktree erstellt wird:

Setup-Skript-Beispiel

# .codex/setup.sh
npm install        # Abhängigkeiten installieren
npm run build      # Projekt bauen

Aktionen

Allgemeine Aufgaben für den schnellen Zugriff in der oberen Aktionsleiste definieren:

AktionBeschreibung
Entwicklungsserver startennpm run dev ausführen
Tests ausführenTest-Suite ausführen
Code-Formatierungprettier ausführen

Tastaturkürzel

TastaturkürzelMerkmal
Cmd + Shift + PBefehlsmenü
Cmd + NNeues Projekt
Cmd + Shift + [ / ]Projekt wechseln
Cmd + Option + BReview-Bereich ein-/ausblenden
Cmd + JTerminal ein-/ausblenden
Ctrl + MSpracheingabe
Cmd + OProjekt hinzufügen

Häufig gestellte Fragen

F: Wie synchronisiert sich die App mit der CLI/IDE?

Wenn die App und die IDE-Erweiterung im selben Projekt verwendet werden, synchronisieren sie automatisch Auto Context und das aktive Projekt.

F: Wie finde ich archivierte Projekte?

Gehen Sie zu Einstellungen, zeigen Sie Archivierte Threads an und wählen Sie Archivierung aufheben, um wiederherzustellen.

F: Der Worktree-Code unterscheidet sich vom lokalen Code?

Der Worktree erbt nur Dateien von Git. Sie müssen Skripte einrichten, um Abhängigkeiten zu installieren und zu bauen.

F: Unterschiede in der Funktionalität aufgrund unterschiedlicher App- und CLI-Versionen?

Versionen prüfen: Für CLI verwenden Sie `codex --version`; für die App verwenden Sie das Über-Menü.

Andere Erweiterungen