Skip to main content
Claude Code 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.

Paiement à l'usage

Pas d’abonnement. Payez uniquement ce que vous utilisez

Modèles Claude

Accédez aux modèles Opus, Sonnet et Fable actuels via Venice

Mise en cache des prompts

Le cache Venice fonctionne en complément de Claude Code

​
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, un proxy local open source qui :

Intercepte

Capture les requêtes sortantes de Claude Code avant qu’elles n’atteignent Anthropic

Transforme

Convertit les requêtes Anthropic Messages au format de chat compatible OpenAI de Venice

Redirige

Achemine les requêtes vers api.venice.ai/api/v1/chat/completions

​
Prérequis

Compte Venice

Avec des crédits Venice

Node.js

v22 ou supérieur

Claude Code

Installé via npm

​
Configuration

1

Installez ou mettez à jour Claude Code

Installez la dernière version de la CLI Claude Code :
2

Installez Claude Code Router

3

Obtenez votre clé API

Générez une clé depuis venice.ai/settings/api. Vous l’ajouterez à CCR à l’étape suivante.
4

Ajoutez Venice comme fournisseur

Démarrez l’interface de gestion de CCR :
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.
5

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

Lancez et vérifiez

Lancez le profil par son nom :
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.

​
Modèles pris en charge

Le catalogue évolue au fil du temps. Utilisez Search models dans CCR ou GET /models?type=text pour la liste et les limites actuelles.
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 de Venice.

​
Mise à jour d’une installation existante

Mettez à jour CCR avant de dépanner une installation existante :
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 :

​
Mise en cache des prompts

Le 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

  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.
Confirmez Node.js 22 ou plus récent et mettez à jour CCR :
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.
Démarrez la passerelle et vérifiez son état de santé :
Un échec de la vérification de santé signifie que la passerelle locale CCR est indisponible ; la requête n’a pas atteint Venice.
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.

​
Ressources

Docs de l'API Venice

Référence complète de l’API

claude-code-router

Code source et issues

Versions de CCR

Versions actuelles et notes de version