Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Schnellstart für das Plugin Codex Security

Installiere das Plugin Codex Security, führe deinen ersten Scan ohne Schreibzugriff aus und prüfe das Ergebnis in Codex.

Installiere das Plugin Codex Security, führe einen Standardscan für ein lokales Repository aus und prüfe die Befunde. Der Scan lässt deinen Quellcode unverändert und speichert einen Bericht mit Belegen und Hinweisen zur Behebung der Probleme.

Auf dieser Seite geht es um das Plugin Codex Security in der Desktop-App und in der Codex CLI. Wenn du ein verbundenes GitHub-Repository in Codex Cloud scannen möchtest, installiere das separate Plugin Daybreak Defense Factory (Preview) aus dem Plugin-Marketplace. Weitere Informationen findest du im Cloud-Setup.

Plugin installieren

  1. Öffne Codex in der ChatGPT-Desktop-App.

  2. Öffne Plug-ins und suche nach Codex Security oder nutze die folgende Schaltfläche:

  3. Prüfe, ob das Plugin aktiviert ist, und öffne dann Sicherheit in der Seitenleiste.

Wenn bei der Plugin-Installation in einem verwalteten Workspace die Meldung „Durch die Administration deaktiviert“ erscheint, bitte die Person, der der Workspace gehört, den Zugriff auf Plugins zu prüfen. Wenn du ein persönliches Konto nutzt, findest du Hilfe in der Anleitung zur Fehlerbehebung bei Plugins und Apps.

Wenn Sicherheit in der Seitenleiste der Desktop-App fehlt, prüfe, ob Codex ausgewählt und das Plugin aktiviert ist. Aktualisiere bei Bedarf die App und das Plugin. Prüfe außerdem, ob die Workspace-Administration das Plugin zulässt.

Versionen und Updates prüfen

Lies vor einem längeren Scan das Änderungsprotokoll des Plugins. In der Desktop-App verwaltest du deine Installation unter Plug-ins, in der Codex CLI über /plugins. Einzelheiten findest du im Leitfaden zu Plugins. Starte nach einem Plugin-Update einen neuen Chat, damit Codex die Skills und Tools des Plugins lädt. Gib dazu in der Codex CLI /new ein.

Codex und das Plugin Codex Security haben jeweils eine eigene Versionsnummer. Mit diesen Befehlen prüfst du in der Codex CLI die Version des Hosts und die Versionen der installierten Plugins:

codex --version
codex plugin list --json

Suche in der Liste installed nach Codex Security. Notiere dir beim Start eines Scans beide Versionsnummern, damit du sie angeben kannst, wenn du einen Fehler meldest.

Das eigenständige Paket @openai/codex-security enthält ein eigenes Plugin. Wenn du das Paket aktualisierst, wird das Marketplace-Plugin in Codex nicht mitaktualisiert. Wie du das Paket installierst und seine Version prüfst, erfährst du im Schnellstart für die CLI.

Wenn du Amazon Bedrock verwendest, konfiguriere den Codex-Host wie im Codex-Leitfaden für Amazon Bedrock beschrieben. Für das eigenständige Paket gelten die separaten Anbietereinstellungen der Security CLI.

Ersten Scan ausführen

Für die beste Scanqualität verwende gpt-5.6-sol und stelle den Reasoning-Aufwand auf xhigh.

Wähle ein Repository aus und konfiguriere den neuen Sicherheitsscan, bevor du ihn startest.

  1. Scan-Setup öffnen

    Wähle Sicherheit in der Seitenleiste, öffne Scans und wähle + Scan.

  2. Codebasis und Scanbereich auswählen

    Wähle ein vorhandenes Repository aus oder verwende einen anderen Ordner. Wähle Codebasis, lass Tiefenscan deaktiviert und wähle das gesamte Repository oder einen einzelnen Ordner aus. Prüfe anhand des Branches und der Revision, ob du den gewünschten Code scannst.

  3. Sicherheitskontext ergänzen

    Wähle das Modell und den Reasoning-Aufwand. Öffne Zusätzlicher Kontext nur, wenn du für die Prüfung einen Angriffsvektor, einen sicherheitskritischen Bereich oder ein Detail zum Repository beschreiben musst.

    Aktiviere den zusätzlichen Kontext, um Angriffsvektoren und Prüfschwerpunkte zu beschreiben und relevante Sicherheitshinweise zu geben.

  4. Scan starten

    Wähle Scan starten und verfolge die einzelnen Scanphasen im Sicherheitsbereich. Wähle Aktivität anzeigen, um dir die Codex-Aufgabe anzusehen, die den Scan ausführt.

  5. Ergebnis prüfen

    Öffne den abgeschlossenen Scan, um die Befunde, die Prüfabdeckung und die verfügbaren Berichtsdateien einzusehen. Unter Befunde kannst du Probleme aus mehreren Scans prüfen. Unter Repositorys findest du den Scanverlauf eines Repositorys.

    Prüfe die Scanergebnisse, die Befunde und die Prüfabdeckung im Sicherheitsbereich.

Ergebnis einordnen

Prüfe zuerst das Scanziel und die Revision. Lies anschließend nach, welche Bereiche geprüft wurden und welche für später zurückgestellt wurden. Auch nach einem abgeschlossenen Scan können Lücken in der Prüfabdeckung bleiben. Selbst wenn die Prüfung keine Befunde ergibt, können noch Schwachstellen vorhanden sein.

Öffne einen Befund. Lies nach, welche Stellen im Quellcode ihn belegen, welche Voraussetzungen für einen Angriff erfüllt sein müssen, wie der Befund validiert wurde und was noch unklar ist. Die Validierung kann sich auf die Analyse des Quellcodes stützen, ohne dass ein Beispiel zur Reproduktion ausgeführt wird. Entscheide anhand der dokumentierten Methode und der Belege, ob das Problem dein System betrifft.

Welche Dateien der Scan erstellt

In der Desktop-App findest du abgeschlossene Scans weiterhin unter Scans. Wenn du die Codex CLI verwendest, öffne das im Chat angegebene Scanverzeichnis. In report.md findest du das Ergebnis als lesbaren Bericht. Bei Bedarf kannst du detaillierte Schwachstellenberichte unter findings/ und Entwurfsvorschläge unter hardening/ anfordern.

Das Verzeichnis enthält außerdem scan-manifest.json, findings.json und coverage.json für Tools und Automatisierungen. Gib das Verzeichnis als Ganzes weiter oder archiviere es vollständig, damit die Links im Bericht weiterhin funktionieren.

Nächsten Workflow auswählen

Weitere Scanmodi und Workflows findest du in der Übersicht zu Codex Security.