So versteht dich Codex besser: Meistere diese Memory-Techniken und steigere deine Effizienz um 90 %

Nachdem du die Codex App eine Weile genutzt hast, kennst du vielleicht ähnliche Frustrationen: Jedes Mal, wenn du ein neues Gespräch beginnst, musst du grundlegende Präferenzen wiederholen, oder sie führt versehentlich Systembefehle aus, die über deine Erwartungen hinausgehen.

Der Kern dieser häufigen Probleme ist, dass deinem Codex ein stabiles Langzeitgedächtnis fehlt. Um diese ineffektiven, sich wiederholenden Kommunikationen vollständig zu lösen, musst du ein vollständiges Gedächtnissystem für ihn aufbauen.

Dieser Artikel erklärt, wie du AGENTS.md und die Memories-Funktion konfigurieren kannst, um Codex ein dauerhaftes Gedächtnis zu geben, sodass er deine Absichten wirklich versteht und Effizienzsteigerungen erzielt.

1. AGENTS.md

1. Was ist das?

AGENTS.md ist eine Reihe von vorgegebenen Regelanweisungen, die Codex bei jedem Start automatisch liest.

Ohne AGENTS.md startet Codex jedes Mal als leeres Blatt – er kennt weder deine Arbeitsgewohnheiten, den Projekthintergrund noch die Grenzen für die Ausführung von Operationen.

Sobald die entsprechenden Regeln konfiguriert sind, werden diese Kontexte dauerhaft wirksam, und du musst das gleiche Problem nie wieder erklären.

2. Wie konfiguriert und verwendet man es

1️⃣ Globale Ebene: Gespeichert im Verzeichnis ~/.codex/AGENTS.md auf deinem lokalen Computer, für alle deine Projekte. Geeignet zum Schreiben von globalen persönlichen Präferenzen und allgemeinen Regeln.

In der Codex App entspricht dies dem Abschnitt „Benutzerdefinierte Anweisungen" auf der Seite „Personalisierung" in den Einstellungen.

Hier ist eine empfohlene Basisvorlage, die du direkt in die oben gezeigte Stelle kopieren und einfügen und dann nach Bedarf anpassen kannst:

1# AGENTS.md
2
3## Grundlegendes Verhalten
4
5- Standardmäßig auf Deutsch antworten, es sei denn, der Benutzer fordert ausdrücklich eine andere Sprache an.
6- Antworten sollten präzise und direkt sein, unnötige Füllwörter und Wiederholungen vermeiden.
7- Wenn die Aufgabenbeschreibung unklar ist, vor dem Start der Ausführung um Bestätigung bitten.
8- Nicht aktiv über die Absicht des Benutzers hinausgehende Bedürfnisse vermuten; nur das tun, was angefragt wird.
9
10## Sicherheitsgrenzen
11
12- Standardmäßig schreibgeschützt; keine Dateien aktiv ändern oder löschen, es sei denn, der Benutzer weist ausdrücklich dazu an.
13- Bei irreversiblen Operationen (wie Löschen, Überschreiben oder Aufrufen externer APIs zum Schreiben) muss zuerst eine Bestätigung eingeholt werden.
14- Keine Schlüssel, Tokens oder sensiblen Anmeldeinformationen in der Ausgabe anzeigen.
15
16## Technische Standards
17
18- Über-Engineering vermeiden; nur Änderungen vornehmen, die explizit erforderlich oder für die Aufgabe offensichtlich notwendig sind, die Lösung einfach halten.
19- Keine Funktionen hinzufügen, Code umgestalten oder zusätzliche Optimierungen durchführen, es sei denn, es wird darum gebeten.
20- Keine Kommentare, Typannotationen oder Docstrings zu unverändertem Code hinzufügen.
21- Kommentare nur hinzufügen, wenn die Logik nicht selbsterklärend ist.
22- Keine Fehlerbehandlung oder Fallback-Logik für Szenarien hinzufügen, die unwahrscheinlich sind.
23- Keine Hilfsfunktionen oder Abstraktionsebenen erstellen, die nur einmal verwendet werden.
24- Code, der als nutzlos bestätigt wurde, direkt löschen; keine Kommentare zur Erklärung hinterlassen.

2️⃣ Projektebene: Gespeichert im Projektverzeichnis, hauptsächlich zum Anpassen von Regeln basierend auf dem Thema und den Eigenschaften des Projekts.

Ein gutes AGENTS.md auf Projektebene sollte typischerweise die folgenden Aspekte abdecken:

