CodeBuddy IDE 实战：通过 models.json 接入团队内网大模型（MiMo / Kimi / Qwen 全记录）

CodeBuddy IDE 实战：接入团队内网大模型配置全记录

一、为什么写这篇

公司内网搭了一套 LLM 网关，上面挂着小米 MiMo、Kimi-for-coding、MiniMax、Qwen 等一堆模型。本来想直接在 CodeBuddy / WorkBuddy 里用，结果发现：Web 版根本不支持自定义模型，只有 CodeBuddy IDE 版才能通过 models.json 自己加模型。

网上基本搜不到完整的接入教程，踩了一圈坑，整理出来给后来人省点时间。照着做，半小时就能把团队内网模型接到 IDE 里用起来。

二、前置认知（先避坑）

先说结论：要接内网模型，必须用 CodeBuddy IDE，别在 Web 版上浪费时间。

• CodeBuddy Web 版：不支持自定义模型，只能用官方云端模型
• CodeBuddy IDE 版：支持，通过 models.json 走自定义模型
• WorkBuddy（办公版）：不支持，同 Web 逻辑，云端模型

三、准备工作

1. 已安装 CodeBuddy IDE（国内版）
2. 团队内网 LLM 网关地址（以 http 开头，形如 内网IP:端口 或公网反代地址）
3. 网关分配的 API Key
4. 确认网关支持的模型列表及对应的 model 名称

注意：API Key 属于敏感凭证，发布文章或提交代码时务必脱敏，用 sk-xxxxxx 占位，不要贴真值。内网地址同理，按需处理。

四、核心步骤：配置 models.json

第一步：找到 models.json 的位置

CodeBuddy IDE 的自定义模型配置文件通常位于用户配置目录下。不同系统路径：

Windows: %APPDATA%/CodeBuddy/User/models.json
macOS:   ~/Library/Application Support/CodeBuddy/User/models.json
Linux:   ~/.config/CodeBuddy/User/models.json

如果文件不存在，直接新建一个空的 models.json。

第二步：写入模型配置

一个典型的内网网关接入配置长这样（以 OpenAI 兼容协议为例，大部分内网网关都是这套）：

{
  "models": [
    {
      "id": "mimo-v2",
      "name": "MiMo v2 (内网)",
      "apiBase": "（网关地址）/v1",
      "apiKey": "sk-xxxxxx",
      "model": "mimo-v2",
      "contextLength": 32768
    },
    {
      "id": "kimi-for-coding",
      "name": "Kimi For Coding (内网)",
      "apiBase": "（网关地址）/v1",
      "apiKey": "sk-xxxxxx",
      "model": "kimi-for-coding",
      "contextLength": 131072
    },
    {
      "id": "qwen-fast",
      "name": "Qwen Fast (内网)",
      "apiBase": "（公网反代地址）/ai/api/v1",
      "apiKey": "sk-xxxxxx",
      "model": "qwen-fast",
      "contextLength": 32768
    }
  ]
}

字段说明：

• id：IDE 内部标识，唯一即可
• name：在模型下拉框里显示的名字
• apiBase：网关的 OpenAI 兼容地址，注意带 /v1 后缀（地址通常以 http 开头）
• apiKey：网关给的 key（务必脱敏）
• model：网关侧实际的模型名，必须和网关注册的一致
• contextLength：上下文长度，影响长文件对话

第三步：重启 IDE 并验证

1. 保存 models.json
2. 完全重启 CodeBuddy IDE（不是关窗口，是退出进程再开）
3. 新建对话，点模型选择下拉框，应该能看到你配置的「MiMo v2 (内网)」等
4. 发一句「你好」测试是否能正常回复

验证通过的标志：模型下拉里出现内网模型名，且对话能返回结果、不报 401/404。

五、踩坑实录（重点）

坑 1：Web 版配了半天没反应

一开始在 WorkBuddy Web 版找自定义模型入口，翻遍设置找不到。后来确认 Web 版没有这个功能，只有 IDE 版支持 models.json。别走弯路。

坑 2：apiBase 漏了 /v1

内网网关如果是 OpenAI 兼容协议，地址通常要拼 /v1。直接填（网关地址）会 404。看清网关文档的 base_url。

坑 3：model 名称和 id 搞混

id 是 IDE 用的，model 是发给网关的。网关只认 model 字段的值。如果网关上注册的是 mimo-v2，model 就得写 mimo-v2，写错返回 404「model not found」。

坑 4：API Key 明文泄露

models.json 是本地文件，但如果你把它提交到 Git 或者截图发群里，key 就出去了。建议：

• 本地文件权限收紧
• 提交配置示例时 key 脱敏
• 网关侧支持的话，用受限权限的 key

坑 5：改完不重启

改 models.json 后必须完全退出 IDE 再打开，热重载不一定生效。这是最常见的「配了没反应」原因。

六、实测效果

接上之后，日常编码直接选内网 Kimi-for-coding 做补全和对话，响应快、不占用云端额度，关键是数据不出内网，公司代码安全合规。MiMo v2 适合做中文需求理解和文档生成，Qwen-fast 跑轻量问答很顺。

等于白嫖了一整套团队级大模型，还不用花云端积分。

七、小结

1. 接内网模型 → 只用 CodeBuddy IDE 版，Web 版不支持
2. 配置文件 models.json，关键是 apiBase（带 /v1）+ model（网关真实名）
3. 改完重启 IDE，发消息验证
4. API Key 一定要脱敏，别提交别截图

照着走基本一遍过。有问题的评论区聊，看到回。

本文为 CodeBuddy 实战原创，转载请注明出处。