AiHubMix Documentation Hub

CodeBuddy supports custom OpenAI-compatible models. After adding AIHubMix, you can use GPT, Claude, Gemini, DeepSeek, GLM, and other AIHubMix models in CodeBuddy.

Before you start

Install and open CodeBuddy.
Create an API key in the AIHubMix Console. It usually starts with sk-***.
Copy the model ID you want to use, such as gpt-5.5, gemini-3.5-flash, or deepseek-chat, from the AIHubMix model list.

Configure AIHubMix in the interface

Open CodeBuddy and click the current model name below the input box, for example Default.

Scroll to the bottom of the model list and select Configure custom models.

Click Add Model, then choose Custom from the Provider menu.

Complete the following fields:

Endpoint: Use https://aihubmix.com/v1. If it is temporarily unavailable, use the backup endpoint https://api.inferera.com/v1.
API Key: Enter the key created in the AIHubMix Console.
Model Name: Enter the model ID, such as gpt-5.5.
Advanced Settings: Enable Tool Calling, Image Input, or Reasoning only when the selected model supports that capability.

Click Save.

Enter the endpoint, API key, and model name in CodeBuddy

Return to the model picker and select the model from Custom Models.

Add a model through a configuration file

CodeBuddy stores custom models locally. Edit the following file when configuring through the interface is inconvenient:

%USERPROFILE%\.codebuddy\models.json

You can also set a project-level configuration here:

your-project-directory\.codebuddy\models.json

The project-level setting takes precedence. When editing models.json, use the full Chat Completions URL:

{
  "models": [
    {
      "id": "gpt-5.5",
      "name": "gpt-5.5",
      "vendor": "AIHubMix",
      "url": "https://aihubmix.com/v1/chat/completions",
      "apiKey": "sk-***",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true,
      "supportsReasoning": true
    }
  ],
  "availableModels": ["gpt-5.5"]
}

If the primary endpoint is unavailable, change url to:

"url": "https://api.inferera.com/v1/chat/completions"

The interface only needs the /v1 endpoint; models.json needs the complete /chat/completions path. Restart CodeBuddy or reopen the model picker after saving. To avoid storing the key in plain text, use an environment variable:

"apiKey": "${AIHUBMIX_API_KEY}"

CodeBuddy CLI

The command-line version is called CodeBuddy Code. Install it with npm, then run codebuddy to start it:

npm install -g @tencent-ai/codebuddy-code

Set the API key, endpoint, and default model with environment variables. AIHubMix’s Anthropic-compatible interface uses the root URL for CODEBUDDY_BASE_URL:

$env:CODEBUDDY_API_KEY="sk-***"
$env:CODEBUDDY_BASE_URL="https://aihubmix.com"
$env:CODEBUDDY_MODEL="glm-4.7"
codebuddy

To keep these settings, add them to %USERPROFILE%\.codebuddy\settings.json:

{
  "env": {
    "CODEBUDDY_API_KEY": "sk-***",
    "CODEBUDDY_BASE_URL": "https://aihubmix.com",
    "CODEBUDDY_MODEL": "glm-4.7"
  }
}

The CLI uses the Anthropic-compatible protocol, while desktop custom models use the OpenAI-compatible endpoint. For a 404 error, check that CODEBUDDY_BASE_URL was not set to an OpenAI path such as /v1/chat/completions.

Verify the setup

Select the custom model and send a short message, such as asking CodeBuddy to introduce AIHubMix. A successful reply confirms the configuration.

For a model that supports image input, upload an image to test that capability.

FAQ

The model is unavailable after saving. What should I check? Confirm that the endpoint includes /v1, the API key is complete, and the model name matches the AIHubMix model ID. For models.json, also confirm that url includes /chat/completions. Why are two similar model names shown? CodeBuddy may display a custom model as model-name:model-name. This is normal as long as it responds correctly. Do the CLI and desktop app use the same settings? Not exactly. Desktop custom models use models.json; the CLI reads environment variables or the env object in settings.json. Last updated: 2026-07-10

​Before you start

​Configure AIHubMix in the interface

​Add a model through a configuration file

​CodeBuddy CLI

​Verify the setup

​FAQ

Before you start

Configure AIHubMix in the interface

Add a model through a configuration file

CodeBuddy CLI

Verify the setup

FAQ