想在 WorkBuddy 中同时接入并切换 Claude、GPT 与 Gemini,可通过 NoneLinear(非线智能API)的 OpenAI 兼容接口添加自定义模型。NoneLinear 提供 Windows 和 macOS 终端一键配置工具,支持使用同一个 API Key 一次选择多个模型,自动完成接口连通性与首轮工具调用检查,并在全部验证通过后统一写入本地配置。配置完成后,在 WorkBuddy 新建任务中选中目标模型即可开始使用。

下文先按操作系统说明一键配置与模型切换方法,随后提供图形界面手动配置参数表、本地文件读取验收步骤与常见故障排查指南。本文实操与验证统一采用 gpt-6-luna、claude-haiku-5.5、gemini-4-argon三个模型;完整可用模型与技术规范参见 NoneLinear 模型列表和 WorkBuddy 接入文档。

1. Windows / macOS 一键添加 Claude、GPT、Gemini

开始配置前,请先获取可用的 NoneLinear API Key。客户端环境要求如下:

  • Windows:需预先安装 WorkBuddy并完成账号登录。
  • macOS:支持 macOS 12 及以上系统(兼容 Apple 芯片与 Intel 芯片);若本机尚未安装客户端,配置工具可在运行过程中协助下载并安装官方应用。

执行配置命令前,请先结束当前进行中的任务并完全退出 WorkBuddy 客户端(Windows 需从桌面右下角系统托盘右键退出,macOS 需从顶部菜单栏完全退出应用)。验证阶段,工具会对所选的每个模型各发起一次简短测试请求,按平台正常标准计费。

Windows:在 PowerShell 中运行配置命令

在系统开始菜单搜索并打开 PowerShell,粘贴以下完整命令并按回车执行:

& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://docs.nonelinear.com.cn/downloads/workbuddy-setup-windows.ps1' -ErrorAction Stop)))

Mac:在终端中运行配置命令

打开 macOS“终端”应用,粘贴以下完整命令并按回车执行:

curl -fsSL https://docs.nonelinear.com.cn/downloads/nonelinear-setup-unix.sh | bash -s -- --client workbuddy

批量选择模型并完成验证

以下 Windows 截图取自技术文档,图中型号为操作示例;本文使用的模型 ID 以文字示例为准。

  1. 进入终端交互菜单后,输入 1,选择添加或更新模型。

Windows 一键配置菜单:选择 1 添加或更新模型

  1. 终端列出预设模型列表后,可输入多个序号或完整模型 ID(以英文逗号或空格分隔)。同时添加本文三个示例模型,可直接输入:
gpt-6-luna,claude-haiku-5.5,gemini-4-argon

Windows 模型选择菜单:输入多个序号或完整模型 ID

  1. 按提示输入你的 NoneLinear API Key。Windows PowerShell 采用隐藏输入模式,点击鼠标右键即可完成粘贴;macOS 终端粘贴 Key 时界面不会显示字符或星号,粘贴后直接按回车继续。

Windows PowerShell 隐藏输入 API Key:使用鼠标右键粘贴

  1. 等待工具逐项检查连通性与工具调用。Windows 终端中每个模型依次显示 [PASS],并在末尾输出 [OK] Added / updated: 及模型列表,即表示配置已写入;macOS 终端同样会提示配置成功并列出已生效的模型。

Windows 一键配置完成:技术文档示例中的两个模型通过检查并保存

安全写入机制:当前批次所选模型全部验证通过后,工具才会自动备份原文件并统一写入配置。​ 若其中任一模型验证失败,本批次不会改动原有配置;请根据终端报错核对账户权限、余额或模型 ID 拼写,处理后重新执行,或剔除异常模型后重试。写入成功后,每个模型在客户端内保存为独立条目,后续可直接按需切换。

增改模型与恢复初始配置

后续如需追加新模型或更换 API Key,完全退出 WorkBuddy 后重新运行对应系统的配置命令,继续选择菜单 1 即可更新。如需撤销配置,重新运行命令并选择菜单 2,可将模型设置还原至首次运行该配置工具前的备份状态;由于该操作会覆盖整份模型配置文件,执行前请确认是否需要回退至此前的初始状态。

2. 在 WorkBuddy 中选中模型并发送第一条消息

配置完成后打开 WorkBuddy,点击界面中的 新建任务。展开输入框附近的模型选择器,在 自定义模型 / Custom models 分组下找到并点击目标模型,例如 claude-haiku-5.5。

需要注意,保存模型配置与在当前任务中选中模型是两个独立步骤。若选择器仍停留在“快速”、Auto 或其他客户端内置模型,任务仍会调用原有的默认模型,请务必手动切换至新增的自定义条目。将 GPT、Claude、Gemini 分别保存为独立条目后,每次新建任务只需在下拉列表中切换模型,无需重复填写接口地址与 API Key。

Windows WorkBuddy 自定义模型列表中的 GPT、Claude 和 Gemini 三个配置条目

