Claude Code + DeepSeek V4 Flash : comment connecter et combien coûte une tâche

DeepSeek dispose d'une adresse au format Anthropic — https://api.deepseek.com/anthropic — et d'un guide officiel pour Claude Code. La clé se crée dans l'espace client DeepSeek (platform.deepseek.com), et le solde doit être rechargé à l'avance. Voici les variables issues du guide DeepSeek au 2 novembre 2026 :

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-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
claude

Ce qu'il faut savoir avant le premier lancement :

• Nom du modèle. Depuis le 10 septembre 2026, deepseek-flash désigne V4.1 Flash, et depuis le 17 octobre, sa mise à jour 1017 au même prix. L'ancien nom deepseek-v4-flash est encore accepté par DeepSeek, mais renvoie à la même V4.1 Flash. Le suffixe [1m] indique à Claude Code que la fenêtre du modèle est de 1 million de tokens, et CLAUDE_CODE_AUTO_COMPACT_WINDOW définit à partir de quel volume l'historique est compressé.
• Noms Claude. Si vous laissez dans Claude Code un modèle portant un nom Claude, DeepSeek le remplace par le sien : les noms contenant claude-opus sont routés vers V4 Pro et facturés au tarif V4 Pro, les autres vers deepseek-flash. C'est pourquoi tous les alias sont explicitement fixés dans le guide.
• Heures de pointe. Depuis le 16 août 2026, DeepSeek applique un tarif double en semaine de 01h00 à 04h00 et de 06h00 à 10h00 UTC, hors jours fériés chinois. En heure de Pékin, cela couvre presque toute la journée de travail ; en Europe, c'est le matin ; aux États-Unis, le soir et la nuit.
• Recherche web. Quand Claude Code effectue une recherche sur Internet avec son outil intégré, c'est DeepSeek qui l'exécute. Depuis le 31 octobre 2026, c'est payant : 0,75 $ pour 1000 requêtes réussies, plus les tokens que le modèle consomme pour lire les résultats.

Sur le réseau Gonka tourne DeepSeek V4 Flash en version 0731 — poids ouverts sous licence MIT. La passerelle accepte elle-même les requêtes Claude Code au format Anthropic (/v1/messages), aucune couche intermédiaire n'est nécessaire.

Étape 1. La clé. Inscrivez-vous sur JoinGonka Gateway — les nouveaux comptes reçoivent 3M tokens gratuits — puis créez une clé jg-… dans votre espace.

Étape 2. L'installateur.

npx @joingonka/setup --tool claude-code --model deepseek

L'installateur vous demandera la clé, sauvegardera une copie de ~/.claude/settings.json et n'ajoutera dans le bloc env que ses propres variables : l'adresse de la passerelle et la clé ; le modèle pour la session courante et les nouvelles sessions, pour les alias opus, sonnet, fable et pour les sous-agents ; MiniMax M2.7 pour l'alias haiku, sur lequel Claude Code fait tourner les tâches en arrière-plan ; les véritables limites du modèle — une fenêtre de 380 000 tokens et une réponse jusqu'à 32 768. Il ne touche pas à vos autres réglages et attribue des droits 600 au fichier contenant la clé. Enfin, l'installateur vérifie la clé par une requête réelle. Le même installateur configure aussi d'autres programmes — ils sont déjà 25, dont Codex CLI et OpenCode.

Étape 3. Vérification. Lancez claude et ouvrez /status : vous devez y voir une ligne Anthropic base URL avec l'adresse de la passerelle et une ligne Auth token avec ANTHROPIC_AUTH_TOKEN. Ensuite, confiez une tâche de code, par exemple Read calc.py and tell me in one sentence whether it has a bug.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai",
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMaxAI/MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "380000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768"
  }
}

Toutes les variantes de configuration, y compris Windows et la configuration pour un seul projet, se trouvent dans le guide Claude Code.

Ce que cela change en pratique :

• Version du modèle. V4.1 Flash est plus récente et, d'après les propres benchmarks de DeepSeek, plus performante : sur Terminal-Bench 2.1, V4.1 Flash obtient 90,6 contre 82,7 pour V4 Flash 0731 (selon les publications du 10 septembre et du 31 juillet). Si vous avez besoin d'images, d'une fenêtre d'un million de tokens ou de la version la plus récente, optez pour l'API officielle DeepSeek. Si ce qui compte davantage, c'est le coût d'un gros volume de travail et un prix unique à toute heure, testez V4 Flash via la passerelle sur vos propres tâches — vous pouvez commencer avec des tokens gratuits.
• Sessions longues. Une fenêtre de 380 000 tokens contient moins d'historique qu'un million. Pour un usage courant, cela suffit : la requête moyenne de Claude Code vers DeepSeek V4 Flash via notre passerelle en octobre 2026 était d'environ 96 k tokens.

Pour en savoir plus sur le modèle lui-même, consultez l'article sur DeepSeek V4 Flash dans le réseau Gonka.

