OpenCode 接入硅基流动 / 阿里云百炼免费额度：/connect 与 opencode.json 自定义 Provider 教程

准备

• 已安装 OpenCode：桌面客户端可在 OpenCode 官网 下载，终端版可用 npm install -g opencode-ai 安装（百炼文档写法，需 Node.js 18+）
• 一个模型平台的 API Key（硅基流动在 API 密钥 页面创建；百炼见 获取与配置 API Key）

步骤

1. 01

   情况一：内置服务商，/connect 一步到位

   OpenCode 文档说明添加服务商只需两步：用 /connect 命令填 API Key，然后用 /models 选模型。Key 会保存在 ~/.local/share/opencode/auth.json。

   很多本站收录的免费平台都在内置列表里，例如 NVIDIA（文档写明可在 build.nvidia.com 免费使用开放模型）、Groq、OpenRouter、Cerebras、Hugging Face 等，选中后粘贴 Key 即可。

   text复制

   /connect
   /models

2. 02

   情况二：硅基流动中文站

   按 SiliconFlow 官方文档（客户端版）：

   • 打开 OpenCode 客户端，左侧菜单点 + 进入 Connect provider；
   • 选择 SiliconFlow (China)，输入你的 API Key；
   • 在对话框下方的模型下拉菜单里，选 SiliconFlow (China) 目录下的模型。

   注意：列表里的 SiliconFlow（不带 China）对应国际站，两个站点账号不互通，别选错。

3. 03

   情况三：任意 OpenAI 兼容平台（通用写法）

   不在 /connect 列表里的平台，OpenCode 文档给出的做法是：先 /connect → 拉到底选 Other → 填一个自定义 provider ID 和 API Key，再在 opencode.json 里用同一个 ID 声明 provider。npm 填 @ai-sdk/openai-compatible（对应 /v1/chat/completions），options.baseURL 填平台的 Base URL，models 里写模型 ID。

   下面以百炼北京地域的 OpenAI 兼容地址为例（Base URL 取自百炼「获取与配置 API Key」文档），模型 ID 以百炼控制台为准：

   json复制

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "bailian": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "阿里云百炼",
         "options": {
           "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1"
         },
         "models": {
           "qwen-plus": { "name": "Qwen Plus" }
         }
       }
     }
   }

4. 04

   （可选）百炼官方写法：走 Anthropic 兼容接口

   百炼的 OpenCode 文档用的是 @ai-sdk/anthropic + Anthropic 兼容地址。配置文件位置：macOS / Linux 为 ~/.config/opencode/opencode.json，Windows 为 C:\Users\<用户名>\.config\opencode\opencode.json。按量计费北京地域的 baseURL 为 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1（替换为你的 Workspace ID）。

   json复制

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "bailian-payg": {
         "npm": "@ai-sdk/anthropic",
         "name": "Alibaba Cloud Model Studio",
         "options": {
           "baseURL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1",
           "apiKey": "你的百炼API Key"
         },
         "models": {
           "qwen3.7-plus": { "name": "Qwen3.7 Plus" }
         }
       }
     }
   }

5. 05

   验证

   保存后重启 OpenCode，输入 /models，搜索你的 provider 名称（如 Alibaba Cloud Model Studio），选中模型开始对话。

注意事项

• API Key 别写死在项目里：OpenCode 支持 "apiKey": "{env:变量名}" 从环境变量读取，比明文写进 opencode.json 更安全，尤其是项目目录下的配置。
• 工具调用很关键：OpenCode 写代码依赖工具调用，选模型时优先挑支持 function calling 的模型；文档也建议工具调用不稳定时换一个工具调用能力强的模型。
• 百炼新人免费额度只适用于北京地域，且按模型独立计算。

常见问题

相关优惠

• 模型 · GroqGroq 免费 API 限速套餐免费档 30 RPM，主力模型 1000 RPD / 8K TPM / 200K TPD，无需信用卡
• 模型 · OpenRouterOpenRouter 免费模型20 请求/分钟，每日 50 次（累计充值 $10 后提升至每日 1000 次）
• 新人 · 阿里云百炼新人免费额度每个模型 100 万 Tokens（70+ 模型，总额超 7000 万），90 天有效
• 额度 · NVIDIA英伟达 NIM 送 1000 点数注册送 1000 credits

信息来源

• OpenCode · Providersopencode.ai/docs/providers/
• SiliconFlow · OpenCodedocs.siliconflow.cn/cn/usercases/use-siliconcloud-in-openCode
• 阿里云百炼 · OpenCodehelp.aliyun.com/zh/model-studio/opencode
• 阿里云百炼 · 获取与配置 API Keyhelp.aliyun.com/zh/model-studio/get-api-key

最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准