Utiliser DeepSeek dans Claude Code : Guide de configuration V4 Flash / Pro
Exécutez DeepSeek V4 Flash et Pro dans Claude Code via APIMaster. Définissez la passerelle et la clé API, changez de modèle, vérifiez les outils de lecture de fichiers et corrigez les erreurs de configuration.
Claude Code peut-il utiliser DeepSeek ? Nos tests avec Claude Code 2.1.239 ont utilisé avec succès deepseek-v4-flash et deepseek-v4-pro via le point de terminaison Messages d'APIMaster. Définissez ANTHROPIC_BASE_URL sur https://apimaster.ai, fournissez une clé APIMaster et sélectionnez explicitement le modèle. Cette configuration exécute DeepSeek, même si le client est nommé Claude Code.
Dernier test : 2026-09-07, Claude Code 2.1.239, Linux. Les deux modèles ont renvoyé le texte attendu et ont effectué un aller-retour avec l'outil de lecture de fichiers. Toutes les exécutions se sont terminées avec le code 0. Le CLI a affiché
unrecognized_model, mais les requêtes testées ont réussi. Ces vérifications n'établissent pas la prise en charge de toutes les fonctionnalités de Claude Code, des sessions longues ou des versions futures. Les commandes de configuration pour Windows / macOS sont incluses ; le test enregistré a été exécuté sur Linux.
1. Préparer le CLI et la clé API
Suivez le guide d'environnement et le guide de configuration de Claude Code pour l'installation. Vérifiez votre version :
claude --version
Obtenez une clé API APIMaster avec accès au modèle DeepSeek sélectionné et un quota suffisant. Utilisez les paramètres de session ci-dessous pour ce tutoriel ; il n'est pas nécessaire de remplacer votre settings.json habituel.
2. Définir la passerelle et la clé
Ouvrez un nouveau terminal pour garder ces paramètres séparés de votre session CLI habituelle.
macOS / Linux :
export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN
Windows PowerShell :
$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
Utilisez l'origine du site ici, sans /v1 : Claude Code ajoute /v1/messages. La clé API doit provenir d'APIMaster. Ces commandes affectent ce terminal et ses processus enfants, pas vos fichiers de connexion enregistrés. Ne mettez pas une vraie clé dans un fichier de paramètres partagé ou un dépôt.
3. Envoyer une requête de test minimale
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"
Attendu : is_error est false, result est DEEPSEEK_TEST_OK, et le processus se termine avec le code 0. Changez --model en deepseek-v4-pro et exécutez à nouveau.
Le mode --bare de la version testée utilise une authentification explicite par clé API et ignore les intégrations d'arrière-plan normales. --setting-sources "" exclut les sources de paramètres enregistrées, tandis que --tools "" désactive les outils pour ce test de texte unique. Ce sont des paramètres de diagnostic délibérés, pas des exigences pour désactiver les outils lors d'une utilisation normale. Les versions plus anciennes du CLI peuvent ne pas accepter tous ces indicateurs.
4. Vérifier les outils de lecture de fichiers
Créez probe.txt dans le répertoire courant avec ce contenu :
TOOL_PROBE_739182
Exécutez :
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."
Attendu : le CLI lit le fichier et renvoie TOOL_PROBE_739182. Répétez avec deepseek-v4-pro. Cela vérifie que le modèle peut demander un outil, recevoir son résultat puis répondre. Seul l'outil Read est activé pour ce test.
Pour un travail interactif ordinaire avec les mêmes paramètres de terminal :
claude --bare --setting-sources "" --model deepseek-v4-flash
Pour démarrer avec Pro :
claude --bare --setting-sources "" --model deepseek-v4-pro
Les commandes interactives omettent --tools "", donc les outils par défaut sont disponibles. Examinez les invites de permission comme d'habitude. --bare ignore les commodités telles que les hooks et les instructions de projet automatiques ; activez vos paramètres normaux délibérément après que la configuration minimale fonctionne, et vérifiez qu'ils ne remplacent pas la passerelle ou le modèle. Fermez ce terminal une fois terminé pour laisser l'environnement de cette session derrière vous.
Dépannage
| Symptôme | Que vérifier |
|---|---|
unrecognized_model |
Observé pour les deux identifiants DeepSeek dans 2.1.239. Cela n'a pas empêché nos requêtes de se terminer. Vérifiez le résultat final plutôt que de traiter l'avertissement seul comme un échec. |
| 401 ou une invite de connexion inattendue | Confirmez que ANTHROPIC_API_KEY est défini, supprimez un ANTHROPIC_AUTH_TOKEN conflictuel dans ce terminal et réessayez le mode bare. |
| 404 | ANTHROPIC_BASE_URL doit être https://apimaster.ai, pas le point de terminaison complet /v1/messages ou une base se terminant par /v1. |
Option --bare inconnue |
Vérifiez votre version par rapport à la version testée 2.1.239. Utilisez le guide d'installation général pour mettre à jour si approprié. |
Impossible de lire probe.txt |
Exécutez depuis le répertoire du fichier. Pour le test d'outil, activez Read plutôt que d'utiliser --tools "". |
| Un modèle différent est sélectionné | Passez l'identifiant complet du modèle avec --model et vérifiez les paramètres enregistrés ou les remplacements d'alias de modèle avant de les activer. |
| Limite de débit, quota insuffisant ou erreur en amont | Lisez le corps de l'erreur, vérifiez le quota et les autorisations du modèle, et enregistrez l'horodatage pour le support. |
Questions fréquemment posées
Est-ce la même chose que d'utiliser un modèle Claude ?
Non. Claude Code est le client ici ; le modèle sélectionné est DeepSeek. Les fonctionnalités qui dépendent d'un modèle Claude particulier ne sont pas automatiquement couvertes par cette configuration.
Pourquoi l'URL de base est-elle différente de l'exemple du SDK Python ?
Le SDK Python OpenAI utilise https://apimaster.ai/v1 et ajoute /chat/completions. Claude Code utilise https://apimaster.ai et ajoute /v1/messages. Utilisez le format de base documenté de chaque client.
Puis-je utiliser une clé officielle DeepSeek avec cette passerelle ?
Ce tutoriel nécessite une clé émise par APIMaster. Les clés sont spécifiques au fournisseur qui les émet ; changer uniquement le point de terminaison ne transfère pas les informations d'identification ou le quota.
L'utilisation réelle d'outils a-t-elle été testée, ou seulement une réponse texte ?
Les deux ont été testés pour les deux modèles. Le test d'outil a lu un fichier local et renvoyé son contenu. Cela n'établit pas que tous les outils, agents d'arrière-plan ou tâches de codage longues sont pris en charge.