Kimi / GLM / 自定义 OpenAI 兼容模型接入
图文分步 ｜ 面向想用更多国产/自定义模型的用户 ｜ 复用 DeepSeek 的接入模板
除了 DeepSeek，Scholardo 还内置了 Kimi、GLM 等第三方模型预设；如果你有一个兼容 OpenAI 接口的自定义服务，也能自己加。它们的接入方式和 DeepSeek 一模一样——都在合并后的单个 AI Agent tab 里配 key + 加服务。这一篇是 P0-3《DeepSeek 完整接入》 的"换个模型"版。
先读过 P0-3 会更顺——本篇只讲和它不同的地方。
一个共同前提：它们都寄生在 Claude Code 上
和 DeepSeek 一样，Kimi / GLM / 自定义 OpenAI 兼容模型都是寄生在 Claude Code 上运行的——Claude Code 充当"运载工具"（carrier）。海外网络下首次启动时 Scholardo 会自动把 Claude Code 装上，你不需要为此再买一份 Claude 订阅。
⚠️ 中国大陆：app 内一键装 carrier 走
claude.ai，被墙装不上（Kimi/GLM 与 DeepSeek 同理）。请先按 《中国大陆使用 Claude Code》 的「第 1 步」用 npm（国内镜像）装好 Claude Code（后面 env-var 步骤不用做，app 会自动注入各服务的端点），再回来做下面的配置。Kimi（Moonshot）/ GLM（智谱）本身是国内服务，运行时可直连、无需 VPN。
接入 Kimi 或 GLM（内置预设）
流程与 DeepSeek 完全相同，只是换一个预设：
- 先去对应平台注册、充值、创建 API key（key 通常只显示一次，立即复制）：
- Kimi：Moonshot 开放平台。
- GLM：智谱 AI 开放平台。
- 具体注册/计费以各平台官网当前页面为准。
- Scholardo 设置 ▸ AI Agent：
- 在 「AI providers」 段点
+，选 Kimi（或 GLM），粘贴 key。 - 在 「CLI agents · Third-party」 段点
+，此时 Kimi / GLM 已就绪（key 没填时会显示 (needs API key)），选它加入。
- 在 「AI providers」 段点
- 回项目开新 session → "Choose an agent" 里出现该服务 → 点它启动。
- 若显示 "Needs Claude Code installed" + 「安装 / Install」，点 Install 让它自动装 carrier。
- 就绪时行上显示类似
<模型名> · Claude Code的摘要。
接入自定义 OpenAI 兼容模型
如果你的服务提供OpenAI 兼容的 API（有 base URL + API key + 模型名），可以自己加：
- 设置 ▸ AI Agent ▸「AI providers」段 点
+→ 选 Add custom provider（添加自定义提供方）。 - 填入这家服务的 base URL、API key、模型名（按其文档）。
- 到 「CLI agents · Third-party」段 点
+→ Add custom service（添加自定义服务），把它接成一个可在终端跑的 agent。 - 回项目开新 session → chooser 里选它启动。
🎯 记住那句共同心智：「AI providers」段放 key，「CLI agents · Third-party」段把它变成能跑的 agent；两段都在同一个 AI Agent tab 里。
Shot list（截图清单）
厂商界面（Kimi / GLM / 自定义服务平台的注册、创建 key 页）如实截取，勿伪造/勿重绘/勿标价格数字。Scholardo 界面用当前发布版、合并后的单个 AI Agent tab。key 截图打码。
| 图号 | 截什么 | 界面来源 | 关键 callout |
|---|---|---|---|
| 1 | Kimi（Moonshot）/ GLM（智谱）平台创建 API key 页 | 厂商界面（如实截取，key 打码） | 🔴 "key 只显示一次，立即复制" |
| 2 | 设置 ▸ AI Agent ▸「AI providers」段 + → 选 Kimi / GLM → 粘 key | Scholardo（key 打码） | 圈出 + 与 key 输入框 |
| 3 | 「CLI agents · Third-party」段 + → Kimi / GLM 已就绪（对比 needs API key） | Scholardo | 圈出"key 填了就亮" |
| 4 | 自定义：+ → Add custom provider 填 base URL/key/模型 | Scholardo | 圈出三项输入 |
| 5 | 开新 session，chooser 里出现该服务并启动 | Scholardo | 旁注"寄生在 Claude Code 上，首次自动装 carrier" |
关键 callout 汇总
- 接入方式同 DeepSeek：「AI providers」放 key + 「CLI agents · Third-party」加服务，同一个 AI Agent tab。
- Kimi / GLM 是内置预设；OpenAI 兼容服务用 Add custom provider / Add custom service 自定义。
- 都寄生在 Claude Code 上：首次启动自动装 carrier，无需另购 Claude 订阅。
- key 只存本机 Keychain，不上传。
常见坑（详见 P0-6 安装/登录 FAQ）
- chooser 里服务显示 needs API key：先回「AI providers」段把该服务的 key 填好保存。
- 终端提示未配置 / 无法读取 key：回 设置 ▸ AI Agent 同一段重新保存 key，再开新 session（第三方服务的中文警告与 DeepSeek 同款，见 P0-6）。
- 自定义服务连不上：核对 base URL / 模型名是否与该服务文档一致，且确为 OpenAI 兼容接口。
数据隐私披露
用 Kimi / GLM / 自定义服务对话时，你的文稿内容会发送给对应的模型服务商处理（Moonshot / 智谱 / 你自定义指向的服务商）。你的 API key 只保存在本机 Keychain，不会上传；但发送出去的文稿内容如何处理，取决于各服务商自己的隐私政策。若材料涉及未公开数据、受访者隐私或保密协议，请先确认发送给第三方 AI 服务是否符合你所在机构的合规要求。