Fehlerbehebung

Häufig gestellte Fragen

Im Seitenbereich werden Dateien angezeigt, die Codex nicht bearbeitet hat

Wenn sich Ihr Projekt in einem Git-Repository befindet, zeigt der Prüfbereich automatisch Änderungen basierend auf dem Git-Status Ihres Projekts an, einschließlich Änderungen, die Codex nicht vorgenommen hat.

Im Prüfbereich können Sie zwischen vorgemerkten und noch nicht vorgemerkten Änderungen wechseln und Ihren Branch mit main vergleichen.

Wenn Sie nur die Änderungen Ihres letzten Codex-Gesprächsschritts sehen möchten, wechseln Sie im Diff-Bereich zur Ansicht Last turn.

Weitere Informationen zur Verwendung des Prüfbereichs.

Ein Projekt aus der Seitenleiste entfernen

Um ein Projekt aus der Seitenleiste zu entfernen, bewegen Sie den Mauszeiger über den Projektnamen, wählen Sie die drei Punkte und dann Remove. Um es wiederherzustellen, fügen Sie das Projekt über die Schaltfläche Add new project neben Chats erneut hinzu oder verwenden Sie

Cmd+O.

Archivierte Chats finden

Archivierte Chats finden Sie in den Einstellungen. Wenn Sie die Archivierung eines Chats aufheben, erscheint er wieder an seiner ursprünglichen Position in der Seitenleiste.

Eine Work-Unterhaltung wird auf einem anderen Gerät nicht angezeigt

• Vergewissern Sie sich, dass Sie auf jedem Gerät mit ChatGPT beim selben Konto und Arbeitsbereich angemeldet sind.
• Bitten Sie den Inhaber Ihres Arbeitsbereichs zu prüfen, ob Work Cloud und Allow local computer access aktiviert sind. Wenn enforce_residency in einer Cloud-Richtlinie aktiviert ist, wird Allow local computer access sowohl für Work als auch für dots deaktiviert. Diese Schutzmaßnahme konfiguriert weder die Datenresidenz des Arbeitsbereichs noch deaktiviert sie für sich genommen Work Cloud oder dots.
• Prüfen Sie, wann die Aufgabe erstellt wurde. Die Synchronisierung gilt für neue Aufgaben, die nach ihrer Aktivierung erstellt werden. Bestehende Aufgaben, einschließlich Aufgaben in Projekten, werden nicht migriert und behalten ihr ursprüngliches Verhalten bei: ausschließlich lokal oder in der Cloud ohne lokale Dateien.

Für Unternehmen bleiben der Umschalter zwischen lokalem und Cloud-Modus in der App sowie seine Standardeinstellung bei der Einführung unverändert. Ein bestimmter Umschalter oder Standardmodus allein bestätigt nicht, ob eine Unterhaltung synchronisiert werden kann. Betrachten Sie den Codex-Verlauf separat, wenn Sie nach einer Work-Unterhaltung suchen. Informationen zur Einrichtung finden Sie unter Zugriff auf den lokalen Computer für Work Cloud und dots, Antworten auf häufige Fragen in den FAQ zur Work-Administration.

Eine synchronisierte Aufgabe kann nicht auf die Dateien oder Tools des Computers zugreifen

Lassen Sie den Computer online und verbunden. Ist er beim Start eines neuen Gesprächsschritts nicht verfügbar, kann eine dafür geeignete synchronisierte Aufgabe in einem Cloud-Container fortgesetzt werden, ohne Zugriff auf die Dateien oder Tools des Computers zu haben. Ein laufender Gesprächsschritt wechselt nicht automatisch vom Computer in die Cloud.

Ein Gesprächsschritt wurde gestoppt, nachdem der Zugriff auf den lokalen Computer mit Work Cloud deaktiviert wurde

Wenn Sie den Zugriff auf den lokalen Computer mit Work Cloud deaktivieren, werden laufende Gesprächsschritte unterbrochen. Falls Sie weiterhin Zugriff auf Work haben, senden Sie eine neue Nachricht, um einen weiteren Gesprächsschritt zu starten. In einer bestehenden Cloud-Unterhaltung verwendet dieser Gesprächsschritt automatisch Work Cloud ohne Zugriff auf lokale Dateien.

Automatische Richtlinienaktualisierungen fehlen

Verwenden Sie die Richtlinien-API, um globale Einstellungen zu verwalten. Lokale Einstellungen oder Einstellungen für Codex Cloud verwalten Sie über die Benutzeroberfläche von Agent Security. Bestehende API-Workflows für globale Einstellungen bleiben nach der Migration verfügbar. Testen Sie Ihre Skripte und Terraform-Integrationen und vergewissern Sie sich, dass Richtlinienzuweisungen und Reihenfolge unverändert sind.

