Externe Modelle mit Codex zu verbinden, ist ein komplexer Vorgang. Diese Anleitung verwendet die Kimi API als praktisches Beispiel, um Sie durch die vollständige Konfiguration der Codex API unter macOS und Windows zu führen.
Was ist Codex?
Codex ist OpenAIs Coding-Agent für die Arbeit an Repositories und im Terminal. Er kann:
Code schreiben: Funktionen, Tests, Skripte und gezielte Features erstellen.
Unbekannte Codebasen verstehen: Dateien durchsuchen, Aufrufe nachverfolgen und Komponenten erklären.
Code überprüfen: Wahrscheinliche Fehler, riskante Annahmen, fehlende Tests und Sicherheitsprobleme identifizieren.
Debuggen und Probleme beheben: Fehler reproduzieren, Änderungen vorschlagen und Prüfungen ausführen.
Routinearbeiten automatisieren: Dateien aktualisieren und dokumentierte Workflows mit Ihrer Zustimmung ausführen.
Codex installieren und anmelden
Teil 1: Codex CLI installieren
Öffnen Sie das Terminal unter macOS oder PowerShell unter Windows.
Führen Sie den Befehl für Ihr Betriebssystem aus:
macOS:
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Warten Sie, bis die Installation abgeschlossen ist, und schließen und öffnen Sie dann das Terminal oder PowerShell erneut.
Führen Sie Folgendes aus:
codexWählen Sie „Mit ChatGPT anmelden“, schließen Sie die Anmeldung im Browser ab und kehren Sie zum Terminal oder zu PowerShell zurück.
Teil 2: Die Codex-Desktop-App installieren
Besuchen Sie die offizielle Seite der Codex-Desktop-App.
Laden Sie die ChatGPT-Desktop-App für macOS oder Windows herunter.
Installieren und öffnen Sie die App und melden Sie sich dann mit Ihrem ChatGPT-Konto an.
Erstellen Sie eine Aufgabe oder öffnen Sie ein Projekt und wählen Sie Codex als Arbeitsmodus.
Geben Sie
Say hello in one sentence.ein und senden Sie die Nachricht.
Integrierte KI-Modelle vs. externe LLM-APIs
Nach der Installation von Codex können Sie dessen integrierte KI-Modelle nutzen oder eine kompatible externe LLM-API verbinden. Die beste Option hängt davon ab, wie viel Einrichtung, Flexibilität und Kontoverwaltung Sie wünschen.
Die integrierten Modelle von Codex nutzen
Integrierte Modelle bieten die einfachste Erfahrung. Sie können ein verfügbares Modell auswählen und mit dem Coden beginnen, ohne einen weiteren Dienst auszuführen oder einen separaten API-Key zu konfigurieren.
Vorteile:
Schnelle Einrichtung ohne zusätzliche Konfigurationsschritte.
Direkte Integration mit Codex-Tools und -Funktionen
Weniger Dienste und Zugangsdaten, die verwaltet werden müssen
Einschränkungen:
Sie können nur aus den Modellen wählen, die für Ihr Konto verfügbar sind
Weniger Flexibilität, wenn Sie ein Modell eines anderen Anbieters nutzen möchten
Erfordert ein GPT-Abonnement, und die Nutzungskosten sind relativ hoch.
Eine externe LLM-API verwenden
Eine externe API bietet Ihnen mehr Modellauswahl und ermöglicht es Ihnen, ein bestehendes Konto bei einem anderen Anbieter zu nutzen. Allerdings erfordern manche Modelle zusätzliche Konfiguration oder ein lokales Kompatibilitäts-Tool, bevor Codex sie verwenden kann.
Vorteile:
Zugriff auf Modelle anderer Anbieter
Mehr Flexibilität für unterschiedliche Coding-Aufgaben
Separate Kontrolle über das externe API-Konto und dessen Nutzung
Kein GPT-Abonnement erforderlich. Ideal für kostensensible Szenarien.
Einschränkungen:
Erfordert einen API-Schlüssel und zusätzliche Konfiguration
Kann einen lokalen Router erfordern, der durchgehend laufen muss
Abrechnung, Kompatibilität, Datenschutz und Fehlerbehebung hängen vom externen Anbieter ab
Wenn Sie die schnellste Einrichtung möchten, beginnen Sie mit einem integrierten Modell. Wenn Sie bereits ein externes API-Konto haben oder mehr Modellauswahl wünschen, folgen Sie der nachstehenden Anleitung. Sie verwendet die Kimi API als praktisches Beispiel, um ein externes Modell mit Codex zu verbinden.
So verbinden Sie eine externe LLM-API mit Codex: Kimi-Beispiel
Einrichtung unter macOS
Schritt 1: Terminal A öffnen und Node.js sowie npm überprüfen
Wo: Drücken Sie Command+Leertaste, geben Sie Terminal ein und drücken Sie Enter. Behandeln Sie dieses erste Fenster als Terminal A.
Ausführen:
node --version
npm --versionErwartetes Ergebnis: Jeder Befehl gibt eine Version aus. Ausgaben wie v22.x.x für Node.js und 10.x.x für npm dienen nur als Beispiele, nicht als Mindestanforderungen.
Wenn ein Befehl nicht gefunden wird: Öffnen Sie einen Browser, rufen Sie https://nodejs.org/en/download auf, laden Sie das LTS-macOS-.pkg herunter, öffnen Sie „Downloads“ im Finder, doppelklicken Sie auf das Paket und übernehmen Sie die Standardeinstellungen des Installationsprogramms. Schließen Sie das Terminal mit Command+Q, öffnen Sie Terminal A erneut und führen Sie beide Versionsbefehle noch einmal aus. Fahren Sie erst fort, wenn beide Befehle Versionen zurückgeben.
Schritt 2: Einen Kimi API-Schlüssel erstellen
Öffnen Sie die Kimi API-Plattform. Erstellen Sie über die Konsole einen API-Schlüssel und speichern Sie ihn dann in einem Passwort-Manager oder Secret-Manager. Wenn Ihre Konsole den vollständigen Schlüssel nur einmal anzeigt, kopieren Sie ihn, bevor Sie die Seite verlassen.
Schritt 3: MOONSHOT_API_KEY in Terminal A setzen
Wo: Kehren Sie zu Terminal A zurück.
Ausführen:
export MOONSHOT_API_KEY="YOUR_KIMI_API_KEY"Ersetzen Sie nur YOUR_KIMI_API_KEY durch Ihren echten Kimi-Schlüssel. Behalten Sie die Anführungszeichen und den Variablennamen MOONSHOT_API_KEY unverändert bei.
Erwartetes Ergebnis: Der Befehl export gibt keine Ausgabe aus. Prüfen Sie, ob ein Wert vorhanden ist, ohne ihn anzuzeigen:
test -n "$MOONSHOT_API_KEY" && echo "Kimi key is set"Das Terminal sollte Kimi key is set ausgeben.
Schritt 4: Kimi direkt aus Terminal A testen
Wo: Verwenden Sie weiterhin Terminal A, in dem MOONSHOT_API_KEY gesetzt ist.
Ausführen:
curl --silent --show-error https://api.moonshot.ai/v1/chat/completions \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"kimi-k2.7-code","messages":[{"role":"user","content":"Say hello in one sentence."}],"stream":false}'Erwartetes Ergebnis: Es erscheint eine JSON-Antwort, die generierten Text unter choices[0].message.content enthält.
Schritt 5: Terminal B öffnen und den Router in Terminal A starten
Wo: Bei aktivem Terminal A Command+N drücken, um ein zweites Fenster zu öffnen. Das neue Fenster Terminal B nennen. Vor dem Ausführen des Router-Befehls zu Terminal A zurückkehren.
In Terminal A ausführen:
npx @codeproxy/cli --base-url https://api.moonshot.ai/v1 --model kimi-k2.7-code --apikey "$MOONSHOT_API_KEY"Die Basis-URL oder das Modell nicht ersetzen. $MOONSHOT_API_KEY muss die Variablenreferenz bleiben und darf nicht durch eine zweite eingefügte Kopie des Schlüssels ersetzt werden.
Mögliche Eingabeaufforderung beim ersten Start: npx kann Need to install ... Ok to proceed? (y) anzeigen. Zunächst den Paketnamen und die verlinkte Drittanbieterquelle prüfen. Nur y eingeben und Enter drücken, wenn dieses Paket akzeptiert wird. Es wird keine konkrete Paketversion als hier getestet angegeben.
Erwartetes Ergebnis: Der Prozess läuft weiter und meldet, dass er auf 127.0.0.1:8787 lauscht. Terminal A geöffnet lassen.
Bei Fehlern: Wenn npm das Paket nicht herunterladen kann, den Internetzugang prüfen und node --version sowie npm --version erneut ausführen. Wenn Port 8787 bereits belegt ist, den anderen lokalen Prozess, der diesen Port nutzt, beenden oder zu dessen Terminal wechseln und Ctrl+C drücken, dann den Router-Befehl erneut ausführen.
Schritt 6: localhost von Terminal B aus testen
Wo: Auf Terminal B klicken.
Ausführen:
curl --no-buffer --show-error http://127.0.0.1:8787/v1/responses \
-H "Content-Type: application/json" \
-d '{"model":"kimi-k2.7-code","input":"Say hello in one sentence.","stream":true}'Erwartetes Ergebnis: Terminal B gibt Responses-ähnliche Streaming-Ereignisse oder eine Ausgabe mit einer einzelnen Begrüßungssatz-Zeile aus. Die genaue Ereignisfolge kann je nach Router-Version variieren.
Wenn Connection refused erscheint: Terminal A prüfen. Wenn der Router gestoppt ist, den Befehl aus Schritt 5 erneut ausführen und das Fenster geöffnet lassen. Zeigt Terminal A einen Upstream-Fehler 401, dort MOONSHOT_API_KEY zurücksetzen und den Router neu starten.
Schritt 7: Die macOS-Codex-Konfiguration erstellen und bearbeiten
Wo: Weiterhin in Terminal B arbeiten.
Ausführen:
mkdir -p "$HOME/.codex"
if [ -f "$HOME/.codex/config.toml" ]; then cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.backup-$(date +%Y%m%d-%H%M%S)"; fi
touch "$HOME/.codex/config.toml"
open -e "$HOME/.codex/config.toml"Diese Befehle erstellen bei Bedarf die Konfigurationsdatei auf Benutzerebene, sichern eine vorhandene Datei und öffnen ~/.codex/config.toml in TextEdit.
Wenn die Datei leer ist
Die folgende vollständige Konfiguration einfügen:
model = "kimi-k2.7-code"
model_provider = "kimi-proxy"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Wenn die Datei bereits Einstellungen enthält
Die vollständige Konfiguration nicht über die vorhandene Datei einfügen. Nicht betroffene Einstellungen beibehalten und nur die erforderlichen Zeilen einzeln aktualisieren.
Die Zeile finden, die mit
model =beginnt, und die gesamte Zeile ersetzen durch:
model = "kimi-k2.7-code"Die Zeile finden, die mit
model_provider =beginnt, und die gesamte Zeile ersetzen durch:
model_provider = "kimi-proxy"Die Zeile finden, die mit
model_context_window =beginnt, und die gesamte Zeile ersetzen durch:
model_context_window = 256000Die Zeile finden, die mit
model_supports_reasoning_summaries =beginnt, und die gesamte Zeile ersetzen durch:
model_supports_reasoning_summaries = falseFalls eine dieser vier Einstellungen noch nicht vorhanden ist, die fehlende Zeile in der Nähe des Dateianfangs hinzufügen.
Jede vollständige Zeile finden und löschen, die beginnt mit:
model_catalog_json =Außerdem jede vollständige Zeile finden und löschen, die beginnt mit:
service_tier =Den folgenden Abschnitt hinzufügen:
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Andere Provider-Abschnitte, wie [model_providers.openai], nicht entfernen.
Nicht betroffene vorhandene Einstellungen beibehalten, einschließlich notify, Genehmigungs-, Sandbox-, Projekt- und Oberflächeneinstellungen. Keine notify-Zeile eines anderen Benutzers kopieren, da sie einen computerspezifischen absoluten Pfad enthalten kann.
Command+S drücken, um die Datei zu speichern, und anschließend TextEdit schließen.
Schritt 8: Codex neu starten und den vollständigen macOS-Test durchführen
Wo: Den Router in Terminal A weiterlaufen lassen. In Terminal B eine bestehende Codex-Sitzung mit Ctrl+C beenden und anschließend einen temporären Ordner vorbereiten.
In Terminal B ausführen:
mkdir -p "$HOME/codex-kimi-test"
cd "$HOME/codex-kimi-test"
codexTest: hello. eingeben und Enter drücken. Eine einsatzfertige Antwort bestätigt einen grundlegenden Anfragepfad.
Windows-Einrichtung
Zwei unabhängige PowerShell-Fenster verwenden. PowerShell A speichert den Kimi-Schlüssel für die aktuelle Sitzung und führt den Router aus. PowerShell B testet localhost, bearbeitet die Konfiguration und startet Codex. Die dauerhafte Benutzervariable unterstützt zukünftige Fenster; die Zuweisung für die aktuelle Sitzung macht den Schlüssel sofort in PowerShell A verfügbar.
Schritt 1: PowerShell A öffnen und Node.js sowie npm überprüfen
Wo: Drücken Sie die Windows-Taste, geben Sie PowerShell ein und öffnen Sie Windows PowerShell. Dieses Fenster nennen wir PowerShell A.
Ausführen:
node --version
npm --versionErwartetes Ergebnis: Beide Befehle geben Versionsnummern aus. Werte wie v22.x.x und 10.x.x sind nur Beispiele, keine Mindestanforderungen.
Falls ein Befehl nicht erkannt wird: Öffnen Sie einen Browser und rufen Sie https://nodejs.org/en/download auf. Laden Sie die LTS-Windows-.msi herunter, öffnen Sie Downloads im Datei-Explorer, doppelklicken Sie auf das Installationsprogramm, übernehmen Sie die Standardeinstellungen und stellen Sie sicher, dass das Installationsprogramm die Option beibehält, Node.js zu PATH hinzuzufügen. Schließen Sie alle PowerShell-Fenster, öffnen Sie PowerShell A erneut und führen Sie beide Befehle erneut aus.
Schritt 2: Einen Kimi-API-Schlüssel erstellen
Öffnen Sie die Kimi-API-Plattform. Erstellen Sie über die Konsole einen API-Schlüssel und speichern Sie ihn anschließend in einem Passwort- oder Secret-Manager. Wenn Ihre Konsole den vollständigen Schlüssel nur einmal anzeigt, kopieren Sie ihn, bevor Sie die Seite verlassen.
Schritt 3: Dauerhafte und sitzungsbezogene Variablen in PowerShell A festlegen
Wo: Kehren Sie zu PowerShell A zurück.
Ausführen:
[Environment]::SetEnvironmentVariable("MOONSHOT_API_KEY", "YOUR_KIMI_API_KEY", "User")
$env:MOONSHOT_API_KEY = "YOUR_KIMI_API_KEY"Ersetzen Sie in beiden Zeilen nur YOUR_KIMI_API_KEY durch denselben Kimi-Schlüssel. Lassen Sie MOONSHOT_API_KEY, User, Anführungszeichen und Satzzeichen unverändert. Die erste Zeile speichert den Wert für künftige Prozesse. Die zweite Zeile macht ihn sofort in PowerShell A verfügbar.
Erwartetes Ergebnis: Beide Befehle geben keine Ausgabe zurück. Überprüfen Sie das Vorhandensein, ohne den Schlüssel anzuzeigen:
$null -ne $env:MOONSHOT_API_KEYPowerShell sollte True ausgeben.
Falls False ausgegeben wird: Führen Sie die sitzungsbezogene Zuweisung mit geraden Anführungszeichen erneut aus. Wurde das Schreiben der User-Variable durch eine Richtlinie blockiert, fahren Sie für dieses Tutorial mit dem sitzungsbezogenen Wert fort und fragen Sie Ihren Administrator, wie Benutzerumgebungsvariablen gespeichert werden sollen. Widerrufen Sie jeden Schlüssel, der in Protokollen oder freigegebenem Text offengelegt wurde.
Schritt 4: Kimi direkt aus PowerShell A testen
API-Referenzen zeigen möglicherweise POST URL an, geben Sie aber niemals POST https://... allein in PowerShell ein. Verwenden Sie Invoke-RestMethod -Method Post wie hier gezeigt.
Wo: Bleiben Sie in PowerShell A, wo $env:MOONSHOT_API_KEY gesetzt ist.
Ausführen:
$headers = @{ Authorization = "Bearer $env:MOONSHOT_API_KEY" }
$body = @{ model = "kimi-k2.7-code"; messages = @(@{ role = "user"; content = "Say hello in one sentence." }); stream = $false } | ConvertTo-Json -Depth 5
$response = Invoke-RestMethod -Method Post -Uri "https://api.moonshot.ai/v1/chat/completions" -Headers $headers -ContentType "application/json" -Body $body
$response.choices[0].message.contentErsetzen Sie den Endpunkt, das Modell oder den Variablennamen nicht. PowerShell liest den Schlüssel aus $env:MOONSHOT_API_KEY.
Erwartetes Ergebnis: Die letzte Zeile gibt eine einsätzige Begrüßung aus choices[0].message.content aus.
Falls Sie 401 erhalten: Prüfen Sie, ob der Schlüssel aus der globalen .ai-Konsole stammt, widerrufen und erstellen Sie ihn bei Bedarf neu, führen Sie beide Zuweisungen aus Schritt 3 erneut aus und versuchen Sie es noch einmal. Wird das Modell abgelehnt, prüfen Sie, ob die ID genau kimi-k2.7-code lautet, und kontrollieren Sie den Modellzugriff in der Kimi-Konsole.
Schritt 5: PowerShell B öffnen und den Router in PowerShell A starten
Wo: Drücken Sie erneut die Windows-Taste, geben Sie PowerShell ein und öffnen Sie ein zweites Windows PowerShell-Fenster. Nennen Sie es PowerShell B. Kehren Sie für den Router-Befehl zu PowerShell A zurück.
In PowerShell A ausführen:
npx @codeproxy/cli --base-url https://api.moonshot.ai/v1 --model kimi-k2.7-code --apikey $env:MOONSHOT_API_KEYLassen Sie $env:MOONSHOT_API_KEY unverändert; fügen Sie den Schlüssel nicht direkt in den Befehl ein.
Mögliche Eingabeaufforderung beim ersten Start: npx zeigt eventuell Need to install ... Ok to proceed? (y) an. Prüfen Sie das Paket und die Drittanbieterquelle. Geben Sie y ein und drücken Sie Enter nur, wenn Sie zustimmen. Es wird keine genaue getestete Paketversion angegeben.
Erwartetes Ergebnis: Der Prozess bleibt geöffnet und meldet, dass er auf 127.0.0.1:8787 lauscht. Lassen Sie PowerShell A geöffnet.
Falls es fehlschlägt: Führen Sie node --version und npm --version in PowerShell A aus. Schlägt eines davon fehl, wiederholen Sie Schritt 1. Ist Port 8787 belegt, beenden Sie den anderen Router mit Ctrl+C in dessen Fenster und führen Sie den Befehl erneut aus.
Schritt 6: Localhost von PowerShell B aus testen
Wo: Klicken Sie auf PowerShell B. Beenden Sie den Router in PowerShell A nicht.
Ausführen:
$localBody = @{ model = "kimi-k2.7-code"; input = "Say hello in one sentence."; stream = $false } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "http://127.0.0.1:8787/v1/responses" -ContentType "application/json" -Body $localBodyErsetzen Sie die Localhost-URL nicht. Sie verweist auf den Router in PowerShell A.
Erwartetes Ergebnis: PowerShell gibt ein Responses-ähnliches Objekt oder eine Ausgabe mit der Begrüßung zurück. Die genauen Felder können je nach Router-Version variieren.
Falls die Verbindung abgelehnt wird: Schauen Sie in PowerShell A nach und starten Sie den Befehl aus Schritt 5 erneut, falls der Router beendet wurde. Zeigt PowerShell A einen Upstream-Authentifizierungsfehler an, drücken Sie Ctrl+C, setzen Sie $env:MOONSHOT_API_KEY zurück und starten Sie den Router neu. Fügen Sie für den Standard-Schnellstart von @codeproxy/cli keinen lokalen Authorization-Header hinzu.
Schritt 7: Die Windows-Codex-Konfiguration erstellen und bearbeiten
Wo: Bleiben Sie in PowerShell B. Die Provider-Konfiguration gehört nach $HOME\.codex\config.toml, nicht in einen Projektordner.
Ausführen:
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
$configPath = "$HOME\.codex\config.toml"
if (Test-Path $configPath) { Copy-Item $configPath "$configPath.backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')" }
if (-not (Test-Path $configPath)) { New-Item -ItemType File -Path $configPath | Out-Null }
notepad "$HOME\.codex\config.toml"Die Befehle erstellen das Benutzerverzeichnis, sichern eine vorhandene Konfiguration, legen die Datei an, falls sie fehlt, und öffnen sie in Notepad.
In Notepad: Fügen Sie diese vollständige Standardkonfiguration ein und entfernen Sie dabei widersprüchliche doppelte Model- oder Provider-Schlüssel, falls die Datei sie bereits enthält:
model_provider = "kimi-proxy"
model = "kimi-k2.7-code"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Ersetzen Sie nicht kimi-proxy, die localhost-URL oder responses. Drücken Sie Ctrl+S und schließen Sie den Editor.
Dateinamen bestätigen: Führen Sie aus:
Get-Item "$HOME\.codex\config.toml" | Select-Object FullName, Name, LengthErwartetes Ergebnis: Name lautet genau config.toml, nicht config.toml.txt, und Length ist größer als null.
Falls der Editor .txt hinzugefügt hat: Wählen Sie im Editor Datei → Speichern unter, stellen Sie Dateityp auf Alle Dateien, geben Sie config.toml ein und speichern Sie es in $HOME\.codex. Führen Sie Get-Item erneut aus. Wenn Codex den Anbieter ignoriert, prüfen Sie, ob Sie den benutzerbezogenen Pfad bearbeitet haben, und entfernen Sie doppelte TOML-Schlüssel.
Schritt 8: Codex neu starten und den vollständigen Windows-Test durchführen
Wo: Lassen Sie PowerShell A und ihren Router weiterlaufen. Schließen Sie jede Codex-App oder -Sitzung vollständig. Schließen Sie PowerShell B, öffnen Sie sie erneut über die Windows-Taste → geben Sie PowerShell ein → öffnen Sie Windows PowerShell, und erstellen Sie einen wegwerfbaren Ordner.
In der neu geöffneten PowerShell B ausführen:
New-Item -ItemType Directory -Force -Path "$HOME\codex-kimi-test" | Out-Null
Set-Location "$HOME\codex-kimi-test"
codexTest: Geben Sie hello. ein und drücken Sie Enter. Eine einsätzige Antwort bestätigt einen grundlegenden Anfragepfad.
Kimi in der Codex-Desktop-App verwenden
Schließen Sie zunächst die Schritte 1–7 der macOS- oder Windows-Einrichtung für den lokalen Router und config.toml ab. Sie müssen den CLI-Test nicht zuerst durchführen, aber der Router muss weiterlaufen, während Sie Kimi in der Desktop-App verwenden.
Schritt 1: Den lokalen Router weiterlaufen lassen
Lassen Sie Terminal A oder PowerShell A geöffnet, während @codeproxy/cli läuft auf:
http://127.0.0.1:8787Schritt 2: Die Anbieterkonfiguration bestätigen
Öffnen Sie die benutzerbezogene Codex-Konfigurationsdatei.
Führen Sie unter macOS aus:
open -e "$HOME/.codex/config.toml"Führen Sie unter Windows aus:
notepad "$HOME\.codex\config.toml"Bestätigen Sie, dass die Datei diese Einstellungen auf oberster Ebene enthält:
model = "kimi-k2.7-code"
model_provider = "kimi-proxy"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Schritt 3: Die Desktop-App vollständig neu starten
Drücken Sie unter macOS Command+Q, um die Desktop-App vollständig zu beenden. Nur das Fenster zu schließen reicht nicht aus.
Schließen Sie unter Windows alle Fenster der Desktop-App und stellen Sie sicher, dass die App nicht mehr im System-Tray läuft.
Öffnen Sie die Desktop-App erneut und öffnen Sie einen Projektordner.
Schritt 4: Custom als ausgewähltes Modell beibehalten
Die Modellauswahl in der Desktop-App zeigt möglicherweise Custom anstelle von Kimi K2.7 Code an. Das ist zu erwarten.
Benutzerdefinierte Anbieter, die in config.toml festgelegt sind, werden in der Desktop-Modellliste nicht immer namentlich angezeigt. Wählen Sie kein OpenAI-Modell wie GPT-5.6 Sol aus, wenn Sie den Kimi-Anbieter verwenden möchten. Behalten Sie Custom ausgewählt.
Möglicherweise sehen Sie auch diese Warnung:
Model metadata for `kimi-k2.7-code` not found.
Defaulting to fallback metadata.Dies ist eine Warnung, kein Verbindungsfehler. Die folgenden Einstellungen liefern bereits die wichtigen Modellinformationen, die für den normalen Betrieb erforderlich sind:
model_context_window = 256000
model_supports_reasoning_summaries = falseSchritt 5: Den Desktop-Anfragepfad überprüfen
Senden Sie diesen Prompt in der Desktop-App:
Beobachten Sie Terminal A oder PowerShell A, während die Desktop-App antwortet. Wenn das Terminal-A-Fenster eine neue Anfrage empfängt und die Desktop-App eine Antwort liefert, verwendet die Desktop-App die lokale Kimi-Route.
Häufige Integrationsfehler beheben
zsh: command not found: POST
POST URL ist eine Notation aus der API-Dokumentation, kein Befehl. Kopieren Sie unter macOS das vollständige curl-Beispiel. Kopieren Sie unter Windows das vollständige Beispiel Invoke-RestMethod -Method Post.
Verbindung an Port 8787 abgelehnt
Kehren Sie zu Terminal A oder PowerShell A zurück. Wenn kein Router-Prozess läuft, setzen Sie die Kimi-Variable für die aktuelle Sitzung und führen Sie den dokumentierten Befehl npx @codeproxy/cli ... erneut aus. Lassen Sie dieses Fenster geöffnet und wiederholen Sie dann den localhost-Test in Fenster B.
Eine 401-Antwort
Lesen Sie das Router-Fenster, um den fehlgeschlagenen Hop zu identifizieren. Ein vorgelagerter 401-Fehler von Kimi bedeutet meist, dass MOONSHOT_API_KEY ungültig, widerrufen oder aus dem falschen Regionalkonto ist. Widerrufen Sie den Schlüssel in der globalen .ai-Konsole, erstellen Sie einen neuen, setzen Sie die Variable für die aktuelle Sitzung zurück und starten Sie den Router neu. Der Standard-Router-Pfad hat keine eingehende Bearer-Prüfung. Ein lokaler 401-Fehler bei einem anderen Adapter kann bedeuten, dass dessen optionaler CODEX_KIMI_PROXY_KEY fehlt oder ungültig ist.
Fehler durch nicht unterstützte Parameter oder Tools
Der Router leitet möglicherweise ein Feld weiter, das Kimi nicht akzeptiert. Sampling-Felder sollten nicht gesetzt sein; falls sie doch übermittelt werden, müssen sie die akzeptierten festen Werte verwenden. Stellen Sie sicher, dass tool_choice auf auto oder none steht und dass der Adapter reasoning_content beibehält. Wenn der mehrstufige Test weiterhin fehlschlägt, verwenden Sie diese Router-Version nicht mehr und wählen oder aktualisieren Sie eine mit expliziter Kimi-Unterstützung.
Codex ignoriert den Anbieter
Öffnen Sie die Benutzerdatei direkt: Führen Sie unter macOS open -e "$HOME/.codex/config.toml" oder unter Windows notepad "$HOME\.codex\config.toml" aus. Vergewissern Sie sich, dass es genau ein model_provider = "kimi-proxy" auf oberster Ebene, eine Provider-Tabelle, die Localhost-Basis-URL und wire_api = "responses" gibt. Speichern Sie die Datei, beenden Sie Codex vollständig und starten Sie es erneut. Legen Sie die Provider-Auswahl nicht nur in einer projektbezogenen .codex/config.toml fest.
npx kann den Router nicht starten
Führen Sie node --version und npm --version in Router-Fenster A aus. Falls einer der Befehle fehlschlägt, installieren Sie das Node.js-LTS-Paket von nodejs.org/download, schließen Sie das Terminal, öffnen Sie es erneut und versuchen Sie es noch einmal. Wenn npx um Erlaubnis bittet, das Paket herunterzuladen, prüfen Sie Paket und Quelle, bevor Sie y eingeben.
Vorteile der Nutzung der Kimi API
Die Verwendung von Kimi in Cursor-API-Workflows kann Coding-, Debugging- und Entwicklungsaufgaben verbessern. Seine fortschrittlichen Fähigkeiten helfen dabei, präzise Antworten zu erzeugen, komplexe Anweisungen zu verarbeiten und schnellere Problemlösungen zu unterstützen. Hier sind die wichtigsten Vorteile der Nutzung von Kimi in Cursor-Workflows für mehr Produktivität und Effizienz.
Verständnis von Code mit langem Kontext
Kimi kann große Mengen an Code und Informationen auf einmal verarbeiten. Es erkennt Zusammenhänge zwischen verschiedenen Dateien und Projektabschnitten effektiver. Dadurch wird die Arbeit mit großen oder komplexen Codebasen deutlich einfacher.
Bessere Dokumentations- und Repository-Analyse
Projektdokumente, technische Notizen und Repositories lassen sich mit Kimi schnell durchsehen. Wichtige Details lassen sich leichter finden, ohne jede Datei manuell durchgehen zu müssen. Entwickler gewinnen in kürzerer Zeit ein klareres Verständnis des gesamten Projekts.
Kosteneffiziente KI-Entwicklung
Kimi bietet eine praktische und budgetfreundliche Option für viele Entwicklungsaufgaben. Leistungsfähige KI-Unterstützung steht zur Verfügung, ohne vollständig auf teurere Modelle angewiesen zu sein. Teams können die Gesamtproduktivität steigern und gleichzeitig die Kosten besser im Griff behalten.
Schnellerer Wissenszugriff
Nützliche Informationen lassen sich schnell über große Codebasen, Datensätze und Projektdateien hinweg finden. Weniger Zeit wird mit der Suche nach Antworten oder Referenzen verbracht. Mehr Aufmerksamkeit kann Coding, Tests und Projektverbesserungen gewidmet werden.
Verbesserte Workflow-Automatisierung
Wiederkehrende Entwicklungsaufgaben lassen sich mit Kimi leichter verwalten und erledigen. Es kann bei Codegenerierung, Inhaltsprüfung und routinemäßigen Projektaktivitäten unterstützen. Tägliche Arbeitsabläufe bleiben so über die Zeit organisiert, effizient und produktiver.
Wie Codex den Entwicklungsworkflow verbessert
Ein konfigurierter Codex-CLI-API-Workflow verbindet Repository-Prüfung, Bearbeitung, Befehle und Review in einem einzigen Kontext. Codex kann Dateien anlegen, unbekannte Module erklären, Fehler reproduzieren, Tests vorschlagen und freigegebene Prüfungen ausführen. Die Unterstützung externer Provider erweitert die Modellauswahl, entbindet aber nicht von der Review-Verantwortung.
Beginnen Sie jede Aufgabe mit einem eng gefassten Ziel. Lassen Sie Codex vor dem Bearbeiten prüfen, überprüfen Sie die vorgeschlagenen Änderungen, genehmigen Sie nur Befehle, die Sie verstehen, führen Sie die Tests des Repositorys aus und prüfen Sie den finalen Diff. Behandeln Sie generierten Code so lange als nicht vertrauenswürdigen Beitrag, bis er Review und Verifizierung bestanden hat.
Fazit
Zuverlässige Codex-API-Nutzung entsteht durch das Testen jeder Ebene der Reihe nach: Codex authentifizieren, Kimi direkt aufrufen, Localhost starten und testen, die Provider-Konfiguration auf Benutzerebene speichern, einen schreibgeschützten Prompt ausführen und eine Datei- und Tool-Aufgabe abschließen. Bewahren Sie den echten Kimi-Schlüssel beim Router auf, halten Sie Geheimnisse aus gemeinsam genutzten Dateien heraus und beenden Sie den Router, wenn Sie fertig sind.