确认 /connect 与配置都使用 wujieWebsite，保存后完全重启。
OpenCode 图文接入教程
从创建密钥到完成第一次对话，按步骤把 OpenCode 安全连接到无界 AI。适用于 OpenCode 1.x。
约 10 分钟 · OpenCode 1.x
配置完成后，你会得到什么
OpenCode 直接通过 HTTPS 调用无界 AI。无需旧的 SSH 隧道，也无需把密钥写进项目配置。
- 服务商 ID
- wujieWebsite
- 模型
- wujie-128k
- 接口
- https://wujieai.fun/v1
STEP 01
创建并保存 API 密钥
每个工具建议使用独立密钥，便于识别和单独停用。
- 登录无界 AI，进入“API 密钥”。
- 点击“创建密钥”，名称建议填写
OpenCode。 - 复制完整密钥并保存在密码管理器；完整内容只显示一次。
不要泄露：密钥不要发进聊天、截图、GitHub 或网页前端。教程中的密钥均为虚构示例。
无界 AI · API 密钥
✓密钥已创建完整密钥仅显示一次
sk-wj-••••••••••••••••••••复制密钥STEP 02
确认 OpenCode 已安装
已经可以正常打开 OpenCode，就直接进入下一步。
已经能打开 OpenCode 的用户可跳过安装。全新安装可在 PowerShell 中使用 npm。
Windows · 安装并检查版本
npm install -g opencode-ai
opencode --version本教程按 OpenCode 1.x 编写。后续版本如更改配置格式，请以 OpenCode 官方文档为准。
STEP 03
把密钥交给 OpenCode 保管
先添加凭据，再在下一步声明无界 AI 服务商。两处 ID 必须完全一致。
- 在项目目录运行
opencode。 - 输入
/connect，滚动到最下方并选择 Other。 - Provider ID 输入
wujieWebsite（注意大小写）。 - 粘贴刚才保存的完整 API 密钥并确认。
这一步由 OpenCode 保存凭据；密钥不需要出现在 opencode.json 中。请像保护密码一样保护本机的 OpenCode 凭据文件。
OpenCode● connected
› /connect
◆ Select provider
● Other
◇ Enter provider id
wujieWebsite
◇ Enter your API key
sk-wj-••••••••••••
STEP 04
在项目中添加服务商配置
在项目根目录创建或更新 opencode.json，让 OpenCode 知道接口和模型。
已有 opencode.json？先备份并合并到同一个根对象；不要把两份 JSON 直接首尾拼接。打开安全合并工具 →
opencode.json · 新项目可直接使用
{
"$schema": "https://opencode.ai/config.json",
"model": "wujieWebsite/wujie-128k",
"provider": {
"wujieWebsite": {
"npm": "@ai-sdk/openai-compatible",
"name": "无界 AI",
"options": {
"baseURL": "https://wujieai.fun/v1"
},
"models": {
"wujie-128k": {
"name": "无界 AI · 128K",
"limit": {
"context": 131072,
"output": 16384
}
}
}
}
}
}provider ID
wujieWebsite必须与 /connect 中输入的 ID 相同。
Base URL
https://wujieai.fun/v1必须保留末尾的 /v1。
完整模型 ID
wujieWebsite/wujie-128k服务商 ID 与模型 ID 用斜杠连接。
STEP 05
重启、选择模型并开始使用
配置保存后完全退出 OpenCode，再重新打开并新建对话。
没连接成功？按这个顺序检查
运行 opencode auth list 检查凭据；必要时停用旧密钥并重新创建。
检查重复大括号和尾逗号。已有配置请用合并工具，不要直接拼接两份 JSON。
确认 Base URL 是 https://wujieai.fun/v1，再查看服务状态。