Crush 接入 Models Hub:crushrc 配置自定义供应商

编辑 Crush 的 crushrc 文件,用 provider add 与 model add 命令接入 Models Hub 的 OpenAI 兼容模型,附验证步骤与常见报错排查。

Crush 是 Charm 开发的开源终端 AI 编码智能体,支持多模型切换、LSP 集成和 MCP 服务器。把自定义供应商指向 Models Hub 后,crush 里的对话与代码修改都会用 Models Hub 的额度调用你指定的模型。本文只讲接入,不讲 Crush 本身的用法。

三样东西

接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1、一个模型名。没有一键配置,Crush 不在 Models Hub CLI 的支持范围内。

准备

已安装 Crush。没装的话运行 npm install -g @charmland/crush,macOS 也可以 brew install charmbracelet/tap/crush,装完 crush --version 能出版本号即可,详见 GitHub 仓库。
一个 Models Hub API Key。在控制台的令牌页创建,令牌所在分组要能访问你打算用的模型。

用途	模型名	定价	实时状态
编码首选	`claude-sonnet-4-6`	查看价格	可用率与延迟
复杂推理与长任务	`gpt-5.5`	查看价格	可用率与延迟
便宜快速的小改动	`gpt-5.4-mini`	查看价格	可用率与延迟

配置步骤

旧的 crush.json 已弃用

Crush 当前推荐用 crushrc(Bash 风格的配置脚本)声明供应商;旧的 crush.json JSON 格式仍能用,但官方已标记为弃用,新装建议直接用 crushrc。

编辑或新建 crushrc 文件,位置按优先级:项目内 ./.crushrc 或 ./crushrc,否则读用户级 ~/.config/crush/crushrc(Windows 为 %USERPROFILE%\.config\crush\crushrc)。写入:

provider add modelsok --type openai-compat \
  --base-url "https://modelsok.com/v1" \
  --api-key "$MODELSOK_API_KEY"

model add modelsok/claude-sonnet-4-6 \
  --name "Claude Sonnet 4.6" \
  --context-window 200000 \
  --default-max-tokens 32768 \
  --can-reason

model add modelsok/gpt-5.4-mini \
  --name "GPT-5.4 Mini" \
  --context-window 128000 \
  --default-max-tokens 16384

命令/参数	作用
`provider add <id> --type openai-compat`	声明一个 OpenAI 兼容供应商,`<id>` 自己起名
`--base-url`	接入地址,必须以 `/v1` 结尾
`--api-key`	引用环境变量,避免把明文密钥写进配置文件
`model add <provider>/<model>`	给供应商登记一个模型,`<model>` 必须与 Models Hub 控制台一致
`--can-reason`	标记该模型支持推理,非推理模型可以省略

再设置环境变量:

Linux / macOS

export MODELSOK_API_KEY="你的 Models Hub API Key"

Windows(PowerShell)

$env:MODELSOK_API_KEY="你的 Models Hub API Key"

建议写进 shell 配置文件持久化。

验证

进入项目目录运行 crush,按 Ctrl+L 打开模型选择器,选择 modelsok 供应商下的模型,发送一条测试消息,能正常回复即接通。再打开 Models Hub 控制台的用量日志,几秒内会出现一条对应模型名的请求。

常见报错

现象	原因	处理
模型选择器看不到 modelsok	`crushrc` 路径不对,或脚本语法有误	确认文件路径,重新打开 Crush
`401 Unauthorized`	`MODELSOK_API_KEY` 没有导出到当前 shell	检查环境变量,重开终端后再试
模型不存在	`model add` 里的模型名与 Models Hub 控制台不一致	对照定价页核对名字
修改配置后没生效	Crush 只在启动时读取一次 `crushrc`	退出 Crush 重新启动
推理模型响应异常	忘了给该模型加 `--can-reason`	重新执行 `model add` 补上这个参数

更多排查见故障排查。

常见问题

计费方式? 按请求实际消耗的输入与输出 token 计费,价格在各模型的定价页,用量日志里能看到每一条请求的明细。

和直接用官方 API 有什么区别? Crush 只认 OpenAI 兼容协议,Models Hub 网关会把请求转发给你指定的具体模型,你不需要单独申请对应厂商的账号。

怎么切换模型? 在 Crush 里按 Ctrl+L 或输入 /model 打开选择器,已登记的模型都会列出来;想加新模型就再执行一次 model add。

Crush 接入 Models Hub:crushrc 配置自定义供应商

准备

推荐模型

配置步骤

验证

常见报错

常见问题

相关

本页目录