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

# Guida introduttiva

> Acquistare un codice, riscattarlo per ottenere una chiave, installare Node.js, scegliere uno strumento

<Steps>
  <Step title="Acquistare un codice CDK">
    I codici hanno il formato `TSL-XXXX-XXXX-XXXX` e vengono venduti per pacchetto:

    | Pacchetto | Modello | Venduto in |
    | - | - | - |
    | **GPT** | `gpt-5.6-sol` | Crediti (10M, 20M, 50M, 100M, 200M, 500M, 1B) |
    | **GPT Astra** | `gpt-astra` | Token (5M, 10M, 20M, 50M, 100M, 200M, 500M, 1B) |
    | **Claude** | `claude-opus-5`, `claude-fable-5-1`, `claude-sonnet-5`, `claude-haiku-4-5`… | Crediti (10M, 20M, 50M, 100M, 200M, 300M, 500M, 1B) |

    Ogni pacchetto ha un **periodo di validità contato dal momento del riscatto** (indicato sul prodotto, es. 1 giorno, 2 giorni, 5 giorni). Alla scadenza o al termine del credito la chiave si blocca; il credito non utilizzato non viene trasferito a una nuova chiave.

    Annunci e supporto: [t.me/teamsoclo](https://t.me/teamsoclo).
  </Step>

  <Step title="Riscattare il codice per una chiave API">
    Apri **[redeem.teamsoclo.site](https://redeem.teamsoclo.site)**, incolla il codice e riscattalo. Riceverai una chiave `sk-...` con le istruzioni per il tuo pacchetto.

    <Warning>
      Copia la chiave con il pulsante **Copy**, non selezionando il testo. Le chiavi sono lunghe ed è facile perdere un carattere a un'estremità; questo apparirà poi come `401 Unauthorized`, non come "hai copiato male".
    </Warning>

    Hai perso la chiave? Riscatta di nuovo lo stesso codice CDK su [redeem.teamsoclo.site](https://redeem.teamsoclo.site); la pagina mostrerà la stessa chiave. Credito restante e scadenza: [gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check).
  </Step>

  <Step title="Installare Node.js (solo per Codex CLI)">
    Codex CLI si installa tramite `npm`, quindi hai bisogno di **Node.js 18 o superiore**. Verifica:

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

    Se non è installato, installalo per il tuo sistema operativo:

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

        Oppure scarica il programma di installazione da [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 evita errori di permesso `EACCES` con i pacchetti globali.
      </Tab>

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

        Oppure scarica il programma di installazione da [nodejs.org](https://nodejs.org).
      </Tab>
    </Tabs>

    Cursor, Cline e Chatbox non richiedono Node.js.
  </Step>

  <Step title="Scegliere uno strumento e configurarlo">
    <CardGroup cols={2}>
      <Card title="Codex" icon="terminal" href="/it/setup/codex">
        CLI + estensione VS Code + app, un solo comando per tutti e tre
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/it/setup/claude-code">
        CLI + estensione, un solo comando, richiede chiave del pacchetto Claude
      </Card>

      <Card title="Cursor" icon="mouse-pointer-2" href="/it/setup/cursor">
        Sostituisci la Base URL in Impostazioni → Modelli
      </Card>

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

      <Card title="Chatbox" icon="message-square" href="/it/setup/chatbox">
        Web e desktop
      </Card>
    </CardGroup>
  </Step>
</Steps>

## Come viene contato il credito

Le chiavi vengono addebitate in base ai **token effettivamente utilizzati** (input + output), esattamente il `usage` che l'API restituisce per ogni richiesta. Nessuna tariffa nascosta, nessun token iniettato.

* Pacchetto **GPT**: 10M crediti = 10M token di `gpt-5.6-sol`.
* Pacchetto **GPT Astra**: 10M = 10M token di `gpt-astra`. Una chiave Astra può chiamare solo `gpt-astra`; una chiave GPT può chiamare solo `gpt-5.6-sol`.
* Pacchetto **Claude**: i crediti vengono addebitati per modello; Opus 5 ≈ 1 credito/token, Fable ≈ 2, Sonnet/Haiku più economici. Una chiave Claude può chiamare solo modelli `claude-*`.

<Tip>
  Il risparmio più efficace: **inizia una nuova conversazione quando cambi argomento**. Ogni turno reinvia l'intera cronologia; il messaggio 51 di una conversazione lunga costa molte volte più del messaggio 1. In Cursor e Cline, punta l'agente sui file esatti invece di lasciarlo scansionare il repository.
</Tip>


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