OpenCode

先在统一配置引导中选择模型和协议，再选择或创建匹配密钥。引导会提供可复制配置；支持 CC Switch 的 CLI 优先使用 CC Switch。

保存密钥

在 OpenCode 中运行 /connect，选择 Other，服务商 ID 填写 toodooai，输入 Toodoo AI 密钥。这里的 ID 必须与下面配置中的键一致。OpenCode 官方服务商文档

配置模型

在 OpenCode 使用的 opencode.json 中合并以下配置，将两处 YOUR_MODEL_ID 替换为完整模型 ID：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "toodooai/YOUR_MODEL_ID",
  "provider": {
    "toodooai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Toodoo AI",
      "options": { "baseURL": "https://toodooai.com/v1" },
      "models": {
        "YOUR_MODEL_ID": { "name": "我的 Toodoo AI 模型" }
      }
    }
  }
}

这里使用 Chat Completions 兼容适配器。若模型 ID 自带 provider/ 前缀，也要完整保留；最外层的 toodooai/ 是 OpenCode 的服务商选择标识。

验证

运行 /models 选择配置的模型，先尝试短文本，再测试工具调用。若当前 OpenCode 版本使用不同配置格式，按该版本官方文档迁移，不混用不同大版本的字段。

配置检查清单

1. /connect 中的服务商 ID 使用 toodooai，并保存了当前 API 密钥。
2. opencode.json 中的 provider.toodooai 键与服务商 ID一致。
3. options.baseURL 使用 https://toodooai.com/v1，没有重复添加 /chat/completions。
4. models 中的模型键与控制台返回的完整模型 ID一致。
5. model 外层的 toodooai/ 是 OpenCode 的 provider 前缀，不要把它删掉；模型对象内部的键仍应保留原始模型 ID。

配置文件示例只展示 OpenAI Compatible 路线。当前模型如果要求 Anthropic Messages，不要强行套用这份配置，应改看 Claude Code 或 Anthropic SDK。

验证顺序

在 OpenCode 中运行 /models，选择刚添加的模型，然后依次执行：

1. 发送短文本，确认基础回复。
2. 让它读取测试目录中的无敏感文件。
3. 再验证编辑或工具调用。
4. 回到 Toodoo AI 日志功能检查请求是否使用了预期模型。

常见问题

• 模型列表为空：确认 /connect 的密钥有效，并检查 JSON 中是否误删了 models 定义。
• 404：检查 baseURL 是否多写 /v1/chat/completions，或客户端是否再次拼接路径。
• 401：重新运行 /connect 更新密钥，避免把密钥直接写进会被同步的配置文件。
• 工具调用失败：基础对话不等于工具能力可用，换用支持工具调用的模型并检查高级参数。

若 OpenCode 大版本改变配置字段，以官方 provider 文档为准；保留 Toodoo AI 的地址、密钥和完整模型 ID即可。