Cline 接入猫云
本文依据工具官方第三方供应商配置文档，调整为猫云接入示例，不是官方对本站的认证。本站尚未对本文工具链逐一实测；下面是配置参考及供用户自行执行的验收步骤，本文编写期间未执行收费请求。请先安装工具、创建猫云 API Key，并在模型广场及密钥分组中确认可用模型。将 REPLACE_WITH_MODEL_ID 替换为完整模型 ID，不要把界面显示名当作 ID。
从扩展设置选择第三方供应商
在 VS Code 打开 Cline 侧边栏 → 齿轮设置 → API Provider，选择 OpenAI Compatible。本教程不是选择官方 OpenAI 登录，也不使用 Claude 订阅登录。先记下现有设置或保存当前配置；仅修改你打算使用的配置，不清除其他供应商。
| 字段 | 猫云设置 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.nekocloud.vip/v1 |
| API Key | REPLACE_WITH_API_KEY，替换为自己的猫云 Key |
| Model / Model ID | REPLACE_WITH_MODEL_ID，替换为准确模型 ID |
| Use Azure Identity Authentication | 不启用；本教程使用猫云 API Key |
Key 字段直接输入密钥，而不是环境变量名。本页不假设该 UI 会自动展开 NEKOCLOUD_API_KEY。模型列表若没有目标条目，使用当前版本提供的手动 ID 输入；无法输入时先核对版本和官方配置文档，不以随便选择另一个显示名代替。
官方页面还列出 Model Configuration 下的 Max Output Tokens、Context Window、图片、Computer Use 与价格等参数。它们是客户端配置能力，不是本站对某模型能力或价格的声明。只根据已确认的模型信息填写；不要照搬其他供应商的数字，也不要为了能保存而把工具或图片开关全部打开。若界面提供 Verify，主动点击也应视为可能发送请求，不把“保存成功”当作调用验收。
保存设置；若当前版本区分 Plan 与 Act 的模型配置，检查你将使用的模式是否也选中了猫云，而不要只修改另一个模式。先保存编辑器文件，再执行 VS Code Developer: Reload Window，重新打开 Cline 并新建任务，确认实际生效的 provider 和模型。
协议边界
本页按第三方 OpenAI Compatible 的 Chat Completions 配置编写，Base URL 保留 /v1，不要填写完整 /v1/chat/completions。支持 Chat Completions 不自动意味着支持 Responses 或 Anthropic Messages；若错误指向 /responses，先核对当前版本的供应商实现和所选路由，不要只替换模型名。
本站 Anthropic 根地址是 https://api.nekocloud.vip。使用 Anthropic 时需要另选支持自定义地址的 Anthropic 供应商配置并核对其 URL 拼接规则，不把这个根地址填进本页的 OpenAI 字段。工具交互是否可用必须通过下面的只读测试，不以聊天回复或手工勾选能力作为证明。
验收：回复、使用记录、只读工具闭环
以下操作会向模型发起请求，可能产生费用，仅在你同意后执行。先关闭自动批准、自动执行命令及不必要的后台请求，使用无敏感信息的小型测试项目。
- 新建对话，确认当前供应商和模型，发送「只回复 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、容器要确认配置和环境变量属于实际运行插件的宿主，而不是仅属于本地终端。