Crush 自定义 API 指南：crushrc 与供应商类型
以 Crush 官方仓库和配置文档为依据，说明 crushrc 的供应商注册、模型选择、旧 JSON 迁移及配置执行风险，避免把示例当实测。
内容复核中 官方配置已核对；本站接入未实测。 图解为本站原创示意，不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
Crush 的接入教程首先要核对配置代际。核验时官方仓库主分支采用 Bash 风格的 crushrc；旧 JSON 仍受支持，但已标记弃用。下文针对这份官方配置文档，不承诺所有已安装版本都认识相同语法。
不要把两种 OpenAI 类型混用
官方明确区分 openai 与 openai-compat：前者用于代理或路由 OpenAI 请求，后者用于其他实现 OpenAI 兼容接口的供应商。另有 anthropic 类型用于 Anthropic 兼容服务。不能只看模型显示名称就判断接口格式。
在经过审阅的配置里注册模型
Unix 类系统的全局配置默认是 ~/.config/crush/crushrc。以下是文件内容示意，不是让你在系统终端直接运行 provider 命令；这些命令由 Crush 的内置解释器处理。
provider add guide --type openai-compat --base-url "https://80321.cn/v1" --api-key "YOUR_API_KEY"
model add guide/YOUR_MODEL_ID --name "示例模型"地址仅为占位，本站没有提供该真实接口。正式密钥不要写入可共享文件；可采用官方示例支持的环境变量读取方式。上下文和输出上限应按实际模型声明填写，不能从另一款模型的示例继承。
模型选择器是第一道检查
启动前先审阅测试目录中的配置，再使用 Ctrl+L 打开模型选择器，确认新供应商及模型能够被选中。 第一轮只问一个短的纯文本问题；第二轮才让模型读取临时说明文件，并保留人工审批。记录实际请求目标和工具结果，不能以选项出现作为联通结论。
项目配置可能覆盖全局
官方配置按项目与全局位置合并，项目设置可以覆盖全局；同目录的 crushrc 又会覆盖旧 JSON。若更改全局地址没有生效，检查项目是否存在另一份定义，不要编辑应用状态目录中的 JSON 来修补。
如果客户端报告不认识内置命令，应先对照所安装版本的官方配置资料。接入评估不需要顺便迁移全部设置，更不应删除旧配置后再凭记忆补回。
配置文件本身就是信任边界
crushrc 可以执行 Shell 逻辑，旧 JSON 中的命令替换也可能在加载时运行，官方要求将两者视为可信代码。 不从陌生仓库复制配置，不为解决鉴权错误执行来源不明的取钥命令。出现协议不兼容、流式工具结果异常时先停止任务；保留默认审批，避免使用跳过全部确认的模式。本文只核验文档能力，没有安装 Crush 或发送模型请求。