> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CodeBuddy / WorkBuddy

> Connect CodeBuddy and WorkBuddy to EvoLink.AI

## Overview

CodeBuddy and WorkBuddy are AI tools launched by Tencent Cloud that support custom AI model integration through `models.json` configuration files.
By integrating them with **EvoLink API**, you can directly use various AI model capabilities provided by EvoLink.

<Note>
  CodeBuddy and WorkBuddy use the same configuration method. This document applies to both.
</Note>

## Prerequisites

### Get EvoLink API Key

* Log in to [EvoLink Console](https://evolink.ai/dashboard)
* Find API Keys in the console, click "Create New Key" button, and copy the generated key
* API Key usually starts with `sk-`, please keep it safe

## Configuration Steps

### 1. Open Configuration File

**CodeBuddy:** `~/.codebuddy/models.json`

**WorkBuddy:** `~/.workbuddy/models.json`

### 2. Add Evolink Model Configuration

Edit the `models.json` file and add the following configuration:

<Note>
  Currently only supports OpenAI SDK format API integration.
</Note>

```json theme={null}
{
  "models": [
    {
      "id": "evolink/auto",
      "name": "Evolink Auto (Smart Routing)",
      "vendor": "Evolink",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "gpt-5.4",
      "name": "Evolink GPT-5.4",
      "vendor": "OpenAI",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "doubao-seed-2.0-mini",
      "name": "Evolink Doubao Seed 2.0 Mini",
      "vendor": "ByteDance",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    }
  ]
}
```

<Warning>
  Please replace `sk-your-api-key-here` with your actual EvoLink API Key.
</Warning>

### More Available Models

In addition to the above examples, you can add the following models (same configuration format, add "Evolink " prefix to name field):

**GPT Series:**

* `gpt-5.2` - Evolink GPT-5.2
* `gpt-5.1` - Evolink GPT-5.1
* `gpt-5.1-chat` - Evolink GPT-5.1 Chat
* `gpt-5.1-thinking` - Evolink GPT-5.1 Thinking

**Gemini Series:**

* `gemini-2.5-pro` - Evolink Gemini 2.5 Pro
* `gemini-2.5-flash` - Evolink Gemini 2.5 Flash
* `gemini-3-pro-preview` - Evolink Gemini 3.0 Pro
* `gemini-3-flash-preview` - Evolink Gemini 3.0 Flash

**Doubao Seed 2.0 Series:**

* `doubao-seed-2.0-pro` - Evolink Doubao Seed 2.0 Pro
* `doubao-seed-2.0-lite` - Evolink Doubao Seed 2.0 Lite
* `doubao-seed-2.0-code` - Evolink Doubao Seed 2.0 Code

**Kimi K2 Series:**

* `kimi-k2-thinking` - Evolink Kimi K2 Thinking
* `kimi-k2-thinking-turbo` - Evolink Kimi K2 Thinking Turbo

### 3. Save and Restart

After saving the configuration file, the tool will automatically detect configuration changes and reload (1 second debounce delay).

After configuration is complete, you can see all configured Evolink models in the model selection dropdown:

<img src="https://mintcdn.com/muyutechnology/Ibsxv__oZ58z38Zo/images/integration-guide/codebuddy-workbuddy-switch-model.png?fit=max&auto=format&n=Ibsxv__oZ58z38Zo&q=85&s=322e21d805183bc4cecfc72eafd6e3c8" alt="Switch Model" width="1799" height="1196" data-path="images/integration-guide/codebuddy-workbuddy-switch-model.png" />

## Using Evolink Auto Smart Routing

### What is Evolink Auto?

Evolink Auto is an intelligent model routing feature that automatically selects the most suitable AI model based on your request content.

### Core Advantages

* **Smart Matching**: Automatically analyzes request content and selects the most suitable model
* **Cost Optimization**: Prioritizes cost-effective models while ensuring quality
* **Load Balancing**: Automatically distributes requests among multiple models to improve system stability
* **Transparent**: Returns the actual model name used in the response

### Usage

Select "Evolink Auto (Smart Routing)" in the model selection dropdown.

## Limit Available Model List

If you only want to display specific models in the dropdown, you can use the `availableModels` field:

```json theme={null}
{
  "models": [
    // ... model configuration
  ],
  "availableModels": [
    "evolink/auto",
    "gpt-5.4",
    "doubao-seed-2.0-mini"
  ]
}
```

## FAQ

### 1. Where is the configuration file?

**CodeBuddy:**

* macOS/Linux: `~/.codebuddy/models.json`
* Windows: `C:\Users\<username>\.codebuddy\models.json`

**WorkBuddy:**

* macOS/Linux: `~/.workbuddy/models.json`
* Windows: `C:\Users\<username>\.workbuddy\models.json`

### 2. Does it support project-level configuration?

Yes. In addition to user-level configuration, you can create configuration files in the project root directory:

**CodeBuddy:** `<project-root>/.codebuddy/models.json`

**WorkBuddy:** `<project-root>/.workbuddy/models.json`

<Note>
  Project-level configuration has higher priority than user-level configuration. It is recommended to configure global models at the user level and project-specific models at the project level.
</Note>

### 3. What if the configuration doesn't work?

1. Check if the JSON format is correct (use a JSON validator)
2. Confirm the API Key is correct
3. Try restarting the application

### 4. Which models are supported?

EvoLink supports models from OpenAI, Anthropic, Google and other vendors. See [Model List](https://evolink.ai/models) for details.

### 5. Is the API Key secure?

The API Key is stored in the local configuration file and will not be uploaded to the cloud. It is recommended to set file permissions to prevent unauthorized access.

## Related Links

* [EvoLink Console](https://evolink.ai/dashboard)
* [CodeBuddy Official Documentation](https://www.codebuddy.cn/docs)
* [EvoLink API Documentation](/en/api-manual)