Claude Code und Codex in der Notch verfolgen

Schalte das Verfolgen von KI-Agenten ein und verbinde Claude Code und Codex im Terminal, um ihren Fortschritt direkt in der Notch zu sehen.

OneNotch verfolgt die Sitzungen von Claude Code und Codex, die du im Terminal ausführst: was der Agent gerade tut, wann er deine Antwort braucht, wann er fertig ist und wie viel Kontingent übrig ist. Dafür installiert OneNotch ein paar kleine „Hooks“ in der Konfiguration jedes Agenten.

Bevor du beginnst

Du brauchst die Terminal-Version von Claude Code oder Codex, installiert und angemeldet. Die Desktop- und Web-Apps von Claude und Codex schreiben die Daten nicht, die OneNotch liest, und können daher nicht verfolgt werden.

Verfolgen einschalten

  1. Öffne Einstellungen › KI und schalte KI-Agenten verfolgen ein.
  2. Lass im Bereich Agenten Claude Code und/oder Codex eingeschaltet, je nachdem, welche Agenten du nutzt.
  3. Öffne im Bereich Verbindung Claude Code oder Codex und klicke auf Einrichtung.
  4. Für Codex: Wenn Codex zum ersten Mal nach den neuen Hooks fragt, wähle Trust all. Hast du das übersprungen, öffne Codex und führe /hooks aus, um den Hooks von OneNotch zu vertrauen.
Einstellungen › KI: „KI-Agenten verfolgen“ und die Bereiche „Notch“, „Kontingent“, „Ton“ und „Agenten“

Du kannst das Verfolgen auch in der Einrichtungshilfe einschalten und deine Agenten verbinden, die beim ersten Öffnen von OneNotch erscheint.

Was die Einrichtung an deiner Konfiguration ändert

  • Claude Code: OneNotch fügt Hooks zu ~/.claude/settings.json hinzu und eine Statuszeile, um dein Kontingent zu lesen. Hast du schon eine eigene Statuszeile, läuft sie weiter und wird wie bisher angezeigt.
  • Codex: OneNotch fügt Hooks zu ~/.codex/hooks.json hinzu und schaltet die Hooks-Funktion in config.toml ein.

Alle vorhandenen Hooks und Einstellungen bleiben erhalten. OneNotch sichert jede Datei, bevor es sie ändert.

Der Bereich „Verbindung“ unter „Einstellungen › KI“: Codex nicht eingerichtet (Taste „Einrichtung“), Claude Code verbunden mit settings.json, „Hook-Befehl“, „Nutzungsstatuszeile“ und die Tasten „Neu installieren“, „Entfernen“ und „Aktualisieren“

Die Tasten im Bereich Verbindung ändern sich mit dem Status des jeweiligen Agenten:

  • Hooks nicht installiert: Einrichtung und Aktualisieren. Entfernen ist abgeblendet, weil es noch nichts zu entfernen gibt.
  • Verbunden (grünes Häkchen, Verbunden): Neu installieren, Entfernen und Aktualisieren. Neu installieren installiert die Hooks erneut. Nutze es, wenn die Hooks versehentlich geändert oder gelöscht wurden.

Anpassen

Unter Einstellungen › KI:

  • Prozent anzeigen als: Verwendet (Standard) oder Verbleibend.
  • Sitzungen sortieren nach: Erfordert zuerst Aufmerksamkeit (Standard) oder Letzte Aktualisierung.
  • Laufanzeige: die Animation an der Notch, während ein Agent arbeitet, etwa Pixelraster, Formen oder Scannender Globus.
  • Hinweise stummschalten und Hinweiston: der Ton, der abgespielt wird, wenn eine Sitzung fertig ist oder dich braucht.

Nutzt Claude Code einen anderen Konfigurationsordner als ~/.claude, öffne Verbindung › Claude Code › Erweitert, gib den Pfad unter Konfigurationsordner ein und drücke Return.

Verfolgen ausschalten

Schaltest du KI-Agenten verfolgen aus, wird die Seite „KI“ ausgeblendet, und die Hooks von OneNotch werden aus Claude Code und Codex entfernt. Schaltest du es wieder ein, klicke erneut auf Einrichtung. Um die Hooks nur für einen Agenten zu entfernen und den anderen weiter zu verfolgen, klicke im Bereich Verbindung dieses Agenten auf Entfernen.