WorkBuddy 接入

主站 / WorkBuddy 接入攻略

开始前：先注册个账号
准备 3 样东西
先搞懂：这套东西到底在干嘛
跟着做：7 步跑通
出问题先看这里（对号入座）
想更较真一点（嫌麻烦可跳过）
跑起来之后，平时怎么用
必须知道的风险（花 3 分钟看完）
想让 AI 帮你配？把这篇丢给它
更多精选资源与实用渠道

🏠 赛博鸡蛋 · 资料库首页｜ 👈 一键返回资料库主目录

🐧欢迎来 QQ 群交流探讨！日常技术交流与算力福利请进 249729644；想找 AI 大肥鱼摸鱼聊天请进鱼塘群 1077397553！想自己养一个的看这篇：👉 QQ 接入大肥鱼无限资源流玩法

🥚 这篇能帮你干成啥：把你手里 WorkBuddy 账号的额度，转成一个通用的接口，能接到 ZCode、Cursor、Cline 等各类支持 OpenAI 接口的工具里。WorkBuddy 这边的额度和模型档位更宽裕，接过去之后能拿来写代码、跑 Agent、做自动化，一种方式多处用。本文以 ZCode 为例讲透全流程，换成别的工具照葫芦画瓢就行。本篇已在 2026-10-13 实测跑通，跟着点就行。

💡 嫌麻烦？也可以直接把这篇文档扔给 AI 让它帮你配（Qoder、豆包、DS、ZCode 都行，但注意，不要发给 workbuddy 本尊，它有防护，不让自己捅自己刀子）。想自己动手的朋友，往下顺着看就行。

开始前：先注册个账号

还没有 WorkBuddy 账号的朋友，可以先走我的邀请链接注册，你多得一些资源点，也能给我赠送点😋：

https://www.workbuddy.cn/events/invite?inviteCode=4fnd7vs6n8ji

顺手说下国内版和海外版的区别，提前知道少踩坑：

国内版（workbuddy.cn）：速率和额度更足，日常首选，邀请链接注册的就是这个；
海外版（WorkBuddy AI）：走 DeepSeek 不消耗额度，但速率和量比国内版差一截；要用谷歌账号注册，网络问题得自己先解决；
两个不冲突：海外和国内各是各的账号，可以都准备一个，哪个顺手用哪个。

准备 3 样东西

一个你自己的 WorkBuddy 账号，能在官方桌面端正常登录就行（没有的话，用上面的邀请链接注册一个再回来）。
你要用的工具，本文以 ZCode 桌面端为例讲，换成 Cursor、Cline 等同理，能正常打开就行。
一台 Windows 电脑。不用装 Docker，也不用装 Go，下载单个文件就能跑。

多说一句：GitHub 有时候直连打不开，下载那一步可以先想办法连上；但“翻译器”跑起来之后，反而要让它直连别走中转，后面会教你。

先搞懂：这套东西到底在干嘛

打个比方。你的 WorkBuddy 账号好比自家粮仓，粮食不少，但外面那些工具（ZCode、Cursor、Cline 等）不认识你家的门。中间这个小工具就是你电脑上的一个“翻译兼传菜员”，下面干脆就叫它翻译器：左边连着你的 WorkBuddy 账号，右边装成大家都认识的接口样子（地址是 http://127.0.0.1:7863/v1 ）。各路工具只管点这个熟面孔的菜，就能吃到你粮仓里的粮食，做更多的事情。

为啥不用以前的老办法？以前那套只能陪聊，一到真干活（读写文件、跑命令、调工具）就走不通。现在这套带面板的新版，把“动手干活”这一步跑通了，2026-10-13 当晚已经真刀真枪验证过，能连着调好几次工具都不翻车。WorkBuddy 这边的模型和额度选择更多，接出来接到趁手的工具里，能覆盖写代码、跑长链路 Agent、做自动化等多种用法。

跟着做：7 步跑通

第 1 步：把“翻译器”下载回来

打开这个开源地址：workbuddy2api-panel 开源地址 →，点进 Releases 找最新版，下载名字带 windows-amd64 的 zip 包。
解压到一个固定的英文目录，别放桌面，路径以后别乱动。你也可以建个类似的，比如 D:\Tools\WorkBuddy2API。
解压完看到 wb2api.exe、config.example.json、README.md 这三样，就是齐了。

做到啥样算成：文件夹里能看到 wb2api.exe 这个程序。

第 2 步：第一次启动它

把 config.example.json 复制一份，改名叫 config.json。用记事本打开，只看三行，别的不用动：listen 那行不用动；api_key 改成你自己编的一长串乱码，这就是以后各工具连它用的密码，只放你自己电脑上，别截图发群；prompt.mode 保持 passthrough，这行是让工具能正常指挥它干活的关键。
双击 wb2api.exe 就能跑。讲究一点可以做个启动脚本：启动前先看看是不是已经在跑了，别重复开；启动时把中转变量清空，日志写到旁边的 server.log 里，方便以后查。
打开浏览器，输入 http://127.0.0.1:7863/panel/ ，能看到管理面板，就是活了。

做到啥样算成：浏览器里管理面板能打开，按钮都能点。

第 3 步：在面板里登录你的 WorkBuddy 账号

在面板上找到“添加账号”按钮，按提示在浏览器里登录一次 WorkBuddy，点同意授权就行，跟平时扫码登录一个感觉。
登完不用重启，账号自己就进列表了。去“账号列表”那页看看，账号是在线的，余额都正常。
顺手点开“任务中心”，新号有个一键完成成长任务，点一次就行；每天的签到保活用不着你管，默认早上 9 点晚上 9 点自己跑。

