> ## 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émarrage

> Acheter un code, l’échanger contre une clé, installer Node.js, choisir un outil

<Steps>
  <Step title="Acheter un code CDK">
    Les codes ressemblent à `TSL-XXXX-XXXX-XXXX` et sont vendus par forfait :

    | Forfait | Modèle | Vendu en |
    | - | - | - |
    | **GPT** | `gpt-5.6-sol` | Crédits (10M, 20M, 50M, 100M, 200M, 500M, 1B) |
    | **GPT Astra** | `gpt-astra` | Tokens (5M, 10M, 20M, 50M, 100M, 200M, 500M, 1B) |
    | **Claude** | `claude-opus-5`, `claude-fable-5-1`, `claude-sonnet-5`, `claude-haiku-4-5`… | Crédits (10M, 20M, 50M, 100M, 200M, 300M, 500M, 1B) |

    Chaque forfait a une **durée de validité comptée à partir de l’échange** (indiquée sur le produit, ex. 1 jour, 2 jours, 5 jours). À l’expiration ou quand le quota est épuisé, la clé s’arrête ; le reste n’est pas reporté sur une nouvelle clé.

    Annonces et support : [t.me/teamsoclo](https://t.me/teamsoclo).
  </Step>

  <Step title="Échanger le code contre une clé API">
    Ouvrez **[redeem.teamsoclo.site](https://redeem.teamsoclo.site)**, collez le code, échangez. Vous obtenez une clé `sk-...` et les instructions de votre forfait.

    <Warning>
      Copiez la clé avec le bouton **Copy**, pas en sélectionnant le texte. Les clés sont longues et il est facile de perdre un caractère à une extrémité ; cela apparaît ensuite comme `401 Unauthorized`, pas comme « copie incomplète ».
    </Warning>

    Clé perdue ? Échangez à nouveau le même code : la page affiche la même clé. Quota restant et expiration : [gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check).
  </Step>

  <Step title="Installer Node.js (seulement pour Codex CLI)">
    Codex CLI s’installe via `npm`, il faut donc **Node.js 18 ou plus récent**. Vérifiez :

    ```bash theme={null}
    node --version
    ```

    S’il manque, installez-le selon votre OS :

    <Tabs>
      <Tab title="macOS">
        ```bash theme={null}
        brew install node
        ```

        Ou téléchargez l’installateur sur [nodejs.org](https://nodejs.org).
      </Tab>

      <Tab title="Linux">
        ```bash theme={null}
        curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
        nvm install --lts
        ```

        nvm évite les erreurs de permission `EACCES` avec les paquets globaux.
      </Tab>

      <Tab title="Windows">
        ```powershell theme={null}
        winget install OpenJS.NodeJS.LTS
        ```

        Ou téléchargez l’installateur sur [nodejs.org](https://nodejs.org).
      </Tab>
    </Tabs>

    Cursor, Cline et Chatbox n’ont pas besoin de Node.js.
  </Step>

  <Step title="Choisir un outil et le configurer">
    <CardGroup cols={2}>
      <Card title="Codex" icon="terminal" href="/fr/setup/codex">
        CLI + extension VS Code + app, une commande pour les trois
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/fr/setup/claude-code">
        CLI + extension, une commande, clé du forfait Claude requise
      </Card>

      <Card title="Cursor" icon="mouse-pointer-2" href="/fr/setup/cursor">
        Remplacer la Base URL dans Settings → Models
      </Card>

      <Card title="Cline / Roo Code" icon="bot" href="/fr/setup/cline">
        Fournisseur OpenAI Compatible
      </Card>

      <Card title="Chatbox" icon="message-square" href="/fr/setup/chatbox">
        Web et bureau
      </Card>
    </CardGroup>
  </Step>
</Steps>

## Comment le quota est compté

Les clés sont facturées aux **tokens réellement utilisés** (entrée + sortie), exactement le `usage` renvoyé par l’API à chaque requête. Pas de frais cachés, pas de tokens injectés.

* Forfait **GPT** : 10M crédits = 10M tokens `gpt-5.6-sol`.
* Forfait **GPT Astra** : 10M = 10M tokens `gpt-astra`. Une clé Astra n’appelle que `gpt-astra` ; une clé GPT n’appelle que `gpt-5.6-sol`.
* Forfait **Claude** : les crédits sont facturés par modèle, Opus 5 ≈ 1 crédit/token, Fable ≈ 2, Sonnet/Haiku moins chers. Une clé Claude n’appelle que les modèles `claude-*`.

<Tip>
  L’économie la plus efficace : **commencez une nouvelle conversation quand vous changez de sujet**. Chaque tour renvoie tout l’historique ; le message 51 d’un long chat coûte bien plus que le premier. Dans Cursor et Cline, indiquez les fichiers exacts à l’agent plutôt que de le laisser parcourir tout le dépôt.
</Tip>


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