配置速查
字段和 Cline 一致，但要注意当前激活的是哪个 Profile。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
API Provider | OpenAI Compatible | 选了别的不会出现 Base URL 字段 |
Base URL | https://turingapi.space/v1 | 必须带 /v1 |
Model ID | 站内实际模型名 | 手写，建议配 Profile 前先确认拼写 |
前置准备
先规划好 Profile，再填字段。
在 注册页 建账号，控制台新建密钥并保存。
Roo Code 同样靠 tool call 干活，模型不支持 tools 会静默停住。
如果打算同时保留官方接口，建议一开始就建一个「图灵」Profile，避免后面来回改。
配置步骤
配置流程和 Cline 类似，多一步 Profile 确认。
插件内配置 主流程
- 在 VS Code 侧边栏打开 Roo Code
- 进入设置，API Provider 选
OpenAI Compatible - Base URL 填
https://turingapi.space/v1 - 填入 API Key
- Model ID 填站内模型名
- 保存后确认顶部显示的是当前 Profile
有多个 Profile 时，改完配置要确认激活的是哪一个，否则会出现「改了没反应」。
多 Profile 切换 特有功能
- 在设置里新建一个 Profile，命名如「turing」
- 在这个 Profile 下填图灵 API 的地址和密钥
- 需要切换时从下拉里选对应 Profile
- 切换后重新发一条消息，确认走的是新配置
不同 Profile 可以绑不同模型，用来对比同一个任务在两个模型下的表现。
模式（Mode）与模型不匹配 特有坑
- Roo Code 有 Code / Architect / Ask 等模式
- 某些模式对模型能力要求更高（例如 Architect 需要长上下文）
- 模式行为异常时先换模式，再怀疑模型
同一个模型在 Ask 模式下正常、在 Architect 模式下跑偏，通常是上下文或推理能力不够，不是配置问题。
验证是否配置成功
看到这些就说明通了
- 在当前 Profile 下发一句「列出当前目录的文件」
- 能看到工具调用被执行并返回结果
- 控制台「用量」页出现记录
能列出文件说明工具调用链路完整。
改了配置但行为没变
- 确认改的是当前激活的 Profile
- 确认保存后没有切回旧 Profile
- 重启 VS Code 让插件重新加载配置
这是 Roo Code 最高频的「配置无效」原因。
常见问题
Roo Code 的问题多在 Profile 和模式这两层。
为什么改完配置完全没生效？
先看当前激活的是哪个 Profile。Roo Code 支持多套配置并存，你很可能改在了没有激活的那一套上。
和 Cline 的配置能通用吗？
思路一样：Provider 选 OpenAI Compatible，Base URL 带 /v1，Model ID 手写。但两者的配置存储不共享，需要各配一次。
Profile 有什么用？
存多套配置随时切换。典型用法：一套走官方、一套走这里，或者按任务类型绑不同模型，做效果对比。
某个模式下表现很差？
换模式再试。不同模式对上下文长度和推理能力的要求不同，同一个模型在不同模式下表现差异会很明显。
相关客户端
CCline
靠工具调用干活，模型必须支持 tools
CCursor
必须手动添加模型名，它不会自动拉
CClaude Code
走 Anthropic 协议，地址不带 /v1
CCodex CLI
wire_api 要写 responses，不是 chat
接入过程卡住了？到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」，比只说"用不了"好排查得多。其他通用问题见 常见问题。