In der Seitenleiste werden nur einige Chats angezeigt

In der Seitenleiste können Sie Chats nach dem Status eines Projekts filtern. Wenn Ihnen Chats fehlen, wählen Sie das Filtersymbol neben Chats und anschließend Chronological aus. Wenn der Chat weiterhin nicht angezeigt wird, öffnen Sie die Einstellungen und prüfen Sie Archived chats.

Code wird in einem Worktree nicht ausgeführt

Worktrees werden in einem anderen Verzeichnis erstellt und übernehmen standardmäßig die in Git eingecheckten Dateien. Je nachdem, wie Sie Abhängigkeiten und Tools für Ihr Projekt verwalten, müssen Sie möglicherweise Einrichtungsskripte in Ihrem Worktree über eine lokale Umgebung ausführen oder ignorierte Einrichtungsdateien mit .worktreeinclude kopieren. Sie können die Änderungen auch in Ihrem regulären lokalen Projekt auschecken. Weitere Informationen finden Sie in der Worktree-Dokumentation.

App übernimmt die freigegebene lokale Umgebung eines Teammitglieds nicht

Die Konfiguration der lokalen Umgebung muss sich im Ordner .codex im Stammverzeichnis Ihres Projekts befinden. Wenn Sie in einem Monorepo mit mehreren Projekten arbeiten, stellen Sie sicher, dass Sie das Projekt in dem Verzeichnis öffnen, das den Ordner .codex enthält.

Codex bittet um Zugriff auf Apple Music

Je nach Aufgabe muss Codex möglicherweise durch das Dateisystem navigieren. Bestimmte Verzeichnisse unter macOS, darunter Musik, Downloads oder Schreibtisch, erfordern eine zusätzliche Genehmigung durch den Benutzer. Wenn Codex Ihr Benutzerverzeichnis lesen muss, fordert macOS Sie auf, den Zugriff auf diese Ordner zu genehmigen.

Geplante Aufgaben erstellen viele Worktrees

Häufig ausgeführte geplante Aufgaben können im Laufe der Zeit viele Worktrees erstellen. Archivieren Sie geplante Ausführungen, die Sie nicht mehr benötigen, und heften Sie Ausführungen nur an, wenn Sie deren Worktrees behalten möchten.

Eine Eingabeaufforderung nach Auswahl des falschen Ziels wiederherstellen

Wenn Sie versehentlich einen Chat mit dem falschen Ziel (Local, Worktree oder Cloud) gestartet haben, können Sie die aktuelle Ausführung abbrechen und Ihre vorherige Eingabeaufforderung wiederherstellen, indem Sie im Eingabefeld die Pfeil-nach-oben-Taste drücken.

„Für mich genehmigen“ fehlt oder ist deaktiviert

Um die automatische Prüfung zu verwenden, wählen Sie Für mich genehmigen in der Berechtigungssteuerung unterhalb des Eingabefelds aus. Wenn der Modus fehlt oder deaktiviert ist:

1. Aktualisieren Sie die Desktop-App und prüfen Sie das Berechtigungsmenü in dem Chat, in dem Sie die automatische Prüfung verwenden möchten. Die verfügbaren Optionen können sich zwischen lokalen Umgebungen und Cloud-Umgebungen unterscheiden.
2. Prüfen Sie bei lokaler Ausführung von Codex Ihre wirksame Konfiguration auf eine explizite Einstellung features.guardian_approval = false und überprüfen Sie das konfigurierte Berechtigungsprofil, die Genehmigungsrichtlinie und die für Genehmigungen zuständige Prüfinstanz. Informationen zur Rangfolge der Konfigurationseinstellungen finden Sie unter Konfigurationsgrundlagen. Die lokale Konfiguration steuert keine verwaltete Cloud-Laufzeitumgebung.
3. Wenn ein Modus in einem verwalteten Arbeitsbereich deaktiviert ist oder fehlt, bitten Sie Ihren Administrator, die zulässigen Berechtigungsprofile, Sandbox-Modi, Genehmigungsrichtlinien und Genehmigungsprüfinstanzen zu überprüfen. Organisations- oder Geräterichtlinien können diese Auswahlmöglichkeiten einschränken; lokale Einstellungen können diese Richtlinien nicht außer Kraft setzen.

Wenn der Modus weiterhin unerwartet nicht verfügbar ist, geben Sie Ihre App-Version, Ihr Betriebssystem, Ihre Ausführungsumgebung und die Information, ob die Option fehlt oder deaktiviert ist, in Ihrem Feedback an.

Funktion ist in der Codex CLI verfügbar, aber nicht in der ChatGPT-Desktop-App

