Crush

Crush 的配置是 Bash — 在 crushrc 中添加一行 `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"`，即可让 Charm 的终端代理使用 Claude 与 GPT。

# A crushrc is Bash, not a settings file. Everything here is executed.
provider add kunavo \
  --type openai-compat \
  --base-url "https://api.kunavo.com/v1" \
  --api-key "${KUNAVO_API_KEY:?set KUNAVO_API_KEY}"

model add kunavo/claude-sonnet-5 \
  --name "Claude Sonnet 5" \
  --context-window 1000000 \
  --default-max-tokens 32000 \
  --price-input 1.4 \
  --price-output 7

model add kunavo/claude-haiku-4-5 \
  --name "Claude Haiku 4.5" \
  --context-window 200000 \
  --default-max-tokens 16000 \
  --price-input 0.7 \
  --price-output 3.5

model large kunavo/claude-sonnet-5
model small kunavo/claude-haiku-4-5

分步操作

1. 在 /app/keys 创建密钥并复制——它只显示一次。将其导出为 KUNAVO_API_KEY，或者直接在配置中从密码管理器读取。
2. 将上面的配置块放入 ~/.config/crush/crushrc。Crush 会依次读取 ./.crushrc、./crushrc，然后读取全局配置，因此项目可以覆盖机器级设置——克隆下来的仓库也可以自带配置文件。
3. 启动 crush，然后按 ctrl+l 打开模型选择器。上面的 model large 和 model small 行已经固定了两个槽位，因此模型选择器用于切换，而非初始设置。
4. 如果不想手动注册 id：当 openai-compat 提供商的模型列表为空或传入 --discover-models true 时，就会运行自动发现。Kunavo 会响应 GET /v1/models，因此列表会自动填充；发生冲突时，你自己设置的 model add 字段优先。
5. 先运行一项范围明确的任务，然后查看账户在 /app/billing 记录的费用。终端显示的数字只是根据你填写的 --price-* 数值进行的计算；账本记录的才是实际账单。

已于 2026年9月21日 对照 Crush 的自定义提供商章节 检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 Crush 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。