RooCode

RooCode 是 VSCode 中常见的 AI 编程插件，通常支持 OpenAI Compatible、Anthropic 或自定义 Provider。

统一接入信息

• 平台名称：FreeDom API
• 控制台 / API Base URL：https://api.yonghu.shop
• 鉴权方式：API Key
• API Key 获取：登录控制台 → 令牌 / API Key 页面创建

一、适用场景

• 想把 RooCode 的模型请求接到 FreeDom API
• 已经有平台 API Key
• 需要统一使用平台里的 Claude、GPT、Gemini 或图像模型

二、安装 / 准备

在 VSCode 扩展市场安装 RooCode，安装完成后打开插件设置。

三、配置接入

推荐选择：

• Provider：OpenAI Compatible 或 Anthropic Compatible（按你要用的模型决定）
• Base URL：https://api.yonghu.shop
• API Key：你的 FreeDom API Key
• Model：填写平台真实模型名

如果 OpenAI Compatible 不通，尝试在 Base URL 末尾加 /v1。

四、启动验证

在 RooCode 面板里让它解释当前项目，或新建一个文件让它生成简单函数。

五、推荐模型填写方式

优先使用控制台里真实展示的模型名。常见可尝试：

• Claude：claude-sonnet-4-5-20250929、claude-opus-4-8、claude-opus-4-8-thinking
• Gemini：gemini-2.5-pro、gemini-2.5-flash
• OpenAI 兼容工具：按平台模型广场/控制台展示为准

六、常见问题

401 Unauthorized

API Key 错误、没保存成功，或请求头没有带上密钥。

403 Forbidden

通常是余额不足、Key 没有权限、模型未开放，或服务返回拒绝。

404 Model Not Found

模型名写错，或者当前 Key 没有这个模型权限。

429 Too Many Requests

请求过快或服务繁忙。降低并发、稍后重试，或切换模型或稍后重试。

七、实用建议

RooCode 的强项是项目级任务。建议给它配置一个稳定模型作为默认，再手动切换高性能模型处理复杂任务。

八、RooCode 官方兼容模式

RooCode 官方文档明确提供 OpenAI Compatible Provider，用于接入任意 OpenAI 兼容服务。接入 FreeDom API 时推荐：

API Provider: OpenAI Compatible
Base URL: https://api.yonghu.shop
API Key: 你的 FreeDom API Key
Model ID: 平台模型名

如果模型下拉框没有你的模型，优先选择可手动输入 Model ID 的兼容模式。

RooCode 配置补充

RooCode 官方 OpenAI Compatible Provider 文档的关键点是：需要 OpenAI 兼容接口，并且模型要支持原生 tool calling。

推荐配置：

API Provider: OpenAI Compatible
Base URL: https://api.yonghu.shop
API Key: 你的 FreeDom API Key
Model ID: 平台模型名

如果工具调用失败但普通聊天成功，优先换支持 OpenAI tool calling 的模型。验证方式见：接入自测。