Trang này hiện chỉ có bản tiếng Trung. Điều hướng và menu đã hiển thị bằng tiếng Việt.

配置 OpenCode

OpenCode 可通过 @ai-sdk/openai-compatible Provider 调用 InOneAPI。模型配置和凭据分开保存：Provider 定义放在配置文件，API Key 放在本地认证文件。

配置 Provider

创建或打开 ~/.config/opencode/opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "inoneapi/YOUR_MODEL_ID",
  "provider": {
    "inoneapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "InOneAPI",
      "options": {
        "baseURL": "https://api.inoneapi.com/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

注意 model 由 OpenCode 的 Provider 名称和 InOneAPI 模型 ID 拼接而成，格式为 inoneapi/YOUR_MODEL_ID。

通过客户端保存凭据

  1. 启动 opencode，输入 /connect。
  2. 选择 Other，Provider ID 填 inoneapi，与配置文件中的键完全一致。
  3. 粘贴 InOneAPI API Key，由 OpenCode 保存凭据；无需创建或编辑 auth.json。
  4. /connect 只保存凭据，不会替你完成自定义 Provider 的端点和模型定义，所以上面的 opencode.json 仍然需要。

默认配置路径为 ~/.config/opencode/opencode.json，Windows 为 %USERPROFILE%\.config\opencode\opencode.json。设置 XDG_CONFIG_HOME 时使用其下的 opencode 目录。

启动与验证

进入测试仓库运行 opencode，输入 /models，确认选择的是 inoneapi/YOUR_MODEL_ID。先发送一个不修改文件的任务，然后在控制台核对 Trace、Token 和费用。

常见问题

  • Provider 不显示：检查 JSON 语法、$schema 和 provider.inoneapi 是否位于根对象。
  • 找不到模型：model 中需要带 inoneapi/ 前缀，models 的键则只写 InOneAPI 模型 ID。
  • 401：认证文件的 Provider 键必须同样是 inoneapi。
  • 工具调用不完整：确认模型支持工具调用；OpenAI-compatible 只表示协议兼容，不代表所有模型能力相同。

配置多个模型时，在 models 中增加条目，并在切换后重新检查项目的模型白名单。

可选：通过 CC Switch 导入

在模型详情页选择本工具和 API Key，点击「打开 CC Switch 并导入」。使用 CC Switch 官方版本，导入链接已包含当前模型 ID，无需重新填写。确认导入后，按本工具的供应商启用与默认模型设置完成接入。若提示不支持该 app，请升级 CC Switch 或按本文手动接入。

导入链接只添加 Provider，不代表已设为默认模型或已成功请求。链接包含 API Key，请勿分享。手动接入与 CC Switch 接入二选一即可。

CC Switch 导入后仍需通过 /models 选择模型；Provider ID 以导入结果为准，不要额外重复创建同名供应商。

官方参考：OpenCode Custom provider。

OpenCode · Tài liệu · InOneAPI