Dieses Tutorial beschreibt nur den Konfigurationsprozess in einer Windows-Umgebung, die Authentifizierungsmethoden und die Stellen, an denen Sie bei Problemen vorrangig überprüfen sollten.
Modellnamen, Client-Versionen und offizielle Skriptinhalte können von Zeit zu Zeit aktualisiert werden, wobei die Informationen auf der offiziellen DeepSeek-Seite vorhanden sind.
Referenzen:
- Offizieller Codex-Zugriffshandbuch von DeepSeek
- DeepSeek offizielle Konfigurationsskripte
1. Vorbereitung: DeepSeek API Key
Gehen Sie zunächst zu der DeepSeek-Konsole und erstellen Sie einen API-Key:
https://platform.deepseek.com/top_up
API Key Sicherheitsvorsichten
Wenn der alte Schlüssel jemals an folgenden Stellen erscheint:
- Screenshots
- Gespräch Aufzeichnungen
- Artikel Unterricht
- Das Code-Lager
- Die soziale Plattform
Bitte löschen Sie dies sofort in der DeepSeek-Konsole und verwenden Sie es nicht weiter.
Neuer API Key:
- nur auf den eigenen Computer eingeben.
- Schicken Sie es nicht an jemanden.
- Keine Screenshots zeigen
- Übertragen Sie nicht an das Code-Repository
Zusätzlich ist zu beachten:
Das offizielle DeepSeek-Konfigurationsscript verwendet nicht nur temporär Key im aktuellen PowerShell-Fenster, sondern schreibt möglicherweise die Zertifizierungsinformationen in das Verzeichnis der Codex-Benutzerkonfiguration.
Folgende Verzeichnisse müssen daher auch als sensible Verzeichnisse geschützt werden:
C:\Users\你的用户名\.codex\
nicht ganz hochladen. .codex Ordner und teilen Sie auch keine Profildateien, die darin sind.
Die API Key-Seite im Screenshot des Tutorials empfiehlt:
- Code müssen.
- Verwenden Sie einen relativen Pfad zum Speichern von Bildressourcen, um den Computer zu wechseln oder nach der Veröffentlichung nicht zu verlieren
Beispiel:
2. Führen Sie das offizielle DeepSeek-Konfigurationsskript aus
Öffnen Sie die Windows PowerShell und führen Sie Folgendes aus:
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex
Der Befehl wird:
- PowerShell-Skripte von der offiziellen Adresse von DeepSeek herunterladen
- Sofortige Ausführung des Konfigurationsvorgangs
Obwohl die Adresse offiziell ist, ist es zu beachten:
Die direkte Ausführung von Remote-Skripten ist an sich immer noch ein Risiko.
Kopieren Sie nicht ähnliche Befehle von unbekannten Tutorials.
Wenn Sie nicht beruhigt sind, können Sie:
- Öffnen Sie zunächst das Skript.
- Quelle bestätigt
- erneut durchzuführen.
Konfiguration Schritte
Nachdem das Menü erscheint:
- Import:
1
- Auswahl:
deepseek-v4-flash
- Geben Sie den neu erstellten DeepSeek API Key ein
- Warten Sie, bis das Skript die Konfiguration abgeschlossen ist
Erinnerungen zu deepseek-v4 - pro
Die Anzeige bestimmter Modellnamen im Skriptmenü bedeutet nicht, dass die aktuelle Clientversion und der offizielle Zugriffszustand vollständig unterstützt werden.
Wählen Sie nicht einfach nur einen Modellnamen, weil Sie ihn im Menü sehen.
Die richtige Art und Weise:
- Basierend auf der aktuellen offiziellen DeepSeek-Dokumentation
- Bestätigen Sie den Modellnamen
- Bestätigen Sie die Clientversionsanforderungen
- Bestätigen Sie die empfohlene Zugangsmethode
Nicht:
- Schlüssel in den Befehl einfügen.
- Schreiben Sie den Key in ein öffentliches Skript
- Echte Schlüssel im Artikel zeigen
3. Neustart von Codex und Drei-Phasen - Validierung
Nach Abschluss der Konfiguration:
- Verlassen Sie den Codex-Desktop vollständig
- Öffnen Sie den Codex
Beginnen Sie nicht direkt mit der Änderung des Projekts.
Es wird empfohlen, die Reihenfolge nach unten zu überprüfen.
Erster Schritt: Basismodell-Anforderungstest
Import:
只回复 OK
Bei Rückkehr:
OK
Beschreibung:
- API-Anforderung grundsätzlich erfolgreich
- Die Anbieterkonfiguration ist möglicherweise normal.
Wenn sie auftreten:
- 401
- Das Modell existiert nicht.
- Fehler des Anbieters
Lassen Sie nicht den Codex zuvor das Projekt betreiben.
Prioritätsprüfung:
- API-Schlüssel
- Name des Modells
- Provider Konfiguration
- Client-Version
Schritt 2: Lese-nur - Datei-Test
Import:
只读当前工作区中的一个文本文件，告诉我它主要写了什么，不要修改任何文件
Zur Bestätigung:
- Kann Codex auf den Arbeitsbereich zugreifen?
- Ist das Lesen von Dateien normal?
Schritt 3: Einfacher Tool-Aufruf - Test
Import:
只列出当前工作区中的文件名，不要创建、删除或修改任何文件
Zur Bestätigung:
- Ist der Aufruf des Tools normal?
- Ist die Berechtigung des Arbeitsbereichs normal?
Warum in drei Schritten?
Weil:
- Grundlegende Anfrage fehlschlägt → Meist Key, Modell, Provider Problem
- Fehler beim Lesen der Datei → Möglicherweise ein Arbeitsbereichs-Berechtigungen oder ein Clientproblem
- Ein fehlgeschlagener Aufruf des Tools → Möglicherweise ein Problem mit der Codex-Toolkette
Getrennte Tests können schnell die Ursache lokalisieren.
4. Der ursprüngliche Backup-Standort
Offizielle Skripte erstellen normalerweise ein Backup-Verzeichnis:
C:\Users\Administrator\.codex\backup-deepseek\
Wenn der Windows-Benutzername kein Administrator ist:
Überprüfen Sie:
C:\Users\你的用户名\.codex\backup-deepseek\
Dieser Katalog kann enthalten:
- Provider Konfiguration
- API-Adresse
- Zertifizierungsinformationen
Nicht:
- Hochladen auf das Netzwerk
- Überprüfen Sie andere.
- In ein öffentliches Lager.
V. Endversion des Codex: Bestätigung der Version
Die Desktop-Version des Codex und die Terminal-Version des Codex sollten nicht miteinander verwechselt werden.
Wenn Sie die Terminalversion verwenden:
Zuerst durchzuführen:
codex --version
In einigen Umgebungen werden beispielsweise:
0.117.0
Das offizielle Konfigurationsscript von DeepSeek erfordert jedoch möglicherweise eine höhere Version, z. B.:
0.144.0+
Die Versionsanforderungen können sich ändern und müssen daher den aktuellen offiziellen Anweisungen folgen.
Wenn Sie ein Upgrade benötigen:
npm install -g @openai/codex
Nach dem Upgrade erneut bestätigt:
codex --version
Acht ung :
Wenn Sie nur einen Schreibtisch verwenden:
Verwenden Sie nicht die Versionsnummer der Terminalversion, um zu beweisen, dass der Desktop erfolgreich zugegriffen wurde.
Das endgültige Urteilskriterium sollte lautet:
- Gibt es einen entsprechenden Anbieter auf dem Desktop?
- Modell-Anfrage erfolgreich
- Sind die Datei-Lese - und Tools-Aufrufe normal?
6. Häufige Fehlersuche
1. 401 oder Authentifizierung fehlgeschlagen
Prioritätsprüfung:
Verwenden Sie einen alten Schlüssel, der verbreitet wurde.
Wenn der Key jemals veröffentlicht wurde:
Sofort entfernen und neu erstellen.
Kopieren Sie Fehler
Insp ek tion :
- Vorherige Leere
- Charakter wechseln.
- Der Import ist vollständig
Geben Sie den Schlüssel nicht an andere Personen, um ihn zu überprüfen.
Die richtige Art und Weise:
Schlüssel neu erstellt, nur eingegeben, wenn Sie lokal konfiguriert sind.
2. Modell nicht vorhanden oder Version nicht unterstützt
Zuerst bestätigen:
codex --version
Danach bestätigt:
- Wird die Desktop-Version oder die Terminal-Version verwendet?
- DeepSeek offiziell gefordert Modellnamen
- Mindestversion der offiziellen Anforderungen
Wenn die Version niedrig ist:
- Upgrade der Kunden
- Konfigurationsskript erneut ausführen
- erneut verifiziert.
3. Verwenden Sie den DeepSeek Key nicht bei der Anmeldung in OpenAI
Verwenden Sie nicht:
codex login --with-api-key
Grund:
Der DeepSeek API Key ist kein OpenAI-Anmeldedaten.
DeepSeek sollte durch:
- Anbieter benutzen
- API-Adresse konfiguriert
- Entsprechende Kommunikationsprotokolle
Zugriff zu machen.
Denken Sie an drei Punkte.
- Der alte Schlüssel wurde exponiert und wurde erstmals zurückgezogen.
- Der DeepSeek API Key ist kein OpenAI-Anmeldedaten.
- Das Auftreten eines Modells in der Schnittstelle bedeutet nicht, dass die Modellanfrage, das Lesen von Dateien und der Aufruf von Werkzeugen völlig normal sind.
Das Kriterium für eine erfolgreiche Konfiguration ist nicht "Modellnamen sehen", sondern:
- Erfolgreichen Antrag
- Dokumente lesen normal.
- Werkzeuge normal aufrufen