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

# CodeBuddy / WorkBuddy

> CodeBuddyとWorkBuddyをEvoLink.AIに接続する

## 概要

CodeBuddyとWorkBuddyは、Tencent Cloudが提供するAIツールで、`models.json`設定ファイルを通じてカスタムAIモデルの統合をサポートしています。
**EvoLink API**と統合することで、EvoLinkが提供する様々なAIモデル機能を直接利用できます。

<Note>
  CodeBuddyとWorkBuddyは同じ設定方法を使用します。このドキュメントは両方に適用されます。
</Note>

## 前提条件

### EvoLink APIキーの取得

* [EvoLinkコンソール](https://evolink.ai/dashboard)にログイン
* コンソールでAPIキーを見つけ、「新しいキーを作成」ボタンをクリックして、生成されたキーをコピー
* APIキーは通常`sk-`で始まります。安全に保管してください

## 設定手順

### 1. 設定ファイルを開く

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

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

### 2. Evolinkモデル設定を追加

`models.json`ファイルを編集し、以下の設定を追加します:

<Note>
  現在、OpenAI SDK形式のAPI統合のみサポートされています。
</Note>

```json theme={null}
{
  "models": [
    {
      "id": "evolink/auto",
      "name": "Evolink Auto (スマートルーティング)",
      "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>
  `sk-your-api-key-here`を実際のEvoLink APIキーに置き換えてください。
</Warning>

### その他の利用可能なモデル

上記の例に加えて、以下のモデルを追加できます(同じ設定形式で、nameフィールドに「Evolink 」プレフィックスを追加):

**GPTシリーズ:**

* `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シリーズ:**

* `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シリーズ:**

* `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シリーズ:**

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

### 3. 保存して再起動

設定ファイルを保存すると、ツールは自動的に設定の変更を検出して再読み込みします(1秒のデバウンス遅延)。

設定が完了すると、モデル選択ドロップダウンで設定されたすべてのEvolinkモデルを確認できます:

<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="モデルを切り替える" width="1799" height="1196" data-path="images/integration-guide/codebuddy-workbuddy-switch-model.png" />

## Evolink Autoスマートルーティングの使用

### Evolink Autoとは?

Evolink Autoは、リクエスト内容に基づいて最適なAIモデルを自動的に選択するインテリジェントなモデルルーティング機能です。

### 主な利点

* **スマートマッチング**: リクエスト内容を自動的に分析し、最適なモデルを選択
* **コスト最適化**: 品質を確保しながら、コストパフォーマンスの高いモデルを優先
* **負荷分散**: 複数のモデル間でリクエストを自動的に分散し、システムの安定性を向上
* **透明性**: レスポンスで実際に使用されたモデル名を返す

### 使用方法

モデル選択ドロップダウンで「Evolink Auto (スマートルーティング)」を選択します。

## 利用可能なモデルリストの制限

ドロップダウンに特定のモデルのみを表示したい場合は、`availableModels`フィールドを使用できます:

```json theme={null}
{
  "models": [
    // ... モデル設定
  ],
  "availableModels": [
    "evolink/auto",
    "gpt-5.4",
    "doubao-seed-2.0-mini"
  ]
}
```

## よくある質問

### 1. 設定ファイルはどこにありますか?

**CodeBuddy:**

* macOS/Linux: `~/.codebuddy/models.json`
* Windows: `C:\Users\<ユーザー名>\.codebuddy\models.json`

**WorkBuddy:**

* macOS/Linux: `~/.workbuddy/models.json`
* Windows: `C:\Users\<ユーザー名>\.workbuddy\models.json`

### 2. プロジェクトレベルの設定はサポートされていますか?

はい。ユーザーレベルの設定に加えて、プロジェクトのルートディレクトリに設定ファイルを作成できます:

**CodeBuddy:** `<プロジェクトルート>/.codebuddy/models.json`

**WorkBuddy:** `<プロジェクトルート>/.workbuddy/models.json`

<Note>
  プロジェクトレベルの設定は、ユーザーレベルの設定よりも優先されます。ユーザーレベルでグローバルモデルを設定し、プロジェクトレベルでプロジェクト固有のモデルを設定することをお勧めします。
</Note>

### 3. 設定が機能しない場合はどうすればよいですか?

1. JSON形式が正しいか確認してください(JSONバリデーターを使用)
2. APIキーが正しいことを確認してください
3. アプリケーションの再起動を試してください

### 4. どのモデルがサポートされていますか?

EvoLinkは、OpenAI、Anthropic、Googleなどのベンダーのモデルをサポートしています。詳細は[モデルリスト](https://evolink.ai/models)をご覧ください。

### 5. APIキーは安全ですか?

APIキーはローカルの設定ファイルに保存され、クラウドにアップロードされることはありません。不正アクセスを防ぐために、ファイルのアクセス許可を設定することをお勧めします。

## 関連リンク

* [EvoLinkコンソール](https://evolink.ai/dashboard)
* [CodeBuddy公式ドキュメント](https://www.codebuddy.cn/docs)
* [EvoLink APIドキュメント](/docs/ja/api-manual)