Kilo Code 接入猫云
本文依据工具官方第三方供应商配置文档，调整为猫云接入示例，不是官方对本站的认证。本站尚未对本文工具链逐一实测；下面是配置参考及供用户自行执行的验收步骤，本文编写期间未执行收费请求。请先安装工具、创建猫云 API Key，并在模型广场及密钥分组中确认可用模型。将 REPLACE_WITH_MODEL_ID 替换为完整模型 ID，不要把界面显示名当作 ID。
当前入口：Providers → Custom provider
打开 Kilo Code → Settings（齿轮）→ Providers 标签，滚动到底部点击 Custom provider。本页遵循当前官方自定义供应商对话框，不使用旧版“在统一 API Provider 面板切换供应商”的描述。已有配置先备份或记录；创建独立供应商，不覆盖原有供应商或手动重写完整 kilo.jsonc。
| 对话框字段 | 猫云示例 |
|---|---|
| Provider ID | nekocloud；若已存在，编辑原项或另取唯一 ID |
| Display name | NekoCloud |
| Provider API | OpenAI Compatible（Chat Completions） |
| Base URL | https://api.nekocloud.vip/v1 |
| API key | REPLACE_WITH_API_KEY，替换为自己的密钥 |
| Models | 添加 REPLACE_WITH_MODEL_ID 对应的真实模型 |
| Headers | 一般留空，不另加冲突的 Authorization |
填写地址和密钥后，Kilo 可以查询供应商的模型列表；这会发出网络请求，不代表已经完成模型推理测试。若自动发现成功，选择准确模型 ID；若失败，手动添加可用 ID，不据此断定整个聊天接口不可用。模型显示名与请求 ID 不同，提交前再核对。API key 输入密钥本身，本页不假设 UI 展开环境变量。
点击 Submit 保存；从模型选择器选择新供应商下的模型。配置高级字段需要按官方 Custom Models 指南编辑实际 kilo.jsonc，但不要猜测 token 限制、tool calling 或 variants，不照搬其他服务的数值。先保存编辑器文件，再执行 VS Code Developer: Reload Window，新建任务并重新核对供应商及模型。
Provider API 决定协议
OpenAI Compatible 对应 Chat Completions；仅在确认模型路由支持时使用 OpenAI Responses，其基础地址仍为 https://api.nekocloud.vip/v1。Anthropic Messages 是独立选项；本站 Anthropic 根地址为 https://api.nekocloud.vip，切换后按该选项的地址规则核对实际路径，不能只改 URL 而保留 OpenAI 协议。
虽然官方说明 Kilo 支持完整端点 URL，本教程统一使用基础地址，不追加 /chat/completions 或 /responses，避免与协议自动拼接及模型发现规则混淆。列表发现、保存配置和普通聊天都不是原生工具闭环的证明；必须观察真实只读调用返回及模型后续回答。不同版本的界面和适配器可能变化，找不到上述 Providers 入口时先核对版本与官方文档。
验收：回复、使用记录、只读工具闭环
以下操作会向模型发起请求，可能产生费用，仅在你同意后执行。先关闭自动批准、自动执行命令及不必要的后台请求，使用无敏感信息的小型测试项目。
- 新建对话，确认当前供应商和模型，发送「只回复 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、容器要确认配置和环境变量属于实际运行插件的宿主，而不是仅属于本地终端。