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 cheminhttps://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 projetclaudela 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 ajoutersudo。

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èdeexportla 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'environnementValeurRequisDescription
ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicOuiAdresse du point de terminaison API, pointant vers l'interface compatible Anthropic de DeepSeek
ANTHROPIC_AUTH_TOKENsk-your-api-keyOuiClé API DeepSeek, utilisée pour l'authentification d'identité
ANTHROPIC_MODELdeepseek-v4-pro[1m]OuiNom du modèle principal, [1m] indique une fenêtre de contexte de 1M
ANTHROPIC_SMALL_FAST_MODELdeepseek-v4-flashOuiModèle rapide utilisé par les sous-agents

Référence rapide des noms de modèles

Nom du modèleCapacitéFenêtre de contexteScénarios applicables
deepseek-v4-pro[1m]Raisonnement le plus puissant1M tokensConception d'architecture complexe, revue de code approfondie, débogage difficile
deepseek-v4-flashRaisonnement rapide1M tokensGénération de fichiers batch, CRUD simple, rédaction de documentation

Référence rapide des chemins des fichiers de configuration Shell

Tri de ShellChemin du fichier de configurationCommande à appliquer
zsh (par défaut sur macOS)~/.zshrcsource ~/.zshrc
bash (par défaut sur Linux)~/.bashrcsource ~/.bashrc
PowerShell (Windows)Paramètres des variables d'environnement systèmeRedémarrer PowerShell

Référence rapide du fichier de configuration de Claude Code

FichierCheminObjectif
CLAUDE.mdRépertoire racine du projetSpécifications au niveau du projet, indiquant à l’IA la pile technique, le style de code et les contraintes
.claudeignoreRépertoire racine du projetRègles d’exclusion, empêchant l’IA de lire ou de modifier les fichiers spécifiés
settings.json~/.claude/settings.jsonParamè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
Autres extensions