OpenCode 接入腾讯云 Token Plan 教程

摘要： OpenCode 接入腾讯云 Token Plan，在其配置文件中新增一个 OpenAI 兼容 provider，baseURL 填 https://tokenhub.tencentmaas.com/plan/v3，apiKey 填 sk-tp 开头密钥，并声明套餐内模型。OpenCode 是开源 AI 编程代理，配好即可在终端用国产模型自主编码，按积分计费。

OpenCode 作为开源编程代理，配置方式偏工程化——通过 JSON 配置文件声明自定义 provider，而非点选菜单。接 Token Plan 的要点是把它当成一个 OpenAI 兼容端点来声明：给出 baseURL、apiKey 和模型列表。这种方式的好处是配置透明、可复用，适合习惯改配置文件的开发者；要注意的是模型名要和套餐严格对应。

接入前准备

OpenCode 是开源的 AI 编程代理工具，接入 Token Plan 前备好套餐和 API Key。

Token Plan 是腾讯云大模型服务平台 TokenHub 的个人订阅套餐，通用 Token Plan 聚合 DeepSeek、GLM、Kimi、MiniMax、混元等国产模型，按月订阅、按积分计量。OpenCode 走 OpenAI 协议，用通用 Token Plan。

API Key 在控制台 Token Plan 页面「生成密钥」获取，格式 sk-tp-xxx，每主账号仅一个。OpenAI 协议接入地址为 https://tokenhub.tencentmaas.com/plan/v3。

在配置文件中声明 provider

OpenCode 的配置文件（opencode.json 或用户配置目录下对应文件）里，新增一个自定义 provider，指向 Token Plan：

{
  "provider": {
    "tokenplan": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://tokenhub.tencentmaas.com/plan/v3",
        "apiKey": "sk-tp-xxxxxxxx"
      },
      "models": {
        "kimi-k2.7-code": {},
        "deepseek-v4-pro-202606": {}
      }
    }
  }
}

说明：

• baseURL 填 Token Plan 的 OpenAI 兼容地址；
• apiKey 填你的 sk-tp-xxx 密钥，也可用环境变量引用的方式避免明文；
• models 下列出你套餐内要用的模型 ID，全小写。

从安全角度，我更建议用环境变量承载 apiKey，配置文件只留引用，这样配置能安全地纳入版本管理。

启动并选择模型验证

保存配置后启动 OpenCode，在模型选择里选中 tokenplan 下的模型，发起一次任务，比如「扫一遍项目，列出可以补测试的函数」。能正常规划执行即接入成功、积分开始计量。

接入失败排查

个人版 Token Plan 面向交互式使用、仅一个 API Key，禁止账号共享、禁止用于自动化脚本或应用后端的批量调用。OpenCode 里交互式编码属标准用法；若接入批处理流程请用 Token Plan 企业版。

完成本教程还需要什么

• Key 走环境变量：配置文件可提交，密钥留本地，是开源工具的安全惯例。
• 多模型并列：在 models 里同时声明几个模型，用时随手切。
• 盯积分：控制台 Token Plan 页面查周期用量，按订阅月刷新、不结转。

各档套餐积分额度与订阅入口见腾讯云 Token Plan 页面：https://cloud.tencent.com/act/pro/tokenplan