Comment utiliser les modèles DeepSeek dans Claude Code

Comment configurer Claude Code avec DeepSeek

1. Obtenez une clé d’API DeepSeek

   Créez-en une sur platform.deepseek.com, dans API keys, et ajoutez du crédit au compte ; l’usage est facturé au token.

2. Installez Claude Code si ce n’est pas déjà fait

   Le guide de DeepSeek l’installe avec npm : Node.js 18 ou plus récent, Git for Windows sous Windows, puis npm install -g @anthropic-ai/claude-code et claude --version pour vérifier.

3. Définissez les variables d’environnement (macOS et Linux)

   Elles font pointer Claude Code vers l’endpoint compatible Anthropic de DeepSeek, utilisent deepseek-flash avec son contexte de 1M pour le modèle principal et les sous-agents, et relèvent le niveau d’effort ainsi que la fenêtre de compactage automatique. Ajoutez-les à votre profil de shell pour les conserver.

   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
   export CLAUDE_CODE_EFFORT_LEVEL=max
   export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432

4. Ou sous Windows (PowerShell)

   Les mêmes réglages sous forme de variables d’environnement PowerShell pour la session en cours.

   $env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
   $env:ANTHROPIC_AUTH_TOKEN="<your DeepSeek API Key>"
   $env:ANTHROPIC_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
   $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
   $env:CLAUDE_CODE_EFFORT_LEVEL="max"
   $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

5. Lancez Claude Code dans votre projet

   Placez-vous dans le projet avec cd et lancez claude. Tout le reste, comme CLAUDE.md, les skills, les hooks et les serveurs MCP, se configure comme d’habitude.

Source : documentation de l’API DeepSeek, Integrate with Claude Code

Correspondance entre les noms de modèles Claude et les modèles DeepSeek

Quand Claude Code (ou l’application de bureau Claude) envoie un nom de modèle Claude à l’endpoint de DeepSeek, DeepSeek le fait correspondre ainsi. C’est pourquoi la configuration ci-dessus règle toutes les variables de modèle sur deepseek-flash : sinon, tout ce qui demande Opus est facturé au tarif de V4 Pro.

Ce que ça coûte

Tarifs de l’API DeepSeek en dollars américains par million de tokens au 6 novembre 2026. Les tarifs heures creuses (en dehors de 01:00–04:00 et 06:00–10:00 UTC en semaine) valent la moitié des tarifs heures pleines. La recherche web de Claude Code fonctionne aussi avec l’API de DeepSeek, mais chaque recherche ajoute des tokens de modèle pour résumer les résultats et est facturée au titre de la Search API de DeepSeek.

Utiliser DeepSeek dans Codex

DeepSeek prend aussi en charge Codex, via la Responses API. Son guide propose un script de configuration qui sauvegarde ~/.codex/config.toml, écrit un catalogue ~/.codex/models.json avec deepseek-flash et deepseek-v4-pro et ajoute un fournisseur DeepSeek ; une seule configuration couvre alors la CLI Codex, l’application de bureau ChatGPT et l’extension VS Code. Lisez le script avant de l’exécuter, ou suivez les étapes manuelles du même guide. Le script désactive la recherche web intégrée, qui n’est disponible qu’avec deepseek-v4-pro. Pour les fichiers d’instructions propres à Codex, voir le guide AGENTS.md pour Codex.

Claude Code avec DeepSeek vs DeepSeek Harness

• Claude Code avec DeepSeek : vous gardez l’interface et les habitudes de Claude Code, y compris CLAUDE.md, les skills, les hooks et les plugins, et payez les tarifs au token de DeepSeek au lieu d’un forfait Claude.
• DeepSeek Harness : l’application d’agents open source de DeepSeek, construite autour des plugins, avec une application de bureau et une interface web ; elle peut aussi exécuter Claude Code ou Codex comme sous-agents. Voir le guide DeepSeek Harness.
• Dans les deux cas, les modèles sont les mêmes, deepseek-flash et deepseek-v4-pro, facturés par DeepSeek.
• Pour revenir aux modèles d’Anthropic, supprimez les variables (ou ouvrez un nouveau shell sans elles) et connectez-vous à Claude Code comme d’habitude.

Des modèles bon marché, au travail toute la journée

Aux tarifs de DeepSeek, faire tourner Claude Code ou DeepSeek Harness permet de garder vos agents occupés à moindre coût. Crewmark transforme ces sessions en employés IA dotés d’un rôle, d’un objectif et d’horaires de travail, et réveille chacun avec une pulsation (heartbeat) pour qu’il prenne la prochaine issue d’un tableau.

1. Utilisez la configuration que vous avez déjà

   Un employé tourne dans une session Claude Code, Codex, DeepSeek Harness ou OpenCode sur votre machine, avec votre environnement et vos clés.

2. Laissez la pulsation lancer le travail

   Pendant ses horaires de travail, il se réveille toutes les 15, 30 ou 60 minutes dans la même conversation et prend la prochaine issue ; voir comment rendre Claude Code proactif.

3. Gardez la facture sous contrôle

   Les horaires de travail et une issue à la fois rendent la consommation prévisible ; voir comment réduire la consommation de tokens de Claude Code.

FAQ Claude Code avec DeepSeek