在 OpenCode 中使用 onomeo

OpenCode 是在终端中运行的编程智能体。按以下五步使用 onomeo 密钥接入，选择当前模型列表中的模型并确认价格；本站付费模型需先充值，按实际用量计费。

在终端中编写代码的智能体。

需要填写的内容

兼容 OpenAI

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

Base URL

https://onomeo.com/v1

密钥

模型

正在核验本账号的接口使用条件…

操作步骤

截图及注明日期的用量数据来自历史实测。其中的模型名称与费用仅代表当时情况，请以上方当前模型及价格为准。

1
安装 OpenCode
Windows：按键盘上的 Win 键，输入 PowerShell 后按回车，打开 PowerShell。macOS：打开「终端」。粘贴下方命令后按回车。
```
npm install -g opencode-ai
```
提示找不到 npm 时，请先在 nodejs.org 下载并安装 Node.js（选择长期支持版），安装完成后关闭 PowerShell 并重新打开。

写入配置

点击「复制」，粘贴到同一窗口后按回车。该命令将本站的地址、你的密钥和若干模型写入 OpenCode 的配置文件。

$f = "$HOME\.config\opencode\opencode.json"
if (-not (Test-Path $f)) {
New-Item -ItemType Directory -Force -Path (Split-Path $f) | Out-Null
[IO.File]::WriteAllText($f, @'
{
  "$schema": "https://opencode.ai/config.json",
  "model": "onomeo/MODEL_ID",
  "provider": {
    "onomeo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "onomeo",
      "options": {
        "baseURL": "https://onomeo.com/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "MODEL_ID": { "name": "MODEL_ID" }
      }
    }
  }
}
'@)
Write-Host "已保存：$f" -ForegroundColor Green
} else { Write-Host "已有配置文件，未改动：$f" -ForegroundColor Yellow }

命令中的 YOUR_API_KEY 需替换为你的密钥。在本浏览器创建密钥后，此处将自动填入。

PowerShell 窗口：粘贴命令后，最后一行显示绿色的「已保存」和配置文件的位置 — 最后一行出现绿色的「已保存」，表示配置已写入。

如出现黄色的「已有配置文件，未改动」，说明该电脑此前配置过 OpenCode。为避免覆盖原有设置，命令未写入任何内容：请用记事本打开提示中的文件，将上方 "onomeo" 一段添加到 "provider" 中。

3
启动 OpenCode
先进入项目文件夹（例如输入 cd D:\my-project 后按回车），再输入下方命令并按回车。
```
opencode
```
输入框下方显示「auto onomeo」，表示 OpenCode 已连接本站。
发起任务
在输入框中输入任务内容后按回车。OpenCode 将自动读写文件、运行命令，直至任务完成。
示例任务为新建 hello.py：OpenCode 自动写入文件，并在最后说明所做的操作。
OpenCode 每一步都会将较长的工作说明和工具清单一并发送给模型，每一步计 1 次调用，较长的一步按长度折算为多次。2026 年 9 月 27 日实测：上图任务共三步，使用 auto 计 3 次，不扣费。
更换模型可选
在输入框中输入 /models 后按回车，用方向键选中「onomeo」下方的模型，再按回车。
请选择「onomeo」下方的模型。上方标有 Free 的为 OpenCode 自带的模型，不经过本站。

连接失败时

提示 401：密钥无效。请返回第 2 步重新复制；若提示已有配置文件，请检查文件中 apiKey 一行。
提示 402：余额不足。Claude、GPT 等大模型按用量计费，可在价格页充值，或选择费用较低的模型后重试。
模型列表中没有 onomeo：配置未写入。请重新执行第 2 步，确认最后一行为绿色的「已保存」，然后完全退出 OpenCode 并重新启动。
OpenCode 每次请求都会附带已读取的文件，较长会话可能增加输入用量及费用；开始新任务时建议新建会话。

OpenCode 官方文档

需要填写的内容

兼容 OpenAI

操作步骤

安装 OpenCode

写入配置

启动 OpenCode

发起任务

更换模型可选

连接失败时