Skip to main content

​
Overview

CodeBuddy and WorkBuddy are AI-powered coding assistants developed by Tencent Cloud that integrate directly into your IDE. By connecting them to AihubMax, you can leverage a wide selection of AI models through AihubMax’s unified API.
CodeBuddy and WorkBuddy use a models.json configuration file to define custom model providers. AihubMax’s OpenAI-compatible endpoint works seamlessly with this configuration method.

​
Prerequisites

AihubMax API Key

An active AihubMax API key with access to the models you want to use.

CodeBuddy / WorkBuddy

The CodeBuddy or WorkBuddy extension installed in your IDE (VS Code, JetBrains, etc.).

​
Configuration

CodeBuddy and WorkBuddy read model definitions from a models.json file. There are two levels of configuration:
  • User-level (applies to all projects): stored in your home directory
  • Project-level (higher priority, applies to a single project): stored in the project root
1

Locate the Configuration File

Choose the appropriate path based on your tool and operating system:
Project-level configuration takes priority over user-level. Use project-level config when you need different models or API keys for specific projects.
2

Create the models.json File

Create the models.json file at the path from the previous step. Here is a basic example with one model:
Replace sk-your-foxapi-api-key with your actual AihubMax API key.
The URL must be the full chat completions endpoint: https://api.aihubmax.com/v1/chat/completions. Do not use just the base URL.
3

Add More Models (Optional)

You can define multiple models in the models array. Each entry appears as a selectable model in the extension:
Refer to AihubMax’s model list for all available model IDs.
4

Select the Model in Your IDE

After saving the models.json file, the extension auto-detects the changes — no restart required. Open CodeBuddy or WorkBuddy in your IDE and select one of the AihubMax models you configured from the model dropdown.

​
Configuration Reference

Each model entry in models.json supports the following fields:

​
Verify the Connection

After configuring models.json:
  1. Open any code file in your IDE.
  2. Select one of your AihubMax models from the model dropdown.
  3. Trigger the AI assistant (e.g., select code and ask for an explanation, or start an inline chat).
  4. If the response is generated successfully, the connection is working.

​
Troubleshooting

  • Verify your API key is correct and has sufficient balance.
  • Check that the url field is exactly https://api.aihubmax.com/v1/chat/completions.
  • Ensure the id field matches a model available on AihubMax.
  • Validate the JSON syntax of your models.json file (no trailing commas, proper quoting).
  • Confirm the models.json file is in the correct directory (see Locate the Configuration File).
  • The extension auto-detects file changes, but try restarting the extension or IDE if models still do not appear.
  • Ensure the JSON file is valid. You can check with:
  • Try switching to a faster model (e.g., claude-sonnet-4-20250514 instead of claude-opus-4-20250514).
  • Check your network connection.
  • Ensure supportsToolCall and/or supportsImages are set to true in your model entry.
  • Not all models support these features. Check the model’s capabilities on AihubMax’s model list.

​
Security Best Practices

  • Never commit models.json to version control if it contains your API key. Add .codebuddy/ and .workbuddy/ to your .gitignore file.
  • Use project-level config with caution. If working in a shared repository, prefer user-level configuration to avoid accidentally exposing your API key.
  • Monitor usage on your AihubMax dashboard to detect any unexpected consumption.