Compact Adviser: Wissen, wann /compact in Claude Code sinnvoll ist

Compact Adviser beantwortet eine Frage, nämlich wann /compact in Claude Code fällig ist: Sollte ich /compact jetzt ausführen? Geschrieben hat sie Kun Chen (kunchenguid), und sie erscheint aus einem einzigen Repository für Claude Code, Pi, Codex CLI und Grok. Diese Seite behandelt die Claude Code Mod in packages/claude-mod.

Zu frühes Komprimieren wirft Kontext weg, den du noch brauchst; zu spätes Komprimieren bedeutet, dass jeder Turn eine lange Historie mitschleppt. Nach jedem abgeschlossenen Turn prüft die Mod ein paar günstige lokale Bedingungen und stellt, wenn sie erfüllt sind, dem Jev-Modell von TypeSafe zwei kurze Fragen zum Gespräch: Ist die letzte Arbeitseinheit des Assistenten fertig, und hat der Assistent die Arbeit selbst erledigt oder vor allem koordiniert? Die beiden Antworten werden zu einem Wert kombiniert. Überschreitet der Wert eine Schwelle, erscheint eine Statuszeile: „work appears completed or recorded. Run /compact to save tokens.“

Die Schwelle ist streng (0,90), solange der Kontext größtenteils leer ist, und lockert sich in Richtung 0,50, je näher der Kontext dem Auto-Compact-Punkt von Claude Code kommt, denn ein falscher Hinweis kostet am meisten, solange noch Platz ist. Wenn du dich für den automatischen Modus entscheidest, führt die Mod die Komprimierung an einem solchen Checkpoint selbst aus, statt nur einen Hinweis zu geben.

Sie braucht einen TypeSafe-API-Schlüssel, den du selbst bereitstellst.

Ein echter Hinweis braucht mehr als 40.000 Tokens Kontext und einen TypeSafe-Schlüssel, was nicht in einen kurzen Clip passt. Die Aufnahme startet Claude Code mit geladener Mod, führt /compact-adviser status aus (Modus, Minimum, Budget und Schlüsselstatus), öffnet dann den Einstellungsbereich /compact-adviser und springt zur Zeile für den TypeSafe-API-Schlüssel, die missing zeigt.

Nutze eine der beiden Methoden aus dem Installationsblock; beide installieren direkt aus dem Marketplace des Autors. Die Mod tut gar nichts, wenn Claude Code nicht mit CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 startet. Starte es also mit dieser Variable und führe dann /compact-adviser aus, um deinen TypeSafe-Schlüssel hinzuzufügen.

Alles beginnt im turn.complete-Hook in hooks/register.ts:

on("turn.complete", async ($, e, next) => {
  const result = await next(e);
  if (!(await isActivated($)) || !interactive) return result;
  if (e.agentId !== undefined || e.reason !== "answer" || e.isAborted || !e.answer.trim()) {
    return result;
  }
  try {
    await settle($);
  } catch {
    notice($, "Compact adviser could not inspect this checkpoint; context left unchanged.");
  }
  return result;
});

Es zählt nur ein Turn der Hauptschleife, der mit einer echten Antwort endete; Subagent-Turns und abgebrochene Turns werden übersprungen. settle zählt den Austausch und prüft die günstigen Hürden: Modus nicht aus, ein Schlüssel vorhanden, Kontext bei oder über minContextTokens und keine Abklingzeit oder Snooze. Sind sie erfüllt, plant es judgeCheckpoint mit $.clock.after(0, …) ein, damit der Turn nicht aufgehalten wird.

judgeCheckpoint baut einen begrenzten Schnappschuss aus $.session.messages() (siehe lib/snapshot.ts), überspringt die Anfrage, wenn das Gespräch unter 20.000 Tokens liegt oder derselbe Checkpoint bereits bewertet wurde, und sendet ihn mit $.http.fetch an https://api.typesafe.ai/v1/systemone. Die Anfrage bricht nach 2 Sekunden ab, und ein Fehler, ein Timeout oder eine fehlerhafte Antwort zählt nie als Ja: Die Mod hält sich dann zurück und zeigt stattdessen einen Toast. Erfüllt der Wert die Schwelle, ruft der Hinweis-Modus $.ui.status mit dem Hinweis auf, und der automatische Modus ruft $.session.compact mit der Anweisung auf, die aktuelle Arbeit, offene Aufgaben und den nächsten Schritt exakt zu erhalten.

