本页按 OpenAI Compatible 的 Chat Completions 模式配置。若当前 Roo Code 版本提供独立 Responses 选项，请按其协议配置，不要混用请求体。
配置参数
1
打开 Roo Code 设置
在 VS Code 中打开 Roo Code 面板，点击设置或 Provider 配置。
2
选择 OpenAI Compatible
不要选择只允许官方地址的 OpenAI 配置；选择可自定义 Base URL 的类型。
3
填写连接参数
填入 Base URL、API Key 和模型 ID。如果有 Context Window 字段，按模型实际能力设置，不要盲目填写极大值。
4
保存并测试
新建任务，要求 Roo Code 只解释当前文件，不执行命令、不修改文件。
工具调用验证
普通对话成功后，按顺序测试：- 读取一个非敏感文件。
- 提议修改但不写入。
- 在测试目录修改一行文本。
- 执行无副作用命令。
常见问题
401：重新粘贴 API Key，确认没有多余空格。- 模型不存在：重新复制
/v1/models中的 ID。 - 能聊天但不能使用工具：模型可能不支持工具调用，或 Roo Code 的模型能力配置不正确。
- 上下文过长：降低上下文窗口和一次发送的文件数量。