OpenCode 接入

OpenCode 提供开源的终端和桌面 AI 编码 Agent。通过自定义 provider 接入 ooioo，走 OpenAI 兼容协议。

桌面版安装包见桌面客户端下载。桌面版同样读取下方配置；通过图形界面启动时，确认 OOIOO_API_KEY 已设置到桌面会话环境，而非只写进 shell 配置。也可以使用客户端添加自定义服务的入口保存密钥。

配置

编辑 ~/.config/opencode/opencode.json（项目根目录同名文件优先）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ooioo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ooioo",
      "options": {
        "baseURL": "https://ooioo.work/v1",
        "apiKey": "{env:OOIOO_API_KEY}"
      },
      "models": {
        "glm-5.2": { "name": "GLM 5.2" }
      }
    }
  },
  "model": "ooioo/glm-5.2"
}

密钥用环境变量注入（避免写进配置文件）：

export OOIOO_API_KEY="sk-你的Token"

改动后重启 OpenCode 生效。示例中的 glm-5.2 为当前在售模型，完整列表见模型广场。

要点

• baseURL 以 /v1 结尾，不要写到 /v1/chat/completions。
• npm 固定为 @ai-sdk/openai-compatible。
• 顶层 model 用 provider_id/model_id 格式，即 ooioo/glm-5.2。
• models 下的 key 必须是网关真实模型名。

常见问题

现象	原因与处理
401	OOIOO_API_KEY 未生效（重开终端）或 Token 错误
402	额度不足，或触发 API Key 价格保护；按 error.type 区分，见计费说明
模型不存在	模型名与模型广场不一致
配置不生效	OpenCode 需重启加载新 provider