OpenCode 可以通过自定义 provider 接入云信大模型 API 平台（简称 AIHub）。推荐使用 Anthropic provider 或 OpenAI-compatible provider，具体选择取决于当前 OpenCode 版本支持的 provider 包和模型能力。

安装 OpenCode

1. OpenCode 需要 Node.js 18 或更高版本，请先确认本机环境：

   bashnode --version
   

2. 执行以下命令安装 OpenCode：

   bashnpm install -g opencode-ai
   

3. 安装完成后确认命令可用：

   bashopencode -v
   

配置接入凭证

OpenCode 的配置文件支持声明 provider、Base URL、API Key 和模型列表。配置参数与 AIHub 的对应关系如下：

OpenCode 配置项	填写内容
Provider	OpenAI-compatible 或 Anthropic-compatible
Base URL	OpenAI-compatible 使用 $AIHUB_BASE_URL/v1；Anthropic provider 使用 $AIHUB_BASE_URL/v1 或工具要求的 Messages endpoint
API Key	AIHUB_TOKEN，即 AIHub API 密钥/访问令牌
Model	AIHub 模型名称

OpenAI-compatible provider

将以下配置合并至 OpenCode 配置文件（如 ~/.opencode/config.json）：

json{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aihub": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Aihub",
      "options": {
        "baseURL": "https://ai.yunxinapi.com/hub/v1",
        "apiKey": "sk-..."
      },
      "models": {
        "your-logical-model": {
          "name": "Aihub logical model"
        }
      }
    }
  }
}

Anthropic provider

如使用 Anthropic provider，将 Base URL 指向 AIHub Anthropic Messages 兼容入口（$AIHUB_BASE_URL/v1/messages），配置方式与上类似，只需更换对应的 provider 包和 Base URL。

验证配置

1. 使用 curl 验证端点。

   bashcurl "$AIHUB_BASE_URL/v1/chat/completions" \
     -H "Authorization: Bearer $AIHUB_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "'"$AIHUB_MODEL"'",
       "messages": [
         {"role": "user", "content": "只回复 OK"}
       ]
     }'
   

2. 在 OpenCode 中验证。

   在 OpenCode 中选择 AIHub provider 和目标逻辑模型，发起一次最小请求。

   如果控制台请求日志中出现 /v1/chat/completions 或 /v1/messages 请求，说明配置已生效。

常见问题

现象	排查方向
找不到模型	配置中的模型 ID 必须与 AIHub 模型名称完全一致。
401/unauthorized	API Key 未正确填写 AIHUB_TOKEN，或令牌已禁用。
404	Base URL 缺少 /hub 或 /v1，或把完整 endpoint 错填到了只接受根地址的字段中。
model not allowed/no candidate	当前访问令牌未授权该模型，或模型无可用路由。