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

# Bắt đầu

> Mua mã, đổi mã lấy key, cài Node.js, chọn công cụ

<Steps>
  <Step title="Mua mã CDK">
    Mã CDK có dạng `TSL-XXXX-XXXX-XXXX`, bán theo gói:

    | Gói | Model | Đơn vị bán |
    | - | - | - |
    | **GPT** | `gpt-5.6-sol` | Credit (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`… | Credit (10M, 20M, 50M, 100M, 200M, 300M, 500M, 1B) |

    Mỗi gói có **thời hạn sử dụng tính từ lúc đổi mã** (ghi trên sản phẩm, ví dụ 1 ngày, 2 ngày, 5 ngày). Hết hạn hoặc hết hạn mức thì key ngừng, phần chưa dùng không cộng dồn sang key mới.

    Kênh thông báo và hỗ trợ: [t.me/teamsoclo](https://t.me/teamsoclo).
  </Step>

  <Step title="Đổi mã lấy API key">
    Vào **[redeem.teamsoclo.site](https://redeem.teamsoclo.site)**, dán mã, bấm đổi. Trang trả về key dạng `sk-...` cùng hướng dẫn cho gói bạn mua.

    <Warning>
      Copy key bằng nút **Copy**, đừng bôi đen bằng chuột. Key dài, rất dễ hụt vài ký tự đầu hoặc cuối, và lỗi đó hiện ra là `401 Unauthorized` chứ không nói rõ là copy thiếu.
    </Warning>

    Mất key thì đổi lại đúng mã đó, trang sẽ hiện lại key cũ. Xem hạn mức và ngày hết hạn tại [gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check).
  </Step>

  <Step title="Cài Node.js (chỉ khi dùng Codex CLI)">
    Codex CLI cài qua `npm`, cần **Node.js 18 trở lên**. Kiểm tra:

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

    Chưa có thì cài theo hệ điều hành:

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

        Hoặc tải bản cài đặt từ [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
        ```

        Dùng nvm tránh được lỗi quyền `EACCES` khi cài package global.
      </Tab>

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

        Hoặc tải bản cài đặt từ [nodejs.org](https://nodejs.org).
      </Tab>
    </Tabs>

    Cursor, Cline, Chatbox không cần Node.js.
  </Step>

  <Step title="Chọn công cụ và cài">
    <CardGroup cols={2}>
      <Card title="Codex" icon="terminal" href="/cai-dat/codex">
        CLI + extension VS Code + app, một lệnh dùng cả ba
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/cai-dat/claude-code">
        CLI + extension, một lệnh, cần key gói Claude
      </Card>

      <Card title="Cursor" icon="mouse-pointer-2" href="/cai-dat/cursor">
        Override Base URL trong Settings → Models
      </Card>

      <Card title="Cline / Roo Code" icon="bot" href="/cai-dat/cline">
        Provider OpenAI Compatible
      </Card>

      <Card title="Chatbox" icon="message-square" href="/cai-dat/chatbox">
        Bản web và desktop
      </Card>
    </CardGroup>
  </Step>
</Steps>

## Hạn mức tính thế nào

Key trừ theo **token thực dùng** (input + output), đúng bằng số `usage` mà API trả về sau mỗi request. Không có phí ẩn, không chèn thêm token.

* Gói **GPT**: 10M credit = 10M token `gpt-5.6-sol`.
* Gói **GPT Astra**: 10M = 10M token `gpt-astra`. Key Astra chỉ gọi được `gpt-astra`, key GPT chỉ gọi được `gpt-5.6-sol`.
* Gói **Claude**: credit trừ theo model, Opus 5 ≈ 1 credit/token, Fable ≈ 2, Sonnet/Haiku rẻ hơn. Key Claude chỉ gọi được model `claude-*`.

<Tip>
  Cách tiết kiệm hiệu quả nhất: **mở cuộc trò chuyện mới khi đổi chủ đề**. Mỗi lượt hỏi, toàn bộ hội thoại cũ được gửi lại; chat 50 tin nhắn thì câu thứ 51 tốn gấp nhiều lần câu đầu. Trong Cursor và Cline, chỉ định rõ file cần sửa thay vì để agent tự quét cả repo.
</Tip>


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