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

# WorkBuddy 配置教程

> 通过将 Crun 接入WorkBuddy，快速为 WorkBuddy 扩展 Claude、GPT 及 Gemini 等大语言模型能力。

## 概览

`WorkBuddy` 是腾讯云推出的桌面级 AI Agent，支持自然语言驱动本地文件操作、多 Agent 并行执行。它内置了混元、DeepSeek、GLM 等模型。

通过将 Crun 接入 WorkBuddy，利用 Crun 统一的 OpenAI 标准兼容接口，只需修改本地 JSON 配置文件，即可快速为 WorkBuddy 扩展 Claude、GPT 及 Gemini 等大语言模型能力。

<Info>
  本教程适用场景：

  * 已安装 WorkBuddy，想把模型后端切换到 Crun 的用户
  * 想用统一 ApiKey 在 WorkBuddy 中调用多个模型的用户
  * 搜索「WorkBuddy 配置第三方模型」「WorkBuddy 接入中转 API」的用户
</Info>

## 一、前置条件

| **项目**     | **说明**                                                                |
| ---------- | --------------------------------------------------------------------- |
| WorkBuddy  | 已在本地电脑安装                                                              |
| Crun 账号    | 在 [crun.ai](http://crun.ai) 注册                                        |
| API Key    | 在控制台「[API 秘钥](https://crun.ai/zh/user-api-key)」创建一个新秘钥，也可以使用历史创建好的秘钥。 |
| 接口地址（url）  | OpenAI 兼容完整路径`https://api.crun.ai/api/v1/chat/completions`            |
| 模型名（model） | 到 [**可选模型参考**](#三、可选模型参考) 复制完整模型名称; 如 `claude-opus-4-8`、`gpt-5.5`     |

## 二、模型接入方式

WorkBuddy 提供两种添加自定义模型的方式：

| **方式**         | **说明**                                                    | **适合人群**  |
| -------------- | --------------------------------------------------------- | --------- |
| 可视化界面配置        | 在 WorkBuddy 设置面板中添加、编辑、删除模型，无需手动编辑文件                      | 新手推荐      |
| 编辑 models.json | 直接修改本地 `workbuddy/models.json`，写入模型名称、接口地址、API Key 和上下文参数 | 熟悉配置文件的用户 |

### **方式一：可视化界面配置**

1. 打开 WorkBuddy 设置面板，进入「模型配置 」页面。
2. 点击「添加模型」，在模型来源中选择 `自定义 / Custom`。
3. 按下方表格填写 Crun 接口信息，保存配置后重启 WorkBuddy。
4. 在 WorkBuddy 内切换到添加的 Crun 模型。发送一条测试消息验证：“你好，你是什么AI模型？”。

<Frame>
  <img src="https://mintcdn.com/handhunt-d524b030/3vVMVQq_0H_kA2qA/images/image.png?fit=max&auto=format&n=3vVMVQq_0H_kA2qA&q=85&s=b9e40016df7ce9024a9a8cdb8b1099db" alt="Image" width="1294" height="894" data-path="images/image.png" />
</Frame>

### **方式二：编辑 models.json**

1. 找到本地配置文件 workbuddy/models.json（用户级全局配置）。也可在项目级目录下放置同名文件，项目级会覆盖用户级同名模型定义。在文件中追加 Crun 模型配置：

<CodeGroup>
  ```text models.json theme={null}
  {
  "crun-claude": {
    "name": "Crun Claude",
    "url": "https://api.crun.ai/api/v1/chat/completions",
    "apiKey": "你的Crun ApiKey",
    "model": "claude-opus-4-8",
    "maxInputTokens": 200000
  },
  "crun-gpt": {
    "name": "Crun GPT",
    "url": "https://api.crun.ai/v1/chat/completions",
    "apiKey": "你的Crun ApiKey",
    "model": "gpt-5.5",
    "maxInputTokens": 200000
  }
  }
  ```
</CodeGroup>

<Tip>
  ***字段说明：***`url `*一般以* `/chat/completions `*结尾，需填写完整路径；*`apiKey `*填 Crun 控制台创建的令牌；*`model `*填价格页对应的完整模型名；*`maxInputTokens `*按模型实际上下文窗口填写。*
</Tip>

2. 在 WorkBuddy 内切换到添加的 Crun 模型。发送一条测试消息验证：“你好，你是什么AI模型？”。

## 三、可选模型参考

|              模型名称             |     厂商    | 输入价格<br />(1k Token积分数) | 输出价格<br />(1k Token积分数) |
| :---------------------------: | :-------: | :---------------------: | :---------------------: |
|          gpt-5.6-sol          |   OpenAI  |          0.784          |          4.704          |
|         gpt-5.6-terra         |   OpenAI  |          0.392          |          2.352          |
|          gpt-5.6-luna         |   OpenAI  |          0.1568         |          0.9408         |
|            gpt-5.5            |   OpenAI  |           0.84          |           5.04          |
|            gpt-5.4            |   OpenAI  |           0.42          |           2.52          |
|          gpt-5.4-mini         |   OpenAI  |          0.126          |          0.756          |
|          gpt-5.4-nano         |   OpenAI  |          0.0036         |           0.21          |
|          gpt-5.4-pro          |   OpenAI  |           5.04          |          30.24          |
|         gpt-5.3-codex         |   OpenAI  |          0.294          |          2.352          |
|          gpt-5.2-pro          |   OpenAI  |          3.528          |          28.224         |
|            gpt-5.2            |   OpenAI  |          0.294          |          2.352          |
|         gpt-5.2-codex         |   OpenAI  |          0.294          |          2.352          |
|            gpt-5.1            |   OpenAI  |           0.21          |           1.68          |
|         gpt-5.1-codex         |   OpenAI  |           0.21          |           1.68          |
|       gpt-5.1-codex-max       |   OpenAI  |           0.21          |           1.68          |
|       gpt-5.1-codex-mini      |   OpenAI  |          0.042          |          0.336          |
|           gpt-5-pro           |   OpenAI  |           2.52          |          20.16          |
|             gpt-5             |   OpenAI  |           0.21          |           1.68          |
|           gpt-5-chat          |   OpenAI  |           0.21          |           1.68          |
|           gpt-5-mini          |   OpenAI  |          0.042          |          0.336          |
|           gpt-5-nano          |   OpenAI  |          0.0084         |          0.0672         |
|             gpt-4o            |   OpenAI  |           0.42          |           1.68          |
|          gpt-4o-mini          |   OpenAI  |          0.0252         |          0.1008         |
|        gemini-3.5-flash       |   Google  |          0.2352         |          1.4112         |
|     gemini-3.1-pro-preview    |   Google  |          0.3136         |          1.8816         |
| gemini-3.1-flash-lite-preview |   Google  |          0.0392         |          0.2352         |
|     gemini-3-flash-preview    |   Google  |          0.0784         |          0.4704         |
|         gemini-2.5-pro        |   Google  |          0.196          |          1.568          |
|        gemini-2.5-flash       |   Google  |         0.04704         |          0.392          |
|         claude-fable-5        | Anthropic |          2.016          |          10.08          |
|        claude-opus-4-8        | Anthropic |          0.952          |           4.76          |
|        claude-opus-4-7        | Anthropic |          0.952          |           4.76          |
|        claude-opus-4-6        | Anthropic |          0.952          |           4.76          |
|        claude-sonnet-5        | Anthropic |          0.4298         |          2.464          |
|       claude-sonnet-4-6       | Anthropic |          0.5712         |          2.856          |
|        claude-opus-4-5        | Anthropic |          0.952          |           4.76          |
|       claude-sonnet-4-5       | Anthropic |          0.5712         |          2.856          |
|        claude-haiku-4-5       | Anthropic |          0.1904         |          0.952          |

## 四、常见问题

| **现象**                  | **常见原因**          | **处理方式**                                     |
| :---------------------- | :---------------- | :------------------------------------------- |
| 401 unauthorized        | API Key 写错、过期或被重置 | 重新生成 Crun ApiKey 并更新 models.json             |
| 403 / model not allowed | 模型限制              | 在 Crun ApiKey 设置中放行对应模型                      |
| 404 / model not found   | 模型名写错或不完整         | 到 [**可选模型参考**](#三、可选模型参考) 复制完整模型名称           |
| 仍然走旧模型                  | WorkBuddy 未读取新配置  | 重启 WorkBuddy，确认 `workbuddy/models.json` 路径正确 |
| 连接超时                    | 网络或 URL 写错        | 检查 `url` 是否以 `/v1/chat/completions` 结尾，排查网络  |