Skip to main content

​
Schnelle Übersicht

​
Schlüssel und Kontingent

​
Falscher oder abgeschnittener Schlüssel

Das häufigste Problem ist kein defekter Schlüssel, sondern ein paar verlorene Zeichen beim Markieren mit der Maus. Verwende immer die Copy-Schaltfläche auf der Einlöseseite. Füge den Schlüssel auf der Prüfseite ein: wenn sie ihn als gültig meldet, ist der Schlüssel in Ordnung und das Problem liegt in der App-Konfiguration.

​
Schlüssel abgelaufen

Jedes Paket hat eine Gültigkeitsdauer ab Einlösung (steht auf dem Produkt). Nach Ablauf gibt jede Anfrage 401 zurück, auch wenn noch Kontingent vorhanden ist. Die Prüfseite zeigt das Ablaufdatum. Ungenutzte Tokens werden nicht auf einen neuen Code übertragen.

​
Kontingent aufgebraucht

Alles funktionierte, dann schlägt plötzlich jede Anfrage mit insufficient quota fehl. Prüfe das Verbleibende auf der Prüfseite. Ungewöhnlich schnell sinkendes Kontingent liegt meist an einem Agenten, der das gesamte Repo liest, oder an einem sehr langen Gespräch, das bei jedem Durchgang neu gesendet wird.

​
Schlüssel verloren

Löse denselben CDK-Code erneut bei redeem.teamsoclo.site ein; die Seite zeigt den ursprünglichen Schlüssel. Codes werden nicht mit einem neuen Schlüssel neu ausgegeben.

​
Wie viele Geräte pro Schlüssel

Es gibt kein Gerätlimit, aber das Anfragen-pro-Minute-Limit wird von jedem Gerät geteilt, das den Schlüssel verwendet. Das Teilen eines Schlüssels bedeutet, dass Nutzer um dasselbe Limit konkurrieren und früher 429 erhalten.

​
Verbindung

​
Fehlendes /v1

Die korrekte Base URL ist https://gpt.teamsoclo.site/v1. Ohne /v1 treffen Anfragen die Website statt der API, und die App meldet 404 oder „konnte nicht verbinden”.
Das Gegenteil schlägt auch fehl: Einige Apps (Chatbox, einige Cline-Builds) hängen /v1 selbst an. Wenn du es eingegeben hast und trotzdem 404 erhältst, versuche es ohne /v1; die eigentliche Adresse könnte /v1/v1 geworden sein.

​
Das Modell des anderen Pakets aufrufen

No available channel for model gpt-astra under group default bedeutet, ein GPT-Schlüssel ruft das Astra-Modell auf (oder umgekehrt). Jeder Schlüssel kann nur das Modell seines eigenen Pakets aufrufen. Prüfe mit:

​
429 Too Many Requests

Jeder Schlüssel hat eine maximale Anzahl erfolgreicher Anfragen pro Minute, festgelegt durch sein Paket. Darüber erhältst du 429 mit einer „request limit reached”-Meldung. Warte auf die nächste Minute. Füge für Batch-Skripte eine Verzögerung zwischen Aufrufen ein oder kaufe einen weiteren Code, um die Last zu verteilen.

​
Antwort mittendrin abgeschnitten

Bei Fragen, die langes Denken erfordern, kann eine nicht-streamende Anfrage vor dem ersten Token unterbrochen werden. Aktiviere stream: true. Die meisten Chat-Apps tun das bereits; füge es beim Aufruf aus Code hinzu.

​
Unsupported parameter: reasoning_effort

Nur Chat Completions akzeptiert ein Top-Level-reasoning_effort. Bei der Responses API verwende "reasoning": {"effort": "high"}. Codex erledigt das selbst.

​
Codex

​
codex: command not found nach der Installation

npm hat abgeschlossen, aber das aktuelle Terminal hat PATH nicht neu geladen. Öffne ein neues Terminal. Falls es immer noch fehlschlägt, prüfe, ob der bin-Ordner von npm in PATH ist:
Dieser Ordner plus /bin muss in $PATH sein.

​
Codex fordert weiterhin OpenAI-Login an

