Agent en ligne de commande

Brancher Claude Code sur un modèle non-Anthropic : ce que vous perdez

Après le changement de modèle, Claude Code fonctionne — mais toutes les fonctionnalités ne survivent pas. Ce tutoriel répartit les capacités en trois couches (client, protocole, modèle), puis détaille point par point ce qui casse, ce qui tient, et si la perte est récupérable.

Vérifié le 2026-10-26S'applique à
Claude Code 2.x

La réponse courte

Les fonctionnalités de Claude Code se répartissent en trois couches, et seule celle du milieu est en jeu :

  • Couche client (subagent, MCP, édition de fichiers, commandes slash) : tourne sur votre machine, insensible au changement de modèle.
  • Couche protocole (format Messages, événements de flux, cache_control, blocs thinking) : c'est la passerelle qui l'implémente, à hauteur de sa compatibilité.
  • Couche modèle (qualité de raisonnement, entrée visuelle, hits de cache) : elle appartient au modèle. Changez de modèle, changez de jeu de capacités.

Le véritable arbitrage se joue sur la couche modèle, pas sur la couche protocole. Cela fixe la bonne attente : vous remplacez le modèle, pas Claude Code.

Tableau des capacités

CapacitéClaude officielSur DeepSeek V4Couche
Édition de code, refactor multi-fichiers✅✅Client, inchangé
subagent / outil Task✅✅Client, inchangé
Serveurs MCP✅✅Client, inchangé
Commandes slash, hooks✅✅Client, inchangé
Entrée d'images (captures, maquettes)✅❌Modèle, nécessite un modèle vision
extended thinking✅❌Modèle, le modèle ne produit pas de blocs thinking
prompt caching✅⚠️ PartielProtocole + modèle
Outil WebSearch✅❌Outil côté serveur, réservé à l'officiel
Contexte long (1M)❌ (200K)✅Modèle, un gain plutôt qu'une perte
Accès direct et facturation en CNY❌✅Réseau et facturation, voir la solution sans carte bancaire

Point par point

L'entrée d'images cesse de fonctionner

Quand vous collez une image, Claude Code l'encode en bloc image et l'insère dans le message. Un modèle texte seul rejette le paramètre ou l'ignore silencieusement — et le cas silencieux est le plus gênant : le modèle se met à deviner ce que montre l'image.

Contournement : envoyez les tâches qui dépendent de l'image vers un modèle acceptant l'entrée visuelle ; un refactor purement textuel n'a pas besoin de basculer.

extended thinking n'apparaîtra pas

extended thinking est un mécanisme de raisonnement côté modèle Anthropic, exposé dans le protocole Messages sous forme de bloc de contenu thinking. Une passerelle peut relayer de tels blocs, mais c'est le modèle qui doit les produire — avec DeepSeek, ce chemin est donc vide.

L'alternative consiste à utiliser directement un modèle de raisonnement (par exemple deepseek-v4-pro-0813, qui est lui-même un modèle reasoning) : son raisonnement se déroule à l'intérieur du modèle et n'est pas exposé via des blocs thinking. Vous obtenez « il réfléchit mieux », pas « on voit comment il réfléchit ».

prompt caching partiellement disponible

C'est le point le plus facile à mal juger, car il faut regarder deux niveaux :

  • Niveau facturation : le barème de KimiSeek comporte une ligne « entrée en cache ». DeepSeek V4 Pro est à ¥4.5 en entrée et ¥0.45 en cache hors pointe, soit un facteur dix : les hits de cache sont réellement mesurés et facturés.
  • Niveau protocole : Anthropic marque les points de rupture de cache avec cache_control, dont la sémantique ne coïncide pas exactement avec les implémentations de cache en amont. Le taux de hit dépend de la façon dont l'amont le calcule ; le client ne peut pas l'imposer.

Conclusion : le cache agit et fait bien économiser, mais ne budgétisez pas votre facture sur les taux de hit de l'officiel.

WebSearch est purement indisponible

Le WebSearch de Claude Code n'est pas un outil exécuté localement : c'est un outil fourni par le serveur d'Anthropic. Une fois la requête sortie par une passerelle tierce, l'amont ne reconnaît pas la définition de l'outil, et l'appel échoue ou renvoie « non implémenté ».

Contournement : remplacez-le par un outil de récupération MCP local ; cela relève de la couche client et survit au changement de modèle.

Ce qui n'est pas affecté

