workbuddy 如何接入 chatgpt api

作者：claude-api-proxy.com 编辑部
更新日期：2026-07-20
来源与核验：官方文档、产品说明、公开配置示例与站内验证清单。具体模型、价格、权限和可用范围以对应官方文档或服务控制台为准。

WorkBuddy 可以接入 ChatGPT API。 截至 2026-07-14，官方已明确支持 自定义模型，腾讯云开发者社区的实战文章也采用同一套 models.json 结构接入 OpenAI 兼容接口。真正决定配置是否成功的，是模型 ID、完整接口地址、API Key 与 models.json 是否一致。

但这里要把一个边界先讲清楚：很多人搜索 chatgpt api，实际想要的是 OpenAI API，不是 chatgpt.com 网页版账号。对 WorkBuddy 来说，可接入的是 OpenAI API 风格的模型接口，也就是 Chat Completions 兼容地址，而不是网页端的 ChatGPT 会话。

验证路径与边界

先确认你要接的是 OpenAI API 风格的模型接口，而不是 ChatGPT 网页会话。落地时用一条 Chat Completions 兼容地址做最小验证，再把同一组模型 ID、URL 和 API Key 写入 WorkBuddy 的 models.json。官方接口和第三方兼容入口都可以作为测试对象，但权限、价格和模型列表必须以各自控制台为准。

WorkBuddy 现在到底支不支持 ChatGPT API

支持，但要分成两层理解。

第一层是 腾讯官方已确认的能力。腾讯云 WorkBuddy 文档在 2026-05-20 更新后，已经明确写出：

WorkBuddy 支持 配置自定义模型
界面里有 + 配置自定义模型
WorkBuddy 需要升级到 v4.22.15

第二层是 实际接入形式。腾讯官方文档本页主要展示的是 腾讯云 Token Plan 的图形化接法，但腾讯云开发者社区近几个月的多篇文章都给出了同一套 ~/.workbuddy/models.json 结构，并统一使用：

vendor: "OpenAI"
完整的 .../v1/chat/completions 接口地址
自定义 model id
自定义 apiKey

所以，workbuddy 如何接入 chatgpt api 的准确答案应该是：

官方确认支持自定义模型
ChatGPT API 这类场景通常按 OpenAI 兼容模型去配
真正落地时，最常见的方法是写 models.json

chatgpt api 在 WorkBuddy 里到底指什么

在这篇文章里，chatgpt api 指的是 OpenAI API 的模型调用接口，而不是 ChatGPT 网页版本身。

对 WorkBuddy 来说，最重要的是下面这三个概念不要混：

概念	说明
ChatGPT 网页版	你在浏览器里使用的 ChatGPT 产品
OpenAI API Key	用于程序调用模型接口的密钥
Chat Completions 接口	WorkBuddy 最常见的兼容接入方式

也就是说，你要让 workbuddy 接入 chatgpt api，需要的是：

一个可用的 API Key
一个可访问的 Chat Completions 接口地址
一个真实存在的模型 ID

WorkBuddy 接入 ChatGPT API 的原理

WorkBuddy 不是直接内建“OpenAI 官方登录”。它更像是读取一份模型配置，然后把请求发到你指定的接口。

腾讯云开发者社区最近的 WorkBuddy 配置示例里，常见结构是这样的：

字段	作用
`id`	实际发送给服务端的模型名
`name`	WorkBuddy 界面显示的模型名
`vendor`	协议类型，通常写 `OpenAI`
`url`	完整的 `chat/completions` 接口地址
`apiKey`	你的 OpenAI 或兼容服务密钥
`maxInputTokens`	最大输入 token
`maxOutputTokens`	最大输出 token
`availableModels`	需要展示在模型列表中的模型 ID

所以，workbuddy 如何接入 chatgpt api 的本质不是装插件，而是把 OpenAI 风格接口写成 WorkBuddy 能识别的模型配置。

前置条件

在开始配置之前，先把下面几项准备好：

WorkBuddy 已安装并升级到较新版本
腾讯官方文档当前明确提到 v4.22.15 需要支持自定义模型。
你有一个可用的 API Key
你知道要调用的模型 ID
你知道对应的完整接口地址

如果你走 OpenAI 官方接口，通常要确认的是：

API Key
模型 ID
https://api.openai.com/v1/chat/completions

如果你走 OpenAI 兼容中转，则需要以中转控制台显示的地址和模型名为准。

配置文件路径

WorkBuddy 最常见的自定义模型配置路径是：

macOS / Linux：

bash

mkdir -p ~/.workbuddy
code ~/.workbuddy/models.json

如果你不用 VS Code，也可以用：

bash

nano ~/.workbuddy/models.json

Windows：

text

C:\Users\<用户名>\.workbuddy\models.json

这一步很关键。很多人搜 workbuddy 如何接入 chatgpt api，最后卡住不是因为模型不支持，而是因为文件路径写错了，或者根本没创建 .workbuddy 目录。

方案一：WorkBuddy 直连 OpenAI 官方 ChatGPT API

如果你已经有 OpenAI 官方 API Key，可以先按 OpenAI 官方接口来写。最常见的思路是：

json

