Codex-Spickzettel

Dieser Anhang enthält einen Befehls-Spickzettel, häufig gestellte Fragen und Informationen zu Versionsupdates.


Befehls-Spickzettel

Grundlegende CLI-Befehle

BefehlBeschreibung
codexInteraktive TUI starten
codex "任务"Angegebene Aufgabe starten und ausführen
codex exec "任务"Aufgabe im nicht-interaktiven Modus ausführen
codex --versionVersionsinformationen anzeigen
codex --helpHilfeinformationen anzeigen

Slash-Befehle

BefehlBeschreibung
/model <name>Modell wechseln
/fastFast-Modus umschalten
/planPlanmodus aufrufen
/reviewCodeänderungen überprüfen
/newNeue Sitzung starten
/resumeHistorische Sitzung fortsetzen
/forkAktuelle Sitzung klonen
/compactKontext komprimieren
/statusSitzungsstatus anzeigen
/clearBildschirm löschen
/quitCodex beenden
/approval <mode>Genehmigungsmodus umschalten

CLI-Argumente

ArgumentBeschreibung
-m <model>Modell angeben
--sandbox <mode>Sandbox-Modus festlegen
--approval-mode <mode>Genehmigungsmodus festlegen
-i <file>Bild anhängen
-o <file>Ausgabe in Datei (exec)
--full-autoVollautomatische Ausführung
--ephemeralSitzungsdateien nicht speichern
--reasoning-effort <level>Reasoning-Aufwand

Ausführung von Shell-Befehlen

FormatBeschreibung
! <command>Shell-Befehl in Codex ausführen
! git statusGit-Status anzeigen
! npm testTests ausführen

Pfade der Konfigurationsdateien

Speicherorte der Konfigurationsdateien

DateiPfadZweck
Benutzerkonfiguration~/.codex/config.tomlGlobale Standardkonfiguration
Projektkonfiguration.codex/config.tomlProjektspezifische Konfiguration
ProjektanweisungenAGENTS.mdRichtlinien für das Projektverhalten
Protokollverzeichnis~/.codex/log/Ausführungsprotokolle
Sitzungsverzeichnis~/.codex/sessions/Sitzungsaufzeichnungen

Skills-Verzeichnis

OrtPfad
Projektebene.agents/skills/
Benutzerebene~/.agents/skills/
Systemebene/etc/codex/skills/

Tastaturkürzel

CLI-Tastenkürzel

TastenkürzelFunktion
EnterNachricht senden
Shift+EnterNeue Zeile
Ctrl+CVorgang unterbrechen
Ctrl+C (两次)Codex beenden
Ctrl+DBeenden (wenn Eingabe leer ist)
Ctrl+RVerlauf durchsuchen
Up/DownVerlauf durchblättern
TabAutovervollständigung
Esc EscVorherige Nachricht bearbeiten
Ctrl+OLetzte Antwort kopieren

App-Tastenkürzel

TastenkürzelFunktion
Cmd/Ctrl+NNeue Sitzung
Cmd/Ctrl+Shift+NNeues Fenster
Cmd/Ctrl+WFenster/Tab schließen
Cmd/Ctrl+[Vorheriger Tab
Cmd/Ctrl+]Nächster Tab

Häufig gestellte Fragen

Installation und Authentifizierung

F: Wie installiere ich Codex CLI?

Verwende npm oder Homebrew:

npm install -g @openai/codex
# 或
brew install codex

F: Wie authentifiziere ich mich bei der ersten Verwendung?

Durch Ausführen des Befehls codex wird automatisch ein Browser zur Authentifizierung geöffnet. Melde dich mit einem ChatGPT-Konto oder API-Schlüssel an.

F: Windows-Unterstützung?

Native Windows-Unterstützung ist experimentell; für die beste Erfahrung wird WSL2 empfohlen.

Nutzungsprobleme

F: Wie sehe ich die aktuelle Konfiguration an?

Verwenden Sie/statusBefehl zum Anzeigen der Konfiguration und des Status der aktuellen Sitzung.

F: Wie deaktiviere ich den alternativen Bildschirm?

Verwenden Siecodex --no-alt-screenoder konfigurierenalternate_screen = "never"。

F: Was ist, wenn der Befehl nicht gefunden wird?

Stelle sicher, dass PATH das globale npm-Installationsverzeichnis enthält, oder verwende Homebrew zur Installation.

F: Wie kann man Logs anzeigen?

Die Logs befinden sich in~/.codex/log/Verzeichnis abgelegt werden.

Feature-Probleme

F: Was ist der Unterschied zwischen exec und dem interaktiven Modus?

exec beendet sich nach einer einzelnen Ausführung, geeignet für Automatisierungsskripte; der interaktive Modus unterstützt fortlaufende Konversation und eignet sich für die tägliche Entwicklung.

