⌘K

Crush

概述

Crush 支持自定义 OpenAI 兼容 provider. 将 Vtrix 配置为 openai-compat provider, 填入 Vtrix Base URL, 并让 Crush 从环境变量读取 Vtrix API Key.

环境要求

  • Crush
  • Vtrix API Key, 在 设置 中创建
可选：使用 Vtrix Doctor

也可以先使用 Vtrix Doctor 检查本机 Base URL、API Key 和模型配置。已支持的工具，包括 OpenClaw 和 Hermes，可在确认后一键写入配置。

配置步骤

1

安装 Crush

• 使用 Homebrew

brew install charmbracelet/tap/crush

• 或使用 npm

npm install -g @charmland/crush

安装完成后运行：

crush --version
2

设置 Vtrix API Key

在 ~/.bashrc 或 ~/.zshrc 中加入：

export VTRIX_API_KEY="YOUR_VTRIX_API_KEY"

修改后请重启终端, 或执行：

source ~/.zshrc
3

添加 Vtrix provider

创建 Crush 全局配置文件：

mkdir -p ~/.config/crush
vim ~/.config/crush/crush.json

加入以下配置：

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "vtrix": {
      "type": "openai-compat",
      "base_url": "https://cloud.vtrix.ai/llm",
      "api_key": "$VTRIX_API_KEY",
      "models": [
        {
          "id": "gpt-5.5",
          "name": "GPT-5.5 via Vtrix"
        },
        {
          "id": "qwen3.7-max",
          "name": "Qwen3.7 Max via Vtrix"
        }
      ]
    }
  }
}
Base URL

Vtrix 的 OpenAI 兼容 Base URL 使用 https://cloud.vtrix.ai/llm. Crush 启动时会从 shell 环境展开 "$VTRIX_API_KEY".

4

启动 Crush

进入项目目录并启动 Crush：

cd /path/to/your/project
crush

在 Crush 的模型选择器中选择 vtrix provider 下的模型. 如果模型能正常回复, 说明请求已通过配置的 Base URL 路由到 Vtrix.

也可在 Vtrix 设置 中查看账单或用量.

故障排查

报错：401 Unauthorized

原因： VTRIX_API_KEY 未设置、设置错误, 或启动 Crush 的终端没有加载该环境变量.

处理：

echo $VTRIX_API_KEY

如果为空, 请检查 shell 配置并重启终端.

没有看到 Vtrix provider

原因： Crush 没有读取到预期配置文件, 或项目里的 .crush.json 覆盖了全局配置.

处理： 确认全局配置文件位于 ~/.config/crush/crush.json. 如果项目中存在 .crush.json 或 crush.json, 检查它是否覆盖了 providers 配置.

报错：model not found

原因： crush.json 中的模型 id 与 Vtrix 模型 ID 不一致.

处理： 前往 模型页面 复制正确的模型 ID, 然后更新 ~/.config/crush/crush.json 中的模型配置.

其他配置问题
  • 确认 type 是 openai-compat
  • 确认 base_url 是 https://cloud.vtrix.ai/llm
  • 确认 api_key 是 "$VTRIX_API_KEY"
  • 修改 crush.json 后重新启动 Crush