xithead 1.2.1

Aggressive Claude context optimizer by Xtream-ITSolutions UG - Cut costs by 50-95%

⚡ xithead

Claude Context Optimizer — bis zu 95% Token-Einsparung, automatisch

🌐 xtream-itsolutions.com · 💬 Discord · 🐛 Bug melden

---

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

---

💬 Discord · 🌐 xtream-itsolutions.com · GitHub