OpenCode

OpenCode 是一款终端 AI 编程工具，可通过 SilvaMux Coding Plan 接入。

前置准备

  1. 购买订阅：在订阅页选择 Lite / Pro / Max 档位与月付/季付/年付周期，购买 Coding Plan 个人版；支付成功后订阅立即生效。
  2. 创建订阅 API Key：进入控制台 → Coding Plan → API Keys，点击创建，并立即复制以 cp_live_ 开头的完整 Key。
  3. 确认端点与协议：Base URL 为 https://www.silvamux.com/api/coding-plan/v1，兼容 OpenAI 与 Anthropic 两种协议；各端点字段详情见端点与协议。
cp_live_ Key 只能调用 /api/coding-plan/v1 订阅端点，用于常规端点（如 /api/v1/chat/completions）会返回 403 CODING_PLAN_KEY_NOT_ALLOWED；同理，常规 sk_live_ Key 也不能调用订阅端点。

购买套餐、创建 Key 与验证调用的完整流程见快速接入。

安装 OpenCode

  1. 安装 Node.js（v18.0 或更高版本）。
  2. 在终端中执行以下命令安装 OpenCode。
npm install -g opencode-ai

运行以下命令验证安装，若有版本号输出则表示安装成功。

opencode -v

配置接入凭证

使用文本编辑器打开配置文件：

  • macOS / Linux：~/.config/opencode/opencode.json
  • Windows：C:\Users\<用户名>\.config\opencode\opencode.json

写入以下配置，将 YOUR_API_KEY 替换为你的 cp_live_ Key。OpenAI 兼容入口由 @ai-sdk/openai-compatible 提供。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "silvamux-coding-plan": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SilvaMux Coding Plan",
      "options": {
        "baseURL": "https://www.silvamux.com/api/coding-plan/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro"
        },
        "glm-5.2": {
          "name": "GLM 5.2"
        },
        "minimax-m3": {
          "name": "MiniMax M3"
        }
      }
    }
  }
}

如需使用 Anthropic Messages 协议，可改用 @ai-sdk/anthropic，其余配置不变：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "silvamux-coding-plan": {
      "npm": "@ai-sdk/anthropic",
      "name": "SilvaMux Coding Plan",
      "options": {
        "baseURL": "https://www.silvamux.com/api/coding-plan/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro"
        }
      }
    }
  }
}

可用模型以 GET /api/coding-plan/v1/models 与模型广场为准。

验证配置

保存配置后重启 OpenCode，输入 /models，选择 SilvaMux Coding Plan 下的模型即可开始对话。

常见问题

调用时返回 401

cp_live_ Key 必须与 https://www.silvamux.com/api/coding-plan/v1 搭配使用，两者不匹配会返回 401。

调用时返回 404

检查 provider.options.baseURL 是否为 https://www.silvamux.com/api/coding-plan/v1，不要额外添加 /v1 之外的路径。

调用时返回 429

订阅额度任一窗口耗尽会返回 429 QUOTA_EXCEEDED（错误信息会标明 5h / weekly / monthly）。等待窗口恢复，或在控制台查看剩余额度。