Utiliser Raven Max dans Claude Code et d'autres outils de codage

Le 12 novembre 2026, l'API DipoleML a commencé à répondre dans un deuxième format de SDK. À côté des complétions de clavardage au format OpenAI, POST /v1/messages répond maintenant au format du SDK Anthropic, avec les mêmes clés, les mêmes crédits et les mêmes prix. Tout outil de codage qui vous laisse ajouter un fournisseur de modèles de l'un ou l'autre format peut utiliser Raven Flash et Raven Max. Ce guide configure d'abord Claude Code, qu'Anthropic décrit comme un outil de codage agentique qui lit votre base de code, modifie les fichiers, exécute des commandes et s'intègre à vos outils de développement, puis les outils au format OpenAI.

Qu'est-ce qui a changé le 12 novembre?

• Un deuxième format. Raven Flash et Raven Max répondent à POST https://api.dipoleml.com/v1/messages au format du SDK Anthropic, comme ils répondent aux complétions de clavardage au format OpenAI depuis le jour du lancement.
• Le même compte. Les clés, les crédits, les prix et les limites sont les mêmes dans les deux formats.
• L'un ou l'autre en-tête. Au format du SDK Anthropic, la clé va dans x-api-key ou en Authorization: Bearer.
• Les outils de codage. Un outil de l'un ou l'autre format utilise Raven avec une URL de base, une clé et les noms des modèles.

De quoi un outil de codage a-t-il besoin?

De trois choses : une URL de base, une clé d'API et les noms des modèles. L'URL de base et l'en-tête de la clé suivent le format que parle votre outil :

• Le format du SDK OpenAI, souvent dit « compatible OpenAI » : l'URL de base https://api.dipoleml.com/v1, et la clé en Authorization: Bearer.
• Le format du SDK Anthropic, celui que parle Claude Code : l'URL de base https://api.dipoleml.com, et la clé dans x-api-key ou en Authorization: Bearer.

Ajoutez ensuite les modèles par leur nom : Raven Max pour le raisonnement difficile et les grands changements, Raven Flash pour le travail rapide et fréquent. Chaque nom contient une espace, et la casse ne compte pas; si un format de configuration n'accepte pas d'espace, mettez le nom entre guillemets. Un outil qui présente les modèles d'un fournisseur trouve les nôtres à GET /v1/models.

Attention au /v1. Les clients du SDK OpenAI veulent l'adresse avec, et les clients du SDK Anthropic la veulent sans, parce qu'ils ajoutent eux-mêmes /v1/messages. Un /v1 en double ou manquant donne une erreur 404.

Comment configurer Claude Code avec Raven Max?

1. Créez une clé d'API dans votre tableau de bord et ajoutez des crédits.
2. Mettez la clé dans une variable d'environnement, comme RAVEN_API_KEY, plutôt que dans un fichier de configuration qui pourrait se retrouver dans votre dépôt.
3. Vérifiez que la clé fonctionne. La réponse présente Raven Flash et Raven Max; une erreur 401 signifie que la clé est erronée.

curl https://api.dipoleml.com/v1/models \
  -H "Authorization: Bearer $RAVEN_API_KEY"

Claude Code parle le format du SDK Anthropic. Réglez ces quatre variables dans le profil du shell où vous le lancez :

export ANTHROPIC_BASE_URL="https://api.dipoleml.com"
export ANTHROPIC_AUTH_TOKEN="$RAVEN_API_KEY"
export ANTHROPIC_MODEL="Raven Max"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="Raven Flash"

La référence des variables d'environnement d'Anthropic décrit ANTHROPIC_BASE_URL comme le moyen de remplacer le point de terminaison de l'API, et ANTHROPIC_AUTH_TOKEN comme une valeur personnalisée pour l'en-tête Authorization, précédée de Bearer. ANTHROPIC_MODEL nomme le modèle à utiliser. ANTHROPIC_DEFAULT_HAIKU_MODEL est le modèle vers lequel pointe l'alias haiku, qui sert aussi, selon cette référence, aux fonctions d'arrière-plan; ces réglages confient cette part à Raven Flash.

ANTHROPIC_API_KEY, qui envoie la clé dans x-api-key, fonctionne aussi. Relancez Claude Code après avoir changé les réglages, et choisissez le modèle avec /model. Ses requêtes sont acceptées telles qu'elles arrivent, y compris les messages système qu'il place dans la conversation.

À quoi ressemble un appel à /v1/messages?

