Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clearmaas.com/llms.txt

Use this file to discover all available pages before exploring further.

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