> ## 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

> Routez les requêtes du CLI Claude Code via Venice avec claude-code-router : accès en paiement par token aux modèles de code Claude Opus, Sonnet et Fable.

[Claude Code](https://code.claude.com/docs) est l'outil CLI d'Anthropic pour le codage agentique. Ce guide vous montre comment l'exécuter via Venice pour un accès anonymisé et à l'usage aux modèles Claude.

<CardGroup cols={3}>
  <Card title="Paiement à l'usage" icon="coins">
    Pas d'abonnement. Payez uniquement ce que vous utilisez
  </Card>

  <Card title="Modèles Claude" icon="cpu">
    Accédez aux modèles Opus, Sonnet et Fable actuels via Venice
  </Card>

  <Card title="Mise en cache des prompts" icon="bolt">
    Le cache Venice fonctionne en complément de Claude Code
  </Card>
</CardGroup>

## Pourquoi un routeur est nécessaire

Claude Code se connecte directement à l'API d'Anthropic par défaut. Pour l'utiliser avec Venice, vous avez besoin de [claude-code-router](https://github.com/musistudio/claude-code-router), un proxy local open source qui :

<Steps>
  <Step title="Intercepte" icon="hand-stop">
    Capture les requêtes sortantes de Claude Code avant qu'elles n'atteignent Anthropic
  </Step>

  <Step title="Transforme" icon="refresh">
    Convertit les requêtes Anthropic Messages au format de chat compatible OpenAI de Venice
  </Step>

  <Step title="Redirige" icon="route">
    Achemine les requêtes vers `api.venice.ai/api/v1/chat/completions`
  </Step>
</Steps>

***

## Prérequis

<CardGroup cols={3}>
  <Card title="Compte Venice" icon="user" href="https://venice.ai/settings/api?utm_source=venice-api-documentation">
    Avec des crédits Venice
  </Card>

  <Card title="Node.js" icon="brand-nodejs" href="https://nodejs.org/">
    v22 ou supérieur
  </Card>

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

***

## Configuration

<Steps>
  <Step title="Installez ou mettez à jour Claude Code">
    Installez la dernière version de la CLI Claude Code :

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

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

  <Step title="Obtenez votre clé API">
    Générez une clé depuis [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation). Vous l'ajouterez à CCR à l'étape suivante.
  </Step>

  <Step title="Ajoutez Venice comme fournisseur">
    Démarrez l'interface de gestion de CCR :

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

    Sur la page **Providers**, choisissez **Add provider** puis **Other / custom API endpoint**. Saisissez :

    * **Nom :** `Venice`
    * **Endpoint API :** `https://api.venice.ai/api/v1`
    * **Clé API :** votre clé API Venice

    CCR devrait détecter **OpenAI Chat** automatiquement. Si ce n'est pas le cas, ouvrez **Advanced settings**, désactivez la détection automatique du protocole et sélectionnez **OpenAI Chat**.

    Utilisez **Search models** ou **Custom models** pour ajouter les modèles Claude souhaités, puis lancez **Check Connection** et enregistrez le fournisseur. La vérification de connexion envoie une requête réelle avec une limite de sortie d'un token.
  </Step>

  <Step title="Créez un profil Claude Code">
    Dans **Agent Config**, choisissez **Add profile** puis **Claude Code** :

    * Nommez le profil `Claude Code - Venice`.
    * Laissez **Effect scope** défini sur **Only opened from CCR** pendant les tests.
    * Choisissez **CLI only** ou **CLI & APP**.
    * Définissez **Model** sur un modèle Venice tel que `Venice/claude-opus-4-8`.
    * Pour conserver chaque niveau de Claude Code sur Venice, définissez également les champs de modèle optionnels Fable, Opus, Sonnet et Haiku sur des modèles Venice.

    Enregistrez le profil.
  </Step>

  <Step title="Lancez et vérifiez">
    Lancez le profil par son nom :

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

    Dans Claude Code :

    1. Exécutez `/context` et confirmez que la fenêtre de contexte correspond au modèle sélectionné. Pour `claude-opus-4-8`, elle devrait afficher `1M`.
    2. Exécutez `/model` si vous souhaitez passer à un autre modèle Venice ; les variantes 1M sont marquées **1M context**.
    3. Envoyez un message de test, puis vérifiez les **Request logs** dans CCR pour confirmer qu'il a utilisé Venice.
  </Step>
</Steps>

***

## Modèles pris en charge

| Modèle               | ID Venice              | Contexte |
| -------------------- | ---------------------- | -------- |
| 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     |

Le catalogue évolue au fil du temps. Utilisez **Search models** dans CCR ou [`GET /models?type=text`](/api-reference/endpoint/models/list) pour la liste et les limites actuelles.

<Info>
  Claude Code est optimisé pour les modèles Claude. Bien que d'autres modèles disponibles via Venice (GPT, DeepSeek, Grok, etc.) puissent fonctionner, nous ne pouvons pas garantir une expérience équivalente, car Claude Code s'appuie sur des fonctionnalités spécifiques à Claude comme la réflexion étendue. Pour les autres modèles, envisagez d'utiliser l'[API standard](/api-reference/endpoint/chat/completions) de Venice.
</Info>

***

## Mise à jour d'une installation existante

Mettez à jour CCR avant de dépanner une installation existante :

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

Les versions actuelles de CCR stockent la configuration active dans `~/.claude-code-router/config.sqlite`. Un ancien `config.json` est importé lorsque la base de données n'existe pas. Après la migration, effectuez les modifications via `ccr ui` au lieu de continuer à éditer `config.json`.

Si un processus d'arrière-plan tourne encore après une mise à jour, redémarrez-le :

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

***

## Mise en cache des prompts

Le [prompt caching](/guides/features/prompt-caching) de Venice fonctionne avec les marqueurs de cache natifs de Claude Code. Aucun transformeur de cache supplémentaire n'est nécessaire pour la configuration normale.

***

## Dépannage

<AccordionGroup>
  <Accordion title="Le contexte atteint 100 % prématurément ou la compaction échoue">
    1. Mettez à jour CCR avec `npm install -g @musistudio/claude-code-router@latest`.
    2. Lancez une nouvelle session Claude Code depuis le profil CCR.
    3. Exécutez `/model` et sélectionnez l'entrée Venice marquée **1M context**.
    4. Exécutez `/context` et confirmez que la fenêtre est de `1M`, et non de `200K`.

    Les anciennes versions de CCR peuvent ne pas exposer correctement la fenêtre de contexte ou la consommation de tokens à Claude Code.
  </Accordion>

  <Accordion title="CCR plante au démarrage">
    Confirmez Node.js 22 ou plus récent et mettez à jour CCR :

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

    Utilisez `ccr serve` pour l'exécuter au premier plan et exposer l'erreur de démarrage d'origine. Une pile `Cannot read properties of undefined (reading 'error')` provenant de `server.logger.error` indique une installation CCR obsolète ; mettez-la à jour avant d'investiguer davantage.
  </Accordion>

  <Accordion title="Claude Code signale ConnectionRefused">
    Démarrez la passerelle et vérifiez son état de santé :

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

    Un échec de la vérification de santé signifie que la passerelle locale CCR est indisponible ; la requête n'a pas atteint Venice.
  </Accordion>

  <Accordion title="Les modifications de configuration sont ignorées">
    Ouvrez `ccr ui` et effectuez la modification à cet endroit. Les versions actuelles de CCR stockent la configuration dans `config.sqlite` ; `config.json` n'est qu'une source de migration pour les anciennes installations.
  </Accordion>
</AccordionGroup>

***

## Ressources

<CardGroup cols={3}>
  <Card title="Docs de l'API Venice" icon="book" href="/api-reference/api-spec">
    Référence complète de l'API
  </Card>

  <Card title="claude-code-router" icon="brand-github" href="https://github.com/musistudio/claude-code-router">
    Code source et issues
  </Card>

  <Card title="Versions de CCR" icon="history" href="https://github.com/musistudio/claude-code-router/releases">
    Versions actuelles et notes de version
  </Card>
</CardGroup>