OminiApi 文档

OpenCode

在 OpenCode 中配置 OminiApi

OminiApi Team客户端接入约 11 分钟

OpenCode 是开源的 AI 编程助手,可以在终端、IDE 或桌面端辅助写代码、调试和改进代码。它会自动加载对应语言的 LSP,支持多会话并行,可以同时接入多家模型。

安装

打开终端,全局安装 OpenCode:

npm i -g opencode-ai

安装完成后运行 opencode,能看到界面说明安装成功。还没装 Node.js 的话,先看 准备工作。

选择接口格式

模型接口格式地址
Claude 系列(claude-opus-5-5、claude-sonnet-5、claude-haiku-4-5-20251001 等)Anthropichttps://omini.ominiapi.top/v1
GPT 系列(gpt-6、gpt-5.6、gpt-5.3-codex-spark 等)OpenAIhttps://omini.ominiapi.top/v1
DeepSeek / GLM / Kimi / GeminiOpenAIhttps://omini.ominiapi.top/v1

Claude 模型要用 Anthropic 格式

Claude 模型只支持 Anthropic 原生接口,放在 OpenAI 格式的提供商下会报 No eligible upstream supports the requested interface or model。

能用哪些模型取决于你密钥的分组,以 模型广场 为准。

方式一:用 CC Switch 配置(推荐)

按 CC Switch 教程安装并打开 CC Switch。

顶部应用栏切换到 OpenCode,点击「添加供应商」。

填写配置:

  • 预设供应商:选择「自定义」;
  • 供应商标识:起一个好记的名字,例如 ominiapi-claude;
  • 接口格式:按上表选择,Claude 选 Anthropic,其他选 OpenAI;
  • API 地址:https://omini.ominiapi.top/v1;
  • API Key:你的 API Key(见 API 密钥);
  • 额外选项(可选):键值对 {"setCacheKey":true},有助于提升缓存命中;
  • 模型配置:填模型 ID 和显示名称,可以填多个,例如:
    • 模型 ID claude-opus-5-5,显示名称 Claude Opus 5.5
    • 模型 ID claude-sonnet-5,显示名称 Claude Sonnet 5

填好后点击右下角「添加」。

在列表里选中刚添加的 OminiApi 供应商,点击「启用」。想同时用 Claude 和 GPT,就按上面步骤再添加一个 OpenAI 格式的供应商。

方式二:手动编辑配置文件

打开配置目录

start "" "%USERPROFILE%\.config\opencode"

编辑 opencode.json

下面的配置添加了两个提供商:omini 走 OpenAI 兼容接口(GPT、DeepSeek 等),omini-claude 走 Anthropic 原生接口(Claude)。按需保留:

~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omini": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OminiApi",
      "options": {
        "baseURL": "https://omini.ominiapi.top/v1",
        "apiKey": "{env:OMINI_API_KEY}"
      },
      "models": {
        "gpt-6": { "name": "GPT-6" },
        "gpt-5.6": { "name": "GPT-5.6" },
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" }
      }
    },
    "omini-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "OminiApi Claude",
      "options": {
        "baseURL": "https://omini.ominiapi.top/v1",
        "apiKey": "{env:OMINI_API_KEY}"
      },
      "models": {
        "claude-opus-5-5": { "name": "Claude Opus 5.5" },
        "claude-sonnet-5": { "name": "Claude Sonnet 5" }
      }
    }
  }
}
  • models 里的键名填 模型广场 里的模型名,可以写多个。
  • 两个 baseURL 都要带 /v1(OpenCode 使用的 SDK 与官方 Anthropic SDK 的约定不同)。

设置环境变量

setx OMINI_API_KEY "你的 API Key"

设置后需要重新打开终端。

也可以直接把 apiKey 的值写成 Key 本身,但不要把这个文件分享给别人。

验证

重新打开终端,运行 opencode,输入 /models,能看到 OminiApi 下的模型就说明配置成功。选一个模型发句话,能正常回复即可开始使用。

常见问题

  • /models 里看不到 OminiApi:检查 opencode.json 是否是合法 JSON,改完要重启 opencode。
  • Claude 模型报错:确认它放在 Anthropic 格式(@ai-sdk/anthropic)的提供商下。
  • 401:检查环境变量是否生效(Windows 用 setx 后要重开终端)。
  • 其他报错到 使用日志 查看原因,对照 错误码。

本页目录