客户端配置
Cline / Roo Code
在编辑器扩展中配置兼容端点。
Cline / Roo Code
两款扩展都支持 OpenAI-compatible provider，但具体菜单会随版本变化。核心字段如下，模型 ID 必须来自当前 Key 的 /v1/models 返回。
开始前准备
- 先通过 cURL 验证
<API_KEY>与<MODEL>。 - 安装 Cline 或 Roo Code，确认扩展已启用。
- 了解 Agent 任务可能消耗更多 Token，第一次测试使用小任务和专用 Key。
配置步骤
- 打开扩展的 Settings 或 API Provider 配置。
- Provider 选择
OpenAI Compatible。 - 填写下列字段。若有模型能力、上下文窗口等高级选项，第一次先保持默认。
text
API Provider: OpenAI Compatible
Base URL: https://suoxie.codes/v1
API Key: <API_KEY>
Model ID: <MODEL>- 保存配置并重新加载扩展窗口。
- 确认任务界面选中的是刚配置的 provider 与模型。
验证
先在可丢弃目录创建一个极小任务，例如读取一个文本文件并说明内容。保持自动执行和高权限操作关闭，确认模型能回复后再逐步启用工具。
成功标志： 扩展能返回规划或文字响应，用量页显示对应模型和 Key。
常见问题
| 现象 | 先检查什么 |
|---|---|
| Provider 连接失败 | Base URL、代理、证书和扩展网络权限 |
| 401 | Key 是否完整、有效且没有多余空格 |
| 403 | 分组是否允许该模型和需要的能力 |
| 模型错误 | Model ID 是否精确匹配 /v1/models |
| 文本可用但工具失败 | 先关闭工具，检查模型/扩展对工具调用的支持 |
安全与成本
Cline 和 Roo Code 可以读取文件并执行命令。API Key 只解决模型认证，不会限制扩展的本地文件权限。开始前检查扩展审批模式，并为测试 Key 设置合理配额。不要在项目说明文件中保存 Key。
下一步
基础文本任务通过后，每次只启用一种能力，例如代码库读取或命令执行，并在 Key 用量中观察 Token 与费用。