Was ist xithead?

xithead ist ein lokaler Proxy von Xtream-ITSolutions UG, der sich zwischen Claude Code und die Anthropic API setzt. Er komprimiert Kontext aggressiv, cached Antworten und dedupliziert identische Requests — vollautomatisch, ohne Code-Änderungen.

Claude Code  ──►  xithead Proxy :8787  ──►  Anthropic API
                  │ Cache-Control
                  │ Context-Trim
                  │ Request-Dedup
                  └ Live Dashboard

Ergebnis: 50–95% weniger Token-Verbrauch, gleiche Qualität.

Installation

Windows (empfohlen — ein Befehl, alles automatisch)

iex (irm https://raw.githubusercontent.com/xtream-itsolutions/xithead/main/headroom.ps1)

Das Skript installiert automatisch (ohne Adminrechte):

• Python 3.12, Node.js, Git (via Winget falls nicht vorhanden)
• xithead Python-Paket + Proxy-Abhängigkeiten
• xithead npm CLI + Claude Code
• Claude Code konfigurieren (~/.claude/settings.json)
• PowerShell-Profil mit allen Hilfsbefehlen

Danach nur noch eingeben (optional):

• Claude Login (Browser oder API-Key)
• GitHub Token (für Repo-Zugriff in Claude Code)

npm (Windows / macOS / Linux)

npm install -g xithead
xithead

pip (Python direkt)

pip install "xithead[proxy]"
python -m xithead.cli.main proxy --port 8787

Benutzung

xithead              # Claude Code mit Proxy starten (empfohlen)
xithead proxy        # Nur Proxy starten (mit Logs)
xithead stats        # Token-Einsparungen anzeigen
xithead update       # Alles aktualisieren (npm + Python)
xithead help         # Alle Befehle

PowerShell-Hilfsbefehle (nach Installation)

xithead-dashboard    # Dashboard im Browser öffnen
xithead-stats        # Einsparungen anzeigen
xithead-update       # Alles auf neuestem Stand halten
xithead-github       # GitHub Token + MCP Server einrichten
xithead-doctor       # System-Diagnose
xithead-help         # Alle Befehle

Dashboard

Das Live-Dashboard läuft automatisch auf http://localhost:8787/dashboard:

• Echtzeit-Statistiken — Token gespart, Kosten, Cache-Hit-Rate
• Request-Verlauf — Token-Verbrauch pro Request als Chart
• Einstellungen — Komprimierungsstärke, Cache-Optionen
• Installation — Quick-Start Guide direkt im Browser

Wie es funktioniert

| Feature | Beschreibung | |---|---| | Cache Control | Anthropic cache_control wird automatisch in jeden Request injiziert (bis zu 90% Einsparung bei Wiederholungen) | | Context Trimming | Lange Konversations-Historien werden aggressiv komprimiert | | Request Deduplication | Identische gleichzeitige Requests werden zusammengeführt | | 429 Retry | Automatisches Retry mit Retry-After Header bei Rate Limits | | SQLite Cache | Persistenter Cache unter ~/.xithead/cache/ |

Claude Code konfigurieren

xithead setzt ~/.claude/settings.json automatisch während der Installation:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:8787/v1",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "16000",
    "XITHEAD_ENABLE_CACHE_CONTROL": "1",
    "XITHEAD_ENABLE_DEDUP": "1",
    "XITHEAD_ENABLE_CONTEXT_TRIM": "1",
    "HEADROOM_STRENGTH": "aggressive"
  }
}

Damit nutzt auch claude direkt (ohne xithead-Wrapper) den Proxy.

GitHub Integration

Claude Code kann direkt mit GitHub arbeiten (Repos lesen, PRs erstellen, Issues verwalten):

xithead-github   # GitHub Token eingeben + MCP Server einrichten

Token erstellen unter: github.com/settings/tokens/new
Benötigte Scopes: repo, workflow, read:org

Auto-Update

xithead prüft automatisch alle 6 Stunden auf neue Versionen:

• Neue npm-Version → stiller Hintergrund-Update
• Python-Paket → parallel aktualisiert

Manuelles Update jederzeit:

xithead update       # oder
xithead-update       # PowerShell-Funktion

Voraussetzungen

| Software | Version | Installiert durch | |---|---|---| | Python | ≥ 3.9 | Winget (automatisch) | | Node.js | ≥ 18 | Winget (automatisch) | | Claude Code | aktuell | npm (automatisch) | | Git | aktuell | Winget (automatisch) |

Lizenz

Apache 2.0 — © 2026 Xtream-ITSolutions UG