> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamsoclo.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fehlerbehebung

> Symptom → Ursache → Lösung, plus häufig gestellte Fragen

## Schnelle Übersicht

| Die App sagt | Höchstwahrscheinlich | Lösung |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | Falscher Schlüssel, fehlende Zeichen, abgelaufen oder deaktiviert | Schlüssel auf der [Prüfseite](https://gpt.teamsoclo.site/check) eingeben |
| `404 Not Found` | Base URL fehlt `/v1` (oder verdoppelt zu `/v1/v1`) | Base URL korrigieren |
| `No available channel for model ... under group ...` | Ein Schlüssel eines Pakets ruft das Modell des anderen Pakets auf | Modell des eigenen Pakets verwenden, siehe [Modelle](/de/models) |
| `model not found`, sofortiger Modellnamen-Fehler | Tippfehler im Modellnamen | Name aus der [Modelltabelle](/de/models) kopieren |
| `429 Too Many Requests` | Über dem Anfragen-pro-Minute-Limit des Schlüssels | Auf die nächste Minute warten, verlangsamen |
| `insufficient quota` | Schlüssel hat alle Tokens verbraucht | Neuen Code kaufen |
| Konfiguration bearbeitet, aber nichts ändert sich | App nicht vollständig beendet oder Terminal nicht neu geöffnet | Vollständig beenden und neu öffnen |

## 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](https://gpt.teamsoclo.site/check) 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](https://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".

<Warning>
  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.
</Warning>

### 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:

```bash theme={null}
curl https://gpt.teamsoclo.site/v1/models -H "Authorization: Bearer sk-xxx"
```

### 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:

```bash theme={null}
npm config get prefix
```

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:

```bash theme={null}
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
```

Füge die `export`-Zeile zu `~/.bashrc` oder `~/.zshrc` hinzu. Langfristig: installiere Node via nvm, siehe [Erste Schritte](/de/getting-started).

### 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:

```powershell theme={null}
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```

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](/de/setup/codex) 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:

```bash theme={null}
ls ~/.codex/*.bak.*
cp ~/.codex/config.toml.bak.20260925143000 ~/.codex/config.toml
```

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](/de/setup/codex) 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](/de/setup/codex)-Seite. Für andere Apps einfach den Schlüssel in den App-Einstellungen löschen.

## Immer noch nicht funktionierend

<Steps>
  <Step title="Ist der Schlüssel aktiv">
    Füge ihn auf der [Prüfseite](https://gpt.teamsoclo.site/check) ein. Ein Fehler hier bedeutet, der Schlüssel ist falsch (falsch, abgelaufen, kein Kontingent), nicht die App.
  </Step>

  <Step title="API direkt mit cURL aufrufen">
    ```bash theme={null}
    curl https://gpt.teamsoclo.site/v1/chat/completions \
      -H "Authorization: Bearer sk-xxx" \
      -H "Content-Type: application/json" \
      -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"hi"}]}'
    ```

    Wenn das funktioniert und die App nicht, liegt das Problem in der App-Konfiguration.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Support kontaktieren">
    Sende einen Screenshot des Fehlers und die letzten 4 Zeichen deines Schlüssels an [t.me/teamsoclo](https://t.me/teamsoclo). Sende niemals den vollständigen Schlüssel.
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.