⚠️ 翻译器目录下的 auths 文件夹里放的是登录凭证，谁拿到谁就能用你的号。这个文件夹不外发、不同步网盘、不截图。

做到啥样算成：账号列表里能看到你的号是在线的。

第 4 步：确认翻译器认出了你的号

这一步不用敲命令，打开刚才那个面板页面看一眼就行：账号那里显示在线、余额正常，模型列表那一页能看到一长串模型名字。

把你要用的模型 id 记下来，比如 cn:deepseek-v4-flash，后面填到工具里要一字不差。工具里显示的名字可以随便起，比如 Deepseek-V4-Flash (WB)，但背后的 id 必须跟面板里查到的一模一样，差一个字母都认不出来。

（想用命令行自己较真的朋友，文末“想更较真一点”那节有两条命令。）

第 5 步：把这个接口接到工具里（以 ZCode 为例）

这一步以 ZCode 为例讲，换成 Cursor、Cline 等其他工具同理，都是填同样的三件套：接口地址、密码、模型 id，照葫芦画瓢就行。

打开 ZCode，点设置，找到模型供应商，点“添加供应商”，选“自定义端点”。
API 格式选 Chat completions，千万别选另外两个。选错了地址就拼错了，肯定连不上。
Base URL 填 http://127.0.0.1:7863/v1 ，末尾的 /v1 一定要带上。少了它就像快递没写门牌号，肯定送不到。
API Key 填第 2 步你设的那串密码。
模型一个一个加，id 照第 4 步查到的抄，一字不差，加完保存。

做到啥样算成：ZCode 设置里能看到新加的 WorkBuddy2API。别的工具同理，填完保存，能连上、能出字就是成了。

第 6 步：把 ZCode 彻底关掉再重开

这步最容易被跳过。ZCode 点窗口右上角的叉，只是缩到右下角托盘里，根本没退出，新配置读不到。一定要去托盘图标上点右键选退出，或者去任务管理器里结束掉，再重新打开。重进能看到新供应商，才算数。用别的工具时同理，改完配置记得重启或重载，让新配置生效。

第 7 步：真刀真枪试一次（必须做）

别只发一句“你好”就宣布成功。以前的老办法陪聊都挺好，一干活就露馅。标准动作是：在 ZCode 里新开一个 agent 对话，选 WorkBuddy 这条线的模型，让它“新建一个测试文件，写一句话进去，再读出来，最后删掉”。全程看它能不能正常调工具，有没有报错。换成别的工具也一样，至少跑一次带工具调用的真活，别只测一句闲聊。

出问题先看这里（对号入座）

想更较真一点（嫌麻烦可跳过）

命令行自检。想确认翻译器状态，把下面两条复制到命令行里跑一跑。第一条不用密码，看它活没活；第二条要带密码，看它手里有哪些模型。把“你的接口api_key”换成你第 2 步设的那串：

ZCode 加完供应商界面上不显示。这是 ZCode 的老毛病：加供应商要在两个文件里记同一个名字，只记一个，界面上就不显示。这两个文件在 ZCode 工作目录下的 .zcode\v2\ 里（注意别去改 C 盘下那个旧的，改了不生效），一个叫 config.json，一个叫 provider_config.json，两边用同一个编号（样子像 31ae3a83 这种，你新加的时候自己生成一个新的，别照抄别人的）。动手前把这两个文件各复制一份备份，改坏了还能回来。种类对应关系记住一对就行：config.json 里写 openai-compatible，provider_config.json 里就写 openai-chat-completions。

跑起来之后，平时怎么用

开机顺序：先启动“翻译器”，面板能打开了再开趁手的工具。桌面放两个快捷方式最省事，一个直达面板，一个一键启动。
面板每天瞄三眼就行：账号列表里谁被冷却了；用量里哪个号快过期了（会自动先用快过期的）；日志按任务对话系统分开看，不会被刷掉。
签到保活那些定时任务默认都开着，不用你管。新号去任务中心点一次一键完成就行。
模型不够了回第 4 步重新拉一遍，各工具里同步加上，保持两边一致。
整个目录搬家就行，换电脑直接拷走（auths 文件夹除外）。

必须知道的风险（花 3 分钟看完）

这是民间封装的非官方通道，上游随时可能加严风控，今天能用不代表永远能用，平常心。
只用自己的号，小规模自己玩。批量搞小号、拿去卖钱，既违规，也会连累大家都没得用。
密码凭证都在你自己电脑上明文放着，电脑别借人，目录别同步网盘，key 别截图发群。
只在自己电脑上用就行，真要放到公网上，必须套一层 HTTPS，别裸奔。

想让 AI 帮你配？把这篇丢给它

人类读者到这里已经可以开始了。想让 AI 代劳的话，把下面这段连同这篇文档一起丢给它，它照着自己就能配好：

AI 代操作清单：

先读上面这段拿地址路径规则。
跑 healthz，healthy 大于 0 才往下走；不通先看 server.log，别动工具配置。
带 key 拉 models，记下真实模型 id。
确认 ZCode 改的是生效目录那个文件，改前备份两个文件；别的工具直接在界面里填三件套。
图形界面或双文件登记供应商，地址带 /v1，两边用同一个编号。
托盘彻底退出 ZCode 再重开，确认列表里出现了；别的工具重载配置即可。
跑真实 agent 建读删文件验证工具调用，纯聊天通过不算数。
回报告时 key 和凭证全部打码；中转那行留空就是删掉它。

附：这篇的操作链来自 2026-10-13 当天面板加号、本地投产、ZCode 登记、彻底重启、真实验证通过的完整实测，版本端口字段以正文为准，照着做就能复现。接到别的工具时，三件套和验证标准不变。