Skip to main content
WorkBuddy (also known as Tencent Cloud CodeBuddy) is an AI task automation component of the CodeBuddy ecosystem. Add ClearMaas as a custom OpenAI-compatible model provider to use any of the 570+ models in your coding workflows.

​
Prerequisites

  • WorkBuddy / CodeBuddy installed (codebuddy.cn)
  • A ClearMaas API key starting with sk-

​
Setup via models.json

WorkBuddy supports file-based model configuration. Create or edit models.json: User-level (all projects): ~/.codebuddy/models.json Project-level (single project): .codebuddy/models.json Project-level settings override user-level for matching model IDs.

​
Adding ClearMaas

{
  "models": [
    {
      "id": "clearmaas-claude-sonnet",
      "name": "Claude Sonnet via ClearMaas",
      "vendor": "OpenAI",
      "apiKey": "sk-...",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "url": "https://api.clearmaas.com/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "clearmaas-gpt-4o-mini",
      "name": "GPT-4o Mini via ClearMaas",
      "vendor": "OpenAI",
      "apiKey": "sk-...",
      "maxInputTokens": 128000,
      "maxOutputTokens": 16384,
      "url": "https://api.clearmaas.com/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    }
  ]
}
Key fields:
FieldDescription
urlFull path to the chat completions endpoint (must include /chat/completions)
vendorMust be "OpenAI" �?only OpenAI interface format is supported
supportsToolCallEnable tool/function calling support
supportsImagesEnable image input (vision)

​
Setup via UI

Since 2025, WorkBuddy supports graphical model configuration:
  1. Open WorkBuddy settings
  2. Navigate to Models or AI Settings
  3. Click Add Custom Model or Add Provider
  4. Fill in:
FieldValue
ProviderOpenAI Compatible
API Keysk-...
Base URLhttps://api.clearmaas.com/v1
Model IDe.g., anthropic/claude-sonnet-4.6
Max Input Tokens200000
Max Output Tokens8192
Capabilities like tool calling and image input are auto-populated when selecting standard vendors.

​
Model format

When specifying the model ID, use ClearMaas’s provider/model-name format:
Model IDDescription
anthropic/claude-sonnet-4.6Claude Sonnet 4.6
anthropic/claude-opus-4.8Claude Opus 4.8
openai/gpt-4o-miniGPT-4o Mini
google/gemini-2.5-proGemini 2.5 Pro
deepseek/deepseek-chatDeepSeek Chat
grok/grok-4-fast-reasoningGrok 4 Fast Reasoning

​
Ollama and local models

WorkBuddy also supports local models via Ollama. If you have both Ollama and ClearMaas configured, WorkBuddy can route between them:
  • Ollama: http://localhost:11434/v1/chat/completions
  • ClearMaas: https://api.clearmaas.com/v1/chat/completions

​
Custom protocol for gateways

If your ClearMaas URL uses non-standard paths, enable Custom Protocol in the advanced settings to skip path validation.

​
Verification

  1. After adding ClearMaas, select the model from the model picker
  2. Ask a coding question or run a task
  3. Check your ClearMaas dashboard to confirm the request was routed

​
See also