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

# WorkBuddy 接入老张API：自定义模型配置与模型选择

> 在腾讯 WorkBuddy 桌面客户端里添加自定义模型，填入老张API的接口地址和密钥，就能用 GPT-6、GLM、Kimi、Gemini 等模型对话和调用工具，费用按 token 计入老张API账户。

| 项目 | 内容 |
| - | - |
| 入口 | 设置 → 模型 → 添加模型，供应商选「自定义」 |
| 接口地址 | `https://api.laozhang.ai/v1/chat/completions` |
| 自定义协议 | 不勾选（默认） |
| 令牌 | `default` 分组，计费模式按量优先 |
| 推荐模型 | `gpt-6.1-sol`、`glm-5.2`、`gemini-3.8-flash` |
| 费用 | 老张API按 token 计费，不消耗 WorkBuddy 积分 |
| 最后核对 | 2026 年 11 月 4 日，WorkBuddy 5.9.3 |

## 添加老张API模型

**1. 创建令牌**

在[令牌管理](https://api2.laozhang.ai/token)创建令牌，分组选 `default`，计费模式选「按量优先」，然后复制密钥。WorkBuddy 执行任务时会连续发出多次请求，建议给这个令牌设置授权额度，见 [API Key 管理](https://docs.laozhang.ai/faq/token-management.md)。

**2. 打开模型设置**

从 [WorkBuddy 官网](https://www.workbuddy.cn/docs/workbuddy/Download-History)下载并安装客户端（Windows、macOS 均可），登录 WorkBuddy 账号。

在菜单栏选择 **WorkBuddy** → **设置…**，打开左侧的 **模型**，在「自定义模型」一栏点击 **添加模型**。

![WorkBuddy 设置中的模型页面，自定义模型一栏右侧有添加模型按钮](https://mintcdn.com/laozhangai-edd05f2c/UAs8cbdK9dUwAUFr/images/scenarios/workbuddy-zh-models-page.jpg?fit=max\&auto=format\&n=UAs8cbdK9dUwAUFr\&q=85\&s=d0ed29c7e2d3a1ab5c535b42c4b675f5)

设置 → 模型：自定义模型会写入本机的 \~/.workbuddy/models.json（WorkBuddy 5.9.3）

**3. 填写接口信息**

在「供应商（仅支持 OpenAI 兼容协议 API）」下拉框中搜索并选择 **自定义**，然后填写：

* **接口地址**：`https://api.laozhang.ai/v1/chat/completions`，写到 `/chat/completions` 为止
* **API Key**：粘贴老张API密钥，可以点 **测试连接** 确认能连通
* **模型名称**：填写完整的模型 ID，例如 `gpt-6.1-sol` 或 `glm-5.2`

模型 ID 要与[模型与价格总表](https://docs.laozhang.ai/models.md)完全一致。一次添加一个模型，想用多个模型时重复添加。

![WorkBuddy 添加模型弹窗，供应商为自定义，接口地址为 https://api.laozhang.ai/v1/chat/completions，模型名称为 gpt-6.1-sol](https://mintcdn.com/laozhangai-edd05f2c/rKy6rY9-OgF8NHS6/images/scenarios/workbuddy-zh-add-model.jpg?fit=max\&auto=format\&n=rKy6rY9-OgF8NHS6\&q=85\&s=e5e24542cbb9846d46f6866ba11aeb88)

供应商选自定义，接口地址填到 /chat/completions，模型名称填模型 ID

**4. 勾选模型能力**

往下滚动到 **高级配置**，按模型实际能力勾选：

* **工具调用**：默认已勾选，下文「选择模型」表中的模型都支持，保持勾选。
* **图片输入**、**思考模式**：先在[模型与价格总表](https://docs.laozhang.ai/models.md)确认该模型支持再勾选，不确定时不勾。
* **自定义协议**：不要勾选。勾选后 WorkBuddy 会直接使用填写的地址、跳过校验，老张API用不到。

**输入**、**输出** 两栏是上下文长度和最大输出，留空时使用默认值。填完点击 **保存**。

![WorkBuddy 添加模型弹窗的高级配置，勾选工具调用和图片输入，思考模式和自定义协议未勾选](https://mintcdn.com/laozhangai-edd05f2c/rKy6rY9-OgF8NHS6/images/scenarios/workbuddy-zh-advanced.jpg?fit=max\&auto=format\&n=rKy6rY9-OgF8NHS6\&q=85\&s=ef87fab35cd57c5ffbde769fc5ca0f7f)

高级配置：工具调用、图片输入按模型能力勾选，自定义协议不勾

**5. 对话并测试工具调用**

保存后，在对话框的模型选择器中切换到刚添加的模型，先发一句简单的问题确认能正常回复。再给一个需要动手的小任务，例如在指定文件夹里新建一个文档并写入一行内容，能完成说明工具调用也正常。

## 选择模型

| 模型 | 适合 |
| - | - |
| `gpt-6.1-sol` | 写作、复杂分析和多步骤 Agent 任务 |
| `glm-5.2` | 多步骤 Agent 任务 |
| `kimi-k3` | 中文写作和日常办公 |
| `gemini-3.8-flash` | 速度快、单价低，适合频繁使用 |

上表模型都能在 Chat Completions 中连续多轮调用工具。各模型价格见[模型与价格总表](https://docs.laozhang.ai/models.md)。

**Claude 和 DeepSeek 模型暂不建议在 WorkBuddy 中使用。** WorkBuddy 只支持 OpenAI 兼容协议，这两类模型在多步骤任务里连续调用工具时可能返回 400。需要 Claude 时，可以用支持 Anthropic 格式的工具，例如 [Claude Code](https://docs.laozhang.ai/scenarios/programming/claude-code.md)。

## 常见问题

### GPT-6 调用工具报 reasoning\_effort 错误？

2026 年 11 月 4 日之前，GPT-6 系列在 Chat Completions 中带工具请求会报 `Function tools with reasoning_effort are not supported`。老张API现在已兼容这类请求，WorkBuddy 选 `gpt-6.1-sol`、`gpt-6-sol` 可以直接调用工具，不用改设置，详见 [GPT-6 Chat Completions 工具调用公告](https://docs.laozhang.ai/announcements/gpt-6-chat-tools-2026-11.md)。

仍然看到这个报错时，确认接口地址是 `https://api.laozhang.ai/v1/chat/completions`，再把报错时间和模型发给客服。

### 模型在选择器里是灰色的？

自定义模型没有填接口地址或 API Key 时，会在选择器中置灰，强行使用会报错码 4100。回到设置页的 **模型**，编辑这个模型，把两项补全后保存。

### 连接失败或报 401、404？

按报错内容排查：

* **401**：密钥错误或没有复制完整。重新复制密钥，并在[令牌管理](https://api2.laozhang.ai/token)确认令牌已启用。
* **404**：地址里的 `/v1` 重复或缺失。接口地址应与上文完全一致。
* **403 或 503 no available channels**：令牌分组不包含这个模型，或模型 ID 写错，见[如何确认模型是否可用](https://docs.laozhang.ai/faq/model-availability.md)。
* **余额不足**：充值后重试，仍有余额却报错时见[余额不足与调用失败排查](https://docs.laozhang.ai/faq/balance-insufficient.md)。

### 会消耗 WorkBuddy 积分吗？

不会。自定义模型的费用由你和老张API结算，按 token 计入老张API账户，不扣 WorkBuddy 积分。每次请求的模型、token 数和费用可以在[调用日志](https://api2.laozhang.ai/log)查看。

### API Key 保存在哪里？

只保存在本机的 `~/.workbuddy/models.json` 中，旧版 `~/.codebuddy/models.json` 里的配置仍可使用。这个文件包含完整密钥，不要发给别人或截图外发。

## 相关文档

* [工具接入总览](https://docs.laozhang.ai/scenarios.md)
* [Chat Completions 请求格式与字段](https://docs.laozhang.ai/api-reference/chat-completions.md)
* [如何确认模型是否可用](https://docs.laozhang.ai/faq/model-availability.md)
* [WorkBuddy 官方文档](https://www.workbuddy.cn/docs/workbuddy/Overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.