一、前置条件
在开始配置前，请确保你已完成以下准备工作：
1. 订阅 Token Plan 套餐。
2. 获取 API Key。
3. 安装 OpenCode：请参见 OpenCode 安装指南，你可以选择桌面应用版下载。也可以在命令行中执行以下命令安装：
npm install -g opencode-ai
安装完成后，执行以下命令检查，输出版本号则表示安装成功：
opencode -v
二、配置模型
OpenCode 支持通过桌面客户端或命令行配置文件接入腾讯云 Token Plan 个人版，两种方式任选其一即可。
三、方式一：桌面客户端配置
1. 打开 OpenCode，在对话界面，单击管理模型打开模型设置界面。
2. 在打开的弹窗中，单击+ 连接提供商，选择自定义 OpenAI 兼容提供商。
3. 在打开的弹窗中，点击填写信息并提交：
·提供商 ID：tencent
·显示名称：Tencent TokenPlan
·基础 URL：https://tokenhub.tencentmaas.com/plan/v3
·API 密钥：填写你的 API Key。
·model-id 和模型：根据你购买的套餐，填入 套餐支持的模型 ID。
4. 在对话窗口的模型列表中，找到并选定新配置的模型，即可进行对话使用。
四、方式二：命令行配置
1. 修改 OpenCode 的配置文件，配置文件路径如下，配置文件不存在时新建即可。
·macOS / Linux：~/.config/opencode/opencode.json
·Windows：C:\\Users\\<用户名>\\.config\\opencode\\opencode.json
2. 将以下内容复制粘贴到 opencode.json 文件中并保存。请你将 $your_api_key 替换为 Token Plan 专属的 API Key：
注意：说明：
注意：模型列表：下方配置已按通用 Token Plan 套餐预填当前支持的模型；Hy Token Plan 套餐支持的模型（hy3、hy4-preview 等）及各套餐最新模型清单请参见 套餐支持的模型 ID，按下述条目格式在 models 中增减即可。配置 Model ID 时，必须使用全小写格式。
{ "$schema": "https://opencode.ai/config.json", "provider": { "tencent": { "npm": "@ai-sdk/openai-compatible", "name": "Tencent TokenPlan", "options": { "baseURL": "https://tokenhub.tencentmaas.com/plan/v3", "apiKey": "$your_api_key" }, "models": { "tc-code-latest": { "name": "Auto", "modalities": { "input": ["text"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "deepseek-v4-flash-202605": { "name": "DeepSeek-V4-Flash 正式版 原厂直供", "modalities": { "input": ["text"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "deepseek-v4-pro-202606": { "name": "DeepSeek-V4-Pro 正式版 原厂直供", "modalities": { "input": ["text"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "minimax-m2.7": { "name": "MiniMax-M2.7", "modalities": { "input": ["text"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "minimax-m3": { "name": "MiniMax-M3", "modalities": { "input": ["text", "image"], "output": ["text"] } }, "glm-5.2": { "name": "GLM-5.2", "modalities": { "input": ["text"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "glm-5.3": { "name": "GLM-5.3", "modalities": { "input": ["text"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "glm-5.3-flash": { "name": "GLM-5.3-Flash", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "hy4-preview": { "name": "Hy4 preview", "modalities": { "input": ["text"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "kimi-k2.7-code": { "name": "Kimi K2.7 Code", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } }, "kimi-k3": { "name": "Kimi K3", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled" } } } } } }}
3. 在终端执行以下命令启动 OpenCode：
opencode
4. 输入 /models，选择配置的模型，即可开始对话使用。