Codex-Konfiguration und Anpassung
Codex bietet eine umfangreiche Auswahl an Konfigurationsoptionen, mit denen Sie das Verhalten des Agenten an unterschiedliche Arbeitsanforderungen anpassen können.
Standardmäßig verwendet die Codex-App die Sprache Ihrer Systemeinstellungen. Falls nicht, können Sie die Einstellungen verwenden:
Wählen Sie Allgemein, um die gewünschte Sprache unter den Allgemein-Optionen zu ändern:
Um auf ähnliche Weise von Chinesisch auf Englisch umzustellen, wählen Sie einfach Englisch aus:
Codex-App-Einstellungen
So öffnen Sie: Klicken Sie im Anwendungsmenü auf Einstellungen oder drücken SieCmd + ,：
Die Einstellungsoberfläche wird unten angezeigt:
Allgemein:Die Art und Weise, Konfigurationsdateien zu öffnen, und die Anzeigemenge der Befehlsausgabe im Konversations-Thread. Sie können außerdem mehrzeilige Prompts so einstellen, dass sie eine Bestätigung mit Cmd+Enter erfordern, und verhindern, dass das System während der Aufgabenausführung in den Ruhezustand wechselt.
Benachrichtigungen:Legen Sie den Auslösezeitpunkt für Benachrichtigungen bei Aufgabenabschluss fest und ob die App proaktiv die Berechtigung für Systembenachrichtigungen anfordert.
Agent-Konfiguration (Agent Configuration):Der Codex-Agent in der App verwendet dieselbe Konfiguration wie die IDE- und CLI-Erweiterungen. Gängige Optionen können direkt in der App angepasst werden, während erweiterte Optionen das Bearbeiten der Datei config.toml erfordern (wird später beschrieben).
Darstellung:Unterstützt die Auswahl eines Basisdesigns, die Anpassung von Akzentfarbe, Hintergrundfarbe und Vordergrundfarbe sowie das Ändern von UI-Schriftart und Code-Schriftart. Sie können benutzerdefinierte Designs mit anderen teilen.
Codex Pets (Codex Pets):Optionale dynamische Begleiterfiguren, Pfad:Einstellungen > Darstellung > PetsSie können integrierte Pets auswählen oder benutzerdefinierte Pets aus dem lokalen Codex-Home-Verzeichnis laden.
Vorgehensweise:
- Im Eingabefeld eingeben
/pet - Verwenden SieEinstellungen > DarstellunginPet weckenoderPet wegpacken
- drücken
Cmd+K/Ctrl+KFühre dann den Befehl mit demselben Namen aus
Das schwebende Haustier-Fenster kann den aktuellen Arbeitsstatus von Codex (Läuft / Wartet auf Eingabe / Ausstehende Überprüfung) kontinuierlich anzeigen, während du andere Anwendungen verwendest, und enthält einen kurzen Fortschrittshinweis.
Benutzerdefinierte Haustiere (Erstellungsprozess):
$skill-installer hatch-pet
Wähle nach der Installation im BefehlsmenüForce Reload Skillsaus und führe dann aus:
$hatch-pet create a new pet inspired by my recent projects
Git: Vereinheitliche Branch-Namenskonventionen, konfiguriere, ob Force-Push aktiviert werden soll, und lege den Prompt-Text fest, der verwendet wird, wenn Codex automatisch Commit-Nachrichten und PR-Beschreibungen generiert.
Umgebung:Du kannst Projektverzeichnisse anzeigen und Projekte hinzufügen.
Arbeitsbaum:Verwende Git worktree, damit Codex mehrere Aufgaben parallel innerhalb desselben Projekts bearbeiten kann.
Browser-Nutzung:Installiere oder aktiviere das integrierte Browser-Plugin, um Website-Whitelists und -Blacklists zu verwalten. Standardmäßig fragt Codex den Benutzer, bevor eine Website verwendet wird; nachdem eine Website aus der Blacklist entfernt wurde, nimmt Codex das Nachfragen wieder auf. Weitere Details findest du in der In-App-Browser-Dokumentation.
Computer-Nutzung:Nur macOS. Du kannst Zugriffsberechtigungen für Desktop-Apps und zugehörige Einstellungen anzeigen. Um Berechtigungen auf Systemebene zu widerrufen, gehe zu macOS Datenschutz & Sicherheit und ändere die Berechtigungen für Bildschirmaufnahme oder Bedienungshilfen.
Archivierte Threads:
Listet alle archivierten Konversationen auf und zeigt Datum und Projektkontext an. Klicke auf Unarchive, um einen bestimmten Thread wiederherzustellen.
Speicherort der Konfigurationsdatei
Codex-Konfigurationsdateien werden in Ebenen verwaltet:
| Stufe | Pfad | Geltungsbereich |
|---|---|---|
| Benutzerebene | ~/.codex/config.toml | Globale Standardkonfiguration |
| Projektebene | .codex/config.toml | Projektspezifische Konfiguration |
| Verwaltete Ebene | Enterprise-Verteilung | Einheitliche Enterprise-Konfiguration |
Regeln zum Zusammenführen der Konfiguration
Die Konfiguration wird nach Priorität zusammengeführt:
- Verwaltete Konfiguration hat die höchste Priorität
- Projektkonfiguration überschreibt Benutzerkonfiguration
- Benutzerkonfiguration dient als Standard
Grundlegende Konfigurationselemente
Basiskonfiguration
# Standardmodell
model = "gpt-5.4"
# Reasoning-Aufwand
model_reasoning_effort = "medium" # minimal | low | medium | high | xhigh
# Detailstufe der Reasoning-Zusammenfassung
model_reasoning_summary = "auto" # auto | concise | detailed | none
# Service-Tier
service_tier = "flex" # flex | fast
# Genehmigungsrichtlinie
approval_policy = "suggest" # suggest | auto-edit | full-auto
AGENTS.md
AGENTS.md ist eine Agent-Anweisungsdatei auf Projektebene, die die Verhaltensspezifikationen von Codex in diesem Projekt definiert.
Reihenfolge der Dateierkennung
- Global lesen
~/.codex/AGENTS.md - Jedes Verzeichnis ausgehend vom Projektstamm abwärts durchsuchen
- Regeln in näher gelegenen Verzeichnissen haben Vorrang vor weiter entfernten
AGENTS.md Beispiel
Projekt AGENTS.md
## Tech-Stack
- Frontend: React + TypeScript
- Backend: Python FastAPI
- Datenbank: PostgreSQL
## Codestandards
- Verwende 4-Leerzeichen-Einrückung
- Maximal 100 Zeichen pro Zeile
- Alle Funktionen müssen Typannotationen haben
## Testanforderungen
- Neue Funktionen müssen Tests enthalten
- Tests mit pytest ausführen
## Git-Commits
- Conventional-Commits-Format verwenden
- Commit-Nachrichten beschreiben das "Warum"
## Review-Richtlinien
- PII nicht protokollieren
- Authentifizierungs-Middleware überprüfen
- Auf SQL-Injection prüfen
Unterverzeichnis-Überschreibung
Sie können AGENTS.override.md in einem Unterverzeichnis ablegen:
Unterverzeichnis-Regeln
## Sicherheitsanforderungen
- Alle Passwörter müssen mit bcrypt gehasht werden
- Audit-Logs hinzufügen
- Auf SQL-Injection prüfen
AGENTS.md ist auf 32 KiB begrenzt; größere Inhalte werden abgeschnitten.
Skills
Skills sind wiederverwendbare benutzerdefinierte Fähigkeiten, die gängige Aufgabenlogik kapseln.
Speicherort des Skills-Verzeichnisses
| Ort | Pfad | Zweck |
|---|---|---|
| REPO | .agents/skills/ | Skills auf Projektebene |
| USER | ~/.agents/skills/ | Skills auf Benutzerebene |
| ADMIN | /etc/codex/skills/ | Skills auf Systemebene |
| SYSTEM | Integriert | Offizielle voreingestellte Skills |
Skills-Struktur
skill-name/ ├── SKILL.md # 技能定义（必需） ├── scripts/ # 可选脚本 ├── references/ # 可选参考文档 └── assets/ # 可选资源
Skills erstellen
Skill-Definition
name: code-review-standard
description: Führe eine Code-Überprüfung nach Teamstandard durch
---
# Code-Review-Standards
## Prüfpunkte
1. Code-Lesbarkeit
2. Potenzielle Fehler
3. Sicherheitslücken
4. Performance-Probleme
5. Testabdeckung
## Ausgabeformat
Problemliste (nach Schweregrad)
Verbesserungsvorschläge
Bewertung (1-10)
Skill-Auslösung
| Auslösemethoden | Beispiele |
|---|---|
| Expliziter Aufruf | $skill-nameoder/skill-name |
| Impliziter Abgleich | Aufgabenbeschreibung stimmt mit Skill-Beschreibung überein |
Subagenten
Subagenten ermöglichen es, komplexe Aufgaben aufzuteilen und parallel von mehreren Agenten zu verarbeiten.
Integrierte Agent-Typen
| Agent | Funktion |
|---|---|
| default | Allzweck-Agent |
| worker | Ausführungsorientiert, geeignet für Implementierung und Korrekturen |
| explorer | Erkundungsorientiert, geeignet für Codebasis-Analyse |
Konfigurieren von Subagenten
Subagent-Konfiguration
[agents]
# Maximale parallele Threads
max_threads = 6
# Maximale Verschachtelungstiefe
max_depth = 1
# Timeout für einzelne Aufgaben
job_max_runtime_seconds = 1800
Benutzerdefinierte Agenten
Benutzerdefinierte Agenten
name = "reviewer"
description = "Fokussiert auf Code-Review und Qualitätsprobleme"
nickname_candidates = ["Reviewer", "QualityBot"]
developer_instructions = """
Fokus auf Code-Qualitätsprüfung:
- Konsistenz des Code-Stils prüfen
- Potenzielle Fehler entdecken
- Testabdeckung bewerten
"""
Regeln
Regeln definieren Richtlinien für die Befehlsausführung und steuern, welche Befehle automatisch ausgeführt werden können.
Regeldatei
Regeln verwenden die Starlark-Sprache (ähnlich Python):
Regeldefinition
# Git-Befehle erlauben
prefix_rule(
Muster = ["git"],
Entscheidung = "allow",
Begründung = "Git-Befehle sind sicher"
)
# Verbiete rm -rf /
prefix_rule(
Muster = ["rm", "-rf", "/"],
Entscheidung = "forbidden",
Begründung = "Systemschaden verhindern"
)
# Nach npm-Befehlen fragen
prefix_rule(
Muster = ["npm"],
Entscheidung = "prompt",
Begründung = "npm kann Abhängigkeiten ändern"
)
Entscheidungstypen
| Entscheidung | Verhalten |
|---|---|
allow | Automatisch genehmigen |
prompt | Bestätigung anfordern |
forbidden | Ausführung verbieten |
Hooks
Hooks führen bei bestimmten Ereignissen benutzerdefinierte Skripte aus.
Hooks aktivieren
Hooks aktivieren
codex_hooks = true
Hook-Ereignisse
| Ereignis | Auslösezeitpunkt |
|---|---|
SessionStart | Sitzungsstart |
PreToolUse | Vor Tool-Aufruf |
PostToolUse | Nach Tool-Aufruf |
Hook konfigurieren
Hook-Konfiguration
"hooks": [
{
"event": "PostToolUse",
"matcher": {
"toolName": "Bash"
},
"hooks": [
{
"type": "command",
"command": "echo 'Befehl ausgeführt'",
"timeout": 10
}
]
}
]
}
FAQ
F: Wie werden Konfigurationsänderungen wirksam?
Nach dem Ändern der Konfiguration müssen Sie Codex neu starten, damit die Änderung wirksam wird.
F: Wo sollte AGENTS.md platziert werden?
Im Projektstammverzeichnis oder in Unterverzeichnissen, die spezielle Regeln benötigen.
F: Was ist der Unterschied zwischen Skills und Rules?
Skills definieren die Logik der Aufgabenausführung, Rules steuern die Berechtigungen für Befehle.
F: Wie zeige ich die aktuelle Konfiguration an?
Verwenden Sie/statusBefehl zum Anzeigen der aktuellen Sitzungskonfiguration.