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

# Primeros pasos

> Comprar un código, canjearlo por una clave, instalar Node.js, elegir una herramienta

<Steps>
  <Step title="Comprar un código CDK">
    Los códigos tienen el formato `TSL-XXXX-XXXX-XXXX` y se venden por paquete:

    | Paquete | Modelo | Vendido en |
    | - | - | - |
    | **GPT** | `gpt-5.6-sol` | Créditos (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éditos (10M, 20M, 50M, 100M, 200M, 300M, 500M, 1B) |

    Cada paquete tiene un **período de validez contado desde el momento del canje** (indicado en el producto, p. ej. 1 día, 2 días, 5 días). Cuando expira o se agota el cupo, la clave se desactiva; el cupo no utilizado no se transfiere a una clave nueva.

    Anuncios y soporte: [t.me/teamsoclo](https://t.me/teamsoclo).
  </Step>

  <Step title="Canjear el código por una clave API">
    Abre **[redeem.teamsoclo.site](https://redeem.teamsoclo.site)**, pega el código y canjéalo. Recibirás una clave `sk-...` junto con las instrucciones de tu paquete.

    <Warning>
      Copia la clave con el botón **Copy**, no seleccionando el texto. Las claves son largas y es fácil perder un carácter en cualquier extremo; esto aparecerá después como `401 Unauthorized`, no como "copiaste mal".
    </Warning>

    ¿Perdiste la clave? Canjea el mismo código CDK de nuevo en [redeem.teamsoclo.site](https://redeem.teamsoclo.site); la página mostrará la misma clave. Cupo restánte y fecha de expiración: [gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check).
  </Step>

  <Step title="Instalar Node.js (solo para Codex CLI)">
    Codex CLI se instala mediante `npm`, por lo que necesitas **Node.js 18 o superior**. Verifica:

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

    Si no está instalado, hazlo según tu sistema operativo:

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

        O descarga el instalador desde [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 errores de permisos `EACCES` con paquetes globales.
      </Tab>

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

        O descarga el instalador desde [nodejs.org](https://nodejs.org).
      </Tab>
    </Tabs>

    Cursor, Cline y Chatbox no necesitan Node.js.
  </Step>

  <Step title="Elegir una herramienta y configurarla">
    <CardGroup cols={2}>
      <Card title="Codex" icon="terminal" href="/es/setup/codex">
        CLI + extensión VS Code + app, un solo comando para los tres
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/es/setup/claude-code">
        CLI + extensión, un solo comando, requiere clave del paquete Claude
      </Card>

      <Card title="Cursor" icon="mouse-pointer-2" href="/es/setup/cursor">
        Cambia la Base URL en Configuración → Modelos
      </Card>

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

      <Card title="Chatbox" icon="message-square" href="/es/setup/chatbox">
        Web y escritorio
      </Card>
    </CardGroup>
  </Step>
</Steps>

## Cómo se cuenta el cupo

Las claves se cobran por **tokens realmente utilizados** (entrada + salida), exactamente el `usage` que devuelve la API por cada solicitud. Sin cargos ocultos ni tokens inyectados.

* Paquete **GPT**: 10M créditos = 10M tokens de `gpt-5.6-sol`.
* Paquete **GPT Astra**: 10M = 10M tokens de `gpt-astra`. Una clave Astra solo puede llamar a `gpt-astra`; una clave GPT solo puede llamar a `gpt-5.6-sol`.
* Paquete **Claude**: los créditos se cobran por modelo; Opus 5 ≈ 1 crédito/token, Fable ≈ 2, Sonnet/Haiku más barato. Una clave Claude solo puede llamar a modelos `claude-*`.

<Tip>
  El ahorro más efectivo: **inicia una nueva conversación cuando cambies de tema**. Cada turno reenvía todo el historial; el mensaje 51 de una conversación larga cuestá muchas veces más que el mensaje 1. En Cursor y Cline, apunta el agente a los archivos exactos en lugar de dejar que escanee el repositorio.
</Tip>


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