À dire clairement, car c'est ce qui décide si le changement vaut le coup :

  • Capacité d'édition : lecture et écriture de fichiers, diffs multi-fichiers, exécution des tests — tout est fait côté client.
  • subagent et tâches parallèles : planifiés par Claude Code lui-même, sans dépendance au fournisseur du modèle.
  • Écosystème MCP : bases de données, navigateurs, systèmes internes continuent de se brancher comme avant.
  • Permissions et hooks : configuration locale, indépendante du modèle.

Autrement dit, Claude Code conserve intacte sa valeur de « harnais d'agent » ; ce que vous perdez, ce sont certaines propriétés du modèle Claude.

Comment réduire la perte au minimum

  1. Choisissez le modèle selon la tâche : refactor et compréhension de gros fichiers sur deepseek-v4-pro-0813 (contexte 1M, modèle de raisonnement) ; fautes de frappe et messages de commit sur deepseek-v4.1-flash, dix fois moins cher.
  2. Traitez l'image à part : ne donnez pas de capture d'écran à un modèle texte ; transformez-la d'abord en description, ou basculez ponctuellement sur un modèle vision.
  3. Ne dépendez pas des blocs thinking : quand vous voulez « voir le raisonnement », demandez plutôt un plan, puis l'exécution.
  4. Revoyez vos attentes de cache à la baisse : une facture estimée avec les taux de hit de l'officiel sera systématiquement sous-évaluée.

Liste de vérification

Trois contrôles pour confirmer que la connexion est réellement établie :

Définissez votre clé API KimiSeek dans le terminal où vous exécuterez curl, en remplaçant la valeur d’exemple. Une clé enregistrée dans votre client ne remplit pas automatiquement cette variable du shell :

Shell · API key
# Replace the placeholder with your own key from the dashboard.
export KIMISEEK_API_KEY="ks-your-key"
Shell · Anthropic Messages
curl https://api.kimiseek.app/v1/messages \
  -H "x-api-key: ${KIMISEEK_API_KEY:?Set KIMISEEK_API_KEY before running this command}" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro-0813",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Hello"}]
  }'
  • 200 avec un tableau content → la couche protocole fonctionne.
  • Un simple « bonjour » envoyé dans Claude Code obtient une réponse → la configuration client est correcte.
  • Demandez-lui de lire puis de modifier un fichier → la chaîne de tool calls fonctionne.

Si une étape échoue, retrouvez le message exact dans la table des erreurs.

Quand revenir à l'officiel

Économiser n'est pas toujours le bon choix. Trois situations plaident pour l'officiel :

  • Dépendance forte à l'entrée visuelle (maquette vers code, revue d'UI)
  • Recherche en temps réel via WebSearch
  • Sensibilité extrême au taux de hit du cache (system prompt très long et appels fréquents)

Dans tous les autres cas, l'économie réalisée est réelle ; les chiffres sont dans la solution sans carte bancaire.

Versions et vérification

  • Claude Code : 2.x
  • Date de vérification : 2026-10-26
  • Sources : documentation officielle d'Anthropic (protocole Messages, extended thinking, cache_control, outils côté serveur) ; champs de capacité et de prix du catalogue de modèles KimiSeek

Questions fréquentes

Brancher un modèle tiers sur Claude Code viole-t-il ses conditions d'utilisation ?

Claude Code est un client, et pointer ANTHROPIC_BASE_URL vers un service compatible est une configuration qu'il prend en charge. Ce qu'il faut éviter, ce sont les comptes partagés ou les recharges revendues — c'est un autre sujet, traité dans les avertissements du tutoriel sans carte bancaire.

prompt caching fait-il vraiment économiser ?

Oui, mais ne budgétisez pas avec les taux de hit de l'officiel. L'entrée en cache coûte en général un dixième du prix de l'entrée : ¥0.45 contre ¥4.5 pour DeepSeek V4 Pro hors pointe. Le taux de hit dépend de l'implémentation amont ; le client n'a pas la main dessus.

Pourquoi un modèle tiers hésite-t-il davantage à modifier les fichiers sur un même prompt ?

Le plus souvent, une perte à l'aller-retour dans le format des tool calls. Vérifiez d'abord que vous êtes sur le chemin protocolaire natif (Claude Code passe par /v1/messages, Codex par /v1/responses), puis regardez si le modèle est de type reasoning.

Le contexte de 1M est-il réellement utilisable ?

DeepSeek V4 Pro annonce un contexte de 1M dans le catalogue, avec 393,000 tokens de sortie au maximum par requête. Le prix unitaire ne monte pas avec la longueur du contexte, mais chaque requête renvoie tout le texte : le vrai coût du contexte long est donc du côté de l'entrée.