Cline / Roo Code

当前状态：待复验。Cline 与 Roo Code 的版本、设置名称和权限模型不同；一个工具的本地结果不能外推到另一个工具。

前置条件

• 使用官方发布的 Cline 或 Roo Code，并记录扩展与 VS Code 版本。
• 查阅 Cline 的OpenAI 兼容配置说明或当前 Roo Code 官方说明。
• 创建可撤销 API Key，避免写入共享 .vscode 或工作区设置；从模型目录复制模型 ID。
• 在非生产工作区审查代理读取文件、执行命令和写入内容的权限。

入口与计费方式

项目	本页范围
协议与入口	OpenAI 兼容通用余额：https://tokenfactory.cn/api/v1
鉴权	控制台 API Key，保留在本地安全存储或个人环境变量
权益	通用余额
不包含	Coding Plan、远程组织配置与未说明的扩展功能

准确配置

1. 在扩展面板打开设置或 API Provider 配置，选择 OpenAI Compatible 或当前版本的自定义提供方。
2. 填写上表 Base URL、API Key 和原始模型 ID；额外上下文、输出长度或能力字段不能用猜测值填充。
3. 保存后重新打开设置，确认提供方没有回退为默认项；Cline 与 Roo Code 分别执行此配置。

验证

在新建非生产工作区执行低风险任务，发送前确认面板显示的 Provider、Base URL 与模型 ID。

故障排查

• 认证失败：检查 Key 是否保存在当前用户配置，且没有进入聊天或仓库。
• 模型不可用：从模型目录复制原始 ID，确认未被客户端改写。
• model_not_found、权益不足或超时：按错误处理处理。

安全提示

编码代理可能读取工作区并执行操作，应设定最小目录、最小权限和人工确认边界。流式中断后先检查任务是否部分执行，不依赖自动重试处理副作用。

更新信息

本页保持待复验。未来真实复验后仅在本页补充测试版本、验证日期、适用入口和已知限制。