OpenCode 接入

OpenCode 使用 OpenAI 兼容 Provider 接入 Lunora。开始前先完成创建 API Key，并从可用渠道记录当前模型 ID。

1. 安装 OpenCode

安装说明以 OpenCode 官方文档为准。当前 npm 包名是 opencode-ai：

npm install -g opencode-ai
opencode --version

2. 找到配置文件

配置文件是 ~/.config/opencode/opencode.json。Windows 中的 ~ 代表当前用户目录；目录不存在时可以手动创建。

3. 添加 Lunora Provider

把下面的“控制台模型 ID”替换为可用渠道页面显示的完整名称：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lunora": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Lunora",
      "options": {
        "baseURL": "https://api.uselunora.com/v1"
      },
      "models": {
        "控制台模型 ID": {
          "name": "控制台模型 ID"
        }
      }
    }
  }
}

不要直接照搬其他站点的 Provider 名称、模型名或地址。Provider ID lunora 还会用于下一步保存 Key，两处必须完全一致。

4. 保存 API Key

推荐使用 OpenCode 凭证管理：

opencode auth login

类型选择 other，Provider ID 输入 lunora，再输入 Lunora API Key。可以用下面命令检查或移除凭证：

opencode auth list
opencode auth logout lunora

也可以编辑 ~/.local/share/opencode/auth.json：

{
  "lunora": {
    "type": "api",
    "key": "你的 API Key"
  }
}

该文件包含明文 Key，不要上传到代码仓库或发送给其他人。

5. 重启并验证

完全退出旧 OpenCode 进程后重新运行：

opencode

输入 /models，确认可以看到 Lunora 和刚添加的模型，再发送一个简短问题。Ctrl + T 可在当前模型支持时切换推理强度。

常见问题

找不到自定义 Provider

检查 opencode.json 是否为有效 JSON、Provider ID 是否为 lunora，然后完全重启 OpenCode。

返回 401 或 403

重新执行 opencode auth login，确认 Key 完整、未停用并属于包含目标模型的分组。

返回 404

确认 baseURL 是 https://api.uselunora.com/v1，不要重复添加 /v1 或具体接口路径。