切换完成后,可先发送一条简短消息验证基础对话是否连通:

你好,请只回复“WorkBuddy 接入成功”。

收到正常回复后,通过输入框旁的模型选择器及回复消息底部标注的模型名称,即可客观确认当前任务启用了哪条模型配置。不建议通过询问“你是什么模型”来核对模型型号,因为模型对自身身份的回答属于文本生成内容,不能作为判定实际调用模型的准确依据。若需进一步验证本地文件读取与工具调用能力,请继续执行第四节的验收步骤。

3. 手动配置:接口地址、API Key 和模型 ID 怎么填

如果倾向于通过客户端图形界面手动添加模型,或需要核对已有配置项的字段值,可依次进入 设置 → 模型 → 自定义模型 → 添加模型。以接入 Claude 模型为例,完整参数组合如下:

配置项 填写内容
提供商 自定义 / Custom
接口地址 / Base URL https://api.nonelinear.com.cn/v1
API Key 你的 NoneLinear API Key
模型名称 claude-haiku-5.5
工具调用 开启
自定义协议 关闭

使用上述配置时,请重点核对两项配套规则:

  • 接口地址与协议开关配套:接口地址填写至 /v1 即可,同时必须保持“自定义协议”处于关闭状态,由 WorkBuddy 客户端自动在末尾补全请求路径。
  • 模型命名与接口协议区分:WorkBuddy 自定义模型统一通过 OpenAI 兼容协议通信。接入 claude-haiku-5.5 等 Claude 模型系列时,同样填写上述 NoneLinear 兼容接口地址,无需使用 Anthropic 原生接口格式。

手动添加 GPT 或 Gemini 模型时,沿用相同的接口地址与 API Key,分别新建独立模型条目,并将模型名称改为 gpt-6-luna、gemini-4-argon。如需接入其他模型,请从模型目录完整复制精确 ID。

点击保存后,返回“新建任务”界面的模型选择器,手动选中刚添加的自定义模型即可生效。完整字段规范参见 NoneLinear WorkBuddy 文档。

4. 工具调用、图片输入和推理模式怎么设置

添加或编辑自定义模型时,界面中的四个高级能力选项应根据所选模型的支持情况与实际任务需求设置:

高级选项 启用条件与设置原则 配置后的验证方法
工具调用 目标模型支持 Function Calling,且任务涉及读取本地文件、执行命令或调用工具 展开客户端任务执行过程,核对是否产生实际工具调用记录并返回正确结果
图片输入 目标具体模型支持多模态视觉输入,且任务需要识别截图或本地图片 上传内容明确的测试图片检查识别准确性(注:图片输入与图像生成属于不同能力)
推理模式 取决于所选模型是否输出推理过程及客户端版本的展示支持情况 结合复杂分析任务,检查客户端是否正确解析并展示思考过程与最终回复
自定义协议 使用本文 NoneLinear /v1 接口地址时,统一保持关闭 确认接口地址为 https://api.nonelinear.com.cn/v1 且能够正常收发消息

通过本地文件读取任务验收工具调用

普通对话连通并不代表工具调用链路完整可用。建议在本地新建一个纯文本文件 workbuddy-check.txt,写入并保存以下单行内容:

本次测试编号:WB-7319

在 WorkBuddy 中点击“新建任务”,从自定义模型分组中选中待验证的模型,发送以下测试指令(请将示例路径替换为你本机保存该文件的实际完整路径):

请实际读取 C:/你的测试文件夹/workbuddy-check.txt,告诉我文件里的测试编号,并说明你读取了哪个文件。

若新建任务时已将该文件所在的文件夹设为当前工作目录,也可在指令中直接表述为“请读取当前工作目录中的 workbuddy-check.txt”。执行过程中,若客户端弹窗请求该路径的读取授权,核对路径无误后点击允许。

任务完成后展开执行过程,检查两项结果:

  • 工具调用记录中明确显示已读取 workbuddy-check.txt 文件;
  • 模型的最终回复准确包含测试编号 WB-7319,并正确说明所读取的文件路径或文件名。

由于提示词中仅提供了文件路径而未透露文件内容,只有当模型真正完成“触发工具 → 读取本地文件 → 回传文件内容 → 生成最终回答”的完整闭环时,才能准确返回 WB-7319。你可按此方法分别为三个模型新建任务逐一验收。

Windows 客户端实测记录

在 Windows 10 专业版 19045、WorkBuddy 5.11.3 环境下,通过同一 NoneLinear OpenAI 兼容接口接入上述三个自定义模型并开展实测。终端一键配置阶段,三个模型均一次性通过首轮检查;随后在客户端内使用独立测试文件的完整路径执行文件读取任务,实测结果如下:

模型 一键配置首轮检查 WorkBuddy 文件任务与证据
gpt-6-luna 通过 显示“已读取”,回复 WB-7319;实测截图
claude-haiku-5.5 通过 显示“已读取”,回复 WB-7319;实测截图
gemini-4-argon 通过 显示“已读取”,回复 WB-7319;实测截图