Commençons par les prix pour 1 M de tokens au 2 novembre 2026 — d'après la page tarifaire de DeepSeek et l'API OpenRouter. À côté de DeepSeek figure le même V4 Flash 0731 chez les fournisseurs les moins chers d'OpenRouter :

L'entrée classique coûte chez nous 24 à 49 fois moins cher que chez DeepSeek, et la sortie 32 à 65 fois moins. Mais la lecture depuis le cache chez DeepSeek coûte aux heures de pointe à peu près le prix de notre entrée, et le reste du temps deux fois moins cher, et Claude Code relit presque en permanence la même chose : le prompt système, la description des outils et l'historique de la session. Il faut donc comparer une tâche complète, pas le prix d'un token.

La tâche. Prenons une tâche de 30 appels au modèle — par exemple, trouver un bug, corriger le code et lancer les tests. D'après les données de notre passerelle pour octobre 2026, une requête Claude Code vers DeepSeek V4 Flash représente en moyenne environ 96 k tokens en entrée et 0,9 k en sortie. Au total, la tâche représente 2,9 M de tokens en entrée et 27,5 k en sortie. Claude Code renvoie la session à chaque étape, et celle-ci coïncide presque entièrement avec la requête précédente ; on considérera donc que chez DeepSeek et OpenRouter, 95 % de l'entrée est lue depuis le cache.

Les montants sont calculés d'après les prix au 2 novembre 2026 ; notre prix par token sur cette page est dynamique et évolue avec le cours du GNK. Pour une telle tâche, la passerelle revient à environ 5 fois moins cher que DeepSeek aux heures de pointe, 2,5 fois moins le reste du temps et 2,3 fois moins cher que le fournisseur le moins cher du même modèle sur OpenRouter.

L'écart dépend du cache. Si 98 % de l'entrée est lue depuis le cache, DeepSeek est environ 1,8 fois plus cher que nous hors pointe et 3,7 fois plus cher aux heures de pointe. Si c'est 90 % — 3,7 et 7,4 fois. Chez nous, la part du cache n'influence pas le montant : toute l'entrée coûte le même prix. Le calcul sur un mois, la variante avec GLM-5.3 Flash et les prix de Claude lui-même à titre de référence se trouvent dans l'article « Claude Code moins cher ».

Claude Code Router (CCR) — un projet open source sous licence MIT : une passerelle locale sur votre machine, par défaut http://127.0.0.1:3456. Claude Code et d'autres agents lui envoient leurs requêtes, et lui les transmet aux fournisseurs choisis : il convertit les requêtes entre les formats (Anthropic Messages, OpenAI Chat et Responses, Gemini), répartit les tâches par modèle selon des règles, bascule vers un modèle de secours en cas d'échec et tient un journal des requêtes avec les tokens et l'estimation des coûts. Il s'installe comme application pour macOS, Windows et Linux ou via la commande npm install -g @musistudio/claude-code-router (Node.js 22 ou plus récent requis).

Pour un seul DeepSeek, il est inutile : DeepSeek dispose de sa propre adresse au format Anthropic, et JoinGonka Gateway accepte lui aussi directement les requêtes de Claude Code. CCR a du sens si vous voulez :

• gérer plusieurs fournisseurs et des règles déterminant quelle tâche envoyer où ;
• basculer automatiquement vers un modèle de secours quand le principal ne répond pas ;
• voir le journal des requêtes, des tokens et des coûts au même endroit ;
• connecter un fournisseur qui ne comprend que le format OpenAI.

CCR connecte une adresse personnalisée (custom endpoint) avec le protocole Anthropic Messages ou OpenAI Chat, et la passerelle prend en charge les deux : adresse de base https://gate.joingonka.ai pour Anthropic et https://gate.joingonka.ai/v1 pour OpenAI. Détails dans la documentation Gonka API, section Anthropic Messages.

Claude Code récupère la clé d'une API tierce dans l'une des deux variables :

• ANTHROPIC_AUTH_TOKEN — la clé est transmise via l'en-tête Authorization: Bearer et prend effet immédiatement. C'est ce que font le guide DeepSeek et notre installateur.
• ANTHROPIC_API_KEY — la clé est transmise via l'en-tête x-api-key ; en mode interactif, Claude Code demandera une fois s'il faut l'utiliser.

DeepSeek et JoinGonka acceptent les deux en-têtes. Tant que la variable avec la clé est définie, l'abonnement claude.ai n'est pas consommé : Claude Code mémorise votre connexion mais ne l'envoie pas, et les requêtes sont payées depuis le solde de cette clé. Si vous définissez uniquement l'adresse sans clé, Claude Code enverra sa connexion claude.ai à la nouvelle adresse, et la requête échouera.

Conservez la clé dans ~/.claude/settings.json ou dans le .claude/settings.local.json du projet, mais pas dans le .claude/settings.json commun du dépôt — il est généralement commité. L'installateur avec le flag --scope local écrit dans settings.local.json et l'ajoute lui-même au .gitignore.

Revenir à Claude — supprimez du bloc env les lignes qui pointent vers DeepSeek ou la passerelle, puis redémarrez Claude Code : il reprendra votre connexion claude.ai.