Cline 安装与 API 配置
安装 Cline，配置 BetterToken Base URL 和 API Key，选择模型并排查常见错误。
要在 Cline 中使用 BetterToken，请准备 API Key，填写下表中的 Base URL，并从模型广场选择当前可用的 Model ID。类似的界面配置可对照 Roo Code、Kilo Code 和 MonkeyCode。
重点信息
| 字段 | 填写内容 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 从模型广场复制的当前 Model ID |
准备工作
工具特定要求
- 已安装 VS Code
安装
安装 Cline
打开 VS Code，在扩展市场搜索 Cline，点击 Install 安装。
手动配置
主要通过 Cline 的配置界面完成以下设置，不需要手动编辑配置文件。
| 字段 | 填写内容 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 从模型广场复制的当前 Model ID |
配置步骤
清除冲突的环境变量
unset OPENAI_API_KEYunset OPENAI_BASE_URL打开 Cline 配置界面
点击 Cline 侧边栏中的 Use your own API key。
配置 API 提供商
按以下方式填写：
- API Provider →
OpenAI Compatible - Base URL →
https://bettertoken.ai/v1 - API Key → 你的 BetterToken API Key
- Model → 从模型广场复制的 模型 ID
在 Model Configuration 中填写所选模型已确认的上下文和输出上限。只有模型和接口都支持时，才开启图片或 Computer Use 能力；参见 Cline provider 设置。
仅在官方文档明确要求时再配置额外 headers
我们查到的 Cline 官方 OpenAI Compatible 接入文档默认只要求 Base URL、API Key 和模型 ID。接入 BetterToken 时通常不需要额外设置 User-Agent。
如果你还接了自定义网关、租户路由或审计服务，再按对应上游服务的官方文档补充所需 headers。
保存配置
点击右上角 Done 保存配置。
重启 Cline
修改配置后，请重启 VS Code 或重新加载 Cline 插件，使新配置生效。
验证连接
在 provider 设置中点击 Verify 检查连接。
发送一条简短测试消息。工具正常返回内容，并且没有认证或 Model ID 错误，就说明连接成功。修改配置后请完全退出并重新启动工具。
切换模型
打开模型选择器，或修改配置中的 Model 字段。请填写模型广场中的完整 Model ID，然后重新启动当前会话。
常见错误
| 错误 | 排查方式 |
|---|---|
401 或 Unauthorized | 检查 BetterToken API Key，并删除首尾空格。 |
404 | 检查 Base URL，不要附加具体 endpoint 路径。 |
model not found | 从模型广场重新复制当前 Model ID。 |
| 配置未生效 | 保存配置，并完全退出后重新启动工具。 |
- Cline 如何配置 OpenAI-compatible API？
- OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？
- MCP 和 API Key / Base URL 有什么区别？
- Cursor 如何配置自定义 OpenAI API Key 和 Base URL？
技术说明
协议、endpoint 与 provider 内部字段
本页配置使用 https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。