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

# 開始使用

> 購買 CDK、兌換 Key、安裝 Node.js、選擇工具

<Steps>
  <Step title="購買 CDK">
    CDK 形如 `TSL-XXXX-XXXX-XXXX`，按套餐出售：

    | 套餐 | 模型 | 計量單位 |
    | - | - | - |
    | **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） |

    每個套餐都有**從兌換時刻起算的有效期**（寫在商品上，如 1 天、2 天、5 天）。到期或額度用完後 Key 停止工作，未用完的額度不會轉到新 Key。

    公告與支援：[t.me/teamsoclo](https://t.me/teamsoclo)。
  </Step>

  <Step title="兌換 API Key">
    開啟 **[redeem.teamsoclo.site](https://redeem.teamsoclo.site)**，貼上 CDK 並兌換，即可獲得 `sk-...` Key 以及對應套餐的使用說明。

    <Warning>
      請用 **Copy** 按鈕複製 Key，不要用滑鼠拖選。Key 很長，首尾很容易少幾個字元，之後表現為 `401 Unauthorized`，而不會提示“複製不完整”。
    </Warning>

    Key 丟了？再次兌換同一個 CDK，頁面會顯示原來的 Key。剩餘額度和到期時間：[gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check)。
  </Step>

  <Step title="安裝 Node.js（僅 Codex CLI 需要）">
    Codex CLI 透過 `npm` 安裝，需要 **Node.js 18 及以上**。檢查：

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

    沒有則按系統安裝：

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

        或從 [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 可避免全域性安裝時的 `EACCES` 許可權錯誤。
      </Tab>

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

        或從 [nodejs.org](https://nodejs.org) 下載安裝包。
      </Tab>
    </Tabs>

    Cursor、Cline、Chatbox 不需要 Node.js。
  </Step>

  <Step title="選擇工具並配置">
    <CardGroup cols={2}>
      <Card title="Codex" icon="terminal" href="/zh-tw/setup/codex">
        CLI + VS Code 擴充套件 + App，一條命令三者通用
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/zh-tw/setup/claude-code">
        CLI + 擴充套件，一條命令，需要 Claude 套餐的 Key
      </Card>

      <Card title="Cursor" icon="mouse-pointer-2" href="/zh-tw/setup/cursor">
        在 Settings → Models 中覆蓋 Base URL
      </Card>

      <Card title="Cline / Roo Code" icon="bot" href="/zh-tw/setup/cline">
        OpenAI Compatible 提供商
      </Card>

      <Card title="Chatbox" icon="message-square" href="/zh-tw/setup/chatbox">
        網頁版與桌面版
      </Card>
    </CardGroup>
  </Step>
</Steps>

## 額度如何計算

Key 按**實際使用的 Token**（輸入 + 輸出）扣費，與每次請求返回的 `usage` 完全一致。沒有隱藏費用，不注入額外 Token。

* **GPT** 套餐：10M Credit = 10M 個 `gpt-5.6-sol` Token。
* **GPT Astra** 套餐：10M = 10M 個 `gpt-astra` Token。Astra Key 只能呼叫 `gpt-astra`，GPT Key 只能呼叫 `gpt-5.6-sol`。
* **Claude** 套餐：按模型扣 Credit，Opus 5 ≈ 1 credit/token，Fable ≈ 2，Sonnet/Haiku 更便宜。Claude Key 只能呼叫 `claude-*` 模型。

<Tip>
  最有效的省錢方法：**換話題時新開對話**。每一輪都會重發全部歷史，長對話的第 51 條訊息比第 1 條貴許多倍。在 Cursor 和 Cline 中明確指定要改的檔案，不要讓 Agent 掃描整個倉庫。
</Tip>


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