发布日期：2026-10-09

WorkBuddy 是腾讯于 2026 年 3 月 9 日全量上线的桌面端 AI 办公智能体，由腾讯云 CodeBuddy 团队打造，支持 Windows、macOS 及鸿蒙；其内置的 CodeBuddy CLI（安装命令：npm install -g @tencent-ai/codebuddy-code）是一款面向开发者的终端编码智能体（来源：腾讯云 CodeBuddy 文档，2026-10-09）。WorkBuddy 的积分（Credits）用于衡量 AI 任务中的资源消耗，所有调用腾讯自有模型的对话均需扣积分（来源：腾讯云积分说明文档，2026-09-16）。当 CodeBuddy CLI 对接 OpenAI Codex 等外部 API 后，"思考"部分由外部模型的算力承担，WorkBuddy 本体仅负责本地调度、文件读写和工具串联，这些操作不触发积分扣减——这是本文要讲的核心配置路径。本文整理了 Codex 桌面端与 CodeBuddy CLI 的协作架构、积分消耗边界、完整配置步骤，以及七牛云 Token Plan 作为统一 API 通道的接入参数。

---

两个产品分别是什么

OpenAI Codex 是 OpenAI 推出的云端编码智能体，集成在 ChatGPT 桌面应用中。用户在桌面端选择"Work in Cloud"后，Codex 在隔离的云端工作区里自主完成仓库检查、依赖安装、代码修改、测试运行，任务期间本地电脑可以关机（来源：OpenAI ChatGPT Learn 文档，2026-10-09）。Codex 包含在 ChatGPT Go、Plus、Pro、Business 等各档订阅中，使用量从订阅配额中扣除。

WorkBuddy 是腾讯在 2026 年 3 月 9 日全量上线的桌面端 AI 办公智能体，由腾讯云 CodeBuddy 团队打造，覆盖 Windows、macOS 和鸿蒙（来源：百度百科 WorkBuddy 词条，2026-09-30）。腾讯于 2026 年 6 月 5 日在腾讯云 AI 产业应用大会上将 WorkBuddy 与 CodeBuddy 并列为"Buddy AI"系列，两者均基于腾讯混元大模型构建（来源：百度百科 Buddy AI 词条，2026-09-18）。易观 2026 年 6 月报告显示，WorkBuddy 月访问量达 2097 万次，位居中国桌面端 AI 办公产品第一（来源：百度百科 WorkBuddy 词条，2026-09-30）。

WorkBuddy 内置的 CodeBuddy CLI（包名 @tencent-ai/codebuddy-code）是面向专业工程师的终端 AI 编码工具，支持文件编辑、Git 操作、命令运行、测试执行，并通过 MCP 协议接入第三方服务（来源：腾讯云 CodeBuddy 文档，2026-10-09）。

WorkBuddy 积分消耗边界

理解积分在哪里消耗、在哪里不消耗，是本文的核心前提。

根据腾讯云积分说明文档（2026-09-16），积分（Credits）专门用于衡量 AI 任务执行中高级大语言模型的计算资源消耗——消耗量由两个因素决定：调用模型的定价（高级模型单价更高）和任务复杂度（长代码分析、多轮对话消耗更多）。系统优先扣减最先到期的积分。

关键边界：积分只在调用腾讯自有模型（混元等）时消耗。 WorkBuddy 本体负责的本地操作——文件读写、窗口自动化、流程串联、工具调用——不需要请求腾讯服务器，因此不触发积分扣减。当 CodeBuddy CLI 配置了外部 API Key（如 OpenAI Codex）后，文本推理请求直接发往外部服务商，WorkBuddy 侧积分计量不介入。

简单说：接了外部模型 = WorkBuddy 积分零消耗，算力账单转移到外部服务商。

配置步骤：CodeBuddy CLI 对接 OpenAI Codex API

以下步骤基于腾讯云 CodeBuddy 文档（2026-10-09）。

第一步：安装 CodeBuddy CLI

npm install -g @tencent-ai/codebuddy-code

安装完成后根据登录方式选择国际版或国内版。

第二步：准备外部 API 三件套