Votre propre code peut aussi utiliser ce format. Voici un appel avec curl, tel que l'écrit la documentation du format Messages :

curl https://api.dipoleml.com/v1/messages \
  -H "x-api-key: $RAVEN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Raven Max",
    "max_tokens": 1024,
    "system": "Vous êtes un réviseur technique concis.",
    "messages": [{"role": "user", "content": "Resserrez ce paragraphe ..."}]
  }'

La réponse a la forme du SDK Anthropic : une liste content de blocs, un stop_reason et un objet usage. L'entrée en cache est comptée dans cache_read_input_tokens et facturée au prix en cache, et la mise en cache ne demande aucun réglage. Avec le SDK Anthropic pour Python, réglez base_url sur https://api.dipoleml.com, sans /v1 : le SDK ajoute le chemin lui-même.

Comment se connectent les outils au format OpenAI?

Dans un éditeur ou un agent qui offre un fournisseur « compatible OpenAI », choisissez-le et remplissez trois champs :

• L'URL de base, parfois appelée « API base » ou « override base URL » : https://api.dipoleml.com/v1.
• La clé d'API : votre clé, ou le nom de la variable d'environnement qui la contient, si l'outil en lit une.
• Le modèle : Raven Max et Raven Flash, ajoutés à la main si l'outil ne les présente pas.

Votre propre code fonctionne de la même façon avec les SDK OpenAI officiels. Ce qu'il faut chercher dans une API de ce format, et comment la nôtre répond à chaque point, se trouve dans notre guide des API compatibles avec OpenAI.

Qu'est-ce qu'un outil de codage peut utiliser?

• Les appels de clavardage, la diffusion en continu, les images, l'appel d'outils et le raisonnement, dans les deux formats.
• Seulement les propres fonctions de l'outil comme outils. Au format Messages, un outil qui s'exécute sur le serveur, comme la recherche sur le Web, est refusé avec 400.
• Pas le format Responses : POST /v1/responses répond 404, si bien qu'un outil qui ne parle que ce format ne peut pas utiliser l'API pour l'instant.

Quand un outil ne se connecte pas, l'erreur dit pourquoi. Une erreur 401 avec missing_api_key signifie qu'aucune clé n'est arrivée, ou qu'elle est venue dans un en-tête que son format n'utilise pas. Une erreur 404 avec model_not_found signifie que le nom du modèle est écrit autrement que Raven Max ou Raven Flash, avec l'espace, et une erreur 404 dont le code est 404 signifie que l'URL de base ne convient pas au format. Une erreur 402 signifie que le solde est vide ou que la clé a atteint son plafond.

Combien cela coûte-t-il?

Les requêtes d'un outil sont payées avec vos crédits d'API comme tout autre appel, aux mêmes prix dans les deux formats. Chaque prix est donné par million de jetons, en dollars US :

Les crédits se vendent en paquets à partir de 5 $ US, et ils n'expirent jamais. Chaque clé peut avoir un plafond de dépenses et une expiration, ce qui convient bien à une clé que vous confiez à un outil : notre guide des clés montre comment régler les deux.

Pourquoi utiliser Raven Max dans un agent de codage?

Parce que les agents travaillent dans le terminal, et que c'est là que Raven Max s'est classé premier. Selon nos résultats publiés, déclarés par l'entreprise et obtenus avec l'effort de raisonnement maximal, Raven Max s'est classé premier parmi les modèles comparés sur Terminal Bench 4.0, qui mesure l'ingénierie logicielle autonome dans un vrai terminal, à 42,8, 0,4 devant Fable 5.

L'écart est mince, et Raven Max n'arrive pas en tête de chaque test. Sur DeepSWE v1.1, GPT-5.6 Sol s'est classé premier à 70,2 et Raven Max quatrième, à 68,7. Pour les tours rapides et fréquents d'un agent, Raven Flash s'est classé premier parmi les modèles rapides auxquels il est comparé sur Terminal Bench 4.0, à 34,1. Tous les résultats sont dans notre rapport sur Raven Max.

Par où continuer?

Si vous choisissez encore l'agent lui-même, notre guide des solutions de rechange à Claude Code compare les agents de terminal. DCode, notre propre agent, fonctionne avec les modèles Raven sur votre plan ou vos crédits, et notre article sur DCode 2.5 présente sa dernière version. Tout ce que fait l'API est sur la page pour les développeurs, et les prix sont sur la page des tarifs.

Les noms de produits sont des marques de commerce de leurs propriétaires et ne servent ici qu'à identifier les produits.