把小米 MiMo 接入 VSCode：用 CodeBuddy 建立你的专属 AI 编程 Agent

前言

刚拿到小米 MiMo 的 API Key。满怀期待想在 VSCode 内直接写代码，却发现市面上大多只停留在“Python 调 API”的层面离真正的 IDE 集成还有很大距离。许多开发者一样遇到过这样的问题：API Key 在 VSCode 中无法被识别、工具调用失败，甚至收到 Unauthorized 或 Model Not Found 的错误信息。

为什么不能直接改 Enterprise Endpoint？不过，痛点解析

痛点一： 试图修改 CodeBuddy 设置里的 “Enterprise Endpoint” 时往往会得到 “Endpoint 不支持外部 OpenAI 格式” 的提示。原因是该通道仅供腾讯云公司内部私有化部署使用，根本不接受第三方模型。按理说，

痛点二： 很多人误以为只需要改 Endpoint 就能完成集成。却忽略了 CodeBuddy 的“配置驱动”设计。真正的关键是 /models.json 和 Agent 的 .md 配置文件。按理说，

实战步骤 – 环境准备与痛点提示

1️⃣ 环境准备

1. VSCode 安装完成。
2. Add CodeBuddy 插件。话说回来，
3. A valid Xiaomi MiMo API Key。老实说，确保没有空格或换行符。否则会出现 Unauthorized 错误。不过，

2️⃣ 配置 models.json – 痛点：方法不对或 JSON 语法错误导致无法加载模型

注意：方法区分操作程序！话说回来，macOS / Linux 使用 ~/.codebuddy/models.json；Windows 使用 C:\Users\使用者名\.\codebuddy\models.json。

{
"models":。"availableModels":
}

• ID 必须唯一且与 Agent 文件中引用一致，否则报错 Model Not Found。
• "supportsToolCall" 必须为 true，否则工具调用会被禁用并报 Tools not supported。
• "url" 必须完整并以 /chat/completions，否则请求会失败。
• "apiKey" 切勿包含多余空格，否则会触发 Unauthorized 错误。

3️⃣ 创建 Agent 配置文件 – 痛点：工具权限不足导致功能失效

Create a new file at .codebuddy/agents/mimo.md. Use following template:

---
说到name。mimo
description: 基于小米 MiMo 的编程助手，擅长代码重构与生成。再看model，mimo-v2-pro
再看tools。agentMode: agentic
enabled: true
enabledAutoRun: true
---
你是一个专业的全栈开发助手，基于小米 MiMo 模型运行。## 行为准则
**安全第一**：在执行 `execute_command` 前必须向使用者解释命令的作用。**代码规范**：生成的代码必须符合当前项目的 ESLint/Prettier 规范。
**注释风格**：所有主要原因必须添加中文注释。其实，## 工具使用
- 修改文件优先使用 `replace_in_file`。避免全量覆盖，- 阅读代码优先使用 `read_file` 或 `read_lines`。## 响应格式
• 关键步骤使用 ✅ 标记；说起来，潜在风险使用 ⚠️ 标记。--- 

• "tools" 列表越完整，你的 AI 能力越强；如果缺少某个工具，会直接报错 Tools not supported。说起来，
• "model" 必须与 models.json 中 id 完全一致。否则报 Model Not Found。
• "agentMode" 为 agentic 时 AI 会自行规划步骤并调用工具，为了更好体验推荐开启此模式。

4️⃣ 重启 VSCode 并验证 – 痛点：未正确重载导致 Agent 不可见或功能异常

1. SE 所有更改后重启 VSCode 或执行快捷键 D+R+W.
2. MIMO Agent 应该出现在 CodeBuddy 面板左侧列表中。如果看不到，请检查是否已保存至正确方法。
3. MIMO 输入以下指令测试：

"分析当前项目的 package.json。告诉我使用了哪些依赖，并帮我升级到当前版本。"

• MIMO 应先读取 package.json → 调用 read_file → 分析依赖 → 提示升级方案 → 最终执行 npm install 并返回结果.
• If you see “Executing command” with a warning and no result ➜ 检查 execute_command 权限是否已授予或 apiKey 是否有效.

​ ​ ​ ​ ​

成功标志

• AI 能够读取项目文件并自动生成升级脚本。
• 自动输入命令后返回终端输出，无需手动干预。

常见错误 & 排查

避坑教程

• MIMO 使用的是 OpenAI‑compatible 接口，请确保 URL 正确且末尾包含 /chat/completions。若忘记此段 URL，将导致请求被拒绝。
• `maxInputTokens` 与 `maxOutputTokens` 建议设置为官方推荐值，以免因 token 超限导致响应截断。
• `supportsImages` 默认 false。如果你打算让 MIMO 支持图片推理，需要额外申请图像接口权限并在 agents 文件中开启相关工具。

小结

通过以上四步。你可以轻松将 Xiaomi MiMo 集成进 VSCode 并赋予它完整的文件读写、命令行执行还有网络查询等能力，从而建立属于自己的 AI 编程智能体。怎么说呢，不仅解决了「API Key 无法识别」和「Endpoint 改不生效」等痛点。还让团队协作变得更加跨人共享统一的 AI 行为规范。

推荐阅读

• 腾讯云 CodeBuddy 自定义大模型配置文档
• 小米官方 API 文档
• 开源社区关于 OpenAI‑compatible 模型集成案例

祝你编码愉快 🚀