OpenCode

控制台 API Keys -> 使用密钥 可生成 OpenCode 配置。以下是 OpenAI-compatible provider 的最小形状；模型清单必须以当前 API Key 返回的结果为准。

安装与系统差异

从 OpenCode 当前官方发布页按 Windows、macOS 或 Linux 的说明安装。macOS、Linux 和 WSL 通常使用用户级配置目录；Windows 的安装方式和配置位置随当前版本变化，应以该版本官方界面或文档为准，而不是复制未验证的路径。

创建独立 Key 并先执行：

curl 'https://ai.tavonilo.com/v1/models' \
  -H "Authorization: Bearer $AI_SHOP_API_KEY"

选择响应中的 <MODEL_ID>，不要手填不属于当前 Key 的模型。

保存配置

在 macOS、Linux 或 WSL 上，当前安装通常使用 ~/.config/opencode/opencode.json 或 opencode.jsonc。创建文件前备份已有配置，并把包含 Key 的文件限制为当前用户可读。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://ai.tavonilo.com/v1",
        "apiKey": "sk-your-own-key"
      },
      "models": {
        "<MODEL_ID>": {
          "name": "<MODEL_ID>"
        }
      }
    }
  }
}

不要将完整 /chat/completions 填入 Base URL，也不要把客户端内置静态模型表当成生产目录。

验证与恢复

重启 OpenCode，选择 <MODEL_ID>，先运行一个不含敏感内容的短任务。普通对话成功后，再验证工具、编辑和流式输出。

• 401：检查独立 Key 与本机配置权限。
• 403：重新请求模型列表并检查当前 Key 的权限与余额。
• 404：Base URL 应精确为 https://ai.tavonilo.com/v1。
• 429 / 5xx：采用有限退避，不要复制整份 opencode.json 到支持工单。

支持请求只需时间、模型、路径、HTTP 状态、request ID 和脱敏错误。