<!-- Lazu · OpenCode 接入第三方模型：一把 Key 切换 Claude、GPT 与 DeepSeek · https://lazu.ai/zh/blog/opencode-custom-provider -->

# OpenCode 接入第三方模型：一把 Key 切换 Claude、GPT 与 DeepSeek

2026-11-18 · Lazu 团队

先说结论：在 `~/.config/opencode/opencode.json` 里加一个 `provider.lazu`，`baseURL` 填 `https://api.lazu.ai/v1`，同一把 Lazu Key 就能在 OpenCode 里同时切换 Claude、GPT、Gemini、DeepSeek、Kimi、GLM 和 Qwen，主模型和轻量任务（`small_model`）还能分开指定。

## 最快的办法：一行脚本

在 [控制台 › API Keys](https://lazu.ai/console/token) 里选一把 Key，点「接入」，选 OpenCode，复制一键脚本（也可以直接用下面这行）：

```bash
curl -fsSL https://api.lazu.ai/setup/opencode | sh -s -- \
  --model claude-sonnet-5-5 \
  --light claude-haiku-5-5 \
  --also gpt-6.1-sol \
  --also deepseek-v4-pro
```

脚本会在终端提示输入 Key（不会留在命令历史里），自动合并更新 `~/.config/opencode/opencode.json`，并发一次连通性请求确认可用。Windows 用户在同一弹窗里复制 PowerShell 命令即可。

## 手动配置 `opencode.json`

如果想把 API Key 留在环境变量里、方便配置文件入库，先在 shell 启动文件（如 `~/.zshrc`）里导出 `LAZU_API_KEY`：

```bash
export LAZU_API_KEY="sk-lazu-..."
```

然后编辑 `~/.config/opencode/opencode.json`（若设置了 `XDG_CONFIG_HOME`，路径为 `$XDG_CONFIG_HOME/opencode/opencode.json`）：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "lazu/claude-sonnet-5-5",
  "small_model": "lazu/claude-haiku-5-5",
  "provider": {
    "lazu": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Lazu",
      "options": {
        "baseURL": "https://api.lazu.ai/v1",
        "apiKey": "{env:LAZU_API_KEY}"
      },
      "models": {
        "claude-opus-5-5": { "name": "Claude Opus 5.5" },
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "claude-haiku-5-5": { "name": "Claude Haiku 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" },
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
        "deepseek-flash": { "name": "DeepSeek Flash" },
        "kimi-k3": { "name": "Kimi K3" },
        "glm-5.3": { "name": "GLM-5.3" },
        "qwen3.8-max": { "name": "Qwen 3.8 Max" }
      }
    }
  }
}
```

保存后在终端运行 `opencode`，输入 `/models` 就能在上面列出的模型之间即时切换。完整模型 ID 以[模型目录](https://lazu.ai/zh/models)为准。

## 为什么把 `model` 和 `small_model` 分开配

OpenCode 在后台高频发起两类小请求：自动生成会话标题、做轻量文件摘要或辅助判断。如果不设 `small_model`，这些后台请求默认跟着主模型跑——当你主模型选 `claude-opus-5-5` 时，起个标题也按旗舰单价计费。

把 `small_model` 指向 `lazu/claude-haiku-5-5` 或 `lazu/deepseek-flash`，主编码循环保留旗舰推理能力，后台杂活走低延迟小模型，两边共用同一把 Key 的美元预算与用量记录。

## 协议细节：哪些模型怎么注意

OpenCode 的 `@ai-sdk/openai-compatible` 默认走 `/v1/chat/completions`。Lazu 的协议层会在后台把这套请求无损桥接到 Claude 的 Messages 接口或 Gemini 原生接口，工具调用与流式输出照常工作（原理见[协议层说明](/zh/blog/lazu-protocol-layer)）。

只有一处模型限制需要留意：OpenAI 的纯推理型号（如 `gpt-6.1-sol`、`gpt-6-astra`）在 `/v1/chat/completions` 接口上不支持函数工具，必须走 `/v1/responses`。如果你在 `@ai-sdk/openai-compatible` 下主要跑工具调用，OpenAI 系列优先选支持关闭推理的 `gpt-6-luna` 或 `gpt-6-sol`；要用 `gpt-6.1-sol` 跑完整工具流，可以在 `provider` 里为它单独配 `@ai-sdk/openai`（Responses 模式）或直接在 [Codex](/zh/blog/codex-custom-provider) / [Claude Code](/zh/blog/claude-code-custom-api) 中调用。

## 排查常见问题

- **列表里看不到新加的模型：** 检查 `provider.lazu.models` 的键名是否与 [Lazu 模型目录](https://lazu.ai/zh/models)完全一致（区分大小写，如 `MiniMax-M2.7`）。
- **报 `401` 鉴权错误：** 若使用了 `"{env:LAZU_API_KEY}"` 语法，确认启动 `opencode` 的当前终端里 `echo $LAZU_API_KEY` 非空。
- **在控制台看不到按 OpenCode 归类的会话统计：** 旧版 OpenCode 的 `User-Agent` 格式与新版不同，Lazu 已在 `v0.7.260` 兼容新旧两种格式并识别 `x-opencode-session-id` 请求头（详见 [User-Agent 对照复盘](/zh/blog/coding-agent-user-agents)），升级到最新版 OpenCode 即可自动按会话聚合花费。
