Docs›Claude-Code-Integration

Claude-Code-Integration

Claude-Code-Traffic durch Grepture routen für Observability, Kosten-Tracking und PII-Schutz. Einrichtung in unter 2 Minuten.

Überblick

Claude Code ist Anthropics CLI-Tool für agentenbasiertes Programmieren. Wenn Sie Claude Code durch Grepture routen, erhalten Sie:

• Observability — jeden Request und jede Response in Ihrem Grepture-Dashboard protokollieren
• Kosten-Tracking — Token-Nutzung und Ausgaben pro Request und Entwickler sehen
• PII-Schwärzung — sensible Daten erkennen und schwärzen, bevor sie Anthropic erreichen

Die Einrichtung dauert unter 2 Minuten. Keine SDK-Installation nötig — nur drei Umgebungsvariablen.

Voraussetzungen

1. Ein Grepture-Konto (hier registrieren)
2. Ihr Grepture-API-Schlüssel (im Dashboard unter API)
3. Ein Anthropic-API-Schlüssel für Claude Code
4. Claude Code installiert (npm install -g @anthropic-ai/claude-code)

Konfiguration

Claude Code liest seine Konfiguration aus ~/.claude/settings.json (global) oder .claude/settings.json (pro Projekt). Fügen Sie folgende Umgebungsvariablen hinzu:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://proxy.grepture.com/claude",
    "ANTHROPIC_API_KEY": "sk-ant-api03-ihr-schlüssel",
    "ANTHROPIC_CUSTOM_HEADERS": "x-grepture-api-key: grp_ihr-schlüssel"
  }
}

So funktioniert es

Wenn Claude Code einen Request sendet:

1. Der Request wird an https://proxy.grepture.com/claude/v1/messages gesendet
2. Grepture authentifiziert Sie über den x-grepture-api-key-Header
3. Ihre Erkennungsregeln werden angewendet (PII-Schwärzung, Secret-Scanning usw.)
4. Der Request wird an https://api.anthropic.com/v1/messages mit Ihrem Anthropic-API-Schlüssel weitergeleitet
5. Die Antwort fließt zurück durch Grepture, wird protokolliert und geschwärzte Tokens werden wiederhergestellt

Das /claude-Präfix wird vor der Weiterleitung entfernt, sodass Anthropic einen Standard-/v1/messages-Request erhält.

Überprüfen

Nach der Konfiguration starten Sie Claude Code wie gewohnt:

claude

Öffnen Sie dann Ihr Grepture-Dashboard. Sie sollten Claude-Code-Requests im Traffic-Log sehen mit:

• Modellname (z.B. claude-sonnet-4-20250514)
• Token-Zahlen (Input + Output)
• Kosten pro Request
• Vollständige Request/Response-Bodies (wenn Logging aktiviert ist)

Team-Einrichtung

Für Teams fügen Sie die Konfiguration in eine gemeinsame .claude/settings.json in Ihrem Repository ein. Jeder Entwickler nutzt seinen eigenen ANTHROPIC_API_KEY, aber ANTHROPIC_BASE_URL und x-grepture-api-key können teamweit geteilt werden.

So erhalten Sie eine zentrale Dashboard-Ansicht der gesamten Claude-Code-Nutzung Ihrer Organisation — nützlich für Ausgabenverfolgung, Prompt-Auditing und Durchsetzung von Datenschutzrichtlinien.

Erkennungsregeln

Alle Grepture-Erkennungsregeln gelten für Claude-Code-Traffic, einschließlich:

• PII-Erkennung — E-Mails, Telefonnummern, SSNs, Kreditkarten und 50+ Muster
• Secret-Scanning — API-Schlüssel, Tokens, Verbindungsstrings
• Eigene Regex-Regeln — Ihre eigenen Muster (Pro-Plan)
• KI-gestützte NER — Namen, Organisationen, Adressen (Pro-Plan)

Konfigurieren Sie Regeln im Grepture-Dashboard unter Rules. Sie gelten automatisch für allen Traffic, einschließlich Claude Code.

Fehlerbehebung

Claude Code gibt einen Authentifizierungsfehler zurück

Überprüfen Sie, ob Ihr ANTHROPIC_API_KEY gültig ist, indem Sie direkt gegen Anthropic testen:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'

Requests erscheinen nicht im Dashboard

Überprüfen Sie, ob Ihr x-grepture-api-key korrekt ist und ANTHROPIC_BASE_URL auf https://proxy.grepture.com/claude gesetzt ist (beachten Sie das /claude-Suffix).

Latenzerhöhung

Der Proxy fügt minimale Latenz hinzu (typischerweise unter 10ms). Bei höherer Latenz überprüfen Sie Ihre Netzwerkroute zum Proxy. Grepture wird in der EU gehostet — wenn Ihr Team außerhalb Europas ist, kontaktieren Sie uns bezüglich regionaler Deployment-Optionen.