Configuration DeepSeek de Claude Code
Claude CodeClaude Code est un assistant de programmation IA lancé par Anthropic qui s'exécute dans le terminal, prend en charge la configuration d'API tierces compatibles via des variables d'environnement, et peut ainsi se connecter à des modèles tels que DeepSeek.
Cet article décrit comment combiner Claude Code avecDeepSeek, utilisés ensemble, pour obtenir de puissantes capacités de programmation assistée par IA à moindre coût.
Points clés :
- Claude Code utiliseANTHROPIC_BASE_URLcomme variable d'environnement pour pointer vers l'interface compatible avec DeepSeek.
- DeepSeek fournit une API compatible avec l'API Anthropic, avec le chemin
https://api.deepseek.com/anthropic。 - Grâce à un ensemble de variables d'environnement, différents modèles de niveau (Opus / Sonnet / Haiku) peuvent être associés aux modèles DeepSeek correspondants.
- Une fois la configuration terminée, exécutez directement dans le répertoire du projet
claudela commande pour l'utiliser.
En termes simples :Claude Code + DeepSeek = Assistant de programmation IA en terminal + grand modèle à haut rapport coût-performance
- Claude Code: Fournit une expérience complète d'interaction de programmation IA en terminal, prenant en charge la génération de code, la refactorisation, le débogage, l'explication, etc.
- DeepSeek API: Fournit une interface compatible avec Anthropic, prenant en charge les appels aux modèles de la série DeepSeek.
- Pont de variables d'environnement: Relie les deux via des variables d'environnement standard, sans modifier le code source de Claude Code.
Prérequis
Si vous avez déjà installé Claude Code, vous pouvez ignorer cette étape.
- InstalléNode.jsversion 18 ou supérieure.
- Les utilisateurs Windows doivent également installerGit for Windows(fournit un environnement bash).
- DéjàDeepSeek Platformenregistré un compte et créé une clé API.
Exécutez la commande suivante dans l'interface de ligne de commande pour installer Claude Code :
curl -fsSL https://claude.ai/install.sh | bash
Après l'installation, exécutez la commande suivante pour vérifier. Si le numéro de version s'affiche normalement, l'installation a réussi :
claude --version
Si vous rencontrez des problèmes de permissions, les utilisateurs de Linux / macOS peuvent ajouter
sudo。S'il existe une vérification de connexion, vous pouvez trouver le fichier dans le répertoire utilisateur.claude.json:
- macOS/Linux:~/.claude.json
- Windows:C:\Users\YourUsername\.claude.json
{ "hasCompletedOnboarding": true }
Après avoir enregistré, redémarrez le terminal, puis exécutez :
claudeÀ ce stade, la fenêtre / invite pop-upConnexion à claude.ain'apparaîtra plus.
Obtenir une clé API DeepSeek
Accédez àDeepSeek PlatformAprès vous être connecté, créez une clé API et conservez-la correctement. Elle sera nécessaire lors de la configuration des variables d'environnement.

La clé API dispose des autorisations d'exploitation du compte. Ne la validez pas dans un dépôt de code et ne la partagez pas avec d'autres personnes. Il est recommandé d'utiliser l'outil de gestion des clés du système d'exploitation ou un fichier de variables d'environnement (tel que
.env) pour la gestion, et ajoutez les fichiers concernés à.gitignore。
Configurer les variables d'environnement
Claude Code se connecte à l'API DeepSeek via les variables d'environnement suivantes. La signification de chaque variable est la suivante :
| Variable d'environnement | Description |
|---|---|
ANTHROPIC_BASE_URL |
Indique l'adresse de l'interface DeepSeek compatible avec le protocole Anthropic |
ANTHROPIC_AUTH_TOKEN |
Votre clé API DeepSeek |
ANTHROPIC_MODEL |
Le modèle utilisé par défaut |
ANTHROPIC_DEFAULT_OPUS_MODEL |
Le modèle utilisé pour le mappage du niveau Opus (tâches de raisonnement complexes) |
ANTHROPIC_DEFAULT_SONNET_MODEL |
Le modèle utilisé pour le mappage du niveau Sonnet (tâches de programmation quotidiennes) |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
Le modèle utilisé pour le mappage du niveau Haiku (tâches rapides et légères) |
CLAUDE_CODE_SUBAGENT_MODEL |
Le modèle utilisé par les agents de sous-tâches (un modèle plus rapide est recommandé) |
CLAUDE_CODE_EFFORT_LEVEL |
Profondeur de réflexion, facultativelow / medium / max |
Linux / macOS
Exécutez la commande suivante dans le terminal (remplacez<你的 DeepSeek API Key>Remplacez par votre clé réelle) :
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key> export ANTHROPIC_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVEL=max
Ce qui précède
exportla commande ne prend effet que dans la session de terminal actuelle.Pour un effet permanent, ajoutez la commande ci-dessus à la fin du
~/.bashrcfichier (Bash) ou~/.zshrc(Zsh), puis exécutezsource ~/.bashrcpour qu'elle prenne effet immédiatement.
Windows(PowerShell)
Exécutez la commande suivante dans PowerShell :
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>" $env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_EFFORT_LEVEL="max"
L'affectation de PowerShell
$env:ne prend effet que dans la session actuelle. Pour un effet permanent, ajoutez la variable d'environnement utilisateur correspondante dans « Propriétés système → Variables d'environnement », ou écrivez la commande ci-dessus dans le fichier de profil PowerShell ($PROFILE)。
Vérifier si cela prend effet
Une fois la configuration terminée, démarrez Claude Code et exécutez la commande/statuspour vérifier :
$ cd 你的项目目录 $ claude /status
Si la configuration est correcte, vous verrez une sortie similaire à ce qui suit :
Base URL: https://api.deepseek.com/anthropic Model: deepseek-v4-pro[1m] Small fast model: deepseek-v4-flash
Voir ces informations signifie que la configuration a réussi, et que Claude Code utilise maintenant DeepSeek V4 pour le raisonnement.
Si les informations affichées ne sont pas celles ci-dessus, vérifiez point par point : si les variables d'environnement sont correctement définies, si la clé API est valide, et si les noms de variables comportent des fautes d'orthographe.
Commencer à utiliser
Entrez dans le répertoire de votre projet et exécutez laclaudecommande pour démarrer Claude Code :
cd /path/to/my-project claude
Après un démarrage réussi, le terminal entrera dans l'interface interactive de Claude Code, où vous pouvez décrire directement vos besoins de programmation en langage naturel, par exemple :