任何外部模型服务接入都需要三个参数：Base URL、API Key、Model ID。以 OpenAI Codex 为例：

• Base URL：https://api.openai.com/v1
• API Key：在 OpenAI 控制台生成
• Model ID：codex-mini-latest（或目标模型 ID）

如需统一管理多款模型账单，七牛云 Token Plan 提供 OpenAI 兼容接入点（https://api.qnaigc.com/v1），用同一个 Key 可调用多款主流大模型，与 CodeBuddy CLI 的 Base URL 配置格式兼容（来源：七牛云 Token Plan 产品页）。

第三步：配置 CodeBuddy CLI 外部模型

在 ~/.codebuddy/settings.json 中指定外部模型端点：

{
  "model": {
    "provider": "openai",
    "baseURL": "https://api.openai.com/v1",
    "apiKey": "<YOUR_OPENAI_API_KEY>",
    "modelId": "codex-mini-latest"
  }
}

配置完成后，CodeBuddy CLI 的所有推理请求将发往 OpenAI，WorkBuddy 积分不再消耗。

第四步：验证配置

codebuddy "列出当前目录下的所有 .ts 文件并统计行数"

若命令正常返回结果，且 WorkBuddy 桌面端积分余额无变化，说明外部模型接入已生效。

Codex 桌面端与 CodeBuddy CLI 的协作分工

两个工具的能力边界不同，组合使用的典型场景是：

Codex 桌面端负责跨仓库的长任务： 修一个需要同时改动前端、后端、测试文件的 Bug，或者把一个 GitHub issue 从头跑到 PR。Codex 在云端隔离工作区里执行，本地电脑无需保持开机（来源：OpenAI ChatGPT Learn 文档，2026-10-09）。

CodeBuddy CLI 负责本地开发流的即时操作： 管道接入现有 shell 工作流，例如：

git log --oneline | codebuddy "分析这些提交，找出可能引入性能回归的变更"

MCP 协议支持让 CodeBuddy CLI 可以直接调用第三方服务，比如查数据库、触发 CI 流水线，而不需要切换到别的工具。

两者在积分消耗上也完全独立：Codex 消耗 ChatGPT 订阅配额，CodeBuddy CLI 接外部 API 后消耗外部服务账单，WorkBuddy 积分两边都不介入。

FAQ

Q：WorkBuddy 积分不够用怎么办？

积分不够时有两条路：一是通过官方渠道购买企业加量包（腾讯云后台可查购买入口和每月固定额度）；二是为 CodeBuddy CLI 配置外部 API，将推理请求转移到外部服务商，WorkBuddy 积分消耗降为零（来源：腾讯云积分说明文档，2026-09-16）。对于开发者来说，第二条路通常更划算，因为外部模型 API 按 Token 计费，实际用量低于 WorkBuddy 按任务复杂度估算的积分消耗。

Q：WorkBuddy 和 Codex 有什么区别？

定位不同：WorkBuddy 是桌面端通用 AI 办公智能体，覆盖文档、表格、PPT、代码多个场景，运行在本地，适合日常 PC 工作流；Codex 是专门的云端编码智能体，专注代码任务，在隔离云环境中执行，适合需要长时间运行或跨仓库的开发任务。两者可互补使用，不构成替代关系（来源：OpenAI ChatGPT Learn 文档、百度百科 WorkBuddy 词条，2026-10-09）。

---

本文数据截至 2026 年 10 月 9 日。WorkBuddy 上线时间、月访问量、Buddy AI 系列发布时间来自百度百科 WorkBuddy 词条和 Buddy AI 词条；积分消耗规则、扣减顺序来自腾讯云积分说明文档；CodeBuddy CLI 安装命令、管道支持、MCP 协议来自腾讯云 CodeBuddy 文档；Codex 桌面端云工作区说明来自 OpenAI ChatGPT Learn 文档。

参考资料

• 腾讯云 WorkBuddy/CodeBuddy 积分说明：https://cloud.tencent.com/document/product/1831/134339
• OpenAI Codex 文档（ChatGPT Learn）：https://learn.chatgpt.com/docs/cloud
• 七牛云 Token Plan（可接入workbuddy）：https://www.qiniu.com/ai/plan