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