OpenCode

1. 领取 SupaNexus API Key

登录开发者控制台，进入项目 → API Keys，创建 Key 并立即复制（仅展示一次）。同一把项目 Key 可用于 OpenAI 兼容与 Anthropic 兼容客户端。

2. 安装 OpenCode

按平台安装 OpenCode CLI，确认终端可直接运行 opencode。

# see https://opencode.ai for current installers
opencode --version

3. 连接自定义提供方

执行 /connect，选择 Other，填一个好记的提供方 ID（如 supanexus），按提示粘贴 API Key。再在项目（或全局）创建/编辑 opencode.json：使用 @ai-sdk/openai-compatible，baseURL 以 /v1 结尾。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "supanexus": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SupaNexus",
      "options": {
        "baseURL": "<BASE_URL>/v1",
        "apiKey": "sk-snx-..."
      },
      "models": {
        "deepseek/deepseek-chat": {
          "name": "DeepSeek Chat"
        },
        "anthropic/claude-3-5-sonnet": {
          "name": "Claude 3.5 Sonnet"
        }
      }
    }
  }
}

4. 选用目录型号 ID

型号 ID 以 SupaNexus 模型市场或 GET /v1/models 为准（例如 deepseek/deepseek-chat、anthropic/claude-3-5-sonnet）。不要套用其它网关的自创 slug。

5. 选择型号并运行

在仓库启动 OpenCode，执行 /models，在你的提供方下选中 SupaNexus 型号。用一个小编程任务验证工具调用与流式输出。

cd /path/to/your/project
opencode
> /models

6. 排障

/models 看不到提供方：确认 opencode.json 位于启动目录（或文档所述全局路径），且 models 的 key 与目录 ID 一致。鉴权失败：apiKey 必须是项目密钥，baseURL 必须含 /v1。Chat Completions 用 openai-compatible；仅在明确需要 /v1/responses 时改用 @ai-sdk/openai。