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

# WorkBuddy

> 在 WorkBuddy 中配置 Teio API 使用 AI 编程助手

> WorkBuddy 是腾讯云 CodeBuddy 团队推出的 AI Agent / 编程助手。它支持通过自然语言操作本地文件、并行运行多个 Agent，并支持通过 OpenAI 兼容接口接入自定义模型。本文介绍如何将 Teio 配置为 WorkBuddy 的自定义模型服务。

## 前置条件

开始配置前，请先准备好以下内容：

* 已 [创建 API 密钥](/create-token)
* 已了解要使用的模型对应哪个分组；不确定时可查看 [模型与分组](/modelandgroup)
* 已下载并安装 [WorkBuddy](https://www.workbuddy.ai/) 并完成登录

## 下载与安装 WorkBuddy

前往 [WorkBuddy 官网](https://www.workbuddy.ai/) 下载适合你设备的最新版本安装包。

<Tabs>
  <Tab title="macOS">
    下载完成后，打开 `.dmg` 文件，并将 WorkBuddy 拖入 `Applications` 文件夹完成安装。
  </Tab>

  <Tab title="Windows">
    打开下载的安装程序，按照提示完成安装。
  </Tab>
</Tabs>

安装并登录后，建议先打开一次你的项目文件夹，让 WorkBuddy 创建本地配置目录。

## 配置 Teio

WorkBuddy 支持通过图形界面添加自定义 OpenAI 兼容模型。下面以 Teio 为例说明配置步骤：

1. 打开 WorkBuddy，点击用户头像 进入“设置”
   <img src="https://mintcdn.com/cdhyzxwl/Uki3BsvU5t6GpVz0/images/Screenshot-2026-09-07-at-23-42-02.png?fit=max&auto=format&n=Uki3BsvU5t6GpVz0&q=85&s=488e730bc11f9f1185a0f1caf867812f" alt="Screenshot 2026 09 07 At 23 42 02" width="2400" height="1600" data-path="images/Screenshot-2026-09-07-at-23-42-02.png" />
2. 侧边栏选择“模型”，点击“添加模型”。
   <img src="https://mintcdn.com/cdhyzxwl/Uki3BsvU5t6GpVz0/images/Screenshot-2026-09-07-at-23-42-26.png?fit=max&auto=format&n=Uki3BsvU5t6GpVz0&q=85&s=2328a7ab2801e8c02d8633d6e2ef78d0" alt="Screenshot 2026 09 07 At 23 42 26" width="2400" height="1600" data-path="images/Screenshot-2026-09-07-at-23-42-26.png" />
3. 填写以下信息。
   <img src="https://mintcdn.com/cdhyzxwl/Uki3BsvU5t6GpVz0/images/Screenshot-2026-09-07-at-23-44-05-2.png?fit=max&auto=format&n=Uki3BsvU5t6GpVz0&q=85&s=ce0d7a8492f59b4d1eae954e6083f371" alt="Screenshot 2026 09 07 At 23 44 05" width="2400" height="1600" data-path="images/Screenshot-2026-09-07-at-23-44-05-2.png" />
   | 配置项     | 示例值                         |
   | ------- | --------------------------- |
   | 提供商     | `自定义`                       |
   | API 地址  | `https://ai.cdhyzxwl.cn/v1` |
   | API Key | 你在 Teio 创建的 API 密钥          |
   | 模型名称    | 例如 `deepseek-v4-pro`        |
4. 保存模型。回到输入框附近的模型选择器，在“自定义模型”中选择刚添加的模型即可开始使用。
   <img src="https://mintcdn.com/cdhyzxwl/Uki3BsvU5t6GpVz0/images/Screenshot-2026-09-07-at-23-46-29.png?fit=max&auto=format&n=Uki3BsvU5t6GpVz0&q=85&s=d58a53773d88e52af8cb21b990a08674" alt="Screenshot 2026 09 07 At 23 46 29" width="2400" height="1600" data-path="images/Screenshot-2026-09-07-at-23-46-29.png" />

## 常见问题

<AccordionGroup>
  <Accordion title="模型列表为空或提示 model not found">
    请确认 `Model Name` 与 Teio 模型名称完全一致，并确认当前 API 密钥所属分组支持该模型。可查看 [模型与分组](/modelandgroup) 确认。
  </Accordion>

  <Accordion title="提示 401 或认证失败">
    请检查 API Key 是否完整、有效，并确认不是 Teio 后台的登录密码。同时确认 Base URL 使用 `https://ai.cdhyzxwl.cn/v1`。
  </Accordion>

  <Accordion title="Agent 无法调用工具">
    请在高级设置中开启 Tool Calling。部分模型需要所属分组和模型本身支持工具调用。
  </Accordion>
</AccordionGroup>

遇到通用 API 配置问题，也可以参考 [通用配置教程](/general-config) 或 [常见问题](/faq)。