Roo Code 安装与 API 配置

要在 Roo Code 中使用 BetterToken，请准备 API Key，填写下表中的 Base URL，并从模型广场选择当前可用的 Model ID。

重点信息

字段	填写内容
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	从模型广场复制的当前 Model ID

准备工作

• 已安装该工具的当前版本
• BetterToken API Key：注册并获取
• 从模型广场复制的 Model ID

工具特定要求

• 已安装 VS Code

安装

安装 Roo Code

打开 VS Code，在扩展市场搜索 Roo Code，点击 Install 安装，安装完成后重启 VS Code。

手动配置

主要通过 Roo Code 的设置界面完成以下配置，不需要手动编辑配置文件。

字段	填写内容
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	从模型广场复制的当前 Model ID

配置步骤

清除冲突的环境变量

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

打开 Roo Code 设置

点击 Roo Code 侧边栏中的 Settings。

配置 API 提供商

按以下方式填写：

• API Provider → OpenAI Compatible
• Base URL → https://bettertoken.ai/v1
• API Key → 你的 BetterToken API Key
• Model → 从模型广场复制的 模型 ID

仅在官方文档明确要求时再配置额外 headers

我们查到的 Roo Code 官方资料强调 OpenAI-compatible / custom API 接入，但没有把额外 User-Agent 列为 BetterToken 默认接入的必填项。

如果你还接了自定义网关、租户路由或审计服务，再按对应上游服务的官方文档补充所需 headers。

保存并开始使用

点击 Save 和 Done，然后选择刚配置的模型。

重启 Roo Code

修改配置后，请重启 VS Code 或重新加载 Roo Code 插件，再选择刚配置的模型。

Roo Code 要求原生 OpenAI 兼容工具调用，没有 XML 回退方式，请选择支持原生工具调用的模型和接口。仅在上游网关要求时添加额外 headers。

验证连接

发送一条简短测试消息。工具正常返回内容，并且没有认证或 Model ID 错误，就说明连接成功。修改配置后请完全退出并重新启动工具。

然后让 Roo Code 读取一个项目文件并概述内容。确认它执行了文件读取工具并使用返回结果；仅有文字回复无法验证 Agent 的工具使用能力。

切换模型

打开模型选择器，或修改配置中的 Model 字段。请填写模型广场中的完整 Model ID，然后重新启动当前会话。

常见错误

错误	排查方式
401 或 Unauthorized	检查 BetterToken API Key，并删除首尾空格。
404	检查 Base URL，不要附加具体 endpoint 路径。
model not found	从模型广场重新复制当前 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？

• 对比所有支持的工具

• API 错误、状态码与限流

技术说明

协议、endpoint 与 provider 内部字段

本页配置使用 https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。