Skip to main content

​
Tableau rapide

​
Clés et quota

​
Clé erronée ou tronquée

Le problème le plus courant n’est pas une clé cassée mais quelques caractères perdus en sélectionnant le texte à la souris. Utilisez toujours le bouton Copy de la page d’échange. Collez la clé sur la page de vérification : si elle est valide, la clé va bien et le problème est dans la configuration de l’app.

​
Clé expirée

Chaque forfait a une durée de validité comptée depuis l’échange (indiquée sur le produit). Après expiration, toute requête renvoie 401 même s’il reste du quota. La page de vérification montre la date d’expiration. Les tokens non utilisés ne sont pas transférés vers un nouveau code.

​
Quota épuisé

Tout marchait, puis soudain chaque requête échoue avec insufficient quota. Regardez ce qu’il reste sur la page de vérification. Un quota qui baisse anormalement vite vient généralement d’un agent qui lit tout le dépôt, ou d’une très longue conversation renvoyée à chaque tour.

​
Clé perdue

Échangez à nouveau le même code CDK sur redeem.teamsoclo.site ; la page affiche la clé d’origine. Aucun code n’est réémis avec une nouvelle clé.

​
Combien de machines par clé

Pas de limite d’appareils, mais la limite de requêtes par minute est partagée par toutes les machines utilisant la clé. Partager une clé, c’est se disputer la même limite et atteindre 429 plus vite.

​
Connexion

​
/v1 manquant

La Base URL correcte est https://gpt.teamsoclo.site/v1. Sans /v1, les requêtes arrivent sur le site web au lieu de l’API et l’app affiche 404 ou « impossible de se connecter ».
L’inverse échoue aussi : certaines apps (Chatbox, certaines versions de Cline) ajoutent /v1 elles-mêmes. Si vous l’avez saisi et avez toujours 404, essayez sans /v1 ; l’adresse réelle est peut-être devenue /v1/v1.

​
Appel du modèle de l’autre forfait

No available channel for model gpt-astra under group default signifie qu’une clé GPT appelle le modèle Astra (ou l’inverse). Chaque clé n’appelle que le modèle de son forfait. Vérifiez avec :

​
429 Too Many Requests

Chaque clé a un nombre maximal de requêtes réussies par minute fixé par son forfait. Au-delà, vous recevez 429 avec un message « request limit reached ». Attendez la minute suivante. Pour les scripts par lots, ajoutez un délai entre les appels, ou achetez un autre code pour répartir la charge.

​
Réponse coupée en cours

Pour les questions qui demandent une longue réflexion, une requête sans streaming peut être coupée avant le premier token. Activez stream: true. La plupart des apps de chat le font déjà ; ajoutez-le quand vous appelez depuis du code.

​
Unsupported parameter: reasoning_effort

Seul Chat Completions accepte reasoning_effort au niveau racine. Avec la Responses API, utilisez "reasoning": {"effort": "high"}. Codex gère cela lui-même.

​
Codex

​
codex: command not found après l’installation

npm a terminé mais le terminal courant n’a pas rechargé le PATH. Ouvrez un nouveau terminal. Si ça échoue encore, vérifiez que le dossier bin de npm est dans le PATH :
Ce dossier plus /bin doit être dans $PATH.

​
Codex demande toujours une connexion OpenAI

La variable TEAMSOCLO_API_KEY n’a pas atteint le processus Codex :
  • Terminal : ouvrez un nouvel onglet, vérifiez echo $TEAMSOCLO_API_KEY.
  • VS Code sous macOS : quittez avec Cmd + Q et rouvrez. La commande d’installation a défini la variable pour les apps graphiques via launchctl.
  • VS Code sous Linux : lancez VS Code depuis un terminal (code .), ou déconnectez-vous puis reconnectez-vous.
  • Windows : ouvrez un nouveau PowerShell ou VS Code après setx.
Vérifiez que config.toml contient requires_openai_auth = false et env_key = "TEAMSOCLO_API_KEY".

​
config.toml modifié mais Codex ne change pas

La configuration n’est lue qu’au démarrage du processus. Reload Window ne suffit pas ; quittez VS Code complètement (macOS Cmd + Q, Windows fermez toutes les fenêtres et processus en arrière-plan). C’est la question Codex la plus fréquente.

​
EACCES: permission denied à l’installation npm

Node a été installé avec des privilèges système, fréquent sous Linux. Changez le prefix de npm :
Ajoutez la ligne export à ~/.bashrc ou ~/.zshrc. À long terme, installez Node via nvm, voir Démarrage.

​
Windows : running scripts is disabled on this system

PowerShell bloque les fichiers .ps1, et codex / npm tapés dans PowerShell passent par les shims .ps1 de npm. Exécutez une fois :
Puis ouvrez un nouveau PowerShell. Ou tapez codex.cmd, npm.cmd à la place.

​
Windows : EBUSY: resource busy or locked

Codex est en cours d’exécution (CLI, extension ou app), npm ne peut donc pas remplacer codex.exe. Fermez tout ce qui exécute Codex et relancez la commande d’installation. La configuration était déjà écrite avant cette étape ; seule la mise à jour de la CLI a été sautée.

​
Windows : erreur d’encodage du fichier de configuration

Éditer avec PowerShell 5.1 et Set-Content -Encoding UTF8 ajoute un BOM que Codex ne peut pas lire. Relancez la commande d’installation (écrit en UTF‑8 sans BOM), ou enregistrez le fichier dans VS Code en UTF-8 (pas UTF-8 with BOM).

​
Restaurer la configuration précédente

Chaque exécution de la commande d’installation sauvegarde l’ancienne configuration à côté de la nouvelle :
Avec l’outil, choisissez Reset et il restaure automatiquement.

​
Questions fréquentes

​
Comment changer de clé

Relancez la commande d’installation Codex avec la nouvelle clé, ou relancez l’outil. Pour Cursor, Cline et Chatbox, modifiez le champ API Key dans Settings.

​
Peut-on exécuter la commande d’installation plusieurs fois

Oui. Elle est conçue pour être relancée : l’ancienne configuration est enregistrée en .bak.<horodatage>, la CLI est mise à jour, et l’ancienne ligne de clé de votre rc shell est remplacée.

​
La commande envoie-t-elle ma clé quelque part

Non. Vous collez la clé dans la commande sur votre propre machine ; elle n’écrit qu’une variable d’environnement et un fichier de configuration local. La commande entière est affichée sur la page, lisez chaque ligne avant de l’exécuter.

​
Tout supprimer

Voir Désinstaller sur la page Codex. Pour les autres apps, supprimez simplement la clé dans leurs Settings.

​
Ça ne marche toujours pas

1

La clé est-elle vivante

Collez-la sur la page de vérification. Une erreur ici signifie la clé (erronée, expirée, sans quota), pas l’app.
2

Appelez l’API directement avec cURL

Si cela marche et pas l’app, le problème est la configuration de l’app.
3

Revérifiez trois choses dans l’app

La Base URL finit par /v1, la clé est complète, le modèle correspond à votre forfait. Cela cause presque tous les problèmes.
4

Contactez le support

Envoyez une capture de l’erreur et les 4 derniers caractères de votre clé à t.me/teamsoclo. N’envoyez jamais la clé complète.