唯元智创 OpenCode 配置指南

适用范围：使用 OpenCode CLI 接入唯元智创 AI 网关平台，并在 VS Code/Cursor 终端中使用。

项目	配置值
更新时间	2026-06-04
推荐 provider	@ai-sdk/openai-compatible
配置文件	~/.config/opencode/opencode.json
唯元智创平台接口	https://token.wy.cn/v1
默认模型建议	gpt-5.2

重要说明本文档不包含真实 token。请将示例中的 {AIGateway_Token} 替换为唯元智创平台分配的 AI 网关 token。

一、安装

通过 npm 全局安装 OpenCode。安装完成后执行版本检查，能看到版本号即表示安装成功。

npm i -g opencode-ai@latest
opencode --version

![图片](唯元智创 OpenCode 配置指南.assets/image-24dff57df8-1.png)

图 1：安装 OpenCode 并检查版本

二、配置流程

OpenCode 的用户级配置文件为 opencode.json。Windows 与 macOS/Linux 的目录结构一致，均位于用户主目录下的 .config/opencode。

项目	配置值
macOS / Linux	~/.config/opencode/opencode.json
Windows	C:\Users\用户名.config\opencode\opencode.json

2.1 基础格式说明

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "配置名称": {
      "models": {
        "模型id": {"name": "模型显示名"}
      },
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "{AIGateway_Token}",
        "baseURL": "https://token.wy.cn/v1"
      }
    }
  }
}

配置名称用于区分不同 AI 网关；模型 id 必须填写唯元智创平台实际支持的模型名；模型显示名只影响客户端展示。

三、唯元智创完整配置示例

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "weiyuan": {
      "models": {
        "gpt-5.2": {"name": "gpt-5.2"},
        "gpt-5.4": {"name": "gpt-5.4"},
        "claude-4-6-sonnet": {"name": "claude-4-6-sonnet"}
      },
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "{AIGateway_Token}",
        "baseURL": "https://token.wy.cn/v1"
      }
    }
  }
}

![图片](唯元智创 OpenCode 配置指南.assets/image-1edc003ad2-1.png)

图 2：配置 OpenCode 的唯元智创 provider

模型说明如客户账号只开通部分模型，请删除未开通的模型项，或将默认使用模型调整为客户实际可用模型。

3.1 一键写入示例

macOS / Linux

mkdir -p ~/.config/opencode
cat > ~/.config/opencode/opencode.json <<'JSON'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "weiyuan": {
      "models": {
        "gpt-5.2": {"name": "gpt-5.2"},
        "gpt-5.4": {"name": "gpt-5.4"},
        "claude-4-6-sonnet": {"name": "claude-4-6-sonnet"}
      },
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "{AIGateway_Token}",
        "baseURL": "https://token.wy.cn/v1"
      }
    }
  }
}
JSON

chmod 600 ~/.config/opencode/opencode.json

Windows PowerShell

$OpenCodeDir = Join-Path $HOME ".config\opencode"
New-Item -ItemType Directory -Force -Path $OpenCodeDir | Out-Null

@'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "weiyuan": {
      "models": {
        "gpt-5.2": {"name": "gpt-5.2"},
        "gpt-5.4": {"name": "gpt-5.4"},
        "claude-4-6-sonnet": {"name": "claude-4-6-sonnet"}
      },
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "{AIGateway_Token}",
        "baseURL": "https://token.wy.cn/v1"
      }
    }
  }
}
'@ | Set-Content -Encoding UTF8 (Join-Path $OpenCodeDir "opencode.json")

四、OpenCode 使用方法

进入需要处理的项目目录。

运行 opencode 启动交互式会话。

输入 /model，选择 weiyuan provider 下的模型。

开始对话或让 OpenCode 阅读、分析、修改项目文件。

cd 你的项目路径
opencode
/model

![图片](唯元智创 OpenCode 配置指南.assets/image-1f62eebbd4-1.png)

图 3：在 OpenCode 中切换唯元智创模型

五、VS Code / Cursor 使用

OpenCode 可直接在 VS Code 或 Cursor 的集成终端中运行。建议先在项目根目录打开编辑器，再在集成终端执行 opencode，使其读取当前工作区上下文。

cd 你的项目路径
code .
# 在 VS Code 终端中执行
opencode

![图片](唯元智创 OpenCode 配置指南.assets/image-25f2a06ad9-1.png)

图 4：在 VS Code 集成终端中启动 OpenCode

六、网关适配性

测试场景	测试方式	验证能力	唯元智创平台
启动连接	配置 API 后启动 OpenCode	API 认证、基础连通	YES
基础对话	发送“你好”或简单问题	流式响应、SSE 格式	YES
阅读文件	读取某个代码文件	工具上下文读取	YES
执行命令	执行 shell 命令	终端工具调用	YES
复杂任务	读取、分析、修改多步骤任务	多轮工具调用、长上下文	YES
模型切换	输入 /model 切换模型	provider 和模型选择	YES

七、常见问题

7.1 provider 名称必须叫 weiyuan 吗？

不是。weiyuan 是推荐示例名，客户也可以改成 company-gateway、prod-gateway 等便于识别的名称。

7.2 什么时候使用 @ai-sdk/openai-compatible？

当网关提供 OpenAI chat/completions 兼容接口时，推荐使用 @ai-sdk/openai-compatible。唯元智创平台对外接口地址填写 https://token.wy.cn/v1。

7.3 API 返回鉴权失败怎么办？

确认 {AIGateway_Token} 已替换为真实 token。

确认 token 未包含多余空格、换行或中文引号。

确认客户账号已开通当前模型。

确认 baseURL 为 https://token.wy.cn/v1。

OpenCode 配置指南

唯元智创 OpenCode 配置指南#

一、安装#

二、配置流程#

2.1 基础格式说明#

三、唯元智创完整配置示例#

3.1 一键写入示例#

macOS / Linux#

Windows PowerShell#

四、OpenCode 使用方法#

五、VS Code / Cursor 使用#

六、网关适配性#

七、常见问题#

7.1 provider 名称必须叫 weiyuan 吗？#

7.2 什么时候使用 @ai-sdk/openai-compatible？#

7.3 API 返回鉴权失败怎么办？#