Direkt zur Anleitung
buildwith.enzo / Guides Guide 011
Guide 011, Astra-Notizen. Die kurze Anleitung zum Reel.

Astra-Notizen in Codexeinschalten.

Hier ist die Einstellung aus dem Reel: Damit legt sich GPT-6 Astra in langen Codex-Sessions Notizen an und durchsucht frühere Teile der Session. Noch experimentell und standardmäßig aus. In vier Schritten schaltest du sie ein.

  • Rund 5 Min Umsetzung
  • 4 Schritte
  • Windows
  • Codex im Terminal
Los geht’s Lohnt sich das für mich?

So geht’s, in vier Schritten

  1. 1Codex-Version prüfenMindestens 0.153.4, sonst zuerst aktualisieren.
  2. 2config.toml öffnenDie Datei mit den Einstellungen von Codex.
  3. 3Eintrag setzenNeu anhängen oder den vorhandenen ändern.
  4. 4KontrollierenCodex zeigt dir, ob der Schalter an ist.

Du brauchst

  • Einen Windows-PC mit Codex im Terminal, also dem Programm codex in PowerShell.
  • Eine ChatGPT-Anmeldung mit Plus, Pro oder Pro Lite. Mit einem API-Key gibt es die Notizen nicht.
Noch kein Codex oder nur die App?

Noch kein Codex: Richte das Terminal-Programm mit der offiziellen Anleitung von OpenAI ein und komm dann zurück.

Nur Codex-App oder VS-Code-Erweiterung: Diese Anleitung beschreibt den Weg im Terminal. Eintrag und Kontrolle habe ich im Terminal mit Codex 0.154.0 getestet. Die Kontrolle in Schritt 4 braucht das Terminal-Programm. Richte es deshalb zusätzlich nach der offiziellen Anleitung oben ein. Die VS-Code-Erweiterung nutzt laut OpenAI dieselben Einstellungen wie das Terminal-Programm.

1

Prüf deine Codex-Version

Öffne PowerShell: Drück Windows, tipp „PowerShell“ und drück Enter. Gib dann ein:

  • 0.153.4 oder höher: Passt. Weiter mit Schritt 2.
  • Niedriger: Aktualisier Codex zuerst, mit dem Befehl unten. Ältere Versionen kennen den Schalter nicht oder zeigen Astra nicht in der Modellauswahl.
PowerShell kennt codex nicht?

Öffne ein neues PowerShell-Fenster und versuch es noch einmal. Kommt die Meldung weiter, ist das Terminal-Programm nicht eingerichtet, oder PowerShell findet es nicht. Die offizielle Anleitung hilft dir weiter.

Du gibst ein codex --version Codex antwortet, zum Beispiel 
codex-cli 0.154.0
Update-Befehl
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Das ist der offizielle Weg für Windows. Mit npm installiert? Dann nimm npm install -g @openai/codex.

Öffne danach in beiden Fällen ein neues PowerShell-Fenster und prüf die Version noch einmal.

2

Öffne deine config.toml

In dieser Textdatei stehen die Einstellungen von Codex.

  1. Drück Windows + R.
  2. Gib %USERPROFILE%\.codex ein und drück Enter.
  3. Rechtsklick auf config.toml, dann „Öffnen mit“ und „Editor“.
Keine config.toml im Ordner?

Leg sie an: Öffne den Editor von Windows und speichere eine leere Datei in diesem Ordner. Sie muss genau config.toml heißen. Wähl beim Speichern den Dateityp „Alle Dateien“, sonst entsteht config.toml.txt.

Fehlt schon der Ordner .codex, prüf zuerst, ob Codex auf diesem PC eingerichtet ist. Hast du die Umgebungsvariable CODEX_HOME gesetzt, liegt die Datei in dem Ordner, den sie nennt.

3

Setz den Eintrag

Drück im Editor Strg + F und such nach context_management. Drück in der Suche mehrmals Enter, bis du jede Fundstelle gesehen hast. Zeilen, die mit # beginnen, sind Kommentare. Die zählen nicht.

Ist unter den Fundstellen eine Zeile ohne # am Anfang?

Tipp an, was deine Suche ergibt. Dann erscheint der passende Handgriff.

Nichts gefundenHäng den Eintrag ans Ende der Datei

