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

# Claude Code

> Utilisez la CLI Claude Code avec les modèles Claude de Venice AI

[Claude Code](https://docs.anthropic.com/en/docs/claude-code) est l'outil CLI d'Anthropic pour le codage agentique. Ce guide vous montre comment l'exécuter via Venice AI pour un accès à l'usage à Claude Opus 4.5/4.6 et Sonnet 4.5/4.6.

<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="microchip">
    Accédez à Opus 4.5/4.6 et Sonnet 4.5/4.6 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">
    Capture les requêtes sortantes de Claude Code avant qu'elles n'atteignent Anthropic
  </Step>

  <Step title="Transforme" icon="arrows-rotate">
    Convertit le format des requêtes et mappe les identifiants de modèles (par ex. `claude-opus-4-5`)
  </Step>

  <Step title="Redirige" icon="route">
    Achemine les requêtes vers Venice à `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">
    Avec des crédits API
  </Card>

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

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

***

## Configuration

<Steps>
  <Step title="Installez Claude Code">
    Si ce n'est pas déjà fait, installez la CLI Claude Code d'Anthropic :

    ```bash theme={"dark"}
    npm install -g @anthropic-ai/claude-code
    ```
  </Step>

  <Step title="Installez le routeur">
    ```bash theme={"dark"}
    npm install -g @musistudio/claude-code-router
    ```
  </Step>

  <Step title="Obtenez votre clé API">
    Générez une clé depuis [venice.ai/settings/api](https://venice.ai/settings/api). Vous la collerez directement dans le fichier de configuration à l'étape suivante.
  </Step>

  <Step title="Créez la configuration">
    Créez le répertoire de configuration :

    ```bash theme={"dark"}
    mkdir -p ~/.claude-code-router
    ```

    Puis créez `~/.claude-code-router/config.json` avec votre éditeur préféré :

    ```bash theme={"dark"}
    # Avec nano
    nano ~/.claude-code-router/config.json

    # Ou avec VS Code
    code ~/.claude-code-router/config.json
    ```

    Collez la configuration suivante :

    ```json theme={"dark"}
    {
      "APIKEY": "",
      "LOG": true,
      "LOG_LEVEL": "info",
      "API_TIMEOUT_MS": 600000,
      "HOST": "127.0.0.1",
      "Providers": [
        {
          "name": "venice",
          "api_base_url": "https://api.venice.ai/api/v1/chat/completions",
          "api_key": "your-venice-api-key-here",
          "models": [
            "claude-opus-4-5",
            "claude-sonnet-4-5",
            "claude-opus-4-6",
            "claude-opus-4-6-fast",
            "claude-sonnet-4-6"
          ],
          "transformer": {
            "use": ["anthropic"]
          }
        }
      ],
      "Router": {
        "default": "venice,claude-opus-4-5",
        "think": "venice,claude-opus-4-5",
        "background": "venice,claude-opus-4-5",
        "longContext": "venice,claude-opus-4-5",
        "longContextThreshold": 100000
      }
    }
    ```

    <Note>
      Si vous modifiez `config.json` pendant que le routeur tourne, redémarrez-le avec `ccr restart` pour appliquer les changements.
    </Note>
  </Step>

  <Step title="Lancement">
    Démarrez le routeur, puis Claude Code :

    ```bash theme={"dark"}
    ccr start
    ccr code
    ```

    Ou utilisez la méthode d'activation :

    ```bash theme={"dark"}
    eval "$(ccr activate)" && claude
    ```
  </Step>
</Steps>

***

## Modèles pris en charge

| Modèle               | ID Venice              | Idéal pour                                          |
| -------------------- | ---------------------- | --------------------------------------------------- |
| Claude Opus 4.5      | `claude-opus-4-5`      | Raisonnement complexe, refactorisations importantes |
| Claude Sonnet 4.5    | `claude-sonnet-4-5`    | Itérations rapides, codage quotidien                |
| Claude Opus 4.6      | `claude-opus-4-6`      | Raisonnement complexe, refactorisations importantes |
| Claude Opus 4.6 Fast | `claude-opus-4-6-fast` | Raisonnement complexe avec latence réduite          |
| Claude Sonnet 4.6    | `claude-sonnet-4-6`    | Itérations rapides, codage quotidien                |

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

***

## Fonctionnalités du routeur

Le routeur offre plusieurs fonctionnalités utiles au-delà du routage de base :

<AccordionGroup>
  <Accordion title="Changez de modèle à la volée">
    Utilisez la commande `/model` dans Claude Code pour changer de modèle sans redémarrer :

    ```
    /model venice,claude-sonnet-4-5
    ```

    Pratique lorsque vous voulez Opus pour les tâches complexes et Sonnet pour les itérations rapides.
  </Accordion>

  <Accordion title="Configuration visuelle avec le mode UI">
    Vous préférez une interface graphique ? Lancez l'éditeur de configuration web :

    ```bash theme={"dark"}
    ccr ui
    ```

    Cela ouvre une interface dans le navigateur pour modifier votre `config.json` sans toucher au fichier directement.
  </Accordion>

  <Accordion title="Explication des scénarios du routeur">
    La section `Router` de la configuration contrôle quel modèle gère chaque type de tâche :

    | Scénario      | Quand est-il utilisé                                    |
    | ------------- | ------------------------------------------------------- |
    | `default`     | Requêtes générales                                      |
    | `think`       | Tâches de raisonnement intensif (Plan Mode)             |
    | `background`  | Opérations d'arrière-plan                               |
    | `longContext` | Quand le contexte dépasse `longContextThreshold` tokens |

    Vous pouvez router différents scénarios vers différents modèles. Par exemple, utilisez Sonnet pour les tâches d'arrière-plan afin de réduire les coûts.
  </Accordion>

  <Accordion title="Débogage avec les logs">
    Si quelque chose ne fonctionne pas, consultez les logs :

    ```bash theme={"dark"}
    # Logs du serveur (HTTP, appels d'API)
    ~/.claude-code-router/logs/ccr-*.log

    # Logs applicatifs (décisions de routage)
    ~/.claude-code-router/claude-code-router.log
    ```

    Définissez `"LOG_LEVEL": "debug"` dans votre configuration pour des sorties plus verbeuses.
  </Accordion>
</AccordionGroup>

***

## Comportement de la mise en cache

Le [prompt caching](/guides/features/prompt-caching) de Venice fonctionne en parallèle des marqueurs de cache natifs de Claude Code. Venice détecte automatiquement lorsque Claude Code envoie des champs `cache_control` et ajuste sa stratégie de cache en conséquence.

| Scénario                          | TTL du cache | Qui contrôle         |
| --------------------------------- | ------------ | -------------------- |
| Par défaut (recommandé)           | 5 minutes    | Claude Code + Venice |
| Avec le transformeur `cleancache` | 1 heure      | Venice uniquement    |

<AccordionGroup>
  <Accordion title="Quand NE PAS utiliser cleancache (la plupart des utilisateurs)">
    La configuration par défaut permet aux deux systèmes de coopérer :

    * Claude Code envoie ses marqueurs `cache_control` natifs
    * Venice ajoute un cache autour avec un TTL de 5 minutes
    * Les deux systèmes partagent la limite de 4 blocs de cache

    Cela fonctionne bien pour les sessions de codage actives où vous faites des requêtes fréquentes.
  </Accordion>

  <Accordion title="Quand utiliser cleancache">
    Ajoutez `cleancache` au transformeur si vous :

    * Atteignez des erreurs de limite de 4 blocs de cache
    * Constatez un comportement étrange de mise en cache
    * Préférez le TTL d'1 heure de Venice pour les sessions plus longues

    ```json theme={"dark"}
    "transformer": {
      "use": ["anthropic", "cleancache"]
    }
    ```

    Cela retire les marqueurs de cache de Claude Code, donnant à Venice un contrôle complet avec un TTL plus long.
  </Accordion>
</AccordionGroup>

***

## Ressources

<CardGroup cols={2}>
  <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="github" href="https://github.com/musistudio/claude-code-router">
    Code source et issues
  </Card>
</CardGroup>