一个人 + AI = 财务审计团队

主题

第2Z课 · ZCode 添加模型 ​

上一课我们把 OpenCode 的家当——配置、会话、技能——整体搬进了 ZCode。这一课解决下一个问题：加模型。ZCode 订阅本身就自带 GLM 系模型（GLM-5.3、GLM-5.3-Flash），日常已经够用；但你想用别家的模型，比如 DeepSeek，也完全可以接进来。

这一课就以 DeepSeek 为例，讲怎么添加自定义模型提供商。整个过程你会发现：配置这个活，也不用你亲手干。

本节要点 ​

  • ZCode 自带 GLM 系模型，但它是开放的：任何模型提供商（DeepSeek、Kimi……）都能接进来用，方法通用
  • 接入第三方模型只需要一样东西：该平台的 API Key（本课以 DeepSeek 开放平台为例）
  • 核心玩法：不用手动填配置，把 API Key 直接发给 ZCode，让它自己配——配置文件在哪、字段怎么填，它全知道
  • ZCode 内置了「配置指南」Skill，模型提供商配置就写在 .zcode/v2/config.json 的 provider 字段里
  • 手动配置麻烦得很：添加提供商要填名称、Base URL、API Key，添加模型还要查上下文窗口和最大输出 token——这些让 AI 自己查、自己填
  • 配完让它验证一遍 JSON 格式是否合法；然后必须重启 ZCode，新模型才会出现在模型列表里
  • 选型参考：GLM-5.3-Flash 价格和 DeepSeek Flash 差不多，能力目前还要更强一些

1. 第一步：去 DeepSeek 开放平台领一个 API Key ​

接入 DeepSeek，先去 DeepSeek 开放平台注册一个账号，然后创建一个 API Key：

  1. 打开 DeepSeek 开放平台，注册账号
  2. 在后台创建 API Key——名字随便起，比如我创建了一个叫 test 的
  3. 创建完复制这串 Key（等下要发给 ZCode）

不用担心费用：新注册的账号平台会赠送一些额度，跑完这一课的操作完全够用，不用急着充值。

2. 第二步：把 API Key 发给 ZCode，让它自己配 ​

这是本课的核心一步。打开 ZCode，把需求直接说给它听：

markdown
帮我在 ZCode 里面配置上自定义的 DeepSeek 提供商的模型，然后我可以去使用。
下面是我的 API key：
sk-xxxxxxxxxxxxxxxx

把你的 API Key 粘上去，发送——接下来就不用你管了，让它自己帮我们配。这一课要学的，其实就是这一句话。

💡 换成别的提供商也一样：注册账号、拿 Key、发这句话，把「DeepSeek」换成别家名字就行。

3. 它帮你配了什么？ ​

发送之后，它没有瞎摸索，而是自己加载了一份「配置指南」——ZCode 内置了一个配置相关的 Skill，所以它清楚地知道：

  • 模型提供商的配置写在 .zcode/v2/config.json 里
  • 对应的是其中的 provider 字段——各家的提供商配置都住在这里

然后它把 DeepSeek 的提供商和模型配置，全部写进了这个字段。我这次它帮我们加了三个模型：DeepSeek V4 Flash Pro、最新的 DeepSeek V4 Flash，以及对应的视觉模型（能看图的那种）。

而且它还会自己去查这几个模型的上下文窗口和最大输出 token，一并填好。为什么这一步很值钱？看看手动配置要填什么就明白了：

手动配置要做的要填的字段
添加提供商名称、Base URL、API Key
添加模型上下文窗口、最大输出 token

在模型设置里人工添加也可以，但上下文窗口、最大输出这些参数，你得跑去官网一个一个查，麻烦得很。所以这个活就交给 AI：它自己查、自己填。

4. 第三步：让它验证 JSON 格式 ​

配置写完，先别急着用，再补一句：

markdown
帮我验证一下这个 JSON 的格式是否合法

配置文件是 JSON，让它检查一遍格式，确认没写坏，才放心往下走。

5. 第四步：重启 ZCode，新模型才出现 ​

验证通过后它会提醒你重启 ZCode。我录课时特意先不重启，去模型列表看了一眼——新模型没有出现，还是原来那几个。

所以别怀疑，必须重启才生效：

  1. 把 ZCode 强制关闭
  2. 重新打开 ZCode
  3. 进模型设置看一眼——DeepSeek 的三个模型已经躺在里面了

直接选 DeepSeek 的模型用就行，全程没手工填过一个字段。

⚠️ 如果你配完在模型列表里找不到新模型，十有八九是还没重启——我录课时就专门验证过：不重启，列表里就是不出来。

6. 值不值得加？顺便聊聊选型 ​

最后说说费用和选型。DeepSeek 这边，新账号会送一些额度；额度用完直接买 API Key 也用不了多少钱。

不过有个新情况要知道——GLM-5.3-Flash 出来之后，DeepSeek 的价格优势就没那么明显了：

模型价格能力
GLM-5.3-Flash（ZCode 自带）和 DeepSeek Flash 差不多，非常便宜目前比 DeepSeek 还要强一些
DeepSeek V4 Flash新账号送额度，API Key 也便宜能用，暂时略逊一筹

所以我的建议是：

  • 日常默认用自带的 GLM-5.3-Flash，很能打
  • 想用别家模型的时候，按这一课的方法两分钟就能接进来，配置很方便

小结 ​

这一课的套路记住，以后接任何模型提供商都是一个模子：

  1. 去模型平台注册账号 → 创建 API Key → 复制
  2. 把 Key 发给 ZCode：「帮我在 ZCode 里面配置上 XX 提供商的模型，下面是我的 API key」
  3. 让它验证 JSON 格式是否合法
  4. 重启 ZCode，去模型设置里选新模型用

下一课预告：第 3Z 课讲 ZCode 的四大好用功能——/goal 挂机、手机遥控、定时任务、闲时任务和多智能体，全是让它替你干活的狠招，不见不散。

© 2025 逆行的狗