Die ChatGPT-Desktop-App und die Codex CLI können unterschiedliche Codex-Versionen enthalten, sodass Funktionen auf einer Oberfläche früher als auf der anderen verfügbar sein können.

Führen Sie Folgendes aus, um die Version der Codex CLI auf Ihrem System zu ermitteln:

codex --version

Um die Version von Codex zu ermitteln, die in Ihrer ChatGPT-Desktop-App enthalten ist, verwenden Sie den beibehaltenen Pfad des Kompatibilitätspakets Codex.app:

/Applications/Codex.app/Contents/Resources/codex --version

Feedback und Protokolle

Geben Sie / in das Eingabefeld ein, um dem Team Feedback zu geben. Wenn Sie Feedback in einem bestehenden Chat aufrufen, können Sie auswählen, ob Sie die bestehende Sitzung zusammen mit Ihrem Feedback teilen möchten. Nachdem Sie Ihr Feedback gesendet haben, erhalten Sie eine Sitzungs-ID, die Sie dem Team mitteilen können.

So melden Sie ein Problem:

1. Suchen Sie im Codex-GitHub-Repository nach bestehenden Issues.
2. Öffnen Sie ein neues GitHub-Issue

Weitere Protokolle sind an den folgenden Speicherorten verfügbar:

• App-Protokolle (macOS): ~/Library/Logs/com.openai.codex/YYYY/MM/DD
• Sitzungstranskripte: $CODEX_HOME/sessions (Standard: ~/.codex/sessions)
• Archivierte Sitzungen: $CODEX_HOME/archived_sessions (Standard: ~/.codex/archived_sessions)

Wenn Sie Protokolle teilen, prüfen Sie diese zunächst, um sicherzustellen, dass sie keine vertraulichen Informationen enthalten.

Blockierte Zustände und Wiederherstellungsmuster

Wenn ein Chat blockiert zu sein scheint:

1. Prüfen Sie, ob Codex auf eine Genehmigung wartet.
2. Öffnen Sie das Terminal und führen Sie einen einfachen Befehl wie git status aus.
3. Starten Sie einen neuen Chat mit einer kürzeren, gezielteren Eingabeaufforderung.

Wenn Sie die Erstellung eines Worktrees versehentlich abbrechen und Ihre Eingabeaufforderung verlieren, drücken Sie im Eingabefeld die Pfeil-nach-oben-Taste, um sie wiederherzustellen.

Terminalprobleme

Terminal scheint blockiert zu sein

1. Schließen Sie den Terminalbereich.
2. Öffnen Sie ihn mit Ctrl+` erneut.
3. Führen Sie erneut einen einfachen Befehl wie pwd oder git status aus.

Wenn sich Befehle anders als erwartet verhalten, prüfen Sie zuerst das aktuelle Verzeichnis und den Branch im Terminal.

Wenn das Terminal weiterhin blockiert ist, warten Sie, bis Ihre aktiven Chats abgeschlossen sind, und starten Sie die App neu.

Schriftarten werden nicht korrekt dargestellt

Codex verwendet für den Prüfbereich, das integrierte Terminal und sämtlichen anderen in der App angezeigten Code dieselbe Schriftart. Sie können die Schriftart im Bereich Einstellungen unter Code font konfigurieren.

Eine Umgebung erlaubt Netzwerkzugriff, aber die Aktion wird blockiert

Prüfen Sie die Richtlinienpriorität, bevor Sie einzelne Einstellungen vergleichen. Eine Richtlinie mit höherer Priorität hat Vorrang vor einer Richtlinie mit niedrigerer Priorität, selbst wenn die Richtlinie mit niedrigerer Priorität spezifischer ist. Innerhalb einer Richtlinie haben betriebssystemspezifische Umgebungsüberschreibungen Vorrang vor betriebssystemübergreifenden Umgebungsüberschreibungen; danach folgen die globalen Einstellungen.

Für einige Netzwerkanforderungen gelten feldspezifische Zusammenführungsregeln und Laufzeitbeschränkungen. Verwaltete HTTP/SOCKS-Listener-Ports und Proxy-Listener außerhalb der Loopback-Schnittstelle werden von der Cloud-Laufzeit nicht unterstützt; die Unterstützung von Socket-Regeln hängt vom Ausführungspfad ab. Für die lokale Ausführung gilt ein separates Zusammenführungsverhalten.

Vergleichen Sie die wirksamen Richtlinien und testen Sie die Aktionen, die erlaubt bzw. blockiert sein sollen. Einzelheiten zu den verschiedenen Fällen finden Sie unter Verwaltete Konfiguration. Lockern Sie die globalen Grundvorgaben nicht, um einen fehlgeschlagenen Test zu umgehen.