OpenCode 接入 Ace Data Cloud从 API Key 到终端对话的完整配置想在终端里使用 OpenCode又希望模型接入路径足够清晰Ace Data Cloud 提供兼容 OpenAI 风格的 API 接口可以把它配置为 OpenCode 的自定义 Provider。本文按“获取 Key → 安装 → 配置 → 验证”的顺序给出一份可以照着操作的入门指南。本文基于 Ace Data Cloud 的 OpenCode CLI 配置指南 整理。模型名称与可用性可能变化请以 实时模型目录 和自己账户中的配置为准。1. 获取 API Key登录 Ace Data Cloud 应用列表进入可用的应用复制对应的 API Key。这里拿到的是业务 API 调用所用的密钥不要贴进博客、提交到 Git 仓库或发给他人。2. 安装 OpenCode可以按官方安装脚本安装curl -fsSL https://opencode.ai/install | bash也可以使用 npmnpm install -g opencode-ai安装后先确认终端能执行opencode。3. 把 Key 放进环境变量在当前终端会话中执行export ACEDATACLOUD_API_KEY你的 API Key希望新终端也能读取时可以将这行加入~/.zshrc或~/.bashrc然后重新打开终端。注意不要把真实密钥写进公开分享的配置示例中。4. 配置 Ace Data Cloud Provider编辑~/.config/opencode/opencode.json写入以下配置如果已有配置请把provider.acedatacloud部分合并进去而不是覆盖其他 Provider。{ $schema: https://opencode.ai/config.json, provider: { acedatacloud: { npm: ai-sdk/openai-compatible, name: Ace Data Cloud, options: { baseURL: https://api.acedata.cloud/v1, apiKey: {env:ACEDATACLOUD_API_KEY} }, models: { MODEL_ID: { name: MODEL_ID } } } } }有两个关键点baseURL指向 Ace Data Cloud 的 API 地址在这条接入路径中OpenCode 使用 Chat Completions因此适配器采用ai-sdk/openai-compatible。MODEL_ID是占位符。到 Ace Data Cloud 模型目录 查找当前可用模型或用/v1/models响应中的id核对然后把上面两个MODEL_ID一起替换成同一个模型 ID。这里要用的是 API 请求里的模型名不是服务或 API 的 UUID。这也是平台对开发者友好的地方应用中的 Key、统一的 API 基础地址与模型目录把接入步骤串了起来更换模型时重点核对模型 ID 和对应应用的可用范围而不是照抄一份可能过期的型号清单。5. 验证配置再进入项目依次执行opencode auth list opencode models acedatacloud opencode run --model acedatacloud/MODEL_ID Reply only OK最后一行同样需要换成你实际选用的模型 ID。如果命令正常返回就可以进入项目目录执行opencode在终端中使用该 Provider。如果模型没有出现在列表里优先检查配置文件路径、JSON 语法、环境变量是否已导出以及模型 ID 是否准确。遇到401先核对 Key 是否有效、当前终端是否真的读到了环境变量。Provider、IDE 扩展与 MCP 不要混为一谈本文配置的是OpenCode 终端的模型 Provider。OpenCode IDE 扩展复用其运行时配置但仍应分别验证编辑器内的聊天、文件读取与工具调用MCP 则是让 OpenCode 调用外部工具的另一条能力路径不等同于配置模型 Provider。如果想继续拓展可阅读 OpenCode IDE 接入说明 与 OpenCode MCP 总览。快速入口Ace Data Cloud 应用管理 · 实时模型目录 · 原始配置文档参考OpenCode 官方 Provider 文档 · OpenCode 官方配置文档