WorkBuddy / CodeBuddy 接入 MoxAI 教程：配置自定义模型供应商

本文整理自 MoxAI 帮助中心，并改写为博客教程，适合希望把 AI Agent、AI 编程助手或桌面客户端接入 MoxAI 的用户参考。

项目介绍

WorkBuddy / CodeBuddy 是一款 AI Agent 与编程助手工具，通过本地 JSON 模型配置文件 管理可用模型。使用 OpenAI 兼容的 Chat Completions API，可无缝接入 MoxAI。

📦 接入前准备

准备信息

• 已安装 WorkBuddy / CodeBuddy
• 一个可用的 MoxAI 地址（必须以 /v1 结尾）
• 一个可用的 MoxAI API Key（在控制台生成）
• 想使用的模型名称（如 claude-sonnet-4-6、gemini-2.5-flash 等，需与 MoxAI 控制台中的模型 ID 完全一致）

🚀 第一步：编辑模型配置文件

找到 WorkBuddy / CodeBuddy 的本地模型配置 JSON 文件（通常位于用户目录下），添加 MoxAI 模型：

{
  "models": [
    {
      "id": "claude-sonnet-4-6",
      "name": "Claude Sonnet 4.6 (MoxAI)",
      "vendor": "MoxAI",
      "url": "https://api.moxai.ai/chat/completions",
      "apiKey": "${MoxAI_API_KEY}",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "gemini-2.5-flash",
      "name": "Gemini 2.5 Flash (MoxAI)",
      "vendor": "MoxAI",
      "url": "https://api.moxai.ai/chat/completions",
      "apiKey": "${MoxAI_API_KEY}",
      "maxInputTokens": 1000000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": [
    "claude-sonnet-4-6",
    "gemini-2.5-flash"
  ]
}

字段要点

• url 必须是 完整的 Chat Completions 端点地址（含 /v1/chat/completions）
• id 填写 MoxAI 控制台实际暴露的模型名称
• maxInputTokens / maxOutputTokens 根据实际模型能力调整
• availableModels 控制 UI 中可选的模型列表

🔑 第二步：设置 API Key 环境变量

Linux / macOS

export MoxAI_API_KEY="your-moxai-api-key"

Windows（PowerShell）

$env:MoxAI_API_KEY="your-moxai-api-key"

建议将环境变量写入 shell 配置文件（~/.bashrc / ~/.zshrc / PowerShell Profile）以便持久化。

✅ 第三步：验证接入

启动 WorkBuddy / CodeBuddy，在模型选择器中选择刚刚添加的 MoxAI 模型（如 claude-sonnet-4-6），发送一条测试消息：

帮我写一个快速排序的 TypeScript 实现

若模型正常响应则接入成功。

❓ 常见问题

问题解决方案模型选择器看不到新加的模型检查 availableModels 是否包含模型 ID，并重启应用401 / API Key 无效确认环境变量已设置，且进程读取到了新值url must end with /chat/completions确认 url 是完整端点，不要只填到 /v1模型不存在确认 id 与 MoxAI 控制台中的模型 ID 完全一致输出被截断提高 maxOutputTokens 上限

更多配置细节可参考 MoxAI 帮助中心原文。