Roo Code 接入猫云
本文依据工具官方第三方供应商配置文档，调整为猫云接入示例，不是官方对本站的认证。本站尚未对本文工具链逐一实测；下面是配置参考及供用户自行执行的验收步骤，本文编写期间未执行收费请求。请先安装工具、创建猫云 API Key，并在模型广场及密钥分组中确认可用模型。将 REPLACE_WITH_MODEL_ID 替换为完整模型 ID，不要把界面显示名当作 ID。
入口与字段
打开 VS Code 的 Roo Code 侧边栏 → 设置图标 → API Provider，选择 OpenAI Compatible。先保留当前设置，再编辑拟使用的供应商配置；如果安装版本提供配置档案，建议单独创建猫云档案，避免影响原来的任务。
| 字段 | 填写内容 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.nekocloud.vip/v1 |
| API Key | REPLACE_WITH_API_KEY，替换为猫云密钥 |
| Model / Model ID | REPLACE_WITH_MODEL_ID，替换为可调用的完整 ID |
官方设置还包括 Model Configuration，可配置输出上限、上下文窗口、图片、Computer Use 和价格等。不要照抄第三方教程中的模型数字，也不要把配置开关当作能力检测。以本站当前可核验信息为准；本文不列实际能力、限制或价格。列表未列出模型时，检查当前 UI 是否支持手动 ID，保留准确标识，不靠近似名称匹配。
保存配置，确认活动档案和模型；先保存编辑器文件，再执行 Developer: Reload Window，重新打开 Roo Code、新建任务。若新任务仍显示旧供应商，返回设置检查当前选中档案，不删除全部配置来“重置”。Key 字段填实际值，不能假定 UI 会把环境变量名自动替换为密钥。
必须满足原生工具调用
Roo Code 官方文档明确：只支持 native tool calling，没有 XML 工具协议回退。选用的模型以及猫云对应路由必须能够完成 OpenAI 兼容的原生工具调用；纯文字聊天成功不足以证明能运行 Roo。代理需要发出结构化工具参数，客户端执行获准工具后回传结果，模型继续回答。仅输出一段看似工具命令的文本不算调用成功。
本页采用 Chat Completions 兼容入口；客户端会拼接请求路径，因此 Base URL 只填到 /v1。不要假设 Responses 与 Chat Completions 可互换。本站 Anthropic 根地址为 https://api.nekocloud.vip，但 Anthropic Messages 需要对应供应商适配器及认证规则，不能填入这里的 OpenAI Base URL 当作替换方案。
出现“不支持 tools”、工具参数错误或调用一直未完成时，先确认模型及路由是否满足原生工具协议，再执行下方只读闭环测试。不要寻找 XML 开关绕过要求，不要为了让代理继续运行而开放所有执行权限；若不能确认兼容性，应停止并携带脱敏错误信息排查。
验收：回复、使用记录、只读工具闭环
以下操作会向模型发起请求，可能产生费用，仅在你同意后执行。先关闭自动批准、自动执行命令及不必要的后台请求，使用无敏感信息的小型测试项目。
- 新建对话，确认当前供应商和模型，发送「只回复 OK，不调用工具」。收到正常回复后，到猫云主站「使用记录」核对请求时间、模型和 usage/token 信息；客户端估算费用不是本站账单。
- 再发送「仅使用文件读取工具读取现有 README.md 的前几行，给出第一行和一句摘要；不编辑文件、不执行命令、不联网」。没有 README.md 时选择另一份现有无敏感文本，修改提示中的路径，不需要让代理创建文件。
- 手动批准该次只读调用，确认任务轨迹出现实际工具名称、参数和读取结果，随后模型基于工具返回内容作答。仅在回答里声称“已读取”不算通过。再次核对使用记录，并确认工作区没有被修改。
文字回复成功只证明聊天链路；usage 对应成功才证明请求走到预期账号；工具调用、工具返回和后续回答全部完成，才说明此次只读工具闭环通过。失败时停止重试，保留请求时间、模型、错误码和脱敏 request id，不要连续运行长任务。
安全与排错
先备份已有配置，只合并新增供应商或模型条目，不要整文件覆盖其他模型、规则、工具或登录信息。Key 填密钥本身，不加 Bearer 前缀；REPLACE_WITH_API_KEY 只是占位符。不要把真实密钥、认证头、含密钥的配置或敏感源代码提交到 Git、截图或发送给客服；本地配置及备份同样需要保护。
401 先查生效配置、密钥和认证来源；模型不存在先查完整 ID 与分组权限；404 先查地址和协议，避免重复 /v1 或把完整请求路径当作基础地址。429 根据返回信息和使用记录降低频率，不以无限重试解决。不要为排错关闭 TLS 验证、开放执行权限或修改系统网络设置。Remote SSH、WSL、容器要确认配置和环境变量属于实际运行插件的宿主，而不是仅属于本地终端。