{
  "models": [
    {
      "id": "your-openai-model-id",
      "name": "ChatGPT API",
      "vendor": "OpenAI",
      "url": "https://api.openai.com/v1/chat/completions",
      "apiKey": "YOUR_OPENAI_API_KEY",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192
    }
  ],
  "availableModels": [
    "your-openai-model-id"
  ]
}

这里有三个地方最容易写错：

id 必须写成你账户里实际可调用的模型 ID
url 建议直接写完整的 https://api.openai.com/v1/chat/completions
availableModels 必须包含上面的 id

如果你不确定自己账号到底能调用哪个模型，不要先拍脑袋填。更稳妥的做法是先去 OpenAI 控制台确认可用模型，再把模型 ID 原样写进来。

方案二：WorkBuddy 接入 OpenAI 兼容的 ChatGPT API 入口

如果你不想直接走 OpenAI 官方地址，而是想用兼容 OpenAI 协议的统一入口，那么配置方式和上面几乎一样，差别主要在 url、apiKey 和具体模型名。

以 api.clawsocket.com 这类 OpenAI 兼容入口为例，可以先按这个思路写：

json

{
  "models": [
    {
      "id": "gpt-5.4",
      "name": "ChatGPT API",
      "vendor": "OpenAI",
      "url": "https://api.clawsocket.com/v1/chat/completions",
      "apiKey": "YOUR_API_KEY",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192
    }
  ],
  "availableModels": [
    "gpt-5.4"
  ]
}

这里 vendor 仍然写 OpenAI，不是说模型一定来自 OpenAI，而是因为 WorkBuddy 在这个场景里识别的是 OpenAI 协议格式。

如果你想在同一个入口里切多个模型，也可以这样写：

json

{
  "models": [
    {
      "id": "gpt-5.4",
      "name": "GPT-5.4",
      "vendor": "OpenAI",
      "url": "https://api.clawsocket.com/v1/chat/completions",
      "apiKey": "YOUR_API_KEY",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192
    },
    {
      "id": "claude-sonnet-4-6",
      "name": "Claude Sonnet 4.6",
      "vendor": "OpenAI",
      "url": "https://api.clawsocket.com/v1/chat/completions",
      "apiKey": "YOUR_API_KEY",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192
    }
  ],
  "availableModels": [
    "gpt-5.4",
    "claude-sonnet-4-6"
  ]
}

这类配法适合想把 ChatGPT API、Claude API 等入口统一起来的用户。

保存后怎么生效

无论你用哪种方案，写完 models.json 之后都不要只最小化 WorkBuddy，而是按下面顺序处理：

保存 models.json
完全退出 WorkBuddy
重新启动 WorkBuddy
打开底部模型选择区域
查看自定义模型是否出现

腾讯云开发者社区近期几篇 WorkBuddy 实战文章都反复提到一点：写完配置后要完全重启 WorkBuddy。否则模型列表很可能不会刷新。

如何验证配置成功

workbuddy 如何接入 chatgpt api 这个问题，最容易在验证环节浪费时间。更高效的方式是按固定顺序检查：

模型有没有出现在列表里
能不能正常切换过去
先发一个最简单的问题
再发一个代码类或长文本类任务

例如可以先测试：

text

请用三句话介绍你当前使用的模型。

如果这一步都过不去，就不要先怀疑 WorkBuddy 的 Agent 能力，优先回头查配置。

常见报错排查

1. WorkBuddy 里看不到模型

先检查：

availableModels 里有没有这个模型 ID
JSON 格式有没有少逗号、少引号
是否真的完全退出再重启了 WorkBuddy

这类问题比 API Key 错误更常见。

2. 401 Unauthorized

通常表示：

API Key 错了
API Key 多了空格
你用了错误的服务商 key

如果你填的是 OpenAI 官方地址，就必须用 OpenAI 官方 API Key；如果你填的是兼容中转地址，就必须用中转控制台发的 key。

3. 404 Not Found

通常表示 url 写错了。
重点检查：

是不是只写了域名，没有写完整 .../v1/chat/completions
路径是不是把 chat/completions 写成了别的接口

很多 WorkBuddy 配置失败，根因都在这里。

4. 模型不存在

这说明 id 写错了，或者你的服务端根本不支持这个模型。
不要把文章示例里的模型名直接照抄到生产配置里，应该以你自己的控制台模型列表为准。

5. 能对话，但输出太短

先检查 maxOutputTokens。
如果你只写了 4096，复杂任务可能明显不够。可以根据模型能力调高，但不要超过服务商支持上限。

6. OpenAI 官方接口能用，WorkBuddy 还是不通

这种情况优先检查两点：

models.json 路径对不对
url 是否填写为完整 chat/completions 地址

WorkBuddy 在这个场景里更像一个严格按配置读模型的客户端，路径和字段名都不能靠猜。

安全建议

这篇 workbuddy 如何接入 chatgpt api 还要强调一点：models.json 是本地明文文件，里面会保存 API Key。建议你：

不要把 ~/.workbuddy/models.json 上传到 GitHub
不要截图公开带完整 API Key 的配置
给 WorkBuddy 单独创建一把 API Key
如果怀疑泄露，立即禁用旧 key
团队使用时，不要在共享配置里放个人 key