> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-de47a659.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Leite Claude Code CLI-Anfragen mit claude-code-router über Venice und zahle pro Token für die Coding-Modelle Claude Opus, Sonnet und Fable.

[Claude Code](https://code.claude.com/docs) 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.

<CardGroup cols={3}>
  <Card title="Pay Per Token" icon="coins">
    Kein Abo. Zahle nur, was du nutzt
  </Card>

  <Card title="Claude-Modelle" icon="cpu">
    Zugriff auf aktuelle Opus-, Sonnet- und Fable-Modelle über Venice
  </Card>

  <Card title="Prompt Caching" icon="bolt">
    Venice-Caching funktioniert zusammen mit Claude Code
  </Card>
</CardGroup>

## 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](https://github.com/musistudio/claude-code-router), einen quelloffenen lokalen Proxy, der:

<Steps>
  <Step title="abfängt" icon="hand-stop">
    fängt ausgehende Requests von Claude Code ab, bevor sie Anthropic erreichen
  </Step>

  <Step title="transformiert" icon="refresh">
    wandelt Anthropic-Messages-Requests in Venices OpenAI-kompatibles Chat-Format um
  </Step>

  <Step title="umleitet" icon="route">
    leitet die Requests an `api.venice.ai/api/v1/chat/completions` weiter
  </Step>
</Steps>

***

## Voraussetzungen

<CardGroup cols={3}>
  <Card title="Venice-Konto" icon="user" href="https://venice.ai/settings/api?utm_source=venice-api-documentation">
    Mit Venice-Credits
  </Card>

  <Card title="Node.js" icon="brand-nodejs" href="https://nodejs.org/">
    v22 oder höher
  </Card>

  <Card title="Claude Code" icon="terminal" href="https://code.claude.com/docs">
    Per npm installiert
  </Card>
</CardGroup>

***

## Einrichtung

<Steps>
  <Step title="Claude Code installieren oder aktualisieren">
    Installiere die aktuelle Claude Code CLI:

    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code@latest
    claude --version
    ```
  </Step>

  <Step title="Claude Code Router installieren">
    ```bash theme={null}
    npm install -g @musistudio/claude-code-router@latest
    npm list -g @musistudio/claude-code-router --depth=0
    ```
  </Step>

  <Step title="API-Schlüssel erstellen">
    Erstelle einen Schlüssel unter [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation). Du fügst ihn im nächsten Schritt in CCR ein.
  </Step>

  <Step title="Venice als Provider hinzufügen">
    Starte die Verwaltungsoberfläche von CCR:

    ```bash theme={null}
    ccr ui
    ```

    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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Starten und verifizieren">
    Starte das Profil über seinen Namen:

    ```bash theme={null}
    ccr "Claude Code - Venice"
    ```

    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.
  </Step>
</Steps>

***

## Unterstützte Modelle

| Modell               | Venice-ID              | Kontext |
| -------------------- | ---------------------- | ------- |
| Claude Fable 5.1     | `claude-fable-5-1`     | 1M      |
| Claude Fable 5       | `claude-fable-5`       | 1M      |
| Claude Opus 5        | `claude-opus-5`        | 1M      |
| Claude Opus 5 Fast   | `claude-opus-5-fast`   | 1M      |
| Claude Opus 4.8      | `claude-opus-4-8`      | 1M      |
| Claude Opus 4.8 Fast | `claude-opus-4-8-fast` | 1M      |
| Claude Opus 4.7      | `claude-opus-4-7`      | 1M      |
| Claude Opus 4.6      | `claude-opus-4-6`      | 1M      |
| Claude Opus 4.5      | `claude-opus-4-5`      | 198K    |
| Claude Sonnet 5      | `claude-sonnet-5`      | 1M      |
| Claude Sonnet 4.6    | `claude-sonnet-4-6`    | 1M      |
| Claude Sonnet 4.5    | `claude-sonnet-4-5`    | 198K    |

Der Katalog ändert sich im Laufe der Zeit. Verwende **Search models** in CCR oder [`GET /models?type=text`](/api-reference/endpoint/models/list) für die aktuelle Liste und die Limits.

<Info>
  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](/api-reference/endpoint/chat/completions) von Venice.
</Info>

***

## Bestehende Installation aktualisieren

Aktualisiere CCR, bevor du eine bestehende Installation debuggst:

```bash theme={null}
npm install -g @musistudio/claude-code-router@latest
npm list -g @musistudio/claude-code-router --depth=0
ccr ui
```

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:

```bash theme={null}
ccr stop
ccr start
```

***

## Prompt Caching

Venice [Prompt Caching](/guides/features/prompt-caching) funktioniert zusammen mit Claude Codes nativen Cache-Markern. Für die normale Einrichtung ist kein zusätzlicher Cache-Transformer erforderlich.

***

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Kontext erreicht früh 100 % oder die Kompaktierung schlägt fehl">
    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.
  </Accordion>

  <Accordion title="CCR stürzt beim Start ab">
    Bestätige Node.js 22 oder neuer und aktualisiere CCR:

    ```bash theme={null}
    node --version
    npm list -g @musistudio/claude-code-router --depth=0
    ```

    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.
  </Accordion>

  <Accordion title="Claude Code meldet ConnectionRefused">
    Starte das Gateway und prüfe seinen Zustand:

    ```bash theme={null}
    ccr start
    curl http://127.0.0.1:3456/health
    ```

    Ein fehlgeschlagener Health-Check bedeutet, dass das lokale CCR-Gateway nicht verfügbar ist; der Request hat Venice nicht erreicht.
  </Accordion>

  <Accordion title="Konfigurationsänderungen werden ignoriert">
    Ö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.
  </Accordion>
</AccordionGroup>

***

## Ressourcen

<CardGroup cols={3}>
  <Card title="Venice API Docs" icon="book" href="/api-reference/api-spec">
    Vollständige API-Referenz
  </Card>

  <Card title="claude-code-router" icon="brand-github" href="https://github.com/musistudio/claude-code-router">
    Quellcode und Issues
  </Card>

  <Card title="CCR Releases" icon="history" href="https://github.com/musistudio/claude-code-router/releases">
    Aktuelle Versionen und Release Notes
  </Card>
</CardGroup>