OpenCode 接入猫云
本文依据工具官方第三方供应商配置文档，调整为猫云接入示例，不是官方对本站的认证。本站尚未对本文工具链逐一实测；下面是配置参考及供用户自行执行的验收步骤，本文编写期间未执行收费请求。请先安装工具、创建猫云 API Key，并在模型广场及密钥分组中确认可用模型。将 REPLACE_WITH_MODEL_ID 替换为完整模型 ID，不要把界面显示名当作 ID。
配置入口与最小示例
在项目根目录打开 opencode.json；也可使用官方支持的全局配置 ~/.config/opencode/opencode.json，但本教程以项目配置为例。先读取并备份现有文件，再把 nekocloud 合并到现有 provider 对象中，不要重复声明整个 provider 或删除已有供应商。以下展示独立结构，已有文件应只提取相关字段：
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"nekocloud": {
"npm": "@ai-sdk/openai-compatible",
"name": "NekoCloud",
"options": {
"baseURL": "https://api.nekocloud.vip/v1",
"apiKey": "{env:NEKOCLOUD_API_KEY}"
},
"models": {
"REPLACE_WITH_MODEL_ID": {
"name": "NekoCloud model"
}
}
}
}
}models 的对象键是请求中的真实模型 ID，name 仅用于显示；不在示例中猜测上下文、输出上限、图片或工具能力。让启动 OpenCode 的进程安全获得 NEKOCLOUD_API_KEY，不要仅在另一个终端设置变量。变量引用是 OpenCode 的 {env:...} 语法，不是 Shell 的 $...。
不使用环境变量时，可去掉 options.apiKey，在 TUI 输入 /connect → Other → provider ID nekocloud，再通过交互提示输入自己的 Key。ID 必须与配置一致；/connect 只保存凭据，不会替你创建模型配置。官方说明凭据保存在 ~/.local/share/opencode/auth.json，不要分享该文件，也不要同时混用多套认证来源。
保存后退出并重新启动 OpenCode，使配置及启动环境重新加载，执行 /models，选择 NekoCloud / 对应模型，然后新建对话。模型不出现时先核对文件、JSON 语法、provider ID 和模型键，而不是删除认证文件。
Chat、Responses 与 Anthropic 不可混用
上例采用 @ai-sdk/openai-compatible，用于 /v1/chat/completions。若已确认所选路由使用 /v1/responses，将这个供应商的 npm 改为 @ai-sdk/openai，基础地址仍是 https://api.nekocloud.vip/v1；两者不是可以无条件互换的“OpenAI 兼容”开关。不要把 /chat/completions 或 /responses 追加到 baseURL。
Anthropic Messages 是另一种协议，本站提供的 Anthropic 根地址为 https://api.nekocloud.vip，不是上述 OpenAI 配置的替代值。Anthropic SDK 可能要求包含版本路径的 baseURL，应另按该 SDK 文档核对；本页不提供未验证的 Anthropic 配置，也不承诺所有模型都支持上述两条 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、容器要确认配置和环境变量属于实际运行插件的宿主，而不是仅属于本地终端。