Hebby Memories DEEN

Ratgeber · Codex

Codex Gedächtnis & AGENTS.md.

OpenAI Codex arbeitet mit Merkdateien und lokalen Erinnerungen. Was davon bleibt, was nicht und wie Codex ein echtes Langzeitgedächtnis bekommt.

Hat OpenAI Codex ein Gedächtnis?

Ja, aber anders, als viele erwarten. Codex hat keine Erinnerung, die sich von selbst über alle Sitzungen zieht. Es gibt zwei Mechanismen: AGENTS.md, Anweisungsdateien, die Codex vor jeder Arbeit liest, und Codex Memories, lokale Erinnerungen aus früheren Chats. Beide sind Dateien auf deinem Rechner. Wer „Codex Memory“ sucht, landet meistens bei einem von beiden.

AGENTS.md: das wichtigste Codex-Gedächtnis

Codex baut beim Start eine Kette aus AGENTS.md-Dateien auf und liest sie, bevor es arbeitet. So beginnt jede Aufgabe mit denselben Spielregeln, egal welches Repository du öffnest. Die Reihenfolge:

  • Global: Im Codex-Home (standardmäßig ~/.codex) liest Codex AGENTS.override.md, falls vorhanden, sonst AGENTS.md. Es zählt nur die erste nicht leere Datei.
  • Projekt: Ab der Projektwurzel, meist dem Git-Stammordner, geht Codex bis zum aktuellen Verzeichnis. In jedem Ordner prüft es AGENTS.override.md, dann AGENTS.md, dann eigene Ausweichnamen. Pro Ordner kommt höchstens eine Datei hinein.
  • Zusammenführung: Die Dateien werden von der Wurzel nach unten aneinandergehängt. Was näher am Arbeitsverzeichnis steht, kommt später im Prompt und überstimmt Früheres.
  • Grenze: Bei project_doc_max_bytes, standardmäßig 32 KiB, hört Codex auf, weitere Dateien aufzunehmen.

Typische Inhalte sind Befehle für Test und Build, Konventionen und Regeln wie „vor jedem Pull Request den Linter laufen lassen“. Auch Claude Code kann eine vorhandene AGENTS.md als Projektanweisung nutzen, mehr dazu im Ratgeber zu Claude Code Memory.

Codex Memories: lokale Erinnerungen

Zusätzlich kann Codex aus früheren Chats lokale Erinnerungen erzeugen. Das ist standardmäßig aus. Du schaltest es in den Einstellungen unter Personalisierung ein („Enable Codex memories“) oder per memories = true im Abschnitt [features] der config.toml. Dann gilt:

  • Die Erinnerungen entstehen im Hintergrund, nicht sofort am Chat-Ende. Aktive und sehr kurze Sitzungen überspringt Codex, Geheimnisse werden aus den erzeugten Feldern entfernt.
  • Sie liegen lokal im Codex-Home und gelten für den jeweiligen Rechner. Die Erinnerungen des ChatGPT-Webs sind ein getrennter Speicher.
  • OpenAI empfiehlt selbst, verbindliche Vorgaben in AGENTS.md oder Projektdokumentation zu halten. Erinnerungen sind eine Hilfe zum Abrufen, nicht die einzige Quelle für Regeln, die immer gelten müssen.

Wo Merkdateien an Grenzen stoßen

  • Feste Obergrenze: Nach 32 KiB (Standard) fällt weiteres Wissen aus der Kette.
  • Alles oder nichts: Die Kette wird beim Start aufgebaut, nicht passend zur Aufgabe. Jede Zeile kostet bei jeder Sitzung Platz im Kontext.
  • Handpflege: AGENTS.md pflegst du selbst. Überholte Regeln bleiben stehen, bis jemand sie streicht.
  • An einen Rechner gebunden: Codex Memories liegen lokal. Was Codex am Laptop gelernt hat, kennt die Sitzung auf dem Server nicht.
  • Jedes Werkzeug für sich: Was Claude Code gelernt hat, weiß Codex nicht, und umgekehrt.

Codex Memory per MCP

Codex unterstützt das Model Context Protocol (MCP). Server trägst du in der config.toml ein, global unter ~/.codex/config.toml oder je Projekt unter .codex/config.toml. Ein Server mit HTTP-Anbindung bekommt dort einen Abschnitt [mcp_servers.<name>] mit seiner Adresse (url). Lokale Server startest du über command, dafür gibt es auch codex mcp add. Damit bekommt Codex Werkzeuge, um Erinnerungen zu speichern und abzurufen.

Ein Haken bleibt: Viele einfache MCP-Memory-Server warten darauf, dass der Agent selbst daran denkt, sie zu befragen. Im Eifer der Arbeit passiert das oft nicht.

Hebby: ein gemeinsames Gedächtnis für Codex und Claude Code

Hebby ist ein Langzeitgedächtnis, das Codex über Hooks und MCP anbindet. Es erinnert von selbst, ohne dass Codex fragen muss, und löst die Grenzen der Merkdateien:

  • Gezielt: nur die Erinnerungen, die zur aktuellen Anfrage passen, statt einer festen Kette.
  • Vernetzt und aktuell: Hebby weiß, welche Erinnerung zu welchem System gehört. Überholtes tritt zurück, Bewährtes wird gestärkt (Hebbsches Lernen).
  • Gemeinsam: Codex bekommt dieselben Erinnerungen wie Claude Code. Was ein Agent lernt, wissen sofort alle, auch Hermes und jeder andere MCP-fähige Agent.

AGENTS.md mit Hebby: unsere Empfehlung

Lange Anweisungsdateien kosten bei jeder Sitzung Tokens und machen den Agenten messbar schlechter (warum). Halte AGENTS.md deshalb kurz: nur das, was ausnahmslos in jeder Sitzung gelten muss, meist ein, zwei Sätze. Entscheidungen, Stolperfallen und Projektwissen kommen mit Hebby von selbst in die Sitzung, wenn sie gebraucht werden.

Hebby Memories: das Second Brain für Claude Code, Codex & Co. Lernt mit, denkt voraus, vergisst nichts Wichtiges. Early Access sichern →

Häufige Fragen

Hat OpenAI Codex ein Gedächtnis?

Ja, in zwei Formen. Codex liest vor der Arbeit AGENTS.md-Dateien mit deinen Anweisungen. Zusätzlich gibt es lokale Codex Memories, die aus früheren Chats entstehen. Sie sind standardmäßig ausgeschaltet und gelten pro Rechner.

Wo liegt die AGENTS.md von Codex?

Global im Codex-Home, standardmäßig ~/.codex, und je Projekt im Repository: von der Projektwurzel bis zum aktuellen Verzeichnis, höchstens eine Datei pro Ordner. Dateien näher am Arbeitsverzeichnis überschreiben frühere Vorgaben.

Wie binde ich einen Gedächtnisdienst an Codex an?

Über MCP. Codex liest MCP-Server aus der config.toml, global in ~/.codex oder je Projekt in .codex. Für HTTP-Server trägst du unter mcp_servers die Adresse (url) ein. Hebby richtet Codex mit Hooks und MCP im geführten Setup nach der Anmeldung ein.

Können Codex und Claude Code dasselbe Gedächtnis nutzen?

Mit Merkdateien und lokalen Erinnerungen nicht, denn jedes Werkzeug führt seine eigenen. Über einen gemeinsamen MCP-Gedächtnisdienst wie Hebby schon: Was Claude Code lernt, weiß Codex ebenfalls.