Vorher kurz schauen: Beginnt eine Zeile mit features = {? Das ist selten. Dann häng nichts an, sondern schreib in diese Klammer, mit Komma getrennt: context_management = { experimental_mode = true }

Der Eintrag
# Astra-Notizen in Codex:
# Notizen statt Zusammenfassung
[features.context_management]
experimental_mode = true

Setz den Cursor ans Dateiende, drück Enter, füg den Eintrag ein und speichere mit Strg + S.

So endet deine DateiBeispiel
# … deine Einstellungen …# Astra-Notizen in Codex:# Notizen statt Zusammenfassung[features.context_management]experimental_mode = true

GefundenÄndere den vorhandenen Eintrag

Füg den Eintrag nicht zusätzlich ein, sonst lehnt Codex die Datei ab. Meist sieht die Stelle so aus:

  • Keine experimental_mode-Zeile im Abschnitt oder nur eine mit # davor: Schreib experimental_mode = true unter die Zeile [features.context_management]. Kommentarzeilen dazwischen stören nicht.
  • Unter [features] steht context_management.experimental_mode = false: Setz dort true.
  • In features = { … } steht experimental_mode = false: Setz dort true.
  • Der Abschnitt steht zweimal da: Lass genau einen Abschnitt [features.context_management] mit experimental_mode = true stehen und lösch den anderen komplett, samt Kopfzeile. Auch experimental_mode darf im Abschnitt nur einmal vorkommen.

Speichere mit Strg + S.

VorherBeispiel
[features.context_management]experimental_mode = false

false wird true

NachherBeispiel
[features.context_management]experimental_mode = true

Ob der Eintrag sitzt, zeigt dir Codex selbst in Schritt 4.

4

Kontrollier, ob Codex den Eintrag übernimmt

Schalter prüfen

Wechsel in PowerShell in den Projektordner, in dem du mit Codex arbeitest, zum Beispiel mit cd C:\Projekte\meinprojekt. Eine Projekteinstellung dort kann deinen Eintrag überstimmen, und der Befehl zeigt das. Gib dann ein:

Such die Zeile context_management. Entscheidend ist der Wert ganz rechts. „under development“ ist nur die Entwicklungsstufe.

  • true: Codex hat den Schalter übernommen. Weiter mit dem Modell.
  • false oder Fehlermeldung: Codex liest den Schalter noch nicht als an. Bei einer Fehlermeldung nennt Codex die Zeile. In „Es klemmt“ findest du die Lösung.
Du gibst ein codex features list Ausschnitt aus der echten Ausgabe, Codex 0.154.0

compaction_image_budgetstabletrue

context_managementunder developmenttrue

external_agent_memory_importunder developmentfalse

Modell prüfen

Die Notizen gibt es für GPT-6 Astra. Starte eine neue Session, indem du in PowerShell codex eingibst. Tipp dann /status ein. Dort steht dein aktives Modell. Ist es nicht GPT-6 Astra, wechselst du mit /model.

Ob Astra in einer Session gerade Notizen schreibt, zeigt dir keine der beiden Kontrollen. Eine Anzeige dafür beschreibt OpenAI bisher nicht.

Fertig

Die Astra-Notizen sind eingerichtet

Stimmt alles davon, musst du nichts weiter tun. Offen bleibt, was keine der Kontrollen zeigt: ob du mit deinem ChatGPT-Konto angemeldet bist. Nur so gibt es die Notizen, mit einem API-Key nicht. Wann sie sich lohnen, steht unten unter „Lohnt sich das für mich“.

Den nächsten Guide gibt’s mit dem nächsten Reel: @buildwith.enzo auf Instagram

  • Der Eintrag steht in deiner config.toml.

  • codex features list zeigt context_management auf true.

  • Deine Session läuft mit GPT-6 Astra.

Wenn du mehr wissen willst

Lohnt sich das für mich, und wie arbeiten die Notizen?

Mein Maßstab

Lange Aufgabe, viele Entscheidungen, mehrere fehlgeschlagene Versuche: Dann können die Notizen richtig helfen. Für eine kleine Aufgabe würde ich keine riesige Session offenhalten. Ob die Notizen dort überhaupt etwas zu tun bekommen, hängt davon ab, wie viel Verlauf zusammenkommt.

Was sich ändert

Codex hat für den bisherigen Verlauf nur begrenzt Platz, das Kontextfenster. Läuft es voll, wurde der Verlauf bisher zusammengefasst. Dabei können Details verloren gehen, etwa warum ein Fix gescheitert ist. Mit den Notizen hält Astra solche Details über mehrere Kontextfenster fest. Was nicht in den Notizen steht, kann Astra in früheren Teilen der Session wiederfinden, zum Beispiel Anforderungen oder Testergebnisse.

Ein ausgedachtes Beispiel

  1. Stunde 1. Codex sucht mit dir einen Fehler beim Login. Ihr haltet fest: Den Cache zu leeren hilft nicht, und die Login-Dauer darf sich nicht ändern.
  2. Stunde 3. Das Kontextfenster war schon mehrmals voll. Bisher konnten solche Details beim Zusammenfassen rausfallen.
  3. Mit Notizen soll Astra den gescheiterten Versuch und die Vorgabe behalten. Merken könntest du es daran, dass Codex das Cache-Leeren nicht noch einmal vorschlägt. Beweisen lässt es sich damit nicht.

Noch experimentell

OpenAI kann die Funktion ändern oder wieder herausnehmen. Laut Ankündigung vom 3. September 2026 soll sie in den kommenden Wochen Standard für Astra werden, ein Datum nennt OpenAI nicht. Der Schalter aktiviert laut Release Notes außerdem Kontext nach Token-Budget und ein Werkzeug namens new_context.

Es klemmtHilfe

features list zeigt false

Codex liest den Eintrag nicht als eingeschaltet. Prüf in dieser Reihenfolge:

  • Steht experimental_mode = true ohne # davor und ohne Tippfehler da?
  • Hast du gespeichert, und ist es die Datei im Ordner %USERPROFILE%\.codex? Heißt sie in Wahrheit config.toml.txt?
  • Führst du den Befehl in einem Projektordner aus? Eine Projektdatei .codex\config.toml dort kann den Wert überstimmen. Das habe ich nachgestellt: Im Projektordner stand false, außerhalb true.

Danach zurück zu Schritt 4

Meldung „duplicate key“

Etwas steht doppelt: der Abschnitt [features.context_management] oder die Zeile experimental_mode. Codex nennt dir die Zeile. Lass genau einen Abschnitt mit experimental_mode = true stehen und lösch den anderen komplett, samt Kopfzeile.

Danach zurück zu Schritt 4

Error: failed to load bootstrap configuration
…config.toml:8:11: duplicate key

Meldung „cannot extend value of type inline table“

In deiner Datei steht features = { … }. Lösch den angehängten Block wieder und schreib stattdessen in die Klammer, mit Komma getrennt: context_management = { experimental_mode = true }

context_management fehlt in der Liste oder Meldung „expected a boolean“

Dann ist deine Codex-Version sehr wahrscheinlich zu alt. Prüf sie wie in Schritt 1. Mit Version 0.146.0 fehlte die Zeile, und mit dem Eintrag lehnte Codex die ganze Datei ab. Ist sie älter als 0.153.4, nimm den Eintrag heraus, aktualisier Codex und trag ihn dann wieder ein.

GPT-6 Astra fehlt in der Modellauswahl

Prüf zuerst die Version aus Schritt 1. Prüf dann dein Konto: OpenAI hat Astra für Plus, Pro, Business und Enterprise angekündigt. Pro Lite nennt die Ankündigung nicht, die Notizen-Doku dagegen schon.

Ich finde die Datei nicht

Heißt sie in Wahrheit config.toml.txt, benenn sie um. Die Endung zeigt der Explorer unter „Anzeigen“, „Einblenden“, „Dateinamenerweiterungen“. Mit gesetzter Umgebungsvariable CODEX_HOME liegt die Datei in dem Ordner, den sie nennt.

Ich nutze einen Mac oder Linux

Die Datei liegt dort unter ~/.codex/config.toml, Eintrag und Kontrolle sind dieselben. Getestet habe ich Eintrag und Schalterkontrolle nur unter Windows.

Quellen und StandBelege

Die Fakten stammen aus Ankündigung, Dokumentation und Release Notes von OpenAI. Die Reihenfolge der Handgriffe, das Beispiel und der Maßstab sind von mir.

A · Offizielle Quellen

OpenAI · „GPT-6 Astra: A new generation of intelligence“

„In Codex, Astra can keep notes across context windows, preserving accumulated details without repeatedly compressing them into a single summary. Earlier context windows remain searchable, so Astra can find requirements or test results from previous messages and tool outputs, even if that information wasn’t captured in its notes. You can enable this experimental feature in your Codex config.toml, and it will become the default for Astra in the coming weeks.“

Mechanismus, Rücksuche, Aktivierung über die config.toml, experimenteller Status, angekündigte Verfügbarkeit von Astra. Veröffentlicht am 03.09.2026, Textfassung gesichert am 09.09.2026.

openai.com/index/gpt-6-astra/

OpenAI · Codex-Dokumentation, Config Reference

„Enable experimental context management (off by default). Rather than repeatedly compressing context into a single summary, it uses notes and searchable history to preserve accumulated details. Requires ChatGPT sign-in on Plus, Pro, or Pro Lite.“

Abschnitt [features.context_management], Schlüssel experimental_mode, standardmäßig aus, Kontobedingung. Abgerufen am 14.09.2026.

learn.chatgpt.com/docs/config-file/config-reference

OpenAI · Codex Release Notes und Changelog

0.153.0, 03.09.2026: „Adds the disabled-by-default features.context_management.experimental_mode configuration. When enabled for eligible ChatGPT Plus, Pro, or Pro Lite sessions using the Codex backend, it activates token-budget context, history notes, and the new_context tool. API-key sessions, custom providers, and temporary structured threads remain excluded.“

0.153.4, 04.09.2026: „Fixed Astra’s visibility in the bundled model picker and made it the bundled default when no model is explicitly configured.“

0.154.0, 09.09.2026: „GPT-6-Astra is now available in the model picker and Amazon Bedrock catalogs.“

Schalter ab 0.153.0, kein API-Key, Astra in der Modellauswahl ab 0.153.4. Am 14.09.2026 war 0.154.0 die neueste stabile Version. Abgerufen am 14.09.2026.

github.com/openai/codex/releases · learn.chatgpt.com/docs/changelog

OpenAI · Codex-Dokumentation, CLI und Developer Commands

„codex features list: Show known feature flags, their maturity stage, and their effective state.“ · „Manage feature flags stored in $CODEX_HOME/config.toml.“

Befehl zum Aktualisieren unter Windows und mit npm, die Kontrolle mit codex features list, Ablage über CODEX_HOME. Abgerufen am 14.09.2026.

learn.chatgpt.com/docs/cli · learn.chatgpt.com/docs/developer-commands

OpenAI · Config Basics, Slash Commands, Feature Maturity

„/status: Display session configuration and token usage“ · „Experimental: Unstable and OpenAI may remove or change it.“ · „The CLI and IDE extension share the same configuration layers.“

Ablageorte der Datei, Projektdateien nur in vertrauenswürdigen Projekten und mit Vorrang, gemeinsame Einstellungen von Terminal-Programm und Erweiterung, /status und /model, Bedeutung von „experimentell“. Abgerufen am 14.09.2026, der Satz zur Erweiterung am 16.09.2026.

learn.chatgpt.com/docs/config-file/config-basic · learn.chatgpt.com/docs/cli/slash-commands · learn.chatgpt.com/docs/feature-maturity

B · Was hier bewusst nicht steht

Angaben ohne Beleg

„Gilt nur für neu begonnene Sessions“, eine Anzeige, ob die Notizen in einer Session gerade arbeiten, und eine Mindestversion für Codex-App und VS-Code-Erweiterung. Keine davon steht in einer Herstellerquelle, deshalb stehen sie hier nicht als Tatsache.

C · Eigener Test

Getestet unter Windows 11 mit Codex CLI 0.154.0, 15.09.2026

In einem getrennten Testordner ohne Anmeldung: Eintrag in leere und bestehende Dateien, false auf true, Kommentarzeile dazwischen, Form unter [features], features = { … }, doppelte Einträge und eine überstimmende Projektdatei. In jedem Fall mit codex features list kontrolliert; daher stammen Ausgaben und Meldungen auf dieser Seite. Die Meldung „expected a boolean“ stammt aus einem früheren Test mit 0.146.0. Nicht getestet: eine angemeldete Session mit /status, die Kontobedingung und eine echte lange Session mit Notizen.

Wenn du noch Lust hast

Meine anderen Reels