Crush

Crush 是 Charmbracelet 提供的终端 AI 编程 Agent。它支持 OpenAI 兼容 Provider，可通过 crushrc 将请求转发到 ModelGo。

接入前准备

已安装 Node.js 18+、Go 或 Homebrew。
已安装 Crush，并能执行 crush --version。
已在 ModelGo 控制台创建 API Key。
已在模型广场确认逻辑模型名。

1. 安装 Crush

bash

brew install charmbracelet/tap/crush
crush --version

也可以使用 npm install -g @charmland/crush、go install github.com/charmbracelet/crush@latest，Windows 用户可执行 winget install charmbracelet.crush。

2. 添加 ModelGo Provider

Crush 的项目配置放在项目根目录的 .crushrc 或 crushrc，全局配置放在 ~/.config/crush/crushrc（Windows：%USERPROFILE%\\.config\\crush\\crushrc）。推荐使用 CLI 写入配置：

bash

export MODELGO_API_KEY="sk-你的token"
crush provider add modelgo --type openai-compat \
  --base-url "https://api.modelgo.com/v1" \
  --api-key "$MODELGO_API_KEY"
crush model add modelgo/你的模型名 --name "你的模型名"

将 你的模型名 替换为模型广场中的逻辑模型 ID。openai-compat 表示使用 OpenAI Chat Completions 兼容协议。

3. 启动并验证

bash

crush

在模型选择器中选择 ModelGo 模型，发送一条简单请求。也可先验证目录接口：

bash

curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"

常见问题

找不到 Provider

确认 crushrc 路径和文件名正确，并重新启动 Crush。项目配置会覆盖全局配置。

返回 401 或 404

检查 MODELGO_API_KEY 是否生效，Base URL 是否为 https://api.modelgo.com/v1，不要填写完整接口路径。

Crush

接入前准备

1. 安装 Crush

2. 添加 ModelGo Provider

3. 启动并验证

常见问题

找不到 Provider

返回 401 或 404

相关文档