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

# Primeiros passos

> Comprar um código, trocá-lo por uma chave, instalar o Node.js, escolher uma ferramenta

<Steps>
  <Step title="Comprar um código CDK">
    Os códigos têm o formato `TSL-XXXX-XXXX-XXXX` e são vendidos por pacote:

    | Pacote | Modelo | Vendido em |
    | - | - | - |
    | **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 pacote tem um **período de validade contado a partir do momento do resgate** (indicado no produto, ex.: 1 dia, 2 dias, 5 dias). Quando expira ou o limite é esgotado, a chave para de funcionar; o limite não utilizado não é transferido para uma nova chave.

    Anúncios e suporte: [t.me/teamsoclo](https://t.me/teamsoclo).
  </Step>

  <Step title="Resgatar o código por uma chave API">
    Abra **[redeem.teamsoclo.site](https://redeem.teamsoclo.site)**, cole o código e resgate. Você receberá uma chave `sk-...` com as instruções do seu pacote.

    <Warning>
      Copie a chave com o botão **Copy**, não selecionando o texto. As chaves são longas e é fácil perder um caractere em qualquer extremidade; isso aparece depois como `401 Unauthorized`, não como "você copiou errado".
    </Warning>

    Perdeu a chave? Resgate o mesmo código CDK novamente em [redeem.teamsoclo.site](https://redeem.teamsoclo.site); a página mostrará a mesma chave. Limite restante e expiração: [gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check).
  </Step>

  <Step title="Instalar o Node.js (apenas para Codex CLI)">
    O Codex CLI é instalado via `npm`, então você precisa do **Node.js 18 ou mais recente**. Verifique:

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

    Se não estiver instalado, instale para o seu sistema operacional:

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

        Ou baixe o instalador em [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
        ```

        O nvm evita erros de permissão `EACCES` com pacotes globais.
      </Tab>

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

        Ou baixe o instalador em [nodejs.org](https://nodejs.org).
      </Tab>
    </Tabs>

    Cursor, Cline e Chatbox não precisam do Node.js.
  </Step>

  <Step title="Escolher uma ferramenta e configurá-la">
    <CardGroup cols={2}>
      <Card title="Codex" icon="terminal" href="/pt/setup/codex">
        CLI + extensão VS Code + app, um comando para os três
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/pt/setup/claude-code">
        CLI + extensão, um comando, requer chave do pacote Claude
      </Card>

      <Card title="Cursor" icon="mouse-pointer-2" href="/pt/setup/cursor">
        Altere a Base URL em Configurações → Modelos
      </Card>

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

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

## Como o limite é contado

As chaves são cobradas pelos **tokens realmente utilizados** (entrada + saída), exatamente o `usage` que a API retorna para cada requisição. Sem taxas ocultas, sem tokens injetados.

* Pacote **GPT**: 10M créditos = 10M tokens de `gpt-5.6-sol`.
* Pacote **GPT Astra**: 10M = 10M tokens de `gpt-astra`. Uma chave Astra só pode chamar `gpt-astra`; uma chave GPT só pode chamar `gpt-5.6-sol`.
* Pacote **Claude**: os créditos são cobrados por modelo; Opus 5 ≈ 1 crédito/token, Fable ≈ 2, Sonnet/Haiku mais baratos. Uma chave Claude só pode chamar modelos `claude-*`.

<Tip>
  A economia mais eficaz: **inicie uma nova conversa ao mudar de assunto**. Cada turno reenvia todo o histórico; a mensagem 51 de uma conversa longa custa muito mais do que a mensagem 1. No Cursor e no Cline, aponte o agente para os arquivos exatos em vez de deixá-lo escanear o repositório.
</Tip>


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