{
  "$schema": "https://opencode.ai/config.json",

  "model": "wox/YOUR_MODEL_ID",

  "provider": {
    "wox": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "WOX",
      "options": {
        "baseURL": "https://api.wox.lol/v1",
        "apiKey": "{env:WOX_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

如果你已有其他 provider，不要直接覆盖整个配置文件。只需要在 provider 下新增 wox，并将 model 改为 wox/YOUR_MODEL_ID。

配置环境变量

在终端中配置 WOX API Key：

export WOX_API_KEY="你的 WOX API Key"

如果希望长期生效，可以写入 shell 配置文件：

echo 'export WOX_API_KEY="你的 WOX API Key"' >> ~/.bashrc
source ~/.bashrc

macOS 或 zsh 用户可以写入：

echo 'export WOX_API_KEY="你的 WOX API Key"' >> ~/.zshrc
source ~/.zshrc

验证 CLI 配置

启动 OpenCode 后，输入：

/models

如果配置成功，可以看到：

WOX
YOUR_MODEL_ID

选择 WOX / YOUR_MODEL_ID 后，即可开始使用 WOX 模型。

OpenCode Desktop 配置

适用场景

适用于使用 OpenCode Desktop 图形界面的用户。

配置步骤

启动 OpenCode Desktop，点击左下角的设置按钮。

在提供商列表中找到 自定义提供商，点击右侧的连接。

按照以下内容填写 WOX 提供商配置。

提供商配置

字段	填写内容
提供商 ID	`wox`
显示名称	`WOX`
基础 URL	`https://api.wox.lol/v1`
API 密钥	填写你的 WOX API Key
模型 ID	`YOUR_MODEL_ID`
模型显示名称	`YOUR_MODEL_ID`

配置示例：

提供商 ID：wox
显示名称：WOX
基础 URL：https://api.wox.lol/v1
API 密钥：sk-xxxxxxxx
模型 ID：YOUR_MODEL_ID
模型显示名称：YOUR_MODEL_ID

填写完成后，点击提交。

验证 Desktop 配置

配置完成后，回到 OpenCode Desktop 主界面。

在模型选择列表中选择：

WOX / YOUR_MODEL_ID

发送测试消息：

你好，你是什么模型？

如果模型正常回复，说明配置完成。

常见问题

找不到 WOX 模型

请检查以下配置：

Provider ID 是否为 wox
Base URL 是否为 https://api.wox.lol/v1
Model ID 是否为 YOUR_MODEL_ID
API Key 是否填写正确
API Key 前面是否误填了 Bearer

API Key 报错

请确认 API Key 来自 WOX 控制台，并且复制时没有包含多余空格。

正确示例：

sk-xxxxxxxxxxxxxxxx

错误示例：

Bearer sk-xxxxxxxxxxxxxxxx

请求失败或无法连接

请检查：

当前网络是否可以访问 WOX API Gateway
Base URL 是否只填写到 /v1
是否误填成 /v1/chat/completions
API Key 是否仍然有效

正确 Base URL：

https://api.wox.lol/v1

场景	推荐模型
日常代码生成	`YOUR_MODEL_ID`
项目分析	`YOUR_MODEL_ID`
代码修改	`YOUR_MODEL_ID`
多轮开发对话	`YOUR_MODEL_ID`

完整参数速查

参数	值
Provider Name	`WOX`
Provider ID	`wox`
NPM Provider	`@ai-sdk/openai-compatible`
Base URL	`https://api.wox.lol/v1`
API Key Env	`WOX_API_KEY`
Model ID	`YOUR_MODEL_ID`
OpenCode Model Path	`wox/YOUR_MODEL_ID`

Opencode 集成指南

Opencode 集成指南

概述

准备工作

OpenCode CLI 配置

适用场景

配置文件示例

配置环境变量

验证 CLI 配置

OpenCode Desktop 配置

适用场景

配置步骤

提供商配置

验证 Desktop 配置

常见问题

找不到 WOX 模型

API Key 报错

请求失败或无法连接

推荐配置

完整参数速查

本页目录