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

# Probleemoplossing

> Symptoom → oorzaak → oplossing, plus veelgestelde vragen

## Snelle opzoeking

| De app zegt | Hoogstwaarschijnlijk | Oplossing |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | Verkeerde sleutel, ontbrekende tekens, verlopen of uitgeschakeld | Plak de sleutel op de [controlpagina](https://gpt.teamsoclo.site/check) |
| `404 Not Found` | Base URL mist `/v1` (of verdubbeld naar `/v1/v1`) | Base URL corrigeren |
| `No available channel for model ... under group ...` | Een sleutel van het ene pakket roept het model van het andere pakket aan | Gebruik het model van jouw pakket, zie [Modellen](/nl/models) |
| `model not found`, onmiddellijke modelnaamfout | Typfout in de modelnaam | Naam kopiëren uit de [modeltabel](/nl/models) |
| `429 Too Many Requests` | Boven het verzoeken-per-minuut-limiet van de sleutel | Wacht op de volgende minuut, vertraag |
| `insufficient quota` | Sleutel heeft alle tokens gebruikt | Koop een nieuwe code |
| Configuratie bewerkt maar niets verandert | App niet volledig gesloten of terminal niet heropend | Volledig sluiten en heropenen |

## Sleutels en quota

### Verkeerde of afgeknipte sleutel

Het meest voorkomende probleem is geen kapotte sleutel maar **een paar verloren tekens** bij het selecteren met de muis. Gebruik altijd de **Copy**-knop op de inwisselpagina. Plak de sleutel op de [controlpagina](https://gpt.teamsoclo.site/check): als die hem als geldig meldt, is de sleutel in orde en zit het probleem in de app-configuratie.

### Sleutel verlopen

Elk pakket heeft een geldigheidsduur geteld vanaf inwisseling (staat op het product). Na verlopen geeft elk verzoek 401 terug, ook als er nog quota is. De controlpagina toont de vervaldatum. Ongebruikte tokens worden niet overgedragen naar een nieuwe code.

### Quota opgebruikt

Alles werkte, dan mislukt plotseling elk verzoek met *insufficient quota*. Kijk wat er over is op de controlpagina. Quota die ongewoon snel daalt is meestal een agent die de hele repo leest, of een heel lang gesprek dat elke beurt opnieuw gestuurd wordt.

### Sleutel kwijt

Wissel dezelfde CDK-code opnieuw in op [redeem.teamsoclo.site](https://redeem.teamsoclo.site); de pagina toont de originele sleutel. Codes worden niet opnieuw uitgegeven met een nieuwe sleutel.

### Hoeveel machines per sleutel

Er is geen apparaatlimiet, maar het **verzoeken-per-minuut-limiet** wordt gedeeld door elke machine die de sleutel gebruikt. Een sleutel delen betekent dat gebruikers concurreren voor hetzelfde limiet en eerder 429 krijgen.

## Verbinding

### Ontbrekende /v1

De correcte Base URL is `https://gpt.teamsoclo.site/v1`. Zonder `/v1` treffen verzoeken de website in plaats van de API, en rapporteert de app 404 of "kon niet verbinden".

<Warning>
  Het tegendeel werkt ook niet: sommige apps (Chatbox, sommige Cline-builds) voegen `/v1` zelf toe. Als je het hebt ingevoerd en toch 404 krijgt, probeer het zonder `/v1`; het echte adres kan `/v1/v1` zijn geworden.
</Warning>

### Het model van het andere pakket aanroepen

`No available channel for model gpt-astra under group default` betekent dat een GPT-sleutel het Astra-model aanroept (of omgekeerd). Elke sleutel kan alleen het model van zijn eigen pakket aanroepen. Controleer met:

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

### 429 Too Many Requests

Elke sleutel heeft een maximum aantal geslaagde verzoeken per minuut ingesteld door zijn pakket. Daarboven krijg je 429 met een "request limit reached"-bericht. Wacht op de volgende minuut. Voeg voor batchscripts een vertraging toe tussen aanroepen, of koop een andere code om de belasting te spreiden.

### Antwoord halverwege afgekapt

Voor vragen die lang nadenken vereisen, kan een niet-streamingverzoek worden afgebroken vóór het eerste token. Schakel `stream: true` in. De meeste chat-apps doen dit al; voeg het toe bij aanroepen vanuit code.

### `Unsupported parameter: reasoning_effort`

Alleen Chat Completions accepteert een top-level `reasoning_effort`. Met de Responses API gebruik `"reasoning": {"effort": "high"}`. Codex verwerkt dit zelf.

## Codex

### `codex: command not found` na installeren

npm heeft klaargemeld maar de huidige terminal heeft PATH niet opnieuw geladen. **Open een nieuwe terminal**. Als het nog steeds mislukt, controleer of de bin-map van npm in PATH staat:

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

Die map plus `/bin` moet in `$PATH` staan.

### Codex vraagt nog steeds om OpenAI-login

De `TEAMSOCLO_API_KEY`-variabele heeft het Codex-proces niet bereikt:

* Terminal: open een nieuw tabblad, controleer `echo $TEAMSOCLO_API_KEY`.
* VS Code op macOS: sluit met `Cmd + Q` en open opnieuw. Het installatiecommando stelde de variabele in voor GUI-apps via `launchctl`.
* VS Code op Linux: start VS Code vanuit een terminal (`code .`), of log uit en opnieuw in.
* Windows: open een **nieuw** PowerShell of VS Code na `setx`.

Controleer of `config.toml` `requires_openai_auth = false` en `env_key = "TEAMSOCLO_API_KEY"` bevat.

### config.toml bewerkt maar Codex verandert niet

Configuratie wordt alleen bij processtart gelezen. **Reload Window is niet genoeg**; sluit VS Code volledig (macOS `Cmd + Q`, Windows sluit elk venster en achtergrondproces). Dit is de meest gestelde Codex-vraag.

### `EACCES: permission denied` bij npm install

Node was geïnstalleerd met systeemprivileges, veelvoorkomend op Linux. Wijzig het npm-prefix:

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

Voeg de `export`-regel toe aan `~/.bashrc` of `~/.zshrc`. Op de lange termijn: installeer Node via nvm, zie [Aan de slag](/nl/getting-started).

### Windows: `running scripts is disabled on this system`

PowerShell blokkeert `.ps1`-bestanden, en `codex` / `npm` getypt in PowerShell gaan via npm's `.ps1`-shims. Eén keer uitvoeren:

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

Dan een nieuw PowerShell openen. Of typ `codex.cmd`, `npm.cmd` in plaats daarvan.

### Windows: `EBUSY: resource busy or locked`

Codex loopt (CLI, extensie of app) zodat npm `codex.exe` niet kan overschrijven. Sluit alles wat Codex uitvoert en voer het installatiecommando opnieuw uit. De configuratie was al geschreven voor deze stap; alleen de CLI-upgrade werd overgeslagen.

### Windows: configuratiebestand-coderingsfout

Bewerken met PowerShell 5.1 en `Set-Content -Encoding UTF8` voegt een BOM toe die Codex niet kan lezen. Gebruik het [installatiecommando](/nl/setup/codex) opnieuw (schrijft UTF‑8 zonder BOM), of sla het bestand op in VS Code als **UTF-8** (niet UTF-8 met BOM).

### Vorige configuratie herstellen

Elke run van het installatiecommando maakt een back-up van de oude configuratie naast de nieuwe:

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

Met het tool kies **Terugzetten** en het herstelt automatisch.

## Veelgestelde vragen

### Hoe verander ik sleutels

Voer het [Codex-installatiecommando](/nl/setup/codex) opnieuw uit met de nieuwe sleutel, of start het tool opnieuw. Voor Cursor, Cline en Chatbox bewerk het API Key-veld in Instellingen.

### Is het veilig om het installatiecommando meerdere keren uit te voeren

Ja. Het is ontworpen voor herhaalde uitvoering: de oude configuratie wordt opgeslagen als `.bak.<timestamp>`, de CLI wordt bijgewerkt en de oude sleutelregel in je shell-rc wordt vervangen.

### Stuurt het commando mijn sleutel ergens naartoe

Nee. Je plakt de sleutel in het commando op je eigen machine; het schrijft alleen een omgevingsvariabele en een lokaal configuratiebestand. Het volledige commando wordt op de pagina getoond, lees elke regel vóór het uitvoeren.

### Alles verwijderen

Zie **Verwijderen** op de [Codex](/nl/setup/codex)-pagina. Voor andere apps verwijder gewoon de sleutel in de app-instellingen.

## Werkt nog steeds niet

<Steps>
  <Step title="Is de sleutel actief">
    Plak hem op de [controlpagina](https://gpt.teamsoclo.site/check). Een fout hier betekent de sleutel (verkeerd, verlopen, geen quota), niet de app.
  </Step>

  <Step title="Roep de API direct aan met cURL">
    ```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"}]}'
    ```

    Als dit werkt en de app niet, zit het probleem in de app-configuratie.
  </Step>

  <Step title="Controleer drie dingen in de app opnieuw">
    Base URL eindigt op `/v1`, de sleutel is volledig, het model past bij je pakket. Deze veroorzaken bijna elk probleem.
  </Step>

  <Step title="Contact opnemen met support">
    Stuur een screenshot van de fout en de laatste 4 tekens van je sleutel naar [t.me/teamsoclo](https://t.me/teamsoclo). Stuur nooit de volledige sleutel.
  </Step>
</Steps>


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