OpenCode 配置教程

CloudAwn 可通过 OpenCode 的 OpenAI 兼容 Provider 接入。先了解模型切换、视觉输入与推理档位，再在页面底部复制基础配置即可。

1. 创建配置文件

将配置写入全局配置文件后，所有项目都可以使用：

平台	配置文件位置
macOS / Linux	~/.config/opencode/opencode.json
Windows	%USERPROFILE%\.config\opencode\opencode.json

也可以在某个项目根目录新建 opencode.json，仅对该项目生效。项目配置会覆盖同名的全局配置项。

2. 使用模型广场中的其他模型

CloudAwn 模型广场 中的模型都可通过同一个 cloudawn.top Provider 调用。要切换默认模型，请同时修改：

1. 顶层 model：格式为 cloudawn.top/模型 ID。
2. provider.cloudawn.top.models：增加同名模型配置，或复制现有模型块后替换模型 ID。

例如将默认模型切换为 glm-5.3：

"model": "cloudawn.top/glm-5.3"

如果模型需要图片输入、推理档位或不同的上下文限制，可参照 deepseek-v4.1-flash、glm-5.3-flash 或 kimi-k3 的模型块保留对应字段。模型名称、能力和实时价格请以 模型广场 为准。

3. 视觉能力与推理强度

部分模型支持图片输入和多个推理强度档位。要让 OpenCode 正确展示这些能力，请在对应模型块中保留以下字段：

"variants": {
  "low": {},
  "high": {},
  "max": {}
},
"modalities": {
  "input": ["text", "image"]
}

• variants：为该模型提供 low、high、max 三档推理强度选择。任务简单时可选 low，复杂代码、长链路推理或高质量要求时可选择 high 或 max。
• modalities.input：声明该模型可接收文本和图片。保留 "image" 后，可在 OpenCode 对话中附带截图、界面图或其他图片作为输入。

并非所有模型都具备视觉输入或三档推理能力。未在模型广场标注这些能力的模型，不要手动添加对应字段；以模型广场的实际说明为准。

4. 基础配置（可自由修改）

下面配置以 deepseek-v4.1-flash 为默认模型，包含几个常用模型示例。将 sk-xxx 替换为你的 CloudAwn API 密钥后即可使用；你可以按模型广场的模型 ID 自由增加、删除或替换 models 中的模型，也可以修改顶层 model 设置默认模型。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "cloudawn.top/deepseek-v4.1-flash",
  "provider": {
    "cloudawn.top": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "cloudawn.top",
      "options": {
        "baseURL": "https://api.cloudawn.top/v1",
        "apiKey": "sk-xxx"
      },
      "models": {
        "deepseek-v4.1-flash": {
          "name": "deepseek-v4.1-flash",
          "limit": { "context": 204800, "output": 65536 },
          "variants": { "low": {}, "high": {}, "max": {} },
          "modalities": { "input": ["text", "image"] }
        },
        "deepseek-v4-pro": {
          "name": "deepseek-v4-pro",
          "limit": { "context": 204800, "output": 65536 }
        },
        "glm-5.3": {
          "name": "glm-5.3",
          "limit": { "context": 204800, "output": 65536 }
        },
        "glm-5.3-flash": {
          "name": "glm-5.3-flash",
          "limit": { "context": 204800, "output": 65536 },
          "variants": { "low": {}, "high": {}, "max": {} },
          "modalities": { "input": ["text", "image"] }
        },
        "kimi-k3": {
          "name": "kimi-k3",
          "limit": { "context": 204800, "output": 65536 },
          "variants": { "low": {}, "high": {}, "max": {} },
          "modalities": { "input": ["text", "image"] }
        }
      }
    }
  }
}

保存后重新启动 OpenCode。