Skip to main content

Snelle opzoeking

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: 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; 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”.
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.

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:

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:
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:
Voeg de export-regel toe aan ~/.bashrc of ~/.zshrc. Op de lange termijn: installeer Node via nvm, zie Aan de slag.

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:
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 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:
Met het tool kies Terugzetten en het herstelt automatisch.

Veelgestelde vragen

Hoe verander ik sleutels

Voer het Codex-installatiecommando 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-pagina. Voor andere apps verwijder gewoon de sleutel in de app-instellingen.

Werkt nog steeds niet

1

Is de sleutel actief

Plak hem op de controlpagina. Een fout hier betekent de sleutel (verkeerd, verlopen, geen quota), niet de app.
2

Roep de API direct aan met cURL

Als dit werkt en de app niet, zit het probleem in de app-configuratie.
3

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

Contact opnemen met support

Stuur een screenshot van de fout en de laatste 4 tekens van je sleutel naar t.me/teamsoclo. Stuur nooit de volledige sleutel.