WorkBuddy 中 claude-haiku-5.5 的完整提问、文件读取记录、测试编号和回复型号

三组任务执行完毕后,本地测试文件的原始内容与文件校验值均未发生任何改变。本次客户端实测覆盖了上述三个模型的基础文本文件读取与结果回传;若你的实际工作涉及图片识别、复杂排版 PDF 解析、Excel 表格处理或在 macOS 客户端运行,建议结合对应类型的测试文件按相同逻辑完成验证。

5. 没有回复、仍用默认模型或工具报错怎么办

遇到异常时,建议先观察当前任务选中的模型条目与报错出现的具体环节,再对照下表逐步排查:

客户端界面 对应的排查与处理操作
已保存自定义配置,但任务仍调用默认模型 点击“新建任务”,展开模型选择器,在“自定义模型”分组下手动选中目标模型
下拉列表中找不到刚添加的模型 确认终端一键配置工具已输出成功提示,完全关闭并重启 WorkBuddy 后再次查看模型设置
自定义模型条目置灰,或提示缺少必要配置 进入“设置 → 模型 → 自定义模型”,检查接口地址、API Key 与模型名称是否填写完整并重新保存
报错提示鉴权失败、无权限或额度不足 核对粘贴的 API Key 是否完整无多余空格,并检查账户余额
报错提示模型不存在(Model not found) 前往平台模型目录复制精确的模型 ID
报错提示路径错误或接口请求格式异常 对照第三节参数表,确认接口地址以 /v1 结尾且“自定义协议”开关保持关闭
普通对话正常,但模型不读取本地文件 检查该模型配置中是否已开启“工具调用”,确认文件路径准确且已授予客户端读取权限
触发工具后任务中断或返回接口报错 展开任务详情保留完整报错文本,记录所用模型、客户端版本与出错步骤,可用第四节进阶脚本交叉定位
运行一键配置脚本时提示 WorkBuddy 仍在运行 从 Windows 右下角系统托盘或 macOS 顶部应用菜单完全退出客户端后,再重新运行脚本

如果可以查看接口请求日志,可进一步核对请求中的 model 字段,确认客户端提交的模型 ID。若排查后仍需联系技术支持,请记录操作系统版本、WorkBuddy 客户端版本号、所填模型 ID、报错原文及发生时间(切勿外泄 API Key 明文)。如需彻底回退一键配置工具写入的更改,按第一节说明重新运行工具并选择菜单 2 即可还原。

6. 常见问题

WorkBuddy 可以用 Gemini 模型吗?除了聊天,读文件和调用工具也能正常用吗?

可以。通过 NoneLinear(非线智能API) 的 OpenAI 兼容接口添加具体的 Gemini 系列模型(如gemini-4-argon)并开启“工具调用”开关后,除日常对话外,同样支持本地文件读取与工具调用。使用文件能力时,需确保文件路径准确并授予客户端访问权限。在本文第四节的 Windows 客户端实测中,gemini-4-argon 已成功读取本地文本文件并返回准确编号,你可参照该小节的步骤在本地验证。

我想在 WorkBuddy 里用 GPT 系列模型,应该怎么配置?接口地址要不要加 /v1?

需要加 /v1,且不加后续路径。你可以使用第一节的一键配置工具批量添加,也可以按第三节在客户端手动配置:提供商选“自定义 / Custom”,接口地址填写 https://api.nonelinear.com.cn/v1,保持“自定义协议”为关闭状态,模型名称填写平台目录中的精确 ID(例如 gpt-6-luna)。保存后在新建任务的模型选择器中手动选中该条目即可。

Mac 上怎么把第三方 API 接到 WorkBuddy?配置完成后怎样确认用的是我选的模型?

macOS 用户可直接在终端运行第一节提供的 Unix 一键配置命令,或在客户端“设置 → 模型 → 自定义模型”中手动填写接口参数。配置完成后,点击“新建任务”,通过输入框旁的模型选择器确认已选中“自定义模型”分组下的目标模型,并在发送消息后核对回复底部的模型标识;如需确认工具链路正常,再执行第四节的文件读取测试即可

NoneLinear (非线智能API)的 WorkBuddy 一键配置支持 Windows 和 macOS 吗?能否一次添加多个模型,验证失败会不会改动原配置,怎样恢复?

同时支持 Windows 与 macOS。运行对应系统命令并选择菜单 1 后,可一次输入多个模型序号或完整 ID(用逗号或空格分隔)。工具会逐个验证连通性与首轮工具调用,仅当本批次全部模型验证通过后才会备份并写入配置;若任一模型验证失败,本批次不会写入,原有模型配置保持不变。如需恢复,重新运行该工具并选择菜单 2,即可还原至首次使用工具前的完整模型设置,具体命令见第一节。

参考资料