CodeBuddy

CodeBuddy 是一款基于 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 与验证调用的完整流程见快速接入。

安装并登录 CodeBuddy

前往 CodeBuddy 官网下载并安装适合你操作系统的版本，安装后根据提示登录。

配置模型

CodeBuddy 通过 models.json 自定义模型列表并控制模型下拉列表的显示。建议在用户级配置该文件：~/.codebuddy/models.json（全局配置，适用于所有项目）。

写入以下配置，将 YOUR_API_KEY 替换为你的 cp_live_ Key：

{
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "SilvaMux Coding Plan",
      "vendor": "silvamux",
      "apiKey": "YOUR_API_KEY",
      "url": "https://www.silvamux.com/api/coding-plan/v1",
      "supportsToolCall": true,
      "supportsReasoning": true
    }
  ]
}
请妥善保管 API Key，不要泄露给他人，也不要硬编码在共享的代码仓库中。

字段说明

models（Array<LanguageModel>）定义自定义模型列表，可添加新模型或覆盖内置模型配置：

字段类型必填说明
idstring是模型唯一标识符。
namestring否模型显示名称。
vendorstring否模型供应商。
apiKeystring否API 密钥（实际密钥值，非环境变量名）。
maxInputTokensnumber否最大输入 token 数。
maxOutputTokensnumber否最大输出 token 数。
urlstring否API 端点 URL（必须是接口完整路径）。
supportsToolCallboolean否是否支持工具调用。
supportsImagesboolean否是否支持图片输入。
supportsReasoningboolean否是否支持推理模式。

availableModels（Array<string>）控制模型下拉列表中显示哪些模型：未配置或为空数组时显示所有模型；配置后只显示列出的模型 ID，可同时包含内置模型和自定义模型的 ID。

开始对话

保存配置后回到 CodeBuddy，在对话框选择配置好的模型即可开始对话。可用模型以 GET /api/coding-plan/v1/models 与模型广场为准。

常见问题

调用时返回 401

cp_live_ Key 必须与 https://www.silvamux.com/api/coding-plan/v1 搭配使用，两者不匹配会返回 401；请确认未误用常规 sk_live_ Key。

模型不出现在下拉列表

检查 ~/.codebuddy/models.json 是否为合法 JSON、url 是否为 https://www.silvamux.com/api/coding-plan/v1；若配置了 availableModels，确认模型 id 已列入。

调用时返回 429

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