Claude Code undokumentierte Funktionen: Hooks, Memory, YOLO-Klassifikator und mehr

André Figueira hat den Claude Code-Quellcode (v2.1.87) gelesen und Dutzende undokumentierter Konfigurationsoptionen gefunden. Die offizielle Dokumentation deckt die Grundlagen ab, aber das eigentliche Paket – frei einsehbar in node_modules – gibt Felder für Hooks, Agentengedächtnis, Auto-Modus-Regeln und mehr preis. Hier ist, was Sie tatsächlich jetzt konfigurieren können.

YOLO-Klassifikator: Aktionen automatisch genehmigen mit einfachem Englisch

Intern als "YOLO-Klassifikator" bezeichnet (yoloClassifier.ts), ermöglicht dieses System, Ihre Umgebung in einfachem Englisch zu beschreiben, um zu entscheiden, wann Claude Vorgänge automatisch genehmigen kann. Fügen Sie in settings.json eine Beschreibung wie "dies ist ein Staging-Server, destruktive Operationen sind akzeptabel" hinzu, um bestimmte Aktionen ohne Nachfrage zuzulassen.

Hook-Rückgabewerte, die das Verhalten während der Ausführung ändern

Hooks erhalten JSON über stdin und können ereignisspezifisches JSON über stdout zurückgeben. Hier sind die wichtigsten Rückgabefelder:

• PreToolUse: updatedInput (Werkzeugeingabe vor Ausführung umschreiben), permissionDecision (erzwingen Erlauben/Verweigern), permissionDecisionReason, additionalContext
• SessionStart: watchPaths (automatische Dateiüberwachung, die FileChanged-Ereignisse auslöst), initialUserMessage (Inhalt der ersten Benutzernachricht voranstellen), additionalContext
• PostToolUse: updatedMCPToolOutput, additionalContext
• PermissionRequest: decision (programmatisches Erlauben/Verweigern mit updatedInput oder updatedPermissions)

Beispiel: Ein PreToolUse-Hook, der jedem git push-Befehl --dry-run hinzufügt. In .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/hooks/dry-run-pushes.sh"
      }]
    }]
  }
}

Skript unter ~/.claude/hooks/dry-run-pushes.sh:

#!/bin/bash
INPUT=$(jq -r '.tool_input.command' 
Dies schreibt den Befehl vor der Ausführung um – ein undokumentiertes Feld.

Sitzungskontext & Dateiüberwachung

SessionStart-Hooks können watchPaths setzen, um Dateien wie package.json, .env und tsconfig.json auf Änderungen zu überwachen und FileChanged-Ereignisse auszulösen. Sie können auch initialUserMessage injizieren, um Kontext voranzustellen, z.B. aktuellen Git-Branch und Anzahl uncommitteter Änderungen.

Beispielskript, das Überwachungspfade und eine Anfangsnachricht zurückgibt:

#!/bin/bash
BRANCH=$(git branch --show-current 2>/dev/null)
CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
jq -n \
  --arg branch "$BRANCH" \
  --arg changes "$CHANGES" \
  '{
    "watchPaths": ["package.json", ".env", "tsconfig.json"],
    "initialUserMessage": "Aktueller Branch: \($branch), uncommittete Änderungen: \($changes)"
  }'

Persistentes Agentengedächtnis & Auto-Modus-Regeln

Das Agentengedächtnis kann mit Feldern im Verzeichnis ~/.claude/agents/ konfiguriert werden, um über Sitzungen hinweg zu bestehen. Auto-Modus-Regeln können in einfachen englischen Dateien beschrieben werden, die Claude sagen, wann Aktionen automatisch genehmigt werden sollen. Der Quellcode deutet auch auf "selbstverbessernde Traumschleifen" hin, in denen Claude seine eigenen Konfigurationen verfeinern kann.

Dateipfade

• Einstellungen: ~/.claude/settings.json (persönlich) oder .claude/settings.json (Projekt, über Git teilbar)
• Fähigkeiten: ~/.claude/skills/<name>/SKILL.md (persönlich) oder .claude/skills/<name>/SKILL.md (Projekt)
• Agenten: ~/.claude/agents/<name>.md (persönlich) oder .claude/agents/<name>.md (Projekt)
• Hook-Skripte: Üblicherweise in ~/.claude/hooks/, müssen ausführbar sein (chmod +x)

Diese sind praktisch für Entwickler, die Claude Code über die dokumentierten APIs hinaus anpassen möchten. Diese Funktionen können sich zwischen den Versionen ändern.