Jede Komprimierung, ob deine oder die von Claude Code, setzt über den session.compact-Hook die Abklingzeit der Sitzung zurück.

Führe /compact-adviser aus, um den Einstellungsbereich zu öffnen, oder nutze die Unterbefehle: auto, hint und off wechseln den Modus; threshold 60000 setzt den Mindestkontext; budget 450000 setzt ein Kontextbudget, an dem die Schwelle statt am Auto-Compact-Punkt gemessen wird; snooze überspringt die nächsten drei Austausche; dismiss entfernt den aktuellen Hinweis; status gibt den aktuellen Zustand aus. Modus, Minimum, Budget und Anfrageprotokollierung sind auch Zeilen in /config. Ein Bewertungsprofil (JSON in der Einstellung profile) kann die Fragen, die Gewichtung des Werts oder den Verlauf der Schwelle ändern.

Wir haben register.ts, jede Datei unter lib/, plugin.json, hooks.json, package.json und die Test-Helfer gelesen, bevor wir irgendetwas ausgeführt haben.

• Netzwerk: Die Mod sendet pro qualifizierendem Checkpoint eine Anfrage an https://api.typesafe.ai/v1/systemone, einen Drittanbieterdienst, mit deinem Schlüssel im Header Authorization. Der Inhalt ist ein Schnappschuss des jüngsten Gesprächs, gedeckelt auf 32.000 Bytes, nach bestmöglicher Schwärzung von Schlüsselmustern sowie .env-, auth.json-, id_rsa/id_ed25519-, .pem- und .key-Dateien. TYPESAFE_BASE kann auf eine andere https-Basis oder eine Loopback-http-Adresse zeigen. Die Installation des Plugins gilt als Einwilligung, dies zu senden, sobald ein Schlüssel vorhanden ist; stelle den Modus also auf off für Arbeit, die deinen Rechner nicht verlassen darf.
• Dateien: Sie liest .env im Sitzungsordner, um nach TYPESAFE_API_KEY zu suchen. Sie schreibt nur, wenn du die Anfrageprotokollierung einschaltest: ~/.claude/compact-adviser-requests-<session-id>.jsonl, das den Schlüssel nie enthält.
• Einstellungen: Speichern aus dem Bereich schreibt die eigenen userConfig-Zeilen des Plugins über $.config.set. Der gespeicherte Schlüssel ist in /config verborgen.
• Komprimierung: nur im automatischen Modus, nach einem einmaligen Bestätigungsdialog.

Es gibt keine Installationsskripte, keinen gebündelten oder minifizierten Code und keine Telemetrie außer der TypeSafe-Anfrage selbst.

Validiert mit Claude Code 2.1.291: claude plugin validate besteht ohne Warnungen, und claude plugin test führt 114 Tests aus, die alle bestehen. Der Autor nennt Claude Code 2.1.274 oder neuer. Wenn nichts passiert, prüfe Folgendes der Reihe nach:

• /compact-adviser fehlt: CLAUDE_CODE_ENABLE_FUNCTION_HOOKS ist nicht genau 1, oder COMPACT_ADVISER_DISABLE ist gesetzt.
• /compact-adviser status meldet Key: missing: Füge einen Schlüssel im Bereich, in der Umgebung oder in ./.env hinzu.
• Der Befehl funktioniert, aber kein Hinweis erscheint: Der Kontext liegt unter dem Minimum, oder der letzte Turn endete nicht mit einer abgeschlossenen Antwort.
• Ein Toast erwähnt „nonessential network traffic“: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC blockiert die Anfrage an TypeSafe.
• Sitzungen mit claude -p sind absichtlich immer inaktiv.