Ce tutoriel couvre uniquement le processus de configuration dans un environnement Windows, les méthodes de vérification et les endroits où vous devez vérifier en priorité en cas de problème.
Le nom du modèle, la version du client et le contenu du script officiel peuvent être mis à jour au fil du temps. Veuillez utiliser les informations actuellement affichées sur la page officielle de DeepSeek pour la pratique.
Références :
- Guide d'accès officiel au Codex de DeepSeek
- Scripts de configuration officiels de DeepSeek
Préparation : Application de DeepSeek API Key
Tout d'abord, allez à la console DeepSeek pour créer une clé API :
https://platform.deepseek.com/top_up
Précautions de sécurité API Key
Si l'ancienne clé apparaît à l'endroit suivant :
- Screenshot
- Chat historique
- Article tutoriel
- Code Warehouse
- Plateforme sociale
Veuillez révoquer immédiatement sur la console DeepSeek et ne pas continuer à utiliser.
Nouvelles clés API :
- Saisissez seulement sur votre propre ordinateur
- Ne l'envoyez pas à personne
- Ne pas montrer des screenshots
- Ne pas soumettre à un entrepôt de code
En outre, il faut noter :
Le script de configuration officiel de DeepSeek n'utilise pas temporairement la clé uniquement dans la fenêtre actuelle de PowerShell. Il peut écrire les informations d'authentification dans le répertoire de configuration utilisateur de Codex.
Par conséquent, les répertoires suivants doivent également être protégés comme répertoires sensibles :
C:\Users\你的用户名\.codex\
Ne téléchargez pas toute la .codex Les dossiers, et ne partagez pas les fichiers de configuration qui y sont.
La page API Key dans la capture d'écran du tutoriel suggère :
- Doit être code
- Utilisez les chemins relatifs pour enregistrer les ressources d'image pour éviter de changer d'ordinateur ou de publier après la perte de validité
Exemples :
Exécuter le script de configuration officiel de DeepSeek
Ouvrir Windows PowerShell et exécuter :
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex
Cette commande :
- Téléchargez le script PowerShell depuis l'adresse officielle de DeepSeek
- Effectuer le processus de configuration maintenant
Bien que l'adresse provienne de l'officiel, il convient de noter :
L'exécution directe des scripts à distance comporte toujours des risques en soi.
Ne copiez pas des commandes similaires à partir de tutoriels inconnus.
Si vous n'êtes pas rassuré, vous pouvez :
- Ouvrir le contenu du script
- Source confirmée
- Ré - exécution
Étape de configuration
Après que le menu apparaisse dans le script :
- Input :
1
- Sélectionnez :
deepseek-v4-flash
- Appuyez sur l'invite pour entrer la clé API DeepSeek nouvellement créée
- Attendez que le script termine la configuration
Rappel sur deepseek-v4 - pro
La présence de certains noms de modèles dans le menu de script ne signifie pas que la version client actuelle et l'état d'accès officiel sont entièrement pris en charge.
Ne choisissez pas un modèle juste parce que vous voyez un nom dans le menu.
De la bonne façon :
- Sous réserve de la documentation officielle actuelle de DeepSeek
- Confirmer le nom du modèle
- Confirmer les exigences de version client
- Confirmer le mode d'accès recommandé
Ne pas :
- Ajouter la clé à la commande
- Écrire une clé dans un script public
- Afficher la vraie clé dans l'article
Redémarrer le Codex et effectuer une vérification en trois étapes
Une fois la configuration terminée :
- Quitter complètement Codex Desktop
- Réouvrir le Codex
Ne commencez pas à modifier le projet directement.
Il est recommandé de vérifier dans la séquence suivante.
Étape 1 : Test de demande de modèle de base
Input :
只回复 OK
Si vous retournez :
OK
Description :
- Requête API réussie
- La configuration du fournisseur peut être normale
Si cela apparaît :
- 401
- Le modèle n'existe pas
- Erreur fournisseur
Ne laissez pas Codex manipuler le projet.
Inspection prioritaire :
- API Key
- Nom du modèle
- Configuration du fournisseur
- Client version
Étape 2 : Test de fichier en lecture seule
Input :
只读当前工作区中的一个文本文件，告诉我它主要写了什么，不要修改任何文件
Utilisé pour confirmer :
- Codex peut-il accéder à l'espace de travail
- La fonction de lecture du fichier est normale
Étape 3 : Test d'appel d'outil simple
Input :
只列出当前工作区中的文件名，不要创建、删除或修改任何文件
Utilisé pour confirmer :
- L'appel d'outil est normal
- Les autorisations de l'espace de travail sont normales
Pourquoi en trois étapes ?
Parce que,
- Requête de base échouée → La plupart des problèmes de clé, de modèle et de fournisseur
- Échec de la lecture du fichier → Peut - être un problème d'autorisation de l'espace de travail ou du client
- L'appel de l'outil a échoué → Peut - être un problème avec la chaîne d'outils Codex
Les tests sont séparés pour localiser rapidement la cause.
Emplacement de sauvegarde de la configuration d'origine
Les scripts officiels créent généralement des répertoires de sauvegarde :
C:\Users\Administrator\.codex\backup-deepseek\
Si le nom d'utilisateur Windows n'est pas administrateur :
Voir :
C:\Users\你的用户名\.codex\backup-deepseek\
Ce catalogue peut contenir :
- Configuration du fournisseur
- API Adresse
- Informations d'authentification
Ne pas :
- Télécharger sur Net Disk
- Envoyer à quelqu 'un d'autre pour vérifier
- Entrepôt ouvert
V. Codex de la version terminale : Confirmation de la version d'abord
La version de bureau du Codex et la version de terminal du Codex ne sont pas mélangées pour juger.
Si vous utilisez la version Terminal :
Exécutez d'abord :
codex --version
Par exemple, certains environnements ont détecté :
0.117.0
Cependant, les scripts de configuration officiels de DeepSeek peuvent nécessiter des versions ultérieures, telles que :
0.144.0+
Les exigences de version sont sujettes à des changements et doivent donc prévaloir des instructions officielles actuelles.
Si vous avez besoin d'une mise à niveau :
npm install -g @openai/codex
Reconfirmez après la mise à niveau :
codex --version
Note :
Si vous utilisez uniquement le bureau :
Ne prenez pas le numéro de version du terminal pour prouver que le bureau a été connecté avec succès.
Le critère de jugement final devrait être :
- Le fournisseur correspondant apparaît-il sur le côté bureau
- Requête de modèle réussie
- La lecture du fichier et l'appel de l'outil sont normaux
VI. Détection d'erreurs courantes
1. 401 ou échec de l'authentification
Inspection prioritaire :
L'ancienne clé divulguée est utilisée ou non
Si la clé est jamais rendue publique :
Révoquer et recréer immédiatement.
Dupliquer les erreurs
Vérifiez :
- Espace avant et après
- Le caractère Wrap Line
- L'entrée est complète.
N'envoyez pas la clé à quelqu 'un d'autre pour la vérifier.
De la bonne façon :
Créez à nouveau la clé et entrez-la uniquement lors de la configuration native.
2. Le modèle n'existe pas ou la version n'est pas prise en charge
Confirmer d'abord :
codex --version
Ensuite, confirmez :
- Utilisez-vous actuellement la version desktop ou la version terminal ?
- DeepSeek officiel nom de modèle actuellement demandé
- Version client minimale requise officiellement
Si la version est trop basse :
- Upgrade du client
- Retourner le script de configuration
- Vérifier à nouveau
3. Ne pas utiliser la clé DeepSeek dans le processus de connexion OpenAI
N'utilise pas :
codex login --with-api-key
Cause :
La clé API DeepSeek n'est pas un identifiant de connexion OpenAI.
DeepSeek doit :
- Prestataire Custom
- Configuration de l'adresse API
- Protocole de communication correspondant
Accès.
Et enfin, gardez à l'esprit trois points.
- L'ancienne clé a été exposée et a été révoquée la première fois.
- La clé API DeepSeek n'est pas un identifiant de connexion OpenAI.
- L'apparition du modèle dans l'interface ne signifie pas que la demande de modèle, la lecture de fichier et l'appel d'outil sont complètement normaux.
Le critère de réussite de la configuration n'est pas "voir le nom du modèle", mais :
- Requête réussie
- Le fichier est lu normalement
- Appel d'outil normal