重点信息
准备工作
工具特定要求
- 已安装 VS Code
安装
安装 Cline
打开 VS Code,在扩展市场搜索 Cline,点击 Install 安装。手动配置
主要通过 Cline 的配置界面完成以下设置,不需要手动编辑配置文件。配置步骤
1
清除冲突的环境变量
2
打开 Cline 配置界面
点击 Cline 侧边栏中的 Use your own API key。
3
配置 API 提供商
按以下方式填写:
- API Provider →
OpenAI Compatible - Base URL →
https://bettertoken.ai/v1 - API Key → 你的 BetterToken API Key
- Model → 从模型广场复制的 受支持提供商的模型 ID
4
仅在官方文档明确要求时再配置额外 headers
我们查到的 Cline 官方 OpenAI Compatible 接入文档默认只要求
Base URL、API Key 和模型 ID。接入 BetterToken 时通常不需要额外设置 User-Agent。如果你还接了自定义网关、租户路由或审计服务,再按对应上游服务的官方文档补充所需 headers。5
保存配置
点击右上角 Done 保存配置。
6
重启 Cline
修改配置后,请重启 VS Code 或重新加载 Cline 插件,使新配置生效。
验证连接
发送一条简短测试消息。工具正常返回内容,并且没有认证或 Model ID 错误,就说明连接成功。修改配置后请完全退出并重新启动工具。切换模型
打开模型选择器,或修改配置中的Model 字段。请填写模型广场中的完整 Model ID,然后重新启动当前会话。
常见错误
- Cline 如何配置 OpenAI-compatible API?
- OpenAI-compatible API 和 Anthropic-compatible API 有什么区别?
- MCP 和 API Key / Base URL 有什么区别?
- Cursor 如何配置自定义 OpenAI API Key 和 Base URL?
优先检查
Base URL、API Key、模型 ID 和工具版本;不要默认把 User-Agent 当作 BetterToken 必填项。进阶配置
支持的提供商
状态仅针对本页介绍的 BetterToken 接入方式。
配置方式说明
配置方式说明
- 手动配置:填写 API Key、Base URL 和 Model。
- 不支持:当前没有经过验证的直接配置方式。
技术说明
协议、endpoint 与 provider 内部字段
协议、endpoint 与 provider 内部字段
本页配置使用
https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint;除非具体字段明确要求,否则不要在 Base URL 后附加 /chat/completions 或 /responses。
