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

# Dépannage

> Symptôme → cause → solution, plus les questions fréquentes

## Tableau rapide

| L’app affiche | Presque sûrement | Solution |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | Clé erronée, caractères manquants, expirée ou désactivée | Collez la clé sur la [page de vérification](https://gpt.teamsoclo.site/check) |
| `404 Not Found` | Base URL sans `/v1` (ou doublée en `/v1/v1`) | Corrigez la Base URL |
| `No available channel for model ... under group ...` | Une clé d’un forfait appelle le modèle de l’autre | Utilisez le modèle de votre forfait, voir [Modèles](/fr/models) |
| `model not found`, erreur immédiate sur le nom | Faute de frappe dans le nom du modèle | Copiez le nom depuis le [tableau des modèles](/fr/models) |
| `429 Too Many Requests` | Limite de requêtes par minute de la clé dépassée | Attendez la minute suivante, ralentissez |
| `insufficient quota` | La clé a utilisé tous ses tokens | Achetez un nouveau code |
| Configuration modifiée mais rien ne change | App pas quittée complètement, ou terminal pas rouvert | Quittez complètement et rouvrez |

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

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

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

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

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

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

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 :

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

Ajoutez la ligne `export` à `~/.bashrc` ou `~/.zshrc`. À long terme, installez Node via nvm, voir [Démarrage](/fr/getting-started).

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

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

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

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

Avec l’outil, choisissez **Reset** et il restaure automatiquement.

## Questions fréquentes

### Comment changer de clé

Relancez la [commande d’installation Codex](/fr/setup/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](/fr/setup/codex). Pour les autres apps, supprimez simplement la clé dans leurs Settings.

## Ça ne marche toujours pas

<Steps>
  <Step title="La clé est-elle vivante">
    Collez-la sur la [page de vérification](https://gpt.teamsoclo.site/check). Une erreur ici signifie la clé (erronée, expirée, sans quota), pas l’app.
  </Step>

  <Step title="Appelez l’API directement avec 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"}]}'
    ```

    Si cela marche et pas l’app, le problème est la configuration de l’app.
  </Step>

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

  <Step title="Contactez le support">
    Envoyez une capture de l’erreur et les 4 derniers caractères de votre clé à [t.me/teamsoclo](https://t.me/teamsoclo). N’envoyez jamais la clé complète.
  </Step>
</Steps>


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