F: Wie setzt man eine frühere Sitzung fort?

Verwenden Sie/resumeBefehl odercodex resume --last。

F: Können GitHub Actions Dateien ändern?

Ja, setze sandbox: workspace-write.

F: Wie authentifiziert man sich in CI/CD?

Verwende die Umgebungsvariable CODEX_API_KEY, die als Secrets gespeichert ist.

Sicherheitsprobleme

F: Wie kann man verhindern, dass Codex wichtige Dateien löscht?

Verwenden Sie den read-only- oder workspace-write-Sandbox-Modus und konfigurieren Sie Rules, um gefährliche Befehle zu verbieten.

F: Ist der full-auto-Modus sicher?

full-auto führt automatisch alle Vorgänge aus, einschließlich des Löschens von Dateien; mit Vorsicht verwenden.

F: Wie geht man mit sensiblen Daten um?

Verwenden Sie den Secrets-Speicher, der nur in Setup-Skripten verfügbar ist.


Versionsupdates

Aktuelle Updates

VersionDateUpdate-Inhalt
v1.5.02026-04Unterstützung für Modelle der GPT-5.4-Serie hinzugefügt
v1.4.02026-03Worktree-Funktionalität verbessert
v1.3.02026-02Review-Modus hinzugefügt
v1.2.02026-01MCP-Server-Unterstützung optimiert
v1.1.02025-12GitHub-Integration hinzugefügt
v1.0.02025-11Codex offiziell veröffentlicht

CLI aktualisieren

Aktualisierungsbefehle

# npm update
npm install -g @openai/codex@latest

# Homebrew update
brew upgrade codex

# Aktuelle Version anzeigen
codex --version

Verwandte Ressourcen

Offizielle Ressourcen

RessourceAdresse
Offizielle Dokumentationhttps://developers.openai.com/codex
GitHubhttps://github.com/openai/codex
Codex Webhttps://chatgpt.com/codex
Discordhttps://discord.gg/openai

Tutorial-Serie

KapitelTitleInhalt
01Codex – Erste SchritteKernfunktionen, Planvergleich
02KernkonzeptePrompt, Thread, Kontext, Sandbox
03Desktop-AnwendungApp-Funktionen, Review-Modus
04IDE-ErweiterungVS Code, Cursor, Windsurf
05Kommandozeilen-ToolCLI-Installation, TUI, Genehmigung
06Cloud-VersionWeboberfläche, Umgebungen
07Integration & KonnektivitätGitHub, Slack, Linear, MCP
08Konfiguration & AnpassungKonfiguration, Regeln, Skills
09Automatisierung & CI/CDexec, SDK, GitHub Action
10Workflow-ModiEntwicklungsworkflow, Refactoring, Fehlerbehebungen
11Prompt-Best PracticesPrompt-Struktur, Aufgabenzerlegung
12Sicherheit & UnternehmensmanagementSandbox, Berechtigungen, Audit-Logs
13ModellauswahlGPT-5.4-Serie, Reasoning-Stärke
14AnhangBefehls-Kurzreferenz, FAQ

Glossar

BegriffBeschreibung
AgentCodex' zentrale Ausführungseinheit, die Aufgaben verstehen und Operationen ausführen kann
PromptVom Benutzer an Codex gesendete Aufgabenanweisungen
ThreadSitzungssequenz, die den vollständigen Konversationsverlauf enthält
KontextUmfang der für Codex verfügbaren Informationen, einschließlich Dateien, Konversationen und Konfiguration
SandboxIsolierte Ausführungsumgebung, die den Umfang der Operationen von Codex einschränkt
GenehmigungGenehmigungsrichtlinien, die das Bestätigungsverhalten vor der Ausführung von Operationen steuern
AGENTS.mdProjektanweisungsdateien, die die Verhaltensrichtlinien von Codex definieren
SkillWiederverwendbare benutzerdefinierte Fähigkeitsmodule
SubagentUnteragenten, die zur parallelen Verarbeitung komplexer Aufgaben eingesetzt werden
RegelnRegel-Engine, die Berechtigungen für die Befehlsausführung definiert
MCPModel Context Protocol, ein Protokoll zum Verbinden externer Tools
WorktreeGit-Worktree, mit dem Arbeitsverzeichnisse für verschiedene Aufgaben isoliert werden

Feedback und Support

Hilfe erhalten

  • Nutzung/helpVerwenden Sie Befehle, um die integrierte Hilfe anzuzeigen
  • Besuchen Sie die offizielle Dokumentation für detaillierte Anweisungen
  • Treten Sie der Discord-Community bei, um sich auszutauschen und zu diskutieren

Probleme melden

Codex wird kontinuierlich aktualisiert und weiterentwickelt; folgen Sie den offiziellen Kanälen für die neuesten Informationen.

Andere Erweiterungen