# 让 Claude Code 解释当前项目结构 > 帮我梳理一下这个项目的目录结构和主要模块的作用 # 生成代码 > 给 user.go 新增一个根据邮箱查询用户的方法,并补充单元测试 # 调试问题 > 运行 npm test 后报错,帮我分析原因并修复
Configuration de référence
Variables d'environnement complètes
| Variable d'environnement | Valeur | Requis | Description |
|---|---|---|---|
| ANTHROPIC_BASE_URL | https://api.deepseek.com/anthropic | Oui | Adresse du point de terminaison API, pointant vers l'interface compatible Anthropic de DeepSeek |
| ANTHROPIC_AUTH_TOKEN | sk-your-api-key | Oui | Clé API DeepSeek, utilisée pour l'authentification d'identité |
| ANTHROPIC_MODEL | deepseek-v4-pro[1m] | Oui | Nom du modèle principal, [1m] indique une fenêtre de contexte de 1M |
| ANTHROPIC_SMALL_FAST_MODEL | deepseek-v4-flash | Oui | Modèle rapide utilisé par les sous-agents |
Référence rapide des noms de modèles
| Nom du modèle | Capacité | Fenêtre de contexte | Scénarios applicables |
|---|---|---|---|
| deepseek-v4-pro[1m] | Raisonnement le plus puissant | 1M tokens | Conception d'architecture complexe, revue de code approfondie, débogage difficile |
| deepseek-v4-flash | Raisonnement rapide | 1M tokens | Génération de fichiers batch, CRUD simple, rédaction de documentation |
Référence rapide des chemins des fichiers de configuration Shell
| Tri de Shell | Chemin du fichier de configuration | Commande à appliquer |
|---|---|---|
| zsh (par défaut sur macOS) | ~/.zshrc | source ~/.zshrc |
| bash (par défaut sur Linux) | ~/.bashrc | source ~/.bashrc |
| PowerShell (Windows) | Paramètres des variables d'environnement système | Redémarrer PowerShell |
Référence rapide du fichier de configuration de Claude Code
| Fichier | Chemin | Objectif |
|---|---|---|
| CLAUDE.md | Répertoire racine du projet | Spécifications au niveau du projet, indiquant à l’IA la pile technique, le style de code et les contraintes |
| .claudeignore | Répertoire racine du projet | Règles d’exclusion, empêchant l’IA de lire ou de modifier les fichiers spécifiés |
| settings.json | ~/.claude/settings.json | Paramètres globaux, y compris les serveurs MCP, les autorisations, etc. |
Recommandations de sélection de modèle
Les différents modèles DeepSeek présentent différents compromis entre performances et coût. Voici les configurations recommandées pour les scénarios courants :
| Scénario | Modèle recommandé | Description |
|---|---|---|
| Conception d’architecture complexe, refactorisation profonde du code | deepseek-v4-pro[1m] |
Forte capacité de raisonnement, adapté aux tâches nécessitant une compréhension globale |
| Développement quotidien de fonctionnalités, complétion de code | deepseek-v4-pro[1m] |
Bonnes performances globales, couvrant la plupart des scénarios de programmation |
| Questions-réponses rapides, modifications simples, sous-tâches | deepseek-v4-flash |
Réponse rapide, faible coût, adapté aux tâches légères à haute fréquence |
