{
"event": "PostToolUse",
"tool_name": "Read",
"tool_response": {
"type": "text",
"file": {
"filePath": "\/var\/www\/tools\/ki-protokoll\/claude-hook\/README.md",
"content": "# Claude Code KI-Protokoll Hook\n\nDieses System protokolliert alle Claude Code Interaktionen in der MariaDB `ki_protokoll` Datenbank.\n\n## Installation\n\n```bash\ncd \/var\/www\/ki-protokoll\/claude-hook\n.\/install.sh\n```\n\n## Automatische Aktivierung\n\nDas Installationsskript aktiviert die Hooks automatisch **user-weit**, sodass sie von jedem Verzeichnis aus funktionieren:\n\n```bash\ncd \/var\/www\/ki-protokoll\/claude-hook\n.\/install.sh\n```\n\nDas System:\n- Erstellt automatisch `~\/.claude\/` falls nicht vorhanden\n- Sichert bestehende Einstellungen als Backup\n- Installiert die Hooks user-weit\n- **Funktioniert von jedem Verzeichnis** aus\n\n## Manuelle Aktivierung (falls gewünscht)\n\n### Option 1: User-weite Aktivierung (empfohlen)\n```bash\nmkdir -p ~\/.claude\ncp \/var\/www\/ki-protokoll\/claude-hook\/settings.json ~\/.claude\/settings.json\n```\n\n### Option 2: Projekt-spezifische Aktivierung\n```bash\ncp \/var\/www\/ki-protokoll\/claude-hook\/settings.json .claude\/settings.json\n```\n⚠️ **Nur wenn Claude aus dem Projekt-Root gestartet wird**\n\n### Option 3: Manuelle Integration\nFüge den `hooks` Abschnitt aus `settings.json` in Deine bestehende Claude Code Konfiguration ein.\n\n## Funktionalität\n\nDas System protokolliert:\n\n- **UserPromptSubmit**: Alle Benutzereingaben\n- **PreToolUse**: Tool-Aufrufe vor der Ausführung\n- **PostToolUse**: Tool-Antworten nach der Ausführung\n- **Stop\/SubagentStop**: Beendigung von Hauptagent\/Subagenten\n- **SessionStart\/SessionEnd**: Session-Lebenszyklus\n\n## Datenbank-Schema\n\nTabelle: `protokoll`\n- `id`: Auto-Increment ID\n- `timestamp`: Sortierbare Zeitstempel\n- `request_ip`: Client IP-Adresse\n- `client_name`: Benutzername\n- `request`: JSON der Anfrage\n- `request_timestamp`: Zeitstempel der Anfrage\n- `response`: JSON der Antwort\n- `response_timestamp`: Zeitstempel der Antwort\n- `duration_ms`: Dauer in Millisekunden\n- `tokens_input`: Geschätzte Eingabe-Token\n- `tokens_output`: Geschätzte Ausgabe-Token\n- `tokens_total`: Gesamte Token\n- `model_name`: KI-Modell Name\n- `status`: Status (pending\/completed\/error)\n\n## Sicherheit\n\n- **Sensible Daten**: Passwörter, API-Keys und Tokens werden automatisch maskiert\n- **Längenbegrenzung**: Sehr lange Inhalte werden gekürzt mit Checksumme\n- **Nicht-blockierend**: Fehler stoppen nicht den normalen Claude Code Betrieb\n- **Dedizierter DB-User**: Nur Lese-\/Schreibrechte, keine Schema-Änderungen\n\n## Überwachung\n\n```sql\n-- Aktuelle Aktivität anzeigen\nSELECT * FROM ki_protokoll.protokoll ORDER BY timestamp DESC LIMIT 10;\n\n-- Token-Verbrauch pro Tag\nSELECT\n DATE(timestamp) as date,\n SUM(tokens_total) as total_tokens,\n COUNT(*) as interactions\nFROM ki_protokoll.protokoll\nGROUP BY DATE(timestamp)\nORDER BY date DESC;\n\n-- Top Tool-Nutzung\nSELECT\n JSON_EXTRACT(request, '$.tool_name') as tool,\n COUNT(*) as usage_count\nFROM ki_protokoll.protokoll\nWHERE JSON_EXTRACT(request, '$.tool_name') IS NOT NULL\nGROUP BY tool\nORDER BY usage_count DESC;\n```\n\n## Fehlerbehebung\n\n### Database Connection Test\n```bash\npython3 -c \"\nimport pymysql\nconn = pymysql.connect(\n host='localhost',\n user='ki_protokoll',\n password='KiProtokoll2025_Secure_X9mP7nQ4tR8wL2',\n database='ki_protokoll'\n)\nprint('Connection successful')\nconn.close()\n\"\n```\n\n### Hook Test\n```bash\necho '{\"hook_event_name\":\"test\",\"session_id\":\"manual-test\"}' | \/var\/www\/ki-protokoll\/claude-hook\/log_to_db.py\n```\n\n### Debug Mode\nStarte Claude Code mit Debug-Modus:\n```bash\nclaude --debug\n```\n\n## Konfiguration\n\nDatenbankverbindung in `log_to_db.py` anpassen falls nötig:\n```python\nDB_CONFIG = {\n 'host': 'localhost',\n 'port': 3306,\n 'user': 'ki_protokoll',\n 'password': 'KiProtokoll2025_Secure_X9mP7nQ4tR8wL2',\n 'database': 'ki_protokoll',\n 'charset': 'utf8mb4'\n}\n```\n\n## Support\n\nLogs werden nach stderr geschrieben bei Fehlern, blockieren aber nicht den Claude Code Betrieb.\nÜberprüfe die MariaDB Logs bei Verbindungsproblemen:\n```bash\nsudo tail -f \/var\/log\/mysql\/error.log\n```",
"numLines": 152,
"startLine": 1,
"totalLines": 152
}
}
}