03 Providers 与 OpenAI-compatible 接入

关键规则

• provider 必须写在顶层 provider 下。
• 默认模型必须写成 model: "provider_id/model_id"。
• provider_id 大小写敏感，必须在配置和凭据映射里完全一致。

推荐接入（兼容端点）

当你的服务是中转/聚合/兼容端点，优先：

• npm: "@ai-sdk/openai-compatible"
• options.baseURL: "https://.../v1"

示例

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "fluxcode": {
      "name": "FluxCode",
      "npm": "@ai-sdk/openai-compatible",
      "options": { "baseURL": "https://flux-code.cc/v1" },
      "models": {
        "gpt-5.3-codex": { "name": "GPT-5.3 Codex" }
      }
    }
  },
  "model": "fluxcode/gpt-5.3-codex"
}

安全

• 用 /connect 管理凭据
• 不把 key 写进仓库

参考

• https://opencode.ai/docs/providers/
• https://opencode.ai/docs/troubleshooting/