CodeBuddy 模型配置（系统设置）

一、概述

WorkBuddy 支持：

·接入第三方模型：添加 OpenAI、Anthropic、Gemini 等主流模型

·本地模型部署：通过 Ollama 运行开源模型，数据不出本机

·安全管理：API Key 仅本地保存，不上传云端

·灵活切换：根据任务类型选择最适合的模型

注意：说明：

二、快速开始

1. 进入模型设置：单击头像 > 设置 > 模型。

2. 选择接入方式： 支持提供商接入 / 本地部署 / 自定义 API 三种方式接入，可按需选择。

3. 填写配置：补全 API Key 或模型路径，保存即可使用。

三、自动模式（Auto）

自动模式（Auto）启用后，WorkBuddy 将根据任务自动选择适合的模型。

四、内置模型

五、自定义模型

·模型列表已配置的自定义模型以列表形式展示，每条记录显示模型名称与供应商图标

·添加 / 编辑 / 删除: 支持通过弹窗操作完成全部增删改流程

·对话入口联动: 对话界面的模型选择器展示自定义模型分组，并支持快捷跳转到配置界面进行编辑

六、添加自定义模型

在设置页模型中可以通过图形界面管理自定义模型，无需操作配置文件：

保存配置后，将自动持久化选择标准供应商时，工具调用、图片输入等能力标记会自动写入，无需手动配置。

注意：说明：

注意：已通过 ~/.codebuddy/models.json 配置的自定义模型在界面升级后仍可正常使用，并可通过 UI 界面查看、编辑或删除，无需再直接操作配置文件。

七、接入方式

方式一: 提供商接入

从提供商列表中选择供应商或选择自定义 API 后，URL、模型列表、能力标记（工具调用、图片输入、推理模式等）会自动填充，仅需补全 API Key 即可保存使用，全程无需手动修改任何配置文件。

·Token Plan

注意：说明：

注意：腾讯云 Token Plan 专为 AI 编程和 WorkBuddy 场景打造，提供面向个人、企业多种类型的订阅套餐，兼容混元、MiniMax、Kimi、GLM 等主流大模型，满足从个人开发到企业规模化 AI 应用的需求。

如果你已经购买了腾讯云 Token Plan 套餐，可将套餐支持的模型添加到自定义模型配置中。

操作步骤：

1. 在添加模型页面，根据你购买的套餐类型，选择对应的供应商：

·腾讯云 Token Plan / Token Plan 企业版专业套餐

·腾讯云 Token Plan / Token Plan 企业版轻享套餐

·腾讯云 Token Plan / 通用 Token Plan（个人版）

·腾讯云 Token Plan / Hy Token Plan（个人版）

2. 填入套餐对应的 API Key。不同套餐的 API Key 可查看如下指引获取：

·Token Plan 企业版专业套餐 API Key 获取指引

·Token Plan 企业版轻享套餐 API Key 获取指引

·通用 Token Plan（个人版）API Key 获取指引

·Hy Token Plan（个人版）API Key 获取指引

3. 选择套餐支持的模型，不同套餐的可用模型不一样。以下截图以通用 Token Plan（个人版）套餐：GLM-5 模型为例。

·Coding Plan

Coding Plan 是为 AI Coding 场景推出的专属订阅套餐，支持接入腾讯云 Coding Plan、智谱 Coding Plan 和 Kimi Coding Plan。

·自定义 API

内置了主流厂商的预设入口，可一键完成接入：

方式二: 本地部署（Ollama）

Ollama 是一个开源的本地大模型运行工具，安装后通过一行命令即可拉取并运行开源模型。Ollama 启动后会在本地监听 HTTP 端口（默认11434），并自动提供兼容 OpenAI 协议的接口供 WorkBuddy 对接。

适用场景：

·数据隐私 / 内网合规：代码与对话内容不出本机，适合金融、政企、敏感项目场景。

·零成本试用：不用消耗 Token、不用付费 API Key，把硬件当算力。

·离线可用：飞机上、内网开发机、没网的环境也能用 WorkBuddy。

方式三: 自定义

如果你的模型服务不在提供商列表中，可选择自定义 / Custom，手动填写 URL、API Key 与模型名接入。

八、高级配置

自定义协议

当模型服务使用非标准 URL 路径（如经过网关或代理层封装）时，可在高级配置中开启自定义协议开关。开启后 WorkBuddy 将直接按填写的 URL 发起请求，跳过路径校验与自动补全。

九、信息收集与使用

·本地文件读写: 读写 workbuddy/models.json（模型配置）

·API Key 存储: 仅本地保存，WorkBuddy 不向云端上传

·对话内容流向: 由 WorkBuddy 转发至自定义模型，由该模型按其规则处理

十、积分消耗说明

·自定义模型产生的全部费用（Token、订阅等）由你向第三方支付

·在使用联网搜索时，WorkBuddy 默认选择内置的最低价模型对搜索结果进行汇总，这一过程对积分有少量消耗

十一、第三方共享

WorkBuddy 仅作通信链路，输入内容直达第三方模型；具体处理规则按你与该第三方的协议执行。

十二、免责声明

请确保模型来源合法；接入前建议先阅读该模型服务方的协议与隐私政策。

十三、使用建议

·自定义模型由第三方独立运营，其可用性、稳定性、安全性、合规性与生成结果请关注该第三方的服务状态与公告

·使用过程中可能持续触发模型调用，建议密切关注你在第三方的账户费用，避免出现超出预期的支出

·API Key 是访问你第三方模型账号的关键凭据，请妥善保管，避免在共享环境中填写或导出；不再使用时建议在 models.json 中清理

·若接入存在违法违规风险，依据 用户协议，WorkBuddy 可能中止、限制或禁止该模型的接入

十四、声明

本节说明构成 服务协议 和 隐私保护 指引的组成部分，具有同等法律效力。

如有不一致之处，以前述协议原文为准。