CodeBuddy

CodeBuddy is an AI-based, full-cycle intelligent coding tool and can connect to SilvaMux Coding Plan.

Before You Start

  1. Purchase a subscription: buy a Coding Plan Personal subscription (Lite / Pro / Max with monthly, quarterly, or yearly billing) on the subscription page; it takes effect immediately after payment.
  2. Create a subscription API key: in the console, go to Coding Plan → API Keys, create a key, and copy the full value starting with cp_live_ right away.
  3. Confirm endpoints and protocols: all tools share the Base URL https://www.silvamux.com/api/coding-plan/v1, compatible with both the OpenAI and Anthropic protocols; see Endpoints & Protocols for endpoint details.
A cp_live_ key can only call the /api/coding-plan/v1 subscription endpoints; using it on regular endpoints (such as /api/v1/chat/completions) returns 403 CODING_PLAN_KEY_NOT_ALLOWED; conversely, a regular sk_live_ key cannot call the subscription endpoints.

For the full flow of purchasing, key creation, and a verification call, see Quick Start.

Install and Sign In to CodeBuddy

Download and install the version for your operating system from the CodeBuddy website, then sign in as prompted.

Configure Models

CodeBuddy customizes the model list and the model dropdown via models.json. Configure it at the user level: ~/.codebuddy/models.json (a global configuration that applies to all projects).

Add the following, replacing YOUR_API_KEY with your 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
    }
  ]
}
Keep your API key safe. Do not share it with others or hard-code it in shared repositories.

Field Reference

models (Array<LanguageModel>) defines the custom model list; you can add new models or override built-in model configurations:

FieldTypeRequiredDescription
idstringYesUnique model identifier.
namestringNoModel display name.
vendorstringNoModel vendor.
apiKeystringNoAPI key (the actual key value, not an environment variable name).
maxInputTokensnumberNoMaximum input tokens.
maxOutputTokensnumberNoMaximum output tokens.
urlstringNoAPI endpoint URL (must be the complete interface path).
supportsToolCallbooleanNoWhether tool calls are supported.
supportsImagesbooleanNoWhether image input is supported.
supportsReasoningbooleanNoWhether reasoning mode is supported.

availableModels (Array<string>) controls which models appear in the model dropdown: when unset or empty, all models are shown; once configured, only the listed model IDs appear — both built-in and custom model IDs can be included.

Start Chatting

Save the configuration, return to CodeBuddy, and select the configured model in the chat box to start. The available models follow GET /api/coding-plan/v1/models and the Model Plaza.

FAQ

401 on calls

A cp_live_ key must be used with https://www.silvamux.com/api/coding-plan/v1; a mismatch returns 401. Make sure you are not using a regular sk_live_ key.

The model does not appear in the dropdown

Check that ~/.codebuddy/models.json is valid JSON and that url is https://www.silvamux.com/api/coding-plan/v1; if availableModels is configured, make sure the model id is listed.

429 on calls

When any subscription quota window is exhausted, calls return 429 QUOTA_EXCEEDED (the message identifies 5h / weekly / monthly). Wait for the window to recover, or check remaining quota in the console.