• Projekthintergrund und -struktur: Worum es bei dem Projekt geht und wo sich wichtige Verzeichnisse befinden.
• Ausführungsmethoden: Wie das Projekt gestartet, ausgeführt oder betrieben wird.
• Standards und Einschränkungen: Standards, die befolgt werden müssen, und Dinge, die explizit nicht getan werden dürfen.
• Abschlusskriterien: Wie man feststellt, ob eine Aufgabe erledigt ist.

3. Best Practices für AGENTS.md

Das Konfigurieren eines grundlegenden AGENTS.md ist nur der erste Schritt. Die folgenden praktischen Prinzipien bestimmen die Obergrenze deines Gedächtnissystems:

1️⃣ Regel-Hierarchie, klare Verantwortlichkeiten

In Codex folgt AGENTS.md dem Prinzip der Nähe: Unterverzeichnis > Stammverzeichnis > Global. Das heißt, die Regeln in dem Verzeichnis, in dem die aktuelle Arbeit stattfindet, haben die höchste Priorität.

Das bedeutet, dass Regeln auf Projektebene globale Einstellungen desselben Typs direkt überschreiben. Wenn alle Regeln vermischt werden, können lokale Regeln mit hoher Priorität leicht die globale Basisschicht versehentlich verunreinigen oder zerstören.

Daher sollte ein sinnvolles Regel-Gedächtnissystem dem Prinzip der „Trennung der Zuständigkeiten" folgen: Die globale Ebene enthält nur allgemeine Regeln, wie Sprachpräferenzen, Sicherheitsgrenzen und grundlegende Verhaltensgewohnheiten; die Projektebene enthält Spezifikationen, die für dieses Projekt spezifisch sind, wie Build-Befehle, Code-Konventionen und Modulbeschreibungen.

Beide erfüllen ihre jeweiligen Aufgaben, ohne sich gegenseitig zu beeinträchtigen, und es treten keine Konflikte auf, wenn sie zusammengeführt werden.

2️⃣ Einfach anfangen, nach Bedarf iterieren

AGENTS.md muss nicht auf einmal geschrieben werden. Beginne mit den wichtigsten Regeln. Wenn Codex denselben Fehler wiederholt, lass ihn die Regel direkt überprüfen und aktualisieren, zum Beispiel:

„Du hast gerade denselben Fehler gemacht wie beim letzten Mal. Bitte fasse den Grund zusammen und füge die entsprechende Erfahrung zu AGENTS.md hinzu."

Auf diese Weise stammen Regeln immer aus realen Nutzungsproblemen, und AGENTS.md entwickelt sich mit der Nutzung kontinuierlich weiter.

3️⃣ Schlank halten, komplexe Inhalte separat auslagern

Mit zunehmender Nutzung kann der Inhalt von AGENTS.md anwachsen. An diesem Punkt ist es nicht nötig, alles in eine Datei zu packen. Schreibe stattdessen Inhalte zu bestimmten Themen in separate Dateien und verweise in der Hauptdatei darauf.

Zum Beispiel die Projektarchitekturbeschreibung separat als ARCHITECTURE.md schreiben und in AGENTS.md nur einen einzeiligen Verweis einfügen:

„Für die Kernarchitektur und Verzeichnisspezifikationen dieses Projekts siehe die Datei ARCHITECTURE.md im aktuellen Verzeichnis."

2. Memories-Funktion

Zusätzlich zur aktiven Konfiguration relevanter Regeln unterstützt Codex auch eine aktive Gedächtnisfunktion, die in den Einstellungen unter „Personalisierung" – „Memory" aktiviert werden muss, wie unten gezeigt:

Nach dem Einschalten des Schalters fasst Codex aktiv nützliche Informationen und wichtige Präferenzen aus dem Gespräch im Gedächtnis zusammen. Wenn du sehen möchtest, welche Erinnerungen dein Codex hinzugefügt hat, kannst du die Datei Memory.md in ~/.codex/memory öffnen, um den von deinem Codex hinzugefügten Gedächtnisinhalt anzuzeigen. Hier ist meiner:

Abschließend

Der Aufbau eines Gedächtnissystems ist ein Prozess, der sich im Laufe der Zeit weiterentwickelt. Glaube mir, solange du kontinuierlich Aktionsregeln verbesserst und aktualisierst und stetig Erinnerungen ansammelst, wird Codex schnell zu dem unverzichtbaren Produktivitätstool, das dich am besten versteht und am bequemsten zu bedienen ist.