Die TEAMSOCLO_API_KEY-Variable hat den Codex-Prozess nicht erreicht:
  • Terminal: Öffne einen neuen Tab, prüfe echo $TEAMSOCLO_API_KEY.
  • VS Code auf macOS: Mit Cmd + Q beenden und neu öffnen. Der Installationsbefehl setzte die Variable für GUI-Apps via launchctl.
  • VS Code auf Linux: Starte VS Code von einem Terminal (code .), oder melde dich ab und wieder an.
  • Windows: Öffne nach setx ein neues PowerShell oder VS Code.
Prüfe, ob config.toml requires_openai_auth = false und env_key = "TEAMSOCLO_API_KEY" enthält.

​
config.toml bearbeitet, aber Codex ändert sich nicht

Konfiguration wird nur beim Prozessstart gelesen. Reload Window reicht nicht; beende VS Code vollständig (macOS Cmd + Q, Windows alle Fenster und Hintergrundprozesse schließen). Das ist die am häufigsten gestellte Codex-Frage.

​
EACCES: permission denied bei npm install

Node wurde mit Systemprivilegien installiert, häufig unter Linux. Ändere den npm-Präfix:
Füge die export-Zeile zu ~/.bashrc oder ~/.zshrc hinzu. Langfristig: installiere Node via nvm, siehe Erste Schritte.

​
Windows: running scripts is disabled on this system

PowerShell blockiert .ps1-Dateien, und codex / npm in PowerShell laufen über npm-.ps1-Shims. Einmal ausführen:
Dann ein neues PowerShell öffnen. Oder codex.cmd, npm.cmd eingeben.

​
Windows: EBUSY: resource busy or locked

Codex läuft (CLI, Erweiterung oder App), sodass npm codex.exe nicht überschreiben kann. Alles, was Codex ausführt, schließen und den Installationsbefehl erneut ausführen. Die Konfiguration wurde bereits vor diesem Schritt geschrieben; nur das CLI-Upgrade wurde übersprungen.

​
Windows: Konfigurationsdatei-Kodierungsfehler

Bearbeitung mit PowerShell 5.1 und Set-Content -Encoding UTF8 fügt eine BOM hinzu, die Codex nicht lesen kann. Verwende den Installationsbefehl erneut (schreibt UTF‑8 ohne BOM), oder speichere die Datei in VS Code als UTF-8 (nicht UTF-8 mit BOM).

​
Vorherige Konfiguration wiederherstellen

Jeder Lauf des Installationsbefehls sichert die alte Konfiguration neben der neuen:
Mit dem Tool wähle Zurücksetzen und es wird automatisch wiederhergestellt.

​
Häufig gestellte Fragen

​
Wie ändere ich Schlüssel

Führe den Codex-Installationsbefehl erneut mit dem neuen Schlüssel aus, oder starte das Tool neu. Für Cursor, Cline und Chatbox bearbeite das API-Key-Feld in den Einstellungen.

​
Ist es sicher, den Installationsbefehl mehrmals auszuführen

Ja. Es ist für Neuausführungen konzipiert: die alte Konfiguration wird als .bak.<timestamp> gespeichert, die CLI wird aktualisiert und die alte Schlüsselzeile in deiner Shell-RC wird ersetzt.

​
Sendet der Befehl meinen Schlüssel irgendwohin

Nein. Du fügst den Schlüssel in den Befehl auf deinem eigenen Rechner ein; er schreibt nur eine Umgebungsvariable und eine lokale Konfigurationsdatei. Der gesamte Befehl wird auf der Seite angezeigt, lies jede Zeile vor dem Ausführen.

​
Alles entfernen

Siehe Deinstallation auf der Codex-Seite. Für andere Apps einfach den Schlüssel in den App-Einstellungen löschen.

​
Immer noch nicht funktionierend

1

Ist der Schlüssel aktiv

Füge ihn auf der Prüfseite ein. Ein Fehler hier bedeutet, der Schlüssel ist falsch (falsch, abgelaufen, kein Kontingent), nicht die App.
2

API direkt mit cURL aufrufen

Wenn das funktioniert und die App nicht, liegt das Problem in der App-Konfiguration.
3

Drei Dinge in der App erneut prüfen

Base URL endet mit /v1, der Schlüssel ist vollständig, das Modell passt zu deinem Paket. Diese verursachen fast jedes Problem.
4

Support kontaktieren

Sende einen Screenshot des Fehlers und die letzten 4 Zeichen deines Schlüssels an t.me/teamsoclo. Sende niemals den vollständigen Schlüssel.