Skip to main content
Claude Code ist Anthropics CLI-Tool für agentisches Coden. Diese Anleitung zeigt dir, wie du es über Venice betreibst — für anonymisierten, nutzungsbasierten Zugriff auf Claude-Modelle pro Token.

Pay Per Token

Kein Abo. Zahle nur, was du nutzt

Claude-Modelle

Zugriff auf aktuelle Opus-, Sonnet- und Fable-Modelle über Venice

Prompt Caching

Venice-Caching funktioniert zusammen mit Claude Code

​
Warum du einen Router brauchst

Claude Code verbindet sich standardmäßig direkt mit Anthropics API. Um es mit Venice zu verwenden, brauchst du claude-code-router, einen quelloffenen lokalen Proxy, der:

abfängt

fängt ausgehende Requests von Claude Code ab, bevor sie Anthropic erreichen

transformiert

wandelt Anthropic-Messages-Requests in Venices OpenAI-kompatibles Chat-Format um

umleitet

leitet die Requests an api.venice.ai/api/v1/chat/completions weiter

​
Voraussetzungen

Venice-Konto

Mit Venice-Credits

Node.js

v22 oder höher

Claude Code

Per npm installiert

​
Einrichtung

1

Claude Code installieren oder aktualisieren

Installiere die aktuelle Claude Code CLI:
2

Claude Code Router installieren

3

API-Schlüssel erstellen

Erstelle einen Schlüssel unter venice.ai/settings/api. Du fügst ihn im nächsten Schritt in CCR ein.
4

Venice als Provider hinzufügen

Starte die Verwaltungsoberfläche von CCR:
Wähle auf der Seite Providers die Option Add provider und dann Other / custom API endpoint. Gib Folgendes ein:
  • Name: Venice
  • API-Endpunkt: https://api.venice.ai/api/v1
  • API-Schlüssel: dein Venice-API-Schlüssel
CCR sollte OpenAI Chat automatisch erkennen. Falls nicht, öffne die Advanced settings, deaktiviere die automatische Protokollerkennung und wähle OpenAI Chat.Füge über Search models oder Custom models die gewünschten Claude-Modelle hinzu, führe dann Check Connection aus und speichere den Provider. Der Verbindungscheck sendet einen echten Request mit einem Output-Limit von einem Token.
5

Claude-Code-Profil erstellen

Wähle in Agent Config die Option Add profile und dann Claude Code:
  • Nenne das Profil Claude Code - Venice.
  • Lass Effect scope während des Testens auf Only opened from CCR gesetzt.
  • Wähle CLI only oder CLI & APP.
  • Setze Model auf ein Venice-Modell wie Venice/claude-opus-4-8.
  • Um jede Claude-Code-Stufe auf Venice zu halten, setze auch die optionalen Modellfelder für Fable, Opus, Sonnet und Haiku auf Venice-Modelle.
Speichere das Profil.
6

Starten und verifizieren

Starte das Profil über seinen Namen:
In Claude Code:
  1. Führe /context aus und bestätige, dass das Kontextfenster zum ausgewählten Modell passt. Für claude-opus-4-8 sollte 1M angezeigt werden.
  2. Führe /model aus, wenn du zu einem anderen Venice-Modell wechseln möchtest; 1M-Varianten sind mit 1M context markiert.
  3. Sende eine Testnachricht und prüfe dann die Request logs in CCR, um zu bestätigen, dass Venice verwendet wurde.

​
Unterstützte Modelle

Der Katalog ändert sich im Laufe der Zeit. Verwende Search models in CCR oder GET /models?type=text für die aktuelle Liste und die Limits.
Claude Code ist für Claude-Modelle optimiert. Andere über Venice verfügbare Modelle (GPT, DeepSeek, Grok usw.) funktionieren möglicherweise, aber wir können keine gleichwertige Erfahrung garantieren, da Claude Code auf Claude-spezifische Funktionen wie Extended Thinking setzt. Für andere Modelle erwäge die Nutzung der Standard-API von Venice.

​
Bestehende Installation aktualisieren

Aktualisiere CCR, bevor du eine bestehende Installation debuggst:
Aktuelle CCR-Releases speichern die Live-Konfiguration in ~/.claude-code-router/config.sqlite. Eine ältere config.json wird importiert, wenn die Datenbank noch nicht existiert. Nimm Änderungen nach der Migration über ccr ui vor, statt weiterhin die config.json zu bearbeiten. Wenn nach einem Update noch ein Hintergrundprozess läuft, starte ihn neu:

​
Prompt Caching

Venice Prompt Caching funktioniert zusammen mit Claude Codes nativen Cache-Markern. Für die normale Einrichtung ist kein zusätzlicher Cache-Transformer erforderlich.

​
Fehlerbehebung

  1. Aktualisiere CCR mit npm install -g @musistudio/claude-code-router@latest.
  2. Starte eine neue Claude-Code-Session aus dem CCR-Profil.
  3. Führe /model aus und wähle den Venice-Eintrag mit der Markierung 1M context.
  4. Führe /context aus und bestätige, dass das Fenster 1M ist, nicht 200K.
Ältere CCR-Releases geben das korrekte Kontextfenster oder die Token-Nutzung möglicherweise nicht an Claude Code weiter.
Bestätige Node.js 22 oder neuer und aktualisiere CCR:
Verwende ccr serve, um im Vordergrund zu laufen und den ursprünglichen Startfehler sichtbar zu machen. Ein Cannot read properties of undefined (reading 'error')-Stacktrace aus server.logger.error deutet auf eine veraltete CCR-Installation hin; aktualisiere sie, bevor du weiter untersuchst.
Starte das Gateway und prüfe seinen Zustand:
Ein fehlgeschlagener Health-Check bedeutet, dass das lokale CCR-Gateway nicht verfügbar ist; der Request hat Venice nicht erreicht.
Öffne ccr ui und nimm die Änderung dort vor. Aktuelle CCR-Releases speichern die Konfiguration in config.sqlite; config.json dient nur als Migrationsquelle für ältere Installationen.

​
Ressourcen

Venice API Docs

Vollständige API-Referenz

claude-code-router

Quellcode und Issues

CCR Releases

Aktuelle Versionen und Release Notes