在 Crush 中使用 onomeo

Crush 是在终端中编写代码的智能体，其设置统一写在名为 crushrc 的文件中。按以下四步将本站写入该文件后，即可使用本站的模型。

在终端中编写代码的智能体，由 Charm 开发。

需填写的三个值

兼容 OpenAI

以下信息适用于任何兼容 OpenAI 的工具。

Base URL

https://onomeo.com/v1

密钥

模型

尚无密钥时，请先在「我的」页创建，返回本页后下方字段将自动填入。前往「我的」页

操作步骤

1
安装 Crush
Windows：按键盘上的 Win 键，输入 PowerShell 后按回车。macOS：打开「终端」。粘贴下方命令后按回车。
```
npm install -g @charmland/crush
```
提示找不到 npm 时，请先在 nodejs.org 安装 Node.js（LTS 版本），然后关闭 PowerShell 并重新打开。Windows 上也可使用 winget install charmbracelet.crush 安装。
2
写入配置
点击「复制」，粘贴到同一窗口后按回车。该命令将本站的地址、你的密钥和模型 auto 写入 Crush 的 crushrc 文件。
```
$f = "$HOME\.config\crush\crushrc"
if (-not (Test-Path $f)) {
New-Item -ItemType Directory -Force -Path (Split-Path $f) | Out-Null
[IO.File]::WriteAllText($f, @'
provider add onomeo --type openai-compat --base-url "https://onomeo.com/v1" --api-key "YOUR_API_KEY"
model add onomeo/auto --name "onomeo auto" --context-window 128000 --default-max-tokens 16000
'@)
Write-Host "已保存：$f" -ForegroundColor Green
} else { Write-Host "已有配置文件，未改动：$f" -ForegroundColor Yellow }
```
命令中的 YOUR_API_KEY 需替换为你的密钥。在本浏览器创建密钥后，此处将自动填入。
最后一行出现绿色的「已保存」，表示配置已写入。如出现黄色的「已有配置文件，未改动」，说明此前已配置过 Crush：请用记事本打开提示中的文件，将以 provider add 和 model add 开头的两行添加进去。
3
启动 Crush
先进入项目文件夹（例如输入 cd D:\my-project 后按回车），再运行下方命令。文件夹名称下方将显示所用的模型：onomeo auto via onomeo。
```
crush
```
显示 onomeo auto via onomeo，表示请求将发往本站。
发起任务
输入任务内容后按回车。写入文件或运行命令前，Crush 会先请求许可：在 Allow 上按回车。
示例任务为新建 hello.py：许可后，Crush 写入文件、运行检查并回复了输出。
每一步计 1 次调用，较长的一步按长度折算为多次。2026 年 10 月 9 日使用 Crush 0.98.0 实测：上图任务使用 auto 计 4 次，不扣费。

连接失败时

地址末尾保留 /v1，其后无需添加任何内容，Crush 将自动补全 /chat/completions。
如需添加模型页上的其他模型，在 crushrc 文件中再添加一行 model add onomeo/模型名称。在 Crush 中按 Ctrl+M 可切换模型。
编写代码时，整份文件将随问题一并发送：免费模型不扣费，但较长的请求按长度折算为多次调用；Claude、GPT 等大模型按用量计费，余额消耗较快。
提示 401：密钥无效，请修改 crushrc 文件中 --api-key 之后的内容。提示 402：余额不足。Claude、GPT 等大模型按用量计费，可在价格页充值或换用免费模型。
若已在「我的服务商」页接入自己的密钥，添加一行 model add onomeo/my/服务商/模型名称，即可改由该服务商作答，其余设置不变，本站不另收费。

Crush 官方文档

需填写的三个值

兼容 OpenAI

操作步骤

安装 Crush

写入配置

启动 Crush

发起任务

连接失败时