Utiliser Claude Code avec DeepSeek, Ollama ou d'autres modèles

Pointez Claude Code vers l'endpoint compatible Anthropic d'un fournisseur avec ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN, et indiquez les modèles du fournisseur dans ANTHROPIC_MODEL et les variables ANTHROPIC_DEFAULT_*_MODEL. Cela fonctionne, mais Anthropic ne le prend pas en charge, une session ne parle qu'à un seul fournisseur, et des fonctions comme le prompt caching peuvent être ignorées en silence.

Mis à jour le

Comment ça marche

Claude Code envoie chaque requête au format Messages d'Anthropic à l'adresse indiquée par ANTHROPIC_BASE_URL. Un fournisseur qui sert ce format peut remplacer Anthropic, et Claude Code ne voit pas la différence tant qu'une requête n'utilise pas quelque chose que le fournisseur n'a pas implémenté. La documentation d'Anthropic sur les passerelles indique clairement que ce n'est pas pris en charge : elle « ne prend pas en charge le routage de Claude Code vers des modèles autres que Claude, quelle que soit la passerelle ».

Endpoints compatibles

FournisseurANTHROPIC_BASE_URLRemarques
DeepSeekhttps://api.deepseek.com/anthropicGuide officiel. Les noms claude-opus* correspondent à V4 Pro, tout le reste à V4 Flash
Ollama (local)http://localhost:11434Intégration officielle depuis Ollama 0.14 ; ollama launch claude la configure
Kimi (Moonshot)https://api.moonshot.ai/anthropicGuide officiel ; kimi-k2.7-code exige que le thinking soit activé
Z.ai GLMhttps://api.z.ai/api/anthropicGuide officiel
Alibaba Coding Planhttps://coding-intl.dashscope.aliyuncs.com/apps/anthropicGuide officiel ; les endpoints en paiement à l'usage dépendent de la région
OpenRouterhttps://openrouter.ai/apiGaranti uniquement avec Anthropic comme fournisseur en amont ; définissez ANTHROPIC_API_KEY sur une chaîne vide
LM Studio (local)http://localhost:1234Page d'intégration officielle

Exemple : DeepSeek

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
claude

Ce sont les valeurs de la page Claude Code de DeepSeek elle-même. Définissez chaque niveau, pas seulement ANTHROPIC_MODEL : un niveau laissé vide envoie toujours un nom de modèle Claude, que l'endpoint ne connaît pas, et les tâches d'arrière-plan et les sous-agents qui l'utilisent échouent.

Exemple : un modèle local avec Ollama

ollama launch claude

Cette commande configure Claude Code pour vous. À la main, il faut trois variables et un modèle qui prend en charge l'appel d'outils :

export ANTHROPIC_BASE_URL=http://localhost:11434
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
claude --model qwen3.5

Ollama recommande une fenêtre de contexte de 64K tokens ou plus pour les dépôts de grande taille ; un agent de code renvoie la conversation à chaque tour, et une petite fenêtre se remplit vite.

Ce qui casse

  • Les marqueurs de prompt caching. DeepSeek et Ollama ignorent le cache_control d'Anthropic, et Kimi ne le respecte qu'au niveau supérieur. Aucune erreur n'apparaît ; bénéficier encore des tarifs de cache dépend du cache propre au fournisseur.
  • Le changement de fournisseur. Claude Code lit un seul ANTHROPIC_BASE_URL : passer de DeepSeek à Claude suppose donc de redémarrer avec d'autres réglages, pas une commande /model.
  • La recherche web. L'outil WebSearch de Claude Code tourne sur les serveurs d'Anthropic. DeepSeek indique que son endpoint le prend en charge ; Ollama indique que la recherche web hébergée n'est pas entièrement prise en charge.
  • Les champs de requête inconnus. Claude Code traite un nom de modèle non reconnu comme un modèle Claude actuel et envoie des champs de thinking et d'effort que certains endpoints rejettent avec une erreur 400. CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 supprime les champs bêta, au prix de la recherche d'outils MCP.
  • Les fonctions liées au compte. Remote Control et la dictée vocale sont indisponibles tant qu'un identifiant de passerelle est défini.
  • Les identifiants obsolètes. Un ANTHROPIC_API_KEY resté en place, une connexion enregistrée ou d'anciennes valeurs env dans settings.json peuvent prendre le pas sur la configuration ; /status indique lequel est utilisé.

Quand un agent indépendant du modèle convient mieux

Si vous voulez un seul fournisseur à la fois et travaillez déjà dans Claude Code, les réglages ci-dessus suffisent. Si vous voulez Claude, DeepSeek et un modèle local dans la même tâche, OHarness le fait nativement : chaque fournisseur est intégré, la conversation est stockée dans un format indépendant du fournisseur, et /model passe d'un fournisseur à l'autre sans redémarrage. OHarness vs Claude Code compare directement les deux.

npm install -g oharness
oharness -m deepseek/deepseek-v4-flash

Ensuite, en cours de session, /model anthropic/claude-sonnet-5 pour l'étape qui l'exige, puis retour.

Sources

Questions fréquentes

Claude Code peut-il utiliser les modèles DeepSeek ?

Oui, de façon non officielle. DeepSeek sert un endpoint compatible Anthropic à l'adresse https://api.deepseek.com/anthropic : définissez ANTHROPIC_BASE_URL sur cette adresse, ANTHROPIC_AUTH_TOKEN sur une clé API DeepSeek, et les variables de modèle sur les noms de modèles de DeepSeek. Anthropic ne prend pas en charge les modèles autres que Claude dans Claude Code.

Claude Code peut-il faire tourner un modèle local avec Ollama ?

Oui. Ollama 0.14 et versions ultérieures servent le format Anthropic Messages, et `ollama launch claude` configure Claude Code pour l'utiliser. Choisissez un modèle qui prend en charge l'appel d'outils et donnez-lui une fenêtre de contexte de 64K tokens ou plus.

Claude Code peut-il alterner entre Claude et DeepSeek dans une même session ?

Non. Claude Code lit un seul ANTHROPIC_BASE_URL : une session Claude Code ne parle donc qu'à un seul fournisseur. OHarness passe d'Anthropic à DeepSeek, OpenAI, Gemini et aux modèles locaux en cours de session avec /model.

Pourquoi Claude Code renvoie-t-il des erreurs 400 avec l'endpoint d'un autre fournisseur ?

Claude Code suppose qu'un modèle non reconnu est un modèle Claude actuel et envoie des champs comme le thinking adaptatif et l'effort, que certains endpoints rejettent. Définir chaque variable ANTHROPIC_DEFAULT_*_MODEL avec les noms du fournisseur, ainsi que CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, en supprime la plupart.

Voir aussi