> ## 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/setup/codex">
        CLI + VS Code 扩展 + App，一条命令三者通用
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/zh/setup/claude-code">
        CLI + 扩展，一条命令，需要 Claude 套餐的 Key
      </Card>

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

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

      <Card title="Chatbox" icon="message-square" href="/zh/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.