CloudAwn 文档

Appearance

OpenCode 配置教程 ​

本文适用于 OpenCode 2。CloudAwn 可通过 OpenCode 的 OpenAI 兼容 Provider 接入；在页面底部复制或下载示例配置，填入 API 密钥后即可开始使用。

1. 创建配置文件 ​

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

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

也可以在项目根目录新建 opencode.json，为该项目设置模型和 Provider。项目配置与全局配置合并，发生冲突的普通配置项以项目配置为准。

2. 切换或增加模型 ​

CloudAwn 模型广场 中可用的模型，可以配置在同一个 cloudawn.top Provider 下。默认模型的格式为 cloudawn.top/模型 ID。

示例已经包含 glm-5.3，要将其设为默认模型，只需修改顶层 model：

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

要添加尚未定义的模型，先在 providers.cloudawn.top.models 中增加以该模型 ID 为键的配置，再修改顶层 model。复制模型块时，应分别核对工具调用、图片输入和上下文限制，不要只替换模型名称。

临时切换当前会话的模型，可以在 OpenCode 中运行 /models。此操作不会改写配置文件中的默认模型；已有会话的模型选择也会优先于配置中的默认值。

模型 ID、可用性和实时价格请以 模型广场 及当前账号权限为准。

3. 模型能力与推理档位 ​

输入和工具能力 ​

capabilities 用于声明模型的输入、输出和工具调用能力。例如，支持文字、图片输入和工具调用的模型可写为：

json
"capabilities": {
  "tools": true,
  "input": ["text", "image"],
  "output": ["text"]
}

纯文本模型应将 input 写为 ["text"]。声明 "image" 或 "tools": true 不会给模型增加实际能力，仍需模型和 CloudAwn 对应渠道支持。

推理档位 ​

variants 是数组，每个条目使用 id 定义档位名称，并通过 settings 或 body 设置实际请求参数。下面仅演示渠道接受 reasoning_effort: low/high 时的配置方式；它不代表页面中的所有模型都支持这组参数：

json
"variants": [
  { "id": "low", "body": { "reasoning_effort": "low" } },
  { "id": "high", "body": { "reasoning_effort": "high" } }
]

将这段加入对应模型块后，可通过 cloudawn.top/模型 ID#high 为一次运行选择档位。档位名称只是本地标识，实际参数及允许值需要按具体模型和渠道确认；不要仅添加空档位，也不要默认把 max 等名称直接作为接口参数发送。

下面的基础配置使用模型默认的推理行为，你可以在确认参数后自行添加档位。更多字段见 OpenCode 模型文档。

上下文和输出预算 ​

如果已知模型和渠道的实际 token 上限，可以在模型块中增加 limit.context 和 limit.output。这些值用于 OpenCode 的上下文管理和输出预算，不会改变服务端上限，应逐型号填写。

下面的基础配置未指定 limit；自定义模型没有目录数据时，OpenCode 的默认假设为 200,000 token 上下文和 32,000 token 输出。这些默认值不是自动检测结果，使用较长上下文前应按实际渠道限制补充配置。

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

下载示例配置文件，或复制以下 JSON。将 sk-xxx 替换为你的 CloudAwn API 密钥，保存到第 1 节对应的路径。

配置以 deepseek-v4.1-flash 为默认模型，并包含几个常用模型示例。你可以自由增加、删除或替换 models 中的模型，也可以修改顶层 model 设置默认模型。

json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "cloudawn.top/deepseek-v4.1-flash",
  "providers": {
    "cloudawn.top": {
      "package": "@opencode/ai/providers/openai-compatible",
      "name": "CloudAwn",
      "settings": {
        "baseURL": "https://api.cloudawn.top/v1",
        "apiKey": "sk-xxx"
      },
      "models": {
        "deepseek-v4.1-flash": {
          "name": "deepseek-v4.1-flash",
          "capabilities": {
            "tools": true,
            "input": ["text", "image"],
            "output": ["text"]
          }
        },
        "deepseek-v4-pro": {
          "name": "deepseek-v4-pro",
          "capabilities": {
            "tools": true,
            "input": ["text"],
            "output": ["text"]
          }
        },
        "glm-5.3": {
          "name": "glm-5.3",
          "capabilities": {
            "tools": true,
            "input": ["text"],
            "output": ["text"]
          }
        },
        "glm-5.3-flash": {
          "name": "glm-5.3-flash",
          "capabilities": {
            "tools": true,
            "input": ["text", "image"],
            "output": ["text"]
          }
        },
        "kimi-k3": {
          "name": "kimi-k3",
          "capabilities": {
            "tools": true,
            "input": ["text", "image"],
            "output": ["text"]
          }
        }
      }
    }
  }
}

首次配置后运行 opencode，再通过 /models 查看模型。修改配置后，在项目目录执行：

bash
opencode reload

该命令会重新加载配置，无需重启后台服务。可以使用 opencode models 检查模型列表，或使用 opencode debug config 检查配置来源和加载结果。

Provider 字段说明见 OpenCode Provider 文档。

CloudAwn API 服务文档