Crush 接入 MoxAI 教程：配置开源终端 AI 编程 Agent

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

项目介绍

Crush 是由 Charm 开发的开源 AI 编程 Agent，运行在终端中。支持多模型切换、LSP 集成、MCP 服务器和代理式编码工作流，UI 精致且交互流畅。

• GitHub：https://github.com/charmbracelet/crush

📦 接入前准备

准备信息

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

🚀 第一步：安装 Crush

npm install -g @charmland/crush

macOS 用户也可通过 Homebrew 安装：

brew install charmbracelet/tap/crush

验证安装：

crush --version

🔧 第二步：编辑配置文件

配置文件位置：

• Linux / macOS：~/.config/crush/crush.json
• Windows：%USERPROFILE%\.config\crush\crush.json

如果文件不存在，自行创建即可。填入以下内容：

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "moxai": {
      "type": "openai-compat",
      "base_url": "https://api.moxai.ai",
      "api_key": "$MoxAI_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-4-6",
          "name": "Claude Sonnet 4.6",
          "context_window": 200000,
          "default_max_tokens": 32768,
          "can_reason": true
        },
        {
          "id": "gemini-2.5-flash",
          "name": "Gemini 2.5 Flash",
          "context_window": 1000000,
          "default_max_tokens": 32768,
          "can_reason": false
        }
      ]
    }
  }
}

字段要点

• type 必须为 openai-compat
• base_url 需以 /v1 结尾
• api_key 使用 $MoxAI_API_KEY 变量引用，避免把明文密钥写入配置文件
• models[].id 必须与 MoxAI 控制台完全一致

🔑 第三步：设置环境变量

Linux / macOS

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

Windows（PowerShell）

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

建议写入 shell 配置文件以便持久化。

✅ 第四步：启动并选择模型

进入你的项目目录：

cd /path/to/my-project
crush

按 Ctrl+L（或输入 /model）打开模型切换器，选择 moxai 供应商，然后选择目标模型。发送一条测试消息验证响应。

❓ 常见问题

问题解决方案模型切换器看不到 moxai检查 crush.json 路径和 JSON 格式是否正确401 Unauthorized确认 MoxAI_API_KEY 已导出到当前 shell模型不存在核对 models[].id 与 MoxAI 控制台完全一致修改配置后没生效退出 Crush 重新启动

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