选哪种接法
Roo Code 把连接设置存在「配置档案」(configuration profile)里。建议建两个档案,比如
RuAPI Claude 和 RuAPI DeepSeek,在聊天里直接切换。
准备工作
1
RuAPI 密钥
在 www.ruapi.ai 注册、充值(充值方法),然后打开控制台 → 令牌管理,点击 添加令牌。密钥以
sk- 开头。2
最新版 Roo Code
在 VS Code 扩展市场搜索「Roo Code」安装,或更新到最新版。
如果你的 Roo Code 界面是俄语的,字段名称会被翻译,但顺序和含义不变。
Claude 的配置档案(Anthropic 提供商)
1
新建档案
在侧边栏打开 Roo Code → ⚙️ → Providers。点档案列表旁边的 +,给档案起名,例如
RuAPI Claude。2
填写字段
3
保存
点 Save。
如果 Model 列表里没有你要的模型,请更新 Roo Code:Anthropic 的模型列表是写在扩展里的,随新版本增加。
DeepSeek、GPT 等模型的配置档案(OpenAI Compatible)
1
再建一个档案
⚙️ → Providers → +,起名,例如
RuAPI DeepSeek。2
填写字段
3
检查模型参数
在模型参数里:
- Image Support:GPT、Gemini 和
deepseek-flash打开;deepseek-v4-pro不支持图片。 - Context Window:模型的上下文窗口大小。不要填得比模型实际支持的大,否则长任务会报「超出上下文长度」的错误。
- Input Price / Output Price:可以不填。如果填上价格页上的价格(每 100 万 token),Roo Code 会显示每个任务的大概花费。
4
保存
点 Save。
kimi/kimi-k3)。
Roo Code 只能用支持工具调用(tool calling)的模型。RuAPI 的主要文本模型——Claude、GPT、Gemini、DeepSeek、GLM、Qwen、Kimi——都支持;生成图片和视频的模型不能用在 Roo Code 里。
每个模式用自己的模型
Roo Code 有好几种模式:Architect(设计和规划)、Code(改代码)、Ask(问代码相关的问题)、Debug(找错误)、Orchestrator(把大任务拆成几部分)。每种模式可以用自己的配置档案。Roo Code 会记住你在每种模式下选的档案,也可以在设置的 Prompts 标签页里固定下来。 效果好的搭配:第一个任务和检查
打开项目文件夹,选 Code 模式,写一个任务,例如:怎样不多花钱
- 换话题就开新任务。 上下文每一步都在变长,而且每次都整段发送。
- 强模型只用在需要的地方。 规划用 Opus,日常修改和提问用便宜的模型。
- 单独的密钥加额度上限。 给 Roo Code 单独建一个密钥,在控制台 → 令牌管理里设好额度上限。
常见问题
401 / Invalid API Key
401 / Invalid API Key
- 确认粘贴的是完整的 RuAPI 密钥
sk-...,没有多余空格。 - Anthropic 提供商的地址是
https://www.ruapi.ai,不带/v1;OpenAI Compatible 的地址是https://www.ruapi.ai/v1,带/v1。
Model Not Found / 404 / 503
Model Not Found / 404 / 503
模型名必须和 RuAPI 上的一字不差,请从价格页复制。
400:「enabled」is not supported for this model
400:「enabled」is not supported for this model
最新的 Claude 模型(Opus 4.7 及以后,以及所有第五代模型)只支持自适应思考(adaptive thinking)。如果旧版 Roo Code 给这类模型打开了带 token 预算的思考,请求会被拒绝。请更新 Roo Code,或者在模型设置里关掉思考。
工具调用出错
工具调用出错
确认选的是文本模型,而不是生成图片或视频的模型。如果某个模型反复出错,换一个试试,例如
claude-sonnet-5-5 或 deepseek-flash。400:The reasoning_content in the thinking mode must be passed back
400:The reasoning_content in the thinking mode must be passed back
DeepSeek 在思考模式下,如果任务做到一半换了模型或档案,可能出现这个错误。大多数情况下 RuAPI 会自动修正后重发请求。如果还报错,开一个新任务。
接下来
- Cline 和 Kilo Code:类似的 VS Code 智能体。
- Claude Code:Anthropic 官方的命令行智能体。
- 模型与价格:有哪些模型可用。