腾讯云 Token Plan 快速入门：订阅到第一次对话

摘要： 腾讯云 Token Plan 快速入门分四步：在控制台订阅通用或 Hy 套餐、生成 sk-tp 开头的 API Key、用 cURL 验证连通性、把 Base URL 与 Key 配进 AI 工具。整个流程零配置门槛，几分钟即可让 Claude Code、Cursor 等工具跑在国产模型上，按积分包月。

从零到第一次对话，核心就四步：订阅、拿 Key、验证、配工具。Token Plan 是腾讯云大模型服务平台 TokenHub 面向个人的订阅套餐，不走按 token 计费而是按积分包月，适合高频用 AI 编码的人把预算固定下来。这篇按官方流程走一遍，每步给出能直接复制的命令和要留意的坑。

第一步：订阅套餐

进控制台的 Token Plan 页面选套餐。先定系列：通用 Token Plan 聚合 DeepSeek、GLM、Kimi、MiniMax、混元等多家国产模型，适合多模型切换；Hy Token Plan 专注腾讯自研混元，价格更低。再定档位：Lite / Standard / Pro / Max 积分额度递增，新手建议从 Lite 或 Standard 起步，套餐支持升配、不支持降配，低起步最稳。

要点：套餐不支持退款、只能升不能降，所以第一次别买高。

第二步：生成 API Key

在控制台 Token Plan 页面点「生成密钥」，得到格式为 sk-tp-xxx 的专属 API Key，点复制保存好。

关于 Key 有三条必须知道：

• 每个主账号只能生成一个 API Key；
• 通用和 Hy 两套餐共用同一个 Key，在任一套餐页生成一次即可通用；
• 重置 Key 后旧 Key 会在 5 分钟内失效，用它的所有工具会立刻断。

第三步：用 cURL 验证连通性

拿到 Key 先别急着配工具，用一条 cURL 确认通不通，能省掉后面在工具里反复试错的时间。把 $your_api_key 换成你的 Key，$model_id 换成套餐内模型（如 kimi-k2.7-code）：

curl --location 'https://tokenhub.tencentmaas.com/plan/v3/chat/completions' \
--header 'Authorization: Bearer $your_api_key' \
--header 'Content-Type: application/json' \
--data '{
  "model": "$model_id",
  "messages": [
    {
      "role": "user",
      "content": "hello"
    }
  ],
  "stream": false
}'

能返回一段 JSON 应答，就说明 Key 和地址都对、套餐已可用。这里的地址 https://tokenhub.tencentmaas.com/plan/v3 是 OpenAI 兼容协议的接入点，后面配大多数工具都用它。

第四步：配进 AI 工具

验证通过后，把三样东西填进你用的工具即可：

Token Plan 兼容主流 AI 编程工具（Claude Code、Cursor、Cline、CodeBuddy、Codex、Kilo Code、OpenCode、TRAE 等）和龙虾 Agent 工具（OpenClaw、WorkBuddy、AutoClaw、CoPaw 等）。走 Anthropic 协议的工具（如 Claude Code）用 /plan/anthropic 地址，其余多数走 /plan/v3。各工具具体配置位置略有不同，但填的都是这三项。

常见入门报错

第一次接入可能撞到这几个：

要知悉：个人版面向交互式使用、仅一个 API Key，禁止账号共享、禁止把 Key 用于自动化脚本或应用后端批量调用。日常在工具里手动对话、编码属标准用法；需要稳定 API 批量能力请用 Token Plan 企业版。

完成本教程还需要什么

• 先 cURL 后配工具：连通性先验证，排错成本最低。
• 选对协议地址：Anthropic 工具用 /plan/anthropic，别和 /plan/v3 搞混。
• 盯积分、低起步：控制台看周期用量，积分按订阅月刷新、不结转；不够用再升配。

查看套餐详情与订阅入口，前往腾讯云 Token Plan 页面：https://cloud.tencent.com/act/pro/tokenplan