想在 WorkBuddy 里用 gpt-6-astra翻遍模型列表也找不到——自带的就固定那几个换不了。其实官方本来就支持自定义模型设置 → 模型 → 添加模型只要接口是 OpenAI 兼容协议填上地址、Key、模型名就能加进去腾讯官方文档里写了这条路。这篇把完整配置过程记一遍重点是一个几乎人人都踩的坑配完能正常聊天但让它整理文件夹它只会告诉你「应该怎么做」一个文件都不碰。前提先确认你手里的接口是不是 OpenAI 兼容你需要三样东西一个以/chat/completions结尾的端点、一个 API Key、一个模型名。这三样从哪来都行——自建推理服务的兼容层、云厂商提供的兼容接口、第三方聚合网关都可本文以WanAPIs 为例。别配到一半分不清是客户端问题还是接口问题。一条 curl 就够BASE_URLhttps://你的接口地址/v1 # 换成你自己那个 API_KEYsk-xxx curl $BASE_URL/chat/completions \ -H Authorization: Bearer $API_KEY \ -H Content-Type: application/json \ -d {model:gpt-6-astra,messages:[{role:user,content:hi}]}返回里有choices[0].message.content就说明协议对得上。这一步返回 200后面所有问题就都在客户端侧排查范围直接砍半。想确认工具调用能不能用再加一个tools字段发一次看返回里有没有tool_calls——下一节会讲为什么这个必须提前确认。第一步在界面里添加自定义模型左下角头像 → 设置 → 模型 → 添加模型。弹出的「编辑模型」对话框顶部就标着「仅支持 OpenAI 兼容协议 API」。提供商选「自定义 / Custom」然后填三样接口地址必须是完整路径、以/chat/completions结尾。只填域名会失败中间也不能有多余斜杠。注意这里和很多 SDK 的习惯不一样SDK 里通常填到/v1就行剩下的路径由库拼这里要你填全。模型名称要和接口方模型清单里的完全一致大小写敏感这里就是 gpt-6-astra。填完记得看一眼 Key 末尾有没有粘进空格——这是最常见的低级错误。第二步六个开关选自定义时一个都不会自动探测这就是开头那个坑。走标准供应商时能力标记是自动写入的选「自定义」时全部要手动勾工具调用Function Calling必勾。智能体靠它读写你的文件不勾就只会聊天。图片输入模型能看图再勾。推理模式gpt-6-astra 这类推理模型勾上下面的「默认思考强度」和「支持的思考强度」低/中/高/超高/极致才有意义。仅思考模式一般不勾。允许关闭思考勾上后可以在对话里临时关掉推理省钱。自定义协议只有当接口地址不是/chat/completions结尾时才需要。反过来勾了模型其实不支持的能力会直接导致请求失败。所以上一节那条 curl 值得先跑你勾的每一项最好都是验证过的而不是照着模型卡片猜的。拿不准就先只勾工具调用跑通了再逐项加。最下面的输入/输出上限按模型实际上下文填。第三步先跑个小任务验证再上批量配好别急着丢一堆活进去。先让它做件小事比如「把这个文件夹里的 csv 各读前 5 行汇总成一张表」。这一步同时验证三件事接口通不通、工具调用有没有真生效、扣费正不正常。对话正常返回输入框右下角和每条回复下方都标着当前模型名就说明接上了。再去接口方控制台的日志页对一下这次用了多少 token、花了多少钱。接上之后按任务类型选模型看输入单价这类智能体干的活大多是「读一批文件 → 想 → 写回去」输入长、输出短。按实际调用分布这类请求输入中位数约 4390 token输出中位数不到 198 token——所以输入单价才是主要成本别盯着输出价挑模型。按这个结构算同一个任务用便宜档的小模型和用推理旗舰单次成本能差一个数量级我这边实测大约是 ¥0.004 对 ¥0.028。日常批量整理用便宜档就够需要 gpt-6-astra 这种推理旗舰时再切过去——这也是走自定义模型的好处随时换不用换订阅。配置文件法能不用就不用也可以直接写配置文件用户级路径是~/.codebuddy/models.jsonWindows 在C:\Users\用户名\.codebuddy\models.json项目级放工作区下的同名文件、优先级更高较新版本改用了 workbuddy 目录。{ id: gpt-6-astra, name: GPT-6 Astra, vendor: custom, url: https://api.wanapis.com/v1/chat/completions, apiKey: sk-xxx, supportsToolCall: true, supportsImages: false }但这里有个坑网上不少教程还把改文件当成唯一办法。腾讯官方已经说明通过~/.codebuddy/models.json配好的模型在界面升级后仍然可用而且可以直接在 UI 里查看、编辑、删除。所以优先用界面法只有批量配置或版本较老时才需要动文件。真要改就先备份存成 UTF-8 无 BOM并用编辑器校验一遍 JSON 语法——你的编辑器报错它大概率也读不出来。配不通按这个顺序查先跑第一节那条 curl。200 就说明接口侧没问题直接跳到第 4 条。接口地址是不是完整路径、以/chat/completions结尾中间有没有多余斜杠。API Key 有没有复制全末尾有没有多余空格。模型名称是否和接口方清单完全一致大小写敏感。能聊天但不动文件就是「工具调用」没勾。改了models.json没反应先确认客户端版本够新旧版本可能根本不读本地配置再查文件路径、BOM 和 JSON 语法。以上都对还不行去接口方控制台日志看有没有这条请求有记录说明请求已经到网关看报错原因即可完全没有记录那问题还在客户端这一侧。小结自定义模型这条路本身不难卡人的是两个不报错的地方一是接口地址要填到/chat/completions而不是/v1二是六个能力开关一个都不会自动探测。先用 curl 把接口侧摘干净再配界面能省掉绝大部分来回试的时间。能回答问题只是第一关能在权限范围内正确